PreProcessor | SuperCollider 3.13.0 Help

Description

Using start and end delimiters, PreProcessor internally converts parts of code into a function that you can call, passing in an event with parameters, to which you may add the results. It returns the event.

Class Methods

.current

The preprocessor active in the current context.

Instance Methods

.translate

Arguments:

code

event

.value

This method is used in Interpreter and is called before any code is interpreted.

Arguments:

string

.startDelimiter

The signal to start to interpret the string following it as a certain language. By default, this is "<%".

NOTE: If you set the delimiters to a string that is valid part of sclang code, you may not be able to evaluate code anymore, and thus get stuck in an error state. In such a case, you need to recompile the library.

.endDelimiter

The signal to end to interpret the string following it as a certain language. By default, this is "%>".

.verbose

If set to true, the preprocessor prints information to the post window.

Examples

// python preprocessor, given that you have python installed
// thanks to  tasos tsesmetzis
(
this.preProcessor = PreProcessor.new.startDelimiter_("{-").endDelimiter_("-}");

// a simple python call
e = (
    lang: \python,
    languages:
    (
        python: // code is the incoming string, event is the event for parameters and output
        {|code, event|
            var input, pipe, output;
            code = e[\prefix] ++ "print" ++ "(" ++ code ++ ")";
            input = "python -c '%'".format(code);
            pipe = Pipe(input, "r");
            output = pipe.readUpTo;
            pipe.close;
            event.put(\result, output)
        }
    ),
    prefix: "import math;"
);
);

// ok, assuming such a little interpreter exists for a given language,
// one can now use it in code.

// returns 507580213877224798800856812176625227226004528988036003099405939480985600000000000000
(
e = {- math.factorial(61) -}.value(e);
e.result;
)

// sonify the digits of the result
e.calc_result = e.result.as(Array).collect { |x| x.asString.interpret };
Pbind(\note, Pseq(e.calc_result), \dur, 0.1).play;

// reset
this.preProcessor = nil;

helpfile source: HelpSource/Classes/PreProcessor.schelp
link::PreProcessor/Classes/PreProcessor::

PreProcessorExtension

Description

Class Methods

.current

Instance Methods

.translate

Arguments:

.value

Arguments:

.startDelimiter

.endDelimiter

.verbose

Examples

PreProcessor
Extension