vpow
Prev | Opcodes et opérateurs de l'orchestre | Next

## vpow

vpow — Elévation de chaque composante d'un vecteur à une puissance scalaire.

## Description

Elévation de chaque composante d'un vecteur à une puissance scalaire.

## Syntaxe

    vpow  ifn, kval, kelements [, kdstoffset] [, kverbose]

## Initialisation

ifn - numéro de la table hébergeant le signal vectoriel à traiter.

## Exécution

kval - valeur scalaire, puissance à laquelle seront élevés les éléments de ifn.

kelements - nombre de composantes du vecteur.

kdstoffset - décalage d'indexation pour la table de destination (facultatif, vaut 0 par défaut).

kverbose - Indique si les avertissements sont affichés (vaut 0 par défaut).

vpow élève chaque élément du vecteur contenu dans la table ifn à la puissance kval, à partir de l'index de table kdstoffset. Cela permet de traiter une section particulière d'une table en spécifiant le décalage et le nombre d'éléments à traiter. Le décalage est compté à partir de 0, si bien que si aucun décalage n'est spécifié (ou s'il est fixé à 0), la table est modifiée depuis le début.

Noter que cet opcode est exécuté au taux-k si bien que la valeur de kval est traitée à chaque période de contrôle. A utiliser avec précaution si l'on ne veut pas finir avec des nombres très grands ou très petits (ou utiliser vpow_i).

Ces opcodes (vadd, vmult, vpow et vexp) réalisent des opérations numériques entre un signal vectoriel de contrôle (hébergé par la table ifn), et un signal scalaire (kval). Le résultat est un nouveau vecteur qui écrase les anciennes valeurs de ifn. Tous ces opcodes travaillent au taux-k.

Les valeurs négatives sont valides pour kdstoffset. Les composantes du vecteur se trouvant en dehors de la table sont alors ignorées, et elles ne sont pas repliées autour de la table.

Si l'argument facultatif kverbose est différent de 0, l'opcode affichera des messages d'avertissement à chaque passe-k si les longueurs de table sont dépassées.

Dans tous ces opcodes, les vecteurs résultants sont stockés dans ifn, écrasant les vecteurs initiaux. Si l'on veut garder le vecteur initial, il faut utiliser vcopy ou vcopy_i pour le copier dans une autre table. Tous ces opérateurs sont conçus pour être utilisés avec d'autres opcodes qui opèrent sur des signaux vectoriels tels que vcella, adsynt, adsynt2, etc. Ils peuvent aussi être utiles en conjonction avec les opcodes spectraux pvsftw et pvsftr.

| Note
Prière de noter que l'argument elements a changé dans la version 5.03 du taux-i au taux-k. Cela change le comportement de l'opcode dans le cas inhabituel où la variable de taux-i ielements est modifiée à l'intérieur de l'instrument, par exemple dans :
        instr 1
    ielements  =        10
               vadd     1, 1, ielements
    ielements  =        20
               vadd     2, 1, ielements
               turnoff
        endin

## Exemples

Voici un exemple de l'opcode vpow. Il utilise le fichier vpow.csd.

Example 1016. Exemples de l'opcode vpow.

Voir les sections Audio en Temps Réel et Options de la Ligne de Commande pour plus d'information sur l'utilisation des options de la ligne de commande.

    <CsoundSynthesizer>
    <CsOptions>
    ; Select audio/midi flags here according to platform
    ; Audio out   Audio in
    -odac           -iadc     ;;;RT audio I/O
    ; For Non-realtime ouput leave only the line below:
    ; -o cigoto.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>

    sr=44100
    ksmps=128
    nchnls=2

    	instr 1
    ifn1 = p4
    ival = p5
    ielements = p6
    idstoffset = p7
    kval init 25
    vpow ifn1, ival, ielements, idstoffset, 1
    	endin

    	instr 2	;Printtable
    itable = p4
    isize = ftlen(itable)
    kcount init 0
    kval table kcount, itable
    printk2 kval

    if (kcount == isize) then
      turnoff
    endif

    kcount = kcount + 1
    	endin

    </CsInstruments>
    <CsScore>

    f 1 0 16 -7 1 16 17

    i2	0.0	0.2	1
    i1	0.4	0.01	1	2	3	4
    i2	0.8	0.2	1
    i1	1.0	0.01	1	0.5	5	-3
    i2	1.2	0.2	1
    i1	1.4	0.01	1	1.5	10	12
    i2	1.6	0.2	1
    e

    </CsScore>
    </CsoundSynthesizer>

Voici un autre exemple de l'opcode vpow. Il utilise le fichier vpow-2.csd.

Example 1017.

    <CsoundSynthesizer>
    <CsOptions>
    ; Select audio/midi flags here according to platform
    -odac  ;;;realtime audio out
    ;-iadc    ;;;uncomment -iadc if realtime audio input is needed too
    ; For Non-realtime ouput leave only the line below:
    ; -o vpow-2.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>

    sr = 44100
    ksmps = 32
    nchnls = 2
    0dbfs  = 1

    instr 1

    ain   diskin2 "fox.wav", 1				;soundfile
    fsrc  pvsanal ain, 1024, 256, 1024, 1
    ifn   ftgen   0, 0, 1024/2, 2, 0			;create empty function table for the 513 bins
    kflag pvsftw fsrc,ifn					;export only amplitudes to table
    kval  line .001, p3, 1					;start with big distortion, cahnge over note duration to clean sound
    kbin  line p4, p3, p5					;vary the bins
    vpow  ifn, kval, kbin, 0				;note that this operation is applied each k-cycle!
    ;vpow ifn, kval, kbin, 10				;if you set kdstoffset to 10 it will affect bins 10+(kbin line p4, p3, p5)
          pvsftr  fsrc,ifn					;read modified data back to fsrc
    aout  pvsynth fsrc					;and resynth
          outs aout*p6, aout*p6				;adjust volume to compensate

    endin
    </CsInstruments>
    <CsScore>

    i 1 0 4 100 100 .02	;first 100 bins are affected
    i 1 + 4 10  10  .1	;first 10 bins
    i 1 + 4 1 400	.05	;sweep from bin 1 to 400
    e
    </CsScore>
    </CsoundSynthesizer>

## Voir aussi

vadd_i, vmult, vpow et vexp.

## Crédits

Ecrit par Gabriel Maldonado. Arguments facultatifs ajoutés par Andrés Cabrera et Istvan Varga.

Nouveau dans Csound 5 (Auparavant seulement disponible dans CsoundAV)

Prev | Up | Next
vport | Home | vpow_i