Skip to content

checkbox

Sense on-screen controls. Requires Winsound or TCL/TK.

Plugin opcode in control.

Syntax

kres = checkbox(knum)

kres checkbox knum

Performance

Note that this opcode is not available on Windows due to the implimentation of pipes on that system.

kres -- value of the checkbox control. If the checkbox is set (pushed) then return 1, if not, return 0.

knum -- the number of the checkbox. If it does not exist, it is made on-screen at initialization.

Examples

Here is a simple example of the checkbox opcode. It uses the file checkbox-modern.csd.

Simple example of the checkbox opcode.
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
<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 checkbox.wav -W ;;; for file output any platform
</CsOptions>
<CsInstruments>

sr = 44100
ksmps = 10
nchnls = 2

instr 1
  kq = init(0)
  ; Get the value from the checkbox.
  k1 = checkbox(1)

  ; If the checkbox is selected then k2=440, otherwise k2=880.
  k2 = (k1 == 0 ? 440 : 880)

  a1 = poscil(10000, k2)
  outs(a1, a1)
  kq = button(1)
  schedkwhen(kq, 0, 1, 2, 0, 0)
endin

instr 2
  exitnow()
endin

</CsInstruments>
<CsScore>

; sine wave.
i 1 0 1000 
e

</CsScore>
</CsoundSynthesizer>

Here is a simple example of the checkbox opcode. It uses the file checkbox.csd.

Simple example of the checkbox opcode.
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
<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 checkbox.wav -W ;;; for file output any platform
</CsOptions>
<CsInstruments>

sr = 44100
ksmps = 10
nchnls = 2

instr 1
  kq init 0
  ; Get the value from the checkbox.
  k1 checkbox 1

  ; If the checkbox is selected then k2=440, otherwise k2=880.
  k2 = (k1 == 0 ? 440 : 880)

  a1 oscil 10000, k2, 1
  outs a1, a1
  kq button 1
  schedkwhen kq, 0, 1, 2, 0, 0
endin

instr 2
  exitnow
endin

</CsInstruments>
<CsScore>

; sine wave.
f 1 0 32768 10 1

i 1 0 1000 
e

</CsScore>
</CsoundSynthesizer>

See also

Sensing and Control: TCL/TK widgets

Credits

Author: John ffitch
University of Bath, Codemist. Ltd.
Bath, UK
September, 2000

Example written by Kevin Conder.

New in Csound version 4.08