Evaluate an expression to fill a matrix
Evaluates expressions to fill an output matrix. The expression can contain any operator available from within jit.op, any functor available from within jit.bfg, and many jitter MOPs. A variable number of inputs can be specified with an attribute argument setting the inputs attribute.
Cycling '74
Jitter
Jitter Math
in
TEXT_HERE
in2
TEXT_HERE
out
TEXT_HERE
dumpout
TEXT_HERE
char long float32 float64
Treat data as int cells
Sets all matrix cells corresponding with input to int.
Treat data as float cells
Sets all matrix cells corresponding with input to float.
Treat list as per-plane data
Sets all matrix cells corresponding with input to list, on a per plane basis.
Cache intermediary values
Toggles the cache intermediary values flag. The default is 1 (on). It may be desirable to turn off when using generator operators such as jit.noise in the expression, which should not be cached.
Executable expression
The expression to evaluate. If one expression is specified, it is evaluated for all planes. If multiple expressions are specified, they are evaluated on a plane by plane basis.
For a list of valid operators see jit.op and jit.bfg.
Special variables that may be used are:
cell[0-31] integer coordinate across dim
norm[0-31] normalized coordinate across dim
snorm[0-31] signed normalized coordinate across dim
dim[0-31] matrix size across dim
in[0-31] input matrix, corresponding plane
in[0-31].p[0-31] input matrix, specific plane
matrixname any named matrix, corresponding plane
matrixname.p[0-31] any named matrix, specific plane
Special contants that may be used are:
PI
TWOPI
HALFPI
INVPI 1/PI
DEGTORAD TWOPI/360
RADTODEG 360/TWOPI
E Euler's constant
LN2 natural log of 2
LN10 natural log of 10
LOG2E log base 2 of Euler's constant
LOG10E log base 10 of Euler's constant
SQRT2 square root of 2
SQRT1_2 square root of 1/2
Input count
Input count (default = 2)
Internal precision
Sets the internal precision. The options are:
float32 (the default)
float64
Verbose printing mode
Toggles the printing of expression information to Max Console.
Note: The jit.op operators >p and <p are not recognized by the jit.expr parser. The expressions gtp(x, y) and ltp(x, y) may be used in their place.
Expressions should be specified between double quotes, and different expressions can be evaluated per plane if multiple symbols are used for the expr attribute. There are special variables and constants which can be used within expressions listed below. All expressions are evaluated using floating point arithmetic, so they will be more precise, but often slower for computing char data. For optimal speed with char data, it is recommended to use jit.charmap where possible (perhaps filled with an evaluated expression).