GL Group Attributes and messages common to the GL group

Attributes:
Name Type Description
antialias int Antialiasing flag (default = 0) On some hardware, the blend_enable attribute must also be enabled for antialiasing to work.
automatic int Automatic rendering flag (default = 1) When the flag is set, rendering occurs when the associated jit.gl.render object receives a bang message
auto_material int Automatic material attributes flag (default = 1) When the flag is set, and lighting is enabled for the object, the diffuse and ambient material components for the object will be set to the object’s color, and the specular and emissive lighting components are disabled.
aux_color float list[4] The auxiliary color in the form red green blue alpha (default = 0. 0. 0. 0.) The list elements should be in the range 0.-1.
axes int x/y/z axis rendering off/on (default = 0)
blend_enable int Blending flag (default = 0) When the flag is set, blending is enabled for all rendered objects.
blend_mode int list[2] The source and destination planes associated with the blend mode (default = 6 7) Blend modes are specified in the form src_blend_mode dst_blend_mode. The supported modes are:
0 = zero
1 = one
2 = destination color
3 = source color
4 = one minus destination color
5 = one minus source color
6 = source alpha
7 = one minus source alpha
8 = destination alpha
9 = one minus destination alpha
10 = source alpha saturate
color float list[4] The draw color in the form red green blue alpha (default = 1. 1. 1. 1.) The list elements should be in the range 0.-1.
cull_face int Face culling mode (default = 0 (no culling))
0 = no culling
1 = cull front faces
2 = cull back faces
depth_enable int Depth buffering flag (default = 1) When the flag is set, depth buffering is enabled.
dest_dim int list[2] Destination dimensions width height (default = jit.gl.render destination dimensions)
drawto symbol The named drawing context in which to draw (default = none) 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.
enable int Enable flag (default = 1) When the flag is set, drawing is enabled.
fog_params float list[7] The fog parameters in the form red green blue alpha density start end (default = 0. 0. 0. 0. 0. 0. 0.) The list elements should be in the range 0.-1.
fog float The amount of fog effect (default = 0.)
inherit_all int Inherit all flag (default = 0) When the flag is set, all GL attributes from named drawing context are inherited.
inherit_color int Inherit color flag (default = 0) When the flag is set, all color attributes from the named drawing context are inherited.
inherit_depth int Inherit depth buffer flag (default = 0) When the flag is set, all depth buffer attributes from the named drawing context are inherited.
inherit_fog int Inherit fog attributes flag (default = 0) When the flag is set, all fog attributes from the named drawing context are inherited.
inherit_material int Inherit material attributes flag (default = 0) When the flag is set, all material attributes from the named drawing context are inherited.
inherit_poly int Inherit polygon attributes flag (default = 0) When the flag is set, all polygon attributes from the named drawing context are inherited.
inherit_texture int Inherit texture attributes flag (default = 0) When the flag is set, all texture attributes from the named drawing context are inherited.
inherit_transform int Inherit transform attributes flag (default = 0) When the flag is set, all transform attributes from the named drawing context are inherited.
lighting_enable int Inherit lighting attributes flag (default = 0) When the flag is set, all lighting attributes from the named drawing context are inherited.
line_width float The drawing line width (default = 1.)
mat_ambient float list[4] The ambient light material property in the form red green blue alpha (default = 0. 0. 0. 0.) The list elements should be in the range 0.-1.
mat_diffuse float list[4] The diffuse light material property in the form red green blue alpha (default = 0. 0. 0. 0.) The list elements should be in the range 0.-1.
mat_emission float list[4] The material emission property in the form red green blue alpha (default = 0. 0. 0. 0.) The list elements should be in the range 0.-1.
mat_specular float list[4] The specular light material property in the form red green blue alpha (default = 0. 0. 0. 0.) The list elements should be in the range 0.-1.
matrixoutput int Matrix output mode (default = 0)
0 = issue render commands
1 = output geometry matrices
name symbol The instance name (default = UID)
ortho int Orthographic projection mode (default = 0)
0 = orthographic projection off (perspective projection)
1 = orthographic projection on, using lens angle
2 = orthographic projection on, ignoring lens angle
point_size float The draw point size (default = 1.)
poly_mode int list[2] Polygon rendering modes (default 0 0) Rendering modes are expressed in the form frontface backface. Supported rendering modes are:
0 = render as filled polygons
1 = render as lines
2 = render as points
position float list[3] The 3D origin in the form x y z (default = 0. 0. 0.)
rotate float list[4] The angle of rotation and the three axes about which the rotation is performed in the form rotation-angle x y z (default = 0. 0. 1. 0.)
scale float list[3] The 3D scaling factor in the form x y z (default = 1. 1. 1.)
shininess float The material shininess value (default = 16.0) The value should be a float in the range 0.-255.
smooth_shading int Smooth shading flag (default = 0) When the flag is set, smooth shading is used when rendering.
tex_map int Mode for automatic generation of texture coordinate controls (default = 0)
0 = no coordinates are generated.
1 = OpenGL’s texture generation is used with mode GL_OBJECT_LINEAR. This applies the texture in a fixed orientation relative to the object.
2 = OpenGL’s texture generation is used with mode GL_SPHERE_MAP. This can be used to create a reflection effect.
3 = OpenGL’s texture generation is used with mode GL_EYE_LINEAR. This applies the texture in a fixed orientation relative to OpenGL’s eye coordinates.

Modes 1 and 3 are affected by the value of the tex_plane_s and tex_plane_t attributes listed below.

tex_plane_s float list[4] The texture generation coefficients a b c d that apply to tex_map modes 1 and 3. (default = 1. 0. 0. 0.)

The four coefficients define a plane used to generate the s texture coordinate, which corresponds to the x axis of the texture image. If the tex_map mode is 1, s = ax + by + cz + dw, where x, y, z, and w are the homogeneous coordinates of the vertex.

tex_plane_t float list[4] The texture generation coefficients a b c d, which apply to tex_map modes 1 and 3. (default = 0. 1. 0. 0)

The four coefficients define a plane which is used to generate the t texture coordinate, which corresponds to the y axis of the texture image.

shader symbol The name of the shader to be applied (default = none)
texture symbol list[8] The name of the texture to be applied (default = none). If multiple textures are specified, uses multi-texturing.
viewalign int View aligned transformation flag (default = 0)

Messages:
bang
Equivalent to the draw message.

drawraw
Equivalent to draw with the inherit_all attribute set to 1.

draw
Draws the object in the named drawing destination. If the matrixoutput attribute is supported and set to 1, the geometry matrices are sent out the object’s left outlet.