jit.gl.render Reference

Render Jitter OpenGL objects

jit.gl.render

Description

Use jit.gl.render to render Jitter OpenGL objects to a rendering destination. jit.gl.render drives the rendering of 3D graphics, setting up and invoking the drawing of each frame. jit.gl.render can draw to jit.window, jit.pwindow, and jit.matrix.

Examples

Attributes

camera [3 floats]

Camera position

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.

erase_color [4 floats]

The context RBGA erase color (default = 0.2 0.2 0.2 1)

far_clip [float]

Far clipping plane distance

high_res [int]7.0.0

Enable high resolution accelerated drawing on supported high DPI Retina devices (default = 0) (Mac only).

lens_angle [float]

Camera lens angle

light_ambient [4 floats]

Ambient lighting color

light_diffuse [4 floats]

Diffuse lighting color

light_global_ambient [4 floats]

Global ambient lighting color

light_position [4 floats]

Light position

light_specular [4 floats]

Specular lighting color

lookat [3 floats]

Camera lookat position

near_clip [float]

Near clipping plane distance

point_atten [3 floats]

Point attenuation factor for point sprites

point_fade [float]

Point fade threshold for point sprites

rotate_order [symbol]

Set the order rotations are applied for the rotatexyz attribute for all child gl objects (default = auto). E.G. if set to xyz , the object is first rotated around its X axis, then Y, and finally Z. The default of auto implements yzx ordering. To replicate Max 5, use zyx .

Possible values:

'auto'
'xyz'
'xzy'
'yxz'
'yzx'
'zxy'
'zyx'

up [3 floats]

Camera up vector

verbose [int]

Enable printing messages to the Max Console

Common Box Attributes

OB3D Attributes

Messages

depth_clear

Clear depth values from the rendering destination

drawclients

Arguments

layer [int]
Draw all automatic clients

drawswap

Draw all automatic clients and swap buffers

erase

Erase the render destination contents

getscene_dict8.0.0

Arguments

attribute mode [symbol]
Outputs a dictionary of scene elements out the dumpout prepended by the symbol "scene_dict". The optional argument specifies the attribute mode. If no argument is supplied only the spatial transform attributes are included.

If the arg all_attrs is supplied all object attributes are included.
If the arg modified_attrs is supplied any attributes with modified state are included.

screentoworld

Arguments

x [float]
y [float]
z [float]
Converts screen coordinates to world coordinates, output out the dump outlet. The input x and y input coordinates are in pixels, and the input z coordinate is in normalized distance from camera (0.-1.), where 0. is the near clipping plane and 1. is the far clipping plane.

swap

Swap rendering buffers

updateclients

Update the render list

worldtoscreen

Arguments

x [float]
y [float]
z [float]
Converts world coordinates to screen coordinates, output out the dump outlet. The output x and y input coordinates are in pixels, and the output z coordinate is in normalized distance from camera (0.-1.), where 0. is the near clipping plane and 1. is the far clipping plane.

OB3D Messages

See Also

Name Description
Working with OpenGL Working with OpenGL
Video and Graphics Programming Tutorials Video and Graphics Programming Tutorials
Lua in Max Lua in Max
jit.gl.graph
jit.gl.gridshape
jit.gl.handle
jit.gl.isosurf
jit.gl.mesh
jit.gl.model
jit.gl.nurbs
jit.gl.plato
jit.gl.shader
jit.gl.sketch
jit.gl.slab
jit.gl.text2d
jit.gl.text3d
jit.gl.texture
jit.gl.videoplane
jit.gl.volume
Tutorial 30: Drawing 3D text Tutorial 30: Drawing 3D text
Tutorial 31: Rendering Destinations Tutorial 31: Rendering Destinations
Tutorial 32: Camera View Tutorial 32: Camera View
Tutorial 33: Polygon Modes, Colors and Blending Tutorial 33: Polygon Modes, Colors and Blending
Tutorial 34: Using Textures Tutorial 34: Using Textures
Tutorial 35: Lighting and Fog Tutorial 35: Lighting and Fog
Tutorial 37: Geometry Under the Hood Tutorial 37: Geometry Under the Hood
Tutorial 47: Using Jitter Object Callbacks in JavaScript Tutorial 47: Using Jitter Object Callbacks in JavaScript