jit.gl.slab

Performs a GL accelerated grid-based evaluation

Description

The jit.gl.slab object provides a streamlined interface for performing a general purpose GPU based grid evaluation. Multiple jit.matrix or jit.gl.texture objects can be attached to inlets and used in combination with a jit.gl.shader object and a specialized form of view-aligned geometry with a one-to-one pixel mapping to perform an accurate spatial evaluation. The results of this calculation are automatically saved and made available via a jit.gl.texture object referenced from the leftmost outlet. The resulting jit.gl.texture object can then be bound to any OB3D object, sent to a jit.matrix object, or used as an input to another jit.gl.slab object.
The jit.gl.slab 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

(drag) When an shader file is dragged from the Max 5 File Browser to a jit.gl.slab object, the file will be loaded.
dispose Disposes the currently loaded shader, passing the data through using the default multi-texturing behavior.
dump type [symbol]
Dumps the indicated shader data to the max console window. Valid types are params, source, assembly.
getparamdefault name [symbol]
Sends the default data values for the indicated shader parameter for the internal jit.gl.shader object out the right-most outlet.
getparamlist Sends the names of all the internal jit.gl.shader object shader parameters out the right-most outlet.
getparamtype name [symbol]
Sends the name of the datatype for the indicated shader parameter for the internal jit.gl.shader object out the right-most outlet.
getparamval name [symbol]
Sends the data values for the indicated shader parameter for the internal jit.gl.shader object out the right-most outlet.
param Sets the given shader parameter with the given atom values as defined in a JXS (Jitter shader) file.
sendinput message [list]
Sends the input jit.gl.texture object attached to the active inlet the corresponding message. An optional integer as a first argument lets one send the message to a specific input (zero based, left to right).
sendoutput message [list]
Sends the output jit.gl.texture object the corresponding message.
sendshader message [list]
Sends the internal jit.gl.shader object the corresponding message.
read filename [symbol]
Loads the given JXS shader file from disk.

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
depth float The depth or z-offset for the slab geometry. (default = 0.0)
dim int The dimensions of the output jit.gl.texture object when adapt is disabled (default = 720 480)
dimscale float The dimension scaling factors of the output jit.gl.texture object when adapt is enabled (default = 1. 1.). This is useful for upsampling or downsampling shaders (such as uyvy conversion) which can adapt with the following logic:
output.dim[0] = input.dim[0]*dimscale[0];
output.dim[1] = input.dim[1]*dimscale[1];
displaylist int Cache in displaylist flag (default = 0) This feature may be used to speed up rendering time by creating and storing a list of gl drawing commands on the graphics card. This will have no effect if matrixoutput turned on.
edges int Flags to enable or disable rendering each edge (only valid when shape == edges) (default = 1 1 1 1)/
file symbol The shader file to use (default = none)
inputs int Input count (default = 2)
out_name symbol (get) Returns the name of the internal jit.gl.texture object.
rect float The extent or rectangular coordinates bounding the slab geometry (default = 0 0 1 1)/
shape symbol The shape or geometry to render (default = cubes) Supported modes are:
quad
grid
edges
subdiv int The number of subdivisions to use for generating grid based geometry (only valid when shape == grid) (default = 1 1)
texrect float The extent or rectangular coordinates bounding the texture coordinates for the slab geometry (default = 0 0 1 1)/
type symbol The name of the datatype to use. (default = auto) Supported modes are:
auto (adapt to matrix datatype)
char (8bit unsigned byte)
long (32bit integer)
half (16bit float)
float (32bit float)
float16 (16bit float)
float32 (32bit float)
wrap int Flags to enable or disable wrapping along each edge (only valid when shape == edges) (default = 0 0 0 0)

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.render Render Open GL
jit.gl.shader Manages a GL shader
jit.gl.sketch GL parallel to lcd
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
Tutorial 42: Slab: Data Processing on the GPU Tutorial 42: Slab: Data Processing on the GPU