Use drawing commands with OpenGL Records and draws based on 3-D drawing commands. These commands range from simple turtle graphics to the majority of the OpenGL API. Cycling '74 Jitter Jitter OpenGL messages to this 3d object TEXT_HERE TEXT_HERE matrix output if enabled TEXT_HERE dumpout TEXT_HERE Process drawing commands The jit.gl.sketch object accepts a list of drawing commands. Draw a circle Draws a circle with radius specified by radius and center point at the current drawing position. If theta-start and theta-end are specified, then an arc will be drawn instead of a full circle. The theta-start and theta-end arguments are in terms of degrees (0-360). The current shapeorient and shapeslice values will also affect the drawing. Delete commands from the command list Deletes index or all instances of the command specified by the command argument from the command list. Enable/disable a command Enables/disables command in the command list. Insert a command into the command list Inserts command at position index in the command list. Replace a command in the command list Replaces position index in the command list with command. Alter the drawmatrix command The word dimorient followed by a zero or one, affects the drawmatrix command. The default is 0. Draw a matrix Draws a matrix. The format of the message is
drawmatrix <matrixname> <drawing primitive> <texflag> <normalflag> <colorflag>
texflag values are specified as follows: 0=use, 1=ignore, 2=auto
normalflag values are specified as follows: 0=use, 1=ignore, 2=auto
colorflag values are specified as follows: 0=use, 1=ignore
edgeflag values are specified as follows: 0=use, 1=ignore Draw an object The word drawobject, followed by a symbol that specifies an object name and a 0/1 flag that specifies whether or not to ignore the OB3D attributes, draws a named jit.gl object. Draw a box Draws a box with width 2* scale-x, height 2* scale-y, depth 2* scale-z, and center point at the current drawing position. If scale-y and scale-z are not specified, they will assume the same value as scale-x. The current shapeorient, shapeslice, and shapeprim values will also affect the drawing. Draw a cylinder Draws a cylinder with top radius specified by radius1, bottom radius specified by radius2, length specified by mag, and center point at the current drawing position. If theta-start and theta-end are specified, then a patch will be drawn instead of a full cylinder. The theta-start and theta-end arguments are in terms of degrees (0-360). The current shapeorient, shapeslice, and shapeprim values will also affect the drawing. Begin stroke definition Begin definition of a stroked path of the style specified by a following stroke_style argument. Currently supported stroke styles are "
basic2d
line Draw a circle or arc frame Draws the circumference of the circle with radius specified by radius and center point at the current drawing position. If theta-start and theta-end are specified, then an arc will be drawn instead of a full circle. The theta-start and theta-end arguments are in terms of degrees (0-360). The current shapeorient and shapeslice values will also affect the drawing. Draw an ellipse frame Draws the circumference of the ellipse specified by radius1, radius2 and center point at the current drawing position. If theta-start and theta-end are specified, then an arc will be drawn instead of a full ellipse. The theta-start and theta-end arguments are in terms of degrees (0-360). The current shapeorient and shapeslice values will also affect the drawing. Draw a quadrilateral frame Draws the frame of the quadrilateral specified by the four points x1 y1 z1 x2 y2 z2 x3 y3 z3 x4 y4 z4. Draw a triangle frame Draws the frame of the triangle specified by the three points x1 y1 z1 x2 y2 z2 x3 y3 z3. Draw an ellipse Draws the ellipse specified by radius1, radius2 and center point at the current drawing position. If theta-start and theta-end are specified, then an arc will be drawn instead of a full ellipse. The theta-start and theta-end arguments are in terms of degrees (0-360). The current shapeorient and shapeslice values will also affect the drawing. End a stroked path definition Ends the definition of a stroked path and renders the path. Report the camera location Returns the x, y, and z coordinates of the camera location. Get a command list item Sends the command list item at index as a message out the object's right outlet. Report the command list Sends the command list as a series of messages out the object's right outlet. The command list is bracketed by max messages that indicate the beginning and the of the current command list, and the command list is output between these two lines, one line per command. The output takes the form:
cmdlist_begin index
cmdlist index command-name command-arg1... command-argN
cmdlist index....
cmdlist_end OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. Begin a drawing command list Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. Clear the drawing area Please see the OpenGL "Red Book" or "Blue Book" for more information. Set the color for clearing Please see the OpenGL "Red Book" or "Blue Book" for more information. Set the clearing color depth Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. Set the current drawing color Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. Complete the drawing command list Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more info. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. Draw a matrix using the tessellator Draws a matrix using the tessellator as a set of vertices and colors. Dim 0 represents a single vertex/color. Dim 1 represents a single contour. Dim 2 represents a single polygon. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. OpenGL function Please see the OpenGL "Red Book" or "Blue Book" for more information. Move to a relative position Moves the drawing position delta-x delta-y delta-z relative to the current drawing position. Move to an absolute position Moves the drawing position to the location specified by x y z. Draw a line relative to the current position Draws a line from the current drawing position to the location delta-x delta-y delta-z relative to the current drawing position. Draw a line from the current position Draws a line from the current drawing position to the location specified by x y z. Draw a line segment Draws a line from the location specified by x1 y1 z1 to the location specified by x2 y2 z2. Draw a plane Draws a plane with top width 2* scale-x1, left height 2* scale-y1, bottom width 2* scale-x2, right height 2* scale-y2, and center point at the current drawing position. If scale-y1 is not specified, it will assume the same value as scale-x1. If scale-x2 and scale-y2 are not specified, they will assume the same values as scale-x1 and scale-y1 respectively. The current shapeorient, shapeslice, and shapeprim values will also affect the drawing. Draw a point Draws a point at the location specified by x y z. Delete command list elements Delete all elements of the command list. Draw a quadrilateral Draws the quadrilateral specified by the four points x1 y1 z1 x2 y2 z2 x3 y3 z3 x4 y4 z4. Draw a triangle Draws the triangle specified by the three points x1 y1 z1 x2 y2 z2 x3 y3 z3. Convert screen coordinates to world coordinates The word screentoworld, followed by a pair of numbers that specify x and y coordinates, returns an array containing the x, y, and z world coordinates associated with a given screen pixel using the same the depth from the camera as 0,0,0. Optionally a third depth arg may be specified, which may be useful for hit detection and other applications. The depth value is typically specified in the range 0.-1. where 0 is the near clipping plane, and 1. is the far clipping plane. Set a shape orientation Sets the current orientation for shape drawing commands (circle, framecircle, ellipse, frameellipse, sphere, cylinder, torus, cube, and plane). The rot-x, rot-y, and rot-z arguments are in terms of degrees (0-360). The order in which the orientation is applied is first rotate about x axis rot-x, then rotate about y axis rot-y, and finally rotate about z axis rot-z. Set a drawing primitive Sets the current drawing primitive for shape drawing commands (circle, framecircle, ellipse, frameellipse, sphere, cylinder, torus, cube, and plane). Valid values for draw-prim are:
lines
line_loop
line_strip
points
polygon
quads
quad_grid
quad_strip
triangles
tri_grid
tri_fan
tri_strip
Set the decimation level Sets the current level of decimation (resolution) for shape drawing commands (circle, framecircle, ellipse, frameellipse, sphere, cylinder, torus, cube, and plane). Draw a sphere Draws a sphere with radius specified by radius and center point at the current drawing position. If theta1-start, theta1-end, theta2-start, and theta2-end are specified, then a patch will be drawn instead of a full sphere. The theta1-start, theta1-end, theta2-start, and theta2-end arguments are in terms of degrees (0-360). The current shapeorient, shapeslice, and shapeprim values will also affect the drawing. Draw a rounded plane The message roundedplane round_amount scale_x scale_y draws a rounded plane with width 2 * scale_x, and height 2 * scale_y and center point at the current drawing position. The size of the rounded portion of the plane is determined by the round_amount argument. If scale_y is not specified, it will assume the same value as scale_x. Draw a torus Draws a torus with major radius specified by radius1, minor radius specified by radius1, and center point at the current drawing position. If theta1-start, theta1-end, theta2-start, and theta2-end are specified, then a patch will be drawn instead of a full torus. The theta1-start, theta1-end, theta2-start, and theta2-end arguments are in terms of degrees (0-360). The current shapeorient, shapeslice, and shapeprim values will also affect the drawing. Set a stroked path parameter The word strokeparam, followed by a parameter name argument and a list of parameter values, sets the current value of the parameter specified by the parameter_name argument to be the value specified by parameter_value argument(s). Some parameters are global for the extent of a stroked path definition, while others may vary on a point by point basis. Define a stroked path anchor point The word strokepoint, followed by three numbers that specify x, y, z coordinates, defines an anchor point at the location specified by those coordinates. Some stroke styles (such as basic2d) will ignore the z coordinate. Convert world coordinates to screen coordinates The word worldtoscreen, followed by three numbers that specify x, y, z coordinates, returns an array containing the x, y, and depth screen coordinates associated with a given world coordinate. The depth value is typically specified in the range 0.-1. where 0 is the near clipping plane, and 1. is the far clipping plane. Automatically generate normals Automatically generate normals for tri and quad primitives (default = 0) Cache in a displaylist Cache in a displaylist (default = 0) Immediate mode Toggles immediate mode. When immediate mode is enabled, a message will be executed when it is submitted rather than on draw. Push all attributes on draw Toggles pushing all attributes on draw. The jit.gl.sketch 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.