trigger
Prev | Orchestra Opcodes and Operators | Next

## trigger

trigger — Informs when a krate signal crosses a threshold.

## Description

Informs when a krate signal crosses a threshold.

## Syntax

    kout trigger ksig, kthreshold, kmode

## Performance

ksig -- input signal

kthreshold -- trigger threshold

kmode -- can be 0 , 1 or 2

Normally trigger outputs zeroes: only each time ksig crosses kthreshold trigger outputs a 1. There are three modes of using ktrig:

- kmode = 0 - (down-up) ktrig outputs a 1 when current value of ksig is higher than kthreshold, while old value of ksig was equal to or lower than kthreshold.

- kmode = 1 - (up-down) ktrig outputs a 1 when current value of ksig is lower than kthreshold while old value of ksig was equal or higher than kthreshold.

- kmode = 2 - (both) ktrig outputs a 1 in both the two previous cases.

## Examples

Here is an example of the trigger opcode. It uses the file trigger.csd.

Example 1124. Example of the trigger opcode.

See the sections Real-time Audio and Command Line Flags for more information on using command line flags.

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

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

    instr 1

    kmtr lfo 1, 1, 1			;triangle wave
    kmode = p4
    ktr  trigger kmtr, .5, kmode
         printk2  ktr
         schedkwhen ktr, 0, 3, 2, 0, .3

    endin

    instr 2

    aenv linseg 0,p3*.1,1,p3*.3,1,p3*.6,0	;envelope
    a1   poscil .3*aenv, 1000, 1
         outs a1, a1

    endin
    </CsInstruments>
    <CsScore>
    f 1 0 16384 10 1	;sine

    i 1 0 3 0		;down-up
    i 1 4 3 2		;down-up & up=down

    e
    </CsScore>
    </CsoundSynthesizer>

## See also

Sensing and Control: Tempo and Sequencing

## Credits

Author: Gabriel Maldonado
Italy

New in Csound version 3.49

Prev | Up | Next
trigexpseg | Home | trighold