The Jitter Matrix! The jit.matrix object is a named matrix which may be used for data storage and retrieval, resampling, and matrix type and planecount conversion operations. Cycling '74 Jitter Jitter Data in TEXT_HERE in TEXT_HERE out TEXT_HERE dumpout TEXT_HERE Output the currently stored matrix Outputs the currently stored matrix. Set all cells to a value and output the result Sets all cells to the value specified by value(s) and output the data. Position is specified of a list whose length is equal to the number of dimensions (dimcount). Set all cells to a value and output the result Sets all cells to the value specified by value(s) and output the data. Value is specified as a list whose length is equal to the number of dimensions (dimcount). Set all cells to a value and output the result Sets all cells to the value specified by value(s) and output the data. Position is specified of a list whose length is equal to the number of dimensions (dimcount). Set all matrix values to zero Sets all matrix values to zero. Export the current frame as an image file Export the current frame as an image file with the name specified by the first argument. The second argument sets the file type (default = png). Available file types are png, tiff, and jpeg.
You can use the Max Preferences to specify a default image resolution for png image types. Export a matrix as a QuickTime movie Exports a matrix as a QuickTime movie. The exportmovie message takes an optional argument to specify a file name. If no filename is specified, a file dialog will open to let you choose a file.
See the jit.record object for information on the write arguments and their default values. Evaluate an expression to fill the matrix Evaluates expression to fill the matrix. If a plane argument is provided, the expression is applied to a single plane. Otherwise, it is applied to all planes in the matrix. See jit.expr for more information on expressions. Unlike the jit.expr object, there is no support for providing multiple expressions to fill multiple planes at once with different expressions. Call this method multiple times once for each plane you wish to fill. Report cell values Sends the value(s) in the cell specified by position out the right outlet of the object as a list in the form cell cell-position0... cell-positionN val plane0-value... planeN-value. Fill a plane with a specified value The word fillplane, followed by an integer that specifies a plane number and a value, will fill the specified plane with the single value. Import a QuickTime movie into the matrix Imports a QuickTime movie into the matrix. If no filename is specified, a file dialog will open to let you choose a file. The time-offset argument may be used to set a time offset for the QuickTime movie being imported (the default is 0). Copy a texture to the matrix Copies the texture specified by texture-name to the matrix. Perform jit.op operations on the matrix The word op, followed by the name of a jit.op object operator and a set of values, is equivalent to including a jit.op object with the specified operator set as an attribute and this jit.matrix object specified as the output matrix. The additional value arguments may either be a matrix name or a constant. If only one value argument is provided, this matrix is considered both the output and the left operand. For example, "op + foo bar" is equivalent to the operation thismatrix = foo + bar, and "op * 0.5" is equivalent to the operation thismatrix = thismatrix * 0.5. Read Jitter binary data files (.jxf) Reads Jitter binary data files (.jxf) into a matrix set. If no filename is specified, a file dialog will open to let you choose a file. Set all cells to a value Sets all cells to the value specified by value(s). Position is specified of a list whose length is equal to the number of dimensions (dimcount). Set a cell to a specified value Sets the cell specified by position to the value specified by value. Position is specified of a list whose length is equal to the number of dimensions (dimcount). The optional arguments plane plane-number can be used to specify a plane. If a plane is specified, value should be a single number, otherwise it should be a list of numbers of size planecount - 1. Set a 1-dimensional cell to a specified value The word setcell1d, followed by a number specifying an x coordinate and a list of values, is similar to the setcell message but without the need to use a "val" token to separate the coordinates from the value since the dimension count (1) is fixed. Set a 2-dimensional cell to specified values The word setcell2d, followed by a pair of numbers specifying x and y coordinates and a list of values, is similar to the setcell message but without the need to use a "val" token to separate the coordinates from the value since the dimension count (2) is fixed. Set a 3-dimensional cell to specified values The word setcell3d, followed by three numbers specifying x, y, and z coordinates and a list of values, is similar to the setcell message but without the need to use a "val" token to separate the coordinates from the value since the dimension count (3) is fixed. Set a cell in a plane to a value (1d, no val token) The word setplane1d, followed by a number specifying an x coordinate, a number specifying a plane, and a value, is similar to the setcell message but without the need to use a "val" token to separate the coordinates from the value since the dimension count (1) is fixed, or use the "plane" token to specify which plane to set. Set a cell in a plane to a value (2d, no val token) The word setplane2d, followed by a pair of numbers specifying x and y coordinates, a number specifying a plane, and a value, is similar to the setcell message but without the need to use a "val" token to separate the coordinates from the value since the dimension count (2) is fixed, or use the "plane" token to specify which plane to set. Set a cell in a plane to a value (3d, no val token) The word setplane3d, followed by three numbers specifying x, y, and z coordinates, a number specifying a plane, and a value, is similar to the setcell message but without the need to use a "val" token to separate the coordinates from the value since the dimension count (1) is fixed, or use the "plane" token to specify which plane to set. Set all cells to a value and output the result Sets all cells to the value specified by value(s). Position is specified of a list whose length is equal to the number of dimensions (dimcount) and outputs the data. Write matrix set as a Jitter binary data file (.jxf) Writes matrix set as a Jitter binary data file (.jxf). If no filename is specified, a file dialog will open to let you choose a file. Matrix adaptation flag Matrix adaptation flag (default = 0 if matrix arguments are present, otherwise 1) When the flag is set, the jit.matrix object will adapt to the incoming matrix planecount, type, and dimensions. Dimensions of matrix data The dimensions of matrix data (default = 1 1) Byte stride per dimension The byte stride per dimension The destination dimension end position The destination dimension end position (default = all dim values minus 1) Destination dimension start position The destination dimension start position (default = all 0) Matrix interpolation flag Matrix interpolation flag (default = 0) When the flag is set, the input matrix will be interpolated when copied to the internal matrix. Name of the matrix The name of the matrix (default = UID) Number of planes in matrix data The number of planes in matrix data (default = 4) Plane mapping Maps input places to output planes (default = 0 1 2 3 ...) Thru mode flag Thru mode flag (default = 1) When the flag is set, a matrix is output when another one is received. Total byte size of matrix Total byte size of matrix The source dimension end position The source dimension end position (default = all dim values minus 1) Source dimension start position The source dimension start position (default = all 0) Destdim use flag Destdim use flag (default = 0) When the flag is set, the destination dimension's attributes are used when copying an input matrix to an internal matrix. Srcdim use flag Srcdim use flag (default = 0) When the flag is set, the source dimension's attributes are used when copying an input matrix to an internal matrix. Matrix data type The matrix data type (default = char) Char data Char data (0-255) Long data Long data 32-bit floating-point data 32-bit floating-point data 64-bit floating-point data 64-bit floating-point data Jitter Tutorial 16: Using Named Jitter Matrices Jitter Tutorial 18: Iterative Processes and Matrix Re-Sampling Jitter Tutorial 20: Importing and Exporting Single Matrices Jitter Tutorial 31: Rendering Destinations Jitter Tutorial 39: Spatial Mapping