Discussion

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.

For transformation attributes (position, rotate, rotatexyz, and scale), the order parameters are listed in the glparams attribute determines the order transformations are applied. The standard jit.gl transformation order is position, rotation, scale.

Arbitrary object attributes and shader parameters can be set by including in the glparams list attr. followed by the attr name, or shader. followed by the shader parameter name. For example, shader.zoom creates a matrix input for the zoom parameter of the td.rota.jxs shader, and attr.rad_minor creates a matrix input for the rad_minor attribute of a jit.gl.gridshape.

This 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. Additionally it can reference the name of a jit.gl.node sub-context. This value may also be set via the OB3D drawto attribute. If no argument is present, the object is implicitly added to the first valid drawing context or sub-context found in the current patch or by searching up the patcher hierarchy.

There is an optional second argument which specifies the number of inlets corresponding to the number of arguments in the glparams attribute. If this second argument is not present, the default number of inlets is two. Those inlets will be for position and scale if the glparams attribute is not specified. If there are glparams, it defaults to the first two specified params.