linseg
Prev | Orchestra Opcodes and Operators | Next

## linseg

linseg — Trace a series of line segments between specified points.

## Description

Trace a series of line segments between specified points.

## Syntax

    ares linseg ia, idur1, ib [, idur2] [, ic] [...]

    kres linseg ia, idur1, ib [, idur2] [, ic] [...]

## Initialization

ia -- starting value.

ib, ic, etc. -- value after dur1 seconds, etc.

idur1 -- duration in seconds of first segment. A zero or negative value will cause all initialization to be skipped.

idur2, idur3, etc. -- duration in seconds of subsequent segments. A zero or negative value will terminate the initialization process with the preceding point, permitting the last-defined line or curve to be continued indefinitely in performance. The default is zero.

## Performance

These units generate control or audio signals whose values can pass through 2 or more specified points. The sum of dur values may or may not equal the instrument's performance time: a shorter performance will truncate the specified pattern, while a longer one will cause the last value to be repeated until the end of the note.

## Examples

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

Example 497. Example of the linseg 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 linseg.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>

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

    giSine ftgen 0, 0, 2^10, 10, 1

    instr 1

    kcps = cpspch(p4)
    kenv linseg 0, 0.25, 1, 0.75, 0	; together = 1 sec
    asig poscil kenv, kcps, giSine
         outs asig, asig

    endin

    instr 2	; scaling to duration

    kcps = cpspch(p4)
    kenv linseg 0, p3*0.25, 1, p3*0.75, 0
    asig poscil kenv, kcps, giSine
         outs asig, asig

    endin

    instr 3	; with negative value

    kcps = cpspch(p4)
    aenv linseg 0, 0.1, 1, 0.5, -0.9, 0.4, 0
    asig poscil aenv, kcps, giSine
         outs asig, asig

    endin
    </CsInstruments>
    <CsScore>

    i 1 0 1   7.00	; = 1 sec, p3 fits exactly
    i 1 2 2   7.00	; = 2 sec, p3 truncated at 1 sec

    i 2 4 1   7.00	; scales to duration
    i 2 6 2   7.00	; of p3

    i 3 9 2   7.00
    e
    </CsScore>
    </CsoundSynthesizer>

## See Also

expon, expseg, expsegb, expsegr, cosseg, line, linsegr transeg transegb

## Credits

Author: Barry L. Vercoe

Prev | Up | Next
linrand | Home | linsegb