Scripts

Extension of the Score Language: bin=“…”

The score can be first interpretted by a binary (application), which produces a usual csound score as a result. This is done by the attribute bin="..." in the <CsScore> tag.

• If just a binary is specified, this binary is called and two files are passed to it:
  1. A copy of the user written score. This file has the suffix .ext
  2. An empty file which will be read after the interpretation by Csound. This file has the usual score suffix .sco
• If a binary and a script is specified, the binary calls the script and passes the two files to the script.

With Python installed, the following example will print the arguments (= file names).

<CsoundSynthesizer>
<CsInstruments>
instr 1
endin
</CsInstruments>
<CsScore bin="python3">
from sys import argv
print("File to read = '%s'" % argv[0])
print("File to write = '%s'" % argv[1])
</CsScore>
</CsoundSynthesizer>

The console output should include something like this:

File to read = '/tmp/csound-idWDwO.ext'
File to write = '/tmp/csound-EdvgYC.sco'

And there should be a complaint because the empty .sco file has not been written:

cannot open scorefile /tmp/csound-EdvgYC.sco

As a very basic example for a binary and a script, first save this file as test.py:

from sys import argv
print("Script = '%s'" % argv[0])
print("File to read = '%s'" % argv[1])
print("File to write = '%s'" % argv[2])
with open(argv[2], 'w') as out:
    out.write('i 1 0 1')

Then run this Csound file from the same directory:

<CsoundSynthesizer>
<CsInstruments>
instr 1
  outall(poscil(.2,expon(1500,p3,400)))
endin
</CsInstruments>
<CsScore bin="python3 test.py">
</CsScore>
</CsoundSynthesizer>

CsBeats

As an alternative to the classical Csound score, CsBeats is included with Csound. This is a domain specific language tailored to the concepts of beats, rhythm and standard western notation. To use Csbeat, specify “csbeats” as the CsScore bin option in a Csound unified score file.

<CsScore bin="csbeats">