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

zePolygon

Use .new("polygon") to create the object. This is one of the shape objects that the OpenGL display list is implemented. Rendering of the polygon object is compiled into the display list if activated through the render. By default the object is treated as filled GL_POLYGON. Improperly setting the polygon type is the most misuse of the object. Check whether you have set the type correctly when the rendered result is not what you anticipated. The order of calling translate, scale, and rotate function is 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 the transformation 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.

:set(table)

table - a Lua table.

Sets polyogn 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 polygon color to use when no vertex color object is used or the vertex color object contains no data.
cull side Number If side > 0, culls front; if side < 0; culls back; otherwise no cull (default).
clockwise flag Boolean If flag is true, the face of a polyogn is clockwise; otherwise anticlockwise (default).
type triangles String Instructs the polygon that its vertex object contains data of triangles (GL_TRIANGLES).
  trianglefan String Instructs the polygon that its vertex object contains data of triangle fan (GL_TRIANGLE_FAN).
  trinaglestrip String Instructs the polygon that its vertex object contains data of triangle strip(GL_TRIANGLE_STRIP).
  quads String Instructs the polygon that its vertex object contains data of quads (GL_QUADS).
  quadstrip String Instructs the polygon that its vertex object contains data of quad strip (GL_QUAD_STRIP).
  polygon String Instructs the polygon that its vertex object contains data of polygon (GL_POLYGON).
fill flag Number If flag = 0, draws polygon outline; if flag < 0, draws polygon vertex point; otherwise draws filled polygon.
linewidth width Number (>0) Specifies the line with when the polygon is drawn as outline.
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.
texture_coord obj zeTexCoord Sets the texture coordinate object.