makecsd

makecsd — Creates a CSD file from the specified input files.

Description

Creates a CSD file from the specified input files. The first input file that has a .orc extension (case is not significant) is put to the <CsInstruments> section, and the first input file that has a .sco extension becomes <CsScore>. Any remaining files are Base64 encoded and added as <CsFileB> tags. An empty <CsOptions> section is always added.

Some text filtering is performed on the orchestra and score file:

  • newlines are converted to the native format of the system on which makecsd is being run.

  • blank lines are removed from the beginning and end of files.

  • any trailing whitespace is removed from the end of lines.

  • optionally, tabs can be expanded to spaces with an user specified tabstop size.

  • optionally, a MIDI file can be included.

  • optionally, a Licence can be specified as either a file or a common one.

  • if required a score processor can be specified for the <CsScore> section.

Syntax

makecsd [OPTIONS ... ] infile1 [ infile2 [ ... ]]

Initialization

Flags:

  • - t n = expand tabs to spaces using tabstop size n (default: disabled). This applies only to the orchestra and score file.

  • - w n = set Base64 line width to n (default: 72). Note: the orchestra and score are not wrapped.

  • - o fname = output file name (default: stdout)

  • - m fname = specify a MIDI file to include (default: none)

  • - b progname = specify the program to process the score (default: none)

  • - L fname = file name containing the licence text (default: none)

  • - l integer = specify a standard licence (default: none). The ones available are:

    • 0: All rights reserved
    • 1: CC BY-NC-ND
    • 2: CC BY-NC-SA
    • 3: CC BY-NC
    • 4: CC BY-ND
    • 5: CC BY-SA
    • 6: CC BY
    • 7: Licenced under BSD

Examples

    makecsd -t 6 -w 78 -o file.csd file.mid file.orc file.sco sample.aif

This creates a CSD from file.orc and file.sco (tabs are expanded to spaces assuming a tabstop size of 6 characters), and file.mid and sample.aif are added as <CsFileB> tags containing Base64 encoded data with a line width of 78 characters. The output file is file.csd.

Credits

Author: Istvan Varga

Jan 2003

Author: John ffitch

Feb 2011

Options for MIDI, score processing and licence new in version 5.14