<<<<<<<<<<<<<<<<<_lines(renderer) Rendering _lines(renderer)
NAME
_lines - rendering primitive for a set of polylines
NOTE
This class is actually a placeholder for a specific rendering class, such as phigs_lines. Since its interface is
identical across architecures, only one man page exists.
Thus, throughout this man page you should think of _lines
as (class)_lines where (class) is the name of the renderer
of interest (i.e., gl, phigs, starbase, vogle).
DESCRIPTION
The _lines class is a geomtric interface to the rendering
system. It is used to render a set of polylines on the
display. This class can only be used from within a program.
SUPERCLASS
(class)_modeller
MESSAGES
build! args
Send a new copy of the geometry to the rendering
primitive. The next time the object is drawn, this
geometry will be used. These are "hidden" arguments, that is, they can only be sent from within a
program, not from scripts. They are:
int numlines;
int *lengths;
float *coords;
float *colors;
float *normals;
float *textures;
numlines is the number of polylines in the set.
lengths is an array of integers. Each entry contains the number of vertices in the corresponding
polyline. coords is the array of vertex coordinates
stored as (x0, y0, z0, x1, y1, z1, ..., xn, yn,
zn), where n is the sum of the lengths of all the
polylines. If colors is non-null, it points to an
array of RGB triplets - one for each vertex. The
polylines are then colored with this data. A null
value ignores vertex colors and produces only the
geometry. On many systems the normals are ignored.
draw!
This message causes the geometry last passed into
the object (via build!) to be rendered.
EXAMPLES
see display_lines.cls for an example of how to use this
class.
SEE ALSO
renderer, gl, starbase, phigs, vogle, (class)_modeller,
(class)_points, (class)_polygon, (class)_indexed_polygon,
(class)_tmesh, (class)_text, (class)_text_3d,
(class)_text_an
BUGS
Please send comments and suggestions toconsult@rpi.edu