<<<<<<<<<<<<<<<<<

_points(renderer) Rendering _points(renderer)

NAME

_points - rendering primitive for a 3D points

NOTE

This class is actually a placeholder for a specific rendering class, such as phigs_points. Since its interface is identical across architecures, only one man page exists. Thus, throughout this man page you should think of _points as (class)_points where (class) is the name of the renderer of interest (i.e., gl, phigs, starbase, vogle).

DESCRIPTION

The _points class is a geomtric interface to the rendering system. It is used to render a set of points on the display. This class can only be used from within a program. Not all systems support normals on points.

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 numpoints; float *coords; float *colors; float *normals;

numpoints is the number of points in the set. coords is the array of vertex coordinates stored as (x0, y0, z0, x1, y1, z1, ..., xn, yn, zn), where n is the number of points (numpoints). If colors is non-null, it points to an array of RGB triplets - one for each point. The points are then colored with this data. A null value ignores point colors and produces only the geometry.

draw! This message causes the geometry last passed into the object (via build!) to be rendered.

EXAMPLES

See display_points.cls for an example of how to use this class.