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

points_modeller(modeller) LYMB points_modeller(modeller)

NAME

points_modeller - define an aribtrary group of 3D points

DESCRIPTION

The points_modeller class allows a group of three- dimensional points to be defined and treated as one object. Transformations, and the like, apply to all points in the object.

Points may be either directly created or can be generated randomly. If randomly generated, the points lie in the range -0.5 <= x,y,z <=0.5.

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!).

Points modeller is often used as a source input to the data_probe or data_streamer objects.

SUPERCLASS

new_modeller

INSTANCE VARIABLES

number_random_points The number of random points generated.

random_points Boolean flag indicating whether random points are to be generated. By default value is true.

MESSAGES

number_random_points=, no_random_points= value Set the number of random points to be generated.

number_random_points?, no_random_points? value Get the number of random points to be generated.

(any display_data message) Any message that display data understands can also be sent to points_modeller. Hence it is possible to directly create points with the "points=" message, etc.

EXAMPLES

The following LYMB script defines an instance of points_modeller and sets the vertex value for three points.

points_modeller new: pts_model number_random_points=100 ;

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