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

## syncphasor

syncphasor — Produit une valeur de phase mobile normalisée avec entrée et sortie de synchronisation.

## Description

Produit une valeur de phase mobile entre zéro et un et une impulsion supplémentaire en sortie ("sync out") chaque fois que sa valeur de phase traverse le zéro ou est remise à zéro. La phase peut être réinitialisée à tout instant par une impulsion sur le paramètre "sync in".

## Syntaxe

    aphase, asyncout syncphasor xcps, asyncin, [, iphs]

## Initialisation

iphs (facultatif) -- phase initiale, exprimée comme une fraction d'une période (0 à 1). Avec une valeur négative, l'initialisation de la phase sera ignorée. La valeur par défaut est zéro.

## Exécution

aphase -- la valeur de phase en sortie ; toujours entre 0 et 1.

asyncout -- la sortie de synchronisation prend la valeur 1.0 durant un échantillon chaque fois que la valeur de phase traverse le zéro ou que l'entrée de synchronisation a une valeur non nulle. Elle vaut zéro aux autres moments.

asyncin -- l'entrée de synchronisation provoque la remise à zéro de la phase chaque fois que asyncin est non nul.

xcps -- fréquence du phaseur en Hertz. Si xcps est négatif, la phase sera décrémentée de 1 à 0 au lieu d'être incrémentée.

Une phase interne est augmentée successivement selon la fréquence de xcps pour produire une valeur de phase mobile, normalisée pour se trouver dans l'intervalle 0 <= phs < 1. Lorsqu'elle est utilisée comme indice dans une table, cette phase (multipliée par la longueur de la table de fonction) permettra de l'utiliser comme un oscillateur.

La phase de syncphasor peut être synchronisée à un autre phaseur (ou à un autre signal) au moyen du paramètre asyncin. Chaque fois que asyncin prend une valeur non nulle, la valeur de aphase est remise à zéro. syncphasor sort aussi son propre signal de "synchro" qui consiste en une impulsion d'un échantillon chaque fois que sa phase traverse le zéro ou est réinitialisée. On peut ainsi facilement mettre en série plusieurs opcodes syncphasor pour créer un effet d'oscillateur "hard sync".

## Exemples

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

Example 892. Exemple de l'opcode syncphasor.

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 abs.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>

    instr 1
        ; Use two syncphasors - one is the "master",
        ; the other the "slave"

        ; master's frequency determines pitch
        imastercps  =           cpspch(p4)
        imaxamp     =           10000

        ; the slave's frequency affects the timbre
        kslavecps   line        imastercps, p3, imastercps * 3

        ; the master "oscillator"
        ; the master has no sync input
        anosync     init        0.0
        am, async   syncphasor  imastercps, anosync

        ; the slave "oscillator"
        aout, as    syncphasor  kslavecps, async

        adeclick    linseg      0.0, 0.05, 1.0, p3 - 0.1, 1.0, 0.05, 0.0

        ; Output the slave's phase value which is a rising
        ; sawtooth wave.  This produces aliasing, but hey, this
        ; this is just an example ;)

                  out         aout * adeclick * imaxamp
    endin

    </CsInstruments>
    <CsScore>

    i1 0 1    7.00
    i1 + 0.5  7.02
    i1 + .    7.05
    i1 + .    7.07
    i1 + .    7.09
    i1 + 2    7.06

    e

    </CsScore>
    </CsoundSynthesizer>

Voici un autre exemple de l'opcode syncphasor. Il utilise le fichier syncphasor-CZresonance.csd.

Example 893. Un autre exemple de l'opcode syncphasor.

    <CsoundSynthesizer>
    <CsOptions>
    ; Select audio/midi flags here according to platform
    ; Audio out   Audio in    No messages
    -odac           -iadc     -d     ;;;RT audio I/O
    ; For Non-realtime ouput leave only the line below:
    ; -o syncphasor-CZresonance.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>
    ; by Anthony Kozar. February 2008
    ; http://www.anthonykozar.net/

    ; Imitation of the Casio CZ-series synthesizer's "Resonance" waveforms
    ; using a synced phasor to read a sinusoid table.  The jumps at the sync
    ; points are smoothed by multiplying with a windowing function controlled
    ; by the master phasor.

    ; Based on information from the Wikipedia article on phase distortion:
    ; http://en.wikipedia.org/wiki/Phase_distortion_synthesis

    ; Sawtooth Resonance waveform. Smoothing function is just the inverted
    ; master phasor.

    ; The Wikipedia article shows an inverted cosine as the stored waveform,
    ; which implies that it must be unipolar for the smoothing to work.
    ; I have substituted a sine wave in the first phrase to keep the output
    ; bipolar.  The second phrase demonstrates the much "rezzier" sound of the
    ; bipolar cosine due to discontinuities.

    instr 1
      ifreq      =           cpspch(p4)
      initReson  =           p5
      itable     =           p6
      imaxamp    =           10000
      anosync    init        0.0

      kslavecps       line        ifreq * initReson, p3, ifreq
      amaster, async  syncphasor  ifreq, anosync		; pair of phasors
      aslave, async2  syncphasor  kslavecps, async		; slave synced to master
      aosc            tablei      aslave, itable, 1		; use slave phasor to read a (co)sine table
      aout            =           aosc * (1.0 - amaster)	; inverted master smoothes jumps
      adeclick        linseg      0.0, 0.05, 1.0, p3 - 0.1, 1.0, 0.05, 0.0

                        out         aout * adeclick * imaxamp
    endin

    ; Triangle or Trapezoidal Resonance waveform. Uses a second table to change
    ; the shape of the smoothing function.  (This is my best guess so far as to
    ; how these worked). The cosine table works fine with the triangular smoothing
    ; but we once again need to use a sine table with the trapezoidal smoothing.

    ; (It might be interesting to be able to vary the "width" of the trapezoid.
    ; This could be done with the pdhalf opcode).

    instr 2
      ifreq      =           cpspch(p4)
      initReson  =           p5
      itable     =           p6
      ismoothtbl =           p7
      imaxamp    =           10000
      anosync    init        0.0

      kslavecps       line        ifreq * initReson, p3, ifreq
      amaster, async  syncphasor  ifreq, anosync		; pair of phasors
      aslave, async2  syncphasor  kslavecps, async		; slave synced to master
      aosc            tablei      aslave, itable, 1		; use slave phasor to read a (co)sine table
      asmooth         tablei      amaster, ismoothtbl, 1	; use master phasor to read smoothing table
      aout            =           aosc * asmooth
      adeclick        linseg      0.0, 0.05, 1.0, p3 - 0.1, 1.0, 0.05, 0.0

      out         aout * adeclick * imaxamp
    endin

    </CsInstruments>
    <CsScore>
    f1 0 16385 10  1
    f3 0 16385  9  1 1 270			; inverted cosine
    f5 0 4097   7  0.0 2048 1.0 2049 0.0	; unipolar triangle
    f6 0 4097   7  1.0 2048 1.0 2049 0.0    ; "trapezoid"

    ; Sawtooth resonance with a sine table
    i1 0 1    7.00  5.0  1
    i. + 0.5  7.02  4.0
    i. + .    7.05  3.0
    i. + .    7.07  2.0
    i. + .    7.09  1.0
    i. + 2    7.06  12.0
    f0 6
    s

    ; Sawtooth resonance with a cosine table
    i1 0 1    7.00  5.0  3
    i. + 0.5  7.02  4.0
    i. + .    7.05  3.0
    i. + .    7.07  2.0
    i. + .    7.09  1.0
    i. + 2    7.06  12.0
    f0 6
    s

    ; Triangle resonance with a cosine table
    i2 0 1    7.00  5.0  3  5
    i. + 0.5  7.02  4.0
    i. + .    7.05  3.0
    i. + .    7.07  2.0
    i. + .    7.09  1.0
    i. + 2    7.06  12.0
    f0 6
    s

    ; Trapezoidal resonance with a sine table
    i2 0 1    7.00  5.0  1  6
    i. + 0.5  7.02  4.0
    i. + .    7.05  3.0
    i. + .    7.07  2.0
    i. + .    7.09  1.0
    i. + 2    7.06  12.0

    e

    </CsScore>
    </CsoundSynthesizer>

## Voir aussi

phasor.

Et les opcodes d'Accès aux Table comme : table, tablei, table3 et tab.

## Crédits

Adapté d'après l'opcode phasor par Anthony Kozar
Janvier 2008

Nouveau dans la version 5.08 de Csound

Prev | Up | Next
syncloop | Home | system