XYIN

QUICK-REF - CsoundManual - Top of this section - Previous - Contents - Index - Next

xyin, tempo

kx, ky   xyin    iprd, ixmin, ixmax, iymin, iymax[, ixinit, iyinit] 
         tempo   ktempo, istartempo

DESCRIPTION

Sense the cursor position in an input window. Apply tempo control to an uninterpreted score.

INITIALIZATION

iprd- period of cursor sensing (in seconds). Typically .1 seconds.

xmin, xmax, ymin, ymax - edge values for the x-y coordinates of a cursor in the input window.

ixinit, iyinit (optional) - initial x-y coordinates reported; the default values are 0,0. If these values are not within the given min-max range, they will be coerced into that range.

istartempo - initial tempo (in beats per minute). Typically 60.

PERFORMANCE

xyin samples the cursor x-y position in an input window every iprd seconds. Output values are repeated (not interpolated) at the K-rate, and remain fixed until a new change is registered in the window. There may be any number of input windows. This unit is useful for Realtime control, but continuous motion should be avoided if iprd is unusually small.

tempo allows the performance speed of Csound scored events to be controlled from within an orchestra. It operates only in the presence of the csound -t flag. When that flag is set, scored events will be performed from their uninterpreted p2 and p3 (beat) parameters, initially at the given command-line tempo. When a tempo statement is activated in any instrument (ktempo > 0.), the operating tempo will be adjusted to ktempo beats per minute. There may be any number of tempo statements in an orchestra, but coincident activation is best avoided.

EXAMPLE:

kx,ky    xyin    .05, 30, 0, 120, 0, 75   ; sample the cursor
         tempo   kx, 75     ; and control the tempo of performance

QUICK-REF - CsoundManual - Top of this section - Previous - Contents - Index - Next