A newer version of Max is available. Click here to access the latest version of this document.

jit.gl.imageunit

Render Open GL

Description

The jit.gl.imageunit object loads any Apple Image Unit and permits the processing of incoming matrix and texture data, with resulting texture output, similar to jit.gl.slab.
For more information on Apple Image Units, please see Apple's Core Image developer pages.
The jit.gl.imageunit object requires one argument: the name of a drawing context. A named drawing context is a named instance of a jit.window, jit.pwindow, or jit.matrix object that has an instance of the jit.gl.render object associated with it. This value may also be set via the OB3D drawto attribute.

Information for Jitter 3D Object (OB3D) messages and attributes to this object

Messages

geteffectlist Sends the names of all the available Image Units out the right-most outlet.
getparam name [symbol]
Sends the data values for the indicated shader parameter for the currently loaded Image Unit out the right-most outlet. (synonym for getparamval)
getparamdefault name [symbol]
Sends the default data values for the indicated shader parameter for the currently loaded Image Unit out the right-most outlet.
getparamidentity name [symbol]
Sends the data values to result in no effect for the indicated shader parameter for the currently loaded Image Unit out the right-most outlet.
getparamlist Sends the names of all the currently loaded Image Unit parameters out the right-most outlet.
getparammax name [symbol]
Sends the recommended maximum value for the indicated parameter for the currently loaded Image Unit out the right-most outlet.
getparammin name [symbol]
Sends the recommended minimum value for the indicated parameter for the currently loaded Image Unit out the right-most outlet.
getparamtype name [symbol]
Sends the name of the datatype for the indicated parameter for the currently loaded Image Unit out the right-most outlet.
getparamslidermax name [symbol]
Sends the recommended maximum UI value for the indicated parameter for the currently loaded Image Unit out the right-most outlet.
getparamslidermin name [symbol]
Sends the recommended minimum UI value for the indicated parameter for the currently loaded Image Unit out the right-most outlet.
getparamval name [symbol]
Sends the data values for the indicated shader parameter for the currently loaded Image Unit out the right-most outlet.
loadeffect name [symbol]
Loads the given Image Unit.
param Sets a parameter of the imageunit (e.g., param param_name [list of param values] ).
sendinput message [list]
Sends the input jit.gl.texture object attached to the active inlet the corresponding message.
sendoutput message [list]
Sends the output jit.gl.texture object the corresponding message.
read name [symbol]
Loads the given Image Unit. (synonym for loadeffect)

Attributes

Name Type g/s Description
thru int Thru mode flag (default = 1) When the flag is set, a matrix is output when another one is received.
activeinput int Input number used for jit_matrix method (default = 0) Useful for multiple input Image Units used from Java or JavaScript.
adapt int Enables or disables adapting and resizing to input source dimensions (default = 1).
colormode symbol The colorspace mode to use for each input textures (default = auto). Supported modes are:
auto
luminance
intensity
depth
lumalpha
rgb
argb
uyvy
dim int The dimensions of the output jit.gl.texture object when adapt is disabled (default = 256 256)
dimscale float Sets the scaling of output dims based on the object's leftmost input.
fx symbol Image Unit filter name (default = "Color Matrix") Possible choices are values returned from geteffectlist. Similar to loadeffect method, but can be specified as an attribute argument.
inputs int Input count (default = 2)
out_name symbol (get) Returns the name of the internal jit.gl.texture object.
paramsafe int Parameter limit flag (default = 0) Permits the limiting of parameter values to the range specified by the Image Unit.
verbose int Verbose mode flag (default = 0) In verbose mode, the jit.gl.imageunit object will print out messages useful for debugging.

Information for box attributes common to all objects

Examples

See Also

Name Description
jit.gl.graph Open GL floating-point data visualization
jit.gl.gridshape Generate simple geometric shapes as a connected grid
jit.gl.handle Use mouse movement to control position/rotation
jit.gl.isosurf Generates a GL based surface extraction
jit.gl.mesh Generates GL geometry from existing data
jit.gl.model Read and draw Wavefront .obj models
jit.gl.nurbs Generate NURBS surface
jit.gl.plato Generate platonic solids
jit.gl.shader Manages a GL shader
jit.gl.sketch GL parallel to lcd
jit.gl.slab Performs a GL accelerated grid-based evaluation
jit.gl.text2d Write bitmap text
jit.gl.text3d Write vector text
jit.gl.texture Manages a GL texture
jit.gl.videoplane GL accelerated video plane
jit.gl.volume Creates a GL accelerated volume vizualization