1.2

| home | graph lib | utility lib | custom lib | auxiliary lib | tutorials |

   Axis
   Blend
   Color
   ColorBar
   Fog
   Freetype
   Light
   Line
   Material
   Node
   Point
   Plot
   Polygon
   Render
   Scene
   Stencil
   TexCoord
   Text
   Texture
   Vertex

zeLine

Use .new("line") to create the object. It is one of the shape objects that the OpenGL display list is implemented. Rendering of the line object is compiled into the display list if activated by the render. By default the object is treated as GL_LINE_STRIP with line width of one and style of solid. Improperly setting the line type is the most misuse of the object. When the rendered result is not what you anticipated, check the call object:set{type="?"}. The order of callig translate, scale, and rotate functions are important.

:rotatex(angle)
:rotatey(angle)
:rotatez(angle)

angle - rotation angle in degree.

These functions rotate the object around the x-, y- and z-axis, respectively. The order they are called is important.

:reset()

Resets transformations to none.

:scale(xs, ys, zs)

xs, ys, zs - numbers.

Scales the object in x, y, and z direction for the factors of xs, ys, and zs.

:translate(dx, dy, dz)

dx, dy, dz - numbers.

Moves the object dx, dy, and dz away from the current position.

:update()

Forces updating in the rendering of the object. It should be used in such a case as the data of its vertex are changed because the object is aware of the change of its vertex but but vertex contents.

:set(table)

table - a Lua table.

Sets line properties. Valid key-value paris are listed in the table.

Key Value Type Remark
color {r, g, b, a} Numbers (0 to 1) in table Sets the line color to use when no vertex color object is used or the vertex color object contains no data.
type lines String Instructs the line that its vertex object contains data of lines (GL_LINES).
  loop String Instructs the line that its vertex object contains data of line loop (GL_LINE_LOOP).
  strip String Instructs the line that its vertex object contains data of line segments (GL_LINES).
solid width Number(>0) Sets the line style as solid of the specified width
dot {factor, width} Numbers in table Sets the line style as dot of the specified width. The factor determines length to with ratio.
dash {factor, width} Numbers in table Sets the line style as dash of the specified width. The factor determines length to with ratio.
dotdash {factor, width} Numbers in table Set the line style as dotdash of the specified width. The factor determines length to with ratio.
smooth flag Boolean If true, produces smooth (antialias) line. Blending should be used with this option.
enable flag Boolean Enable (default) and disable the object
vertex obj zeVertex Sets the vertex object.
vertex_normal obj zeVertex Sets the vertex normal object.
vertex_color obj zeColor Sets the vertex color object.