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

polyline_modeller(modeller) LYMB polyline_modeller(modeller)

NAME

polyline_modeller - define an aribtrary 3D polyline

DESCRIPTION

The polyline_modeller class allows a three-dimensional polyline to be defined and displayed. A polyine is essentially a single line defined by a set of points; the points are assumed connected in order. The polyline may de defined by specifying a data object (e.g., vector, or any object responding to "values?"), or by directly defining the points.

Because the points_modeller is a subclass of new_modeller, it responds to the "data?" message and can be used in the display_data pipeline. In addition, points_modeller also inherits the convenience routines from new_modeller (e.g., output!).

SUPERCLASS

new_modeller

INSTANCE VARIABLES

(inherited)

MESSAGES

points[=+] values Define the points for the line. Value may either be an array of floats, a pointer to an array of points, or the name of a vector object.

points? Get the pointer to the array of floats defining the line.

point_values? Place a list of floating point values on the argument stack. Values correspond to the x-y-z coordinates of the points in the line.

EXAMPLES

The following LYMB script creates a polyline modeller and creates the defining points.

polyline_modeller new: pl points=(1,2,3, 4,5,6, 7,8,9) ;

actor new: pts1 color=(1,0,0) modeller=pl ;