jit.gl.multiple

Uses matrices to draw multiple instances of a jit.gl object efficiently

Description

The jit.gl.multiple object uses serveral jit.matrix objects to repeatedly draw an instance of a jit.gl object like jit.gl.mesh or jit.gl.gridshape. It attaches to a named instance of a jit.gl (OB3D) object provided by the name attribute. Parameters that can be set include position, rotation, rotatexyz, scale, color, tex_plane_s, tex_plane_t, and texture. All of these parameters take float32 matrices except texture which takes a char specifying the texture from a list. Parameter matrices can be of differing dim sizes, and will wrap to the dimensions of the matrix specified by the dimparam attribute.

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

Messages

color_matrix matrix name [symbol]
Specifies a named matrix to use for the color parameter if it's in the glparams list. Must be a 4-plane float32 matrix in RGBA format.
position_matrix matrix name [symbol]
Specifies a named matrix to use for the position parameter if it's in the glparams list. Must be a 3-plane float32 matrix.
rotate_matrix matrix name [symbol]
Specifies a named matrix to use for the rotate (angle-axis) parameter if it's in the glparams list. Must be a 4-plane float32 matrix.
rotatexyz_matrix matrix name [symbol]
Specifies a named matrix to use for the rotatexyz parameter if it's in the glparams list. Must be a 3-plane float32 matrix.
scale_matrix matrix name [symbol]
Specifies a named matrix to use for the scale parameter if it's in the glparams list. Must be a 3-plane float32 matrix.
tex_plane_s_matrix Specifies a named matrix to use for the tex_plane_s parameter if it's in the glparams list. Must be a 4-plane float32 matrix. The tex_map attribute of the target gl object must be set to 1 or 3.
tex_plane_t_matrix Specifies a named matrix to use for the tex_plane_t parameter if it's in the glparams list. Must be a 4-plane float32 matrix. The tex_map attribute of the target gl object must be set to 1 or 3.
texture_matrix matrix name [symbol]
Specifies a named matrix to use for the texture parameter if it's in the glparams list. Must be a char matrix.

Attributes

Name Type g/s Description
dimparam symbol The name of the input parameter to wrap all other input matrices to.
glparams symbol The list of OB3D attributes corresponding to object inlets that are modifiable by passing in a matrix. Valid attributes are position, rotate (angle-axis), rotatexyz, scale, color, and texture.
targetmode int Flag for draw mode. 1 = draw_raw, 0 = draw.
targetname symbol The name of the jit.gl object to attach to and draw multiple times.
texture symbol The list of textures that could potentially be bound to the OB3D object. The specific texture can be specified by passing in a char matrix where the values of the matrix index into the texture list.

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.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.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