DoSphereList(3D)

NAME
DoSphereList - Create a sphere list primitive object

SYNOPSIS
C:
DtObject DoSphereList(colormodel, spherecount,
	locations, radii, colors)
DtColorModel colormodel;
DtInt spherecount;
DtReal locations[ ];
DtReal radii[ ];
DtReal colors[ ];

FORTRAN:
INTEGER*4 DOSPHL(COLMOD, SPHCNT, LOCS,
	RADII, COLORS)
INTEGER*4 COLMOD
INTEGER*4 SPHCNT
REAL*8 LOCS(*)
REAL*8 RADII(*)
REAL*8 COLORS(*)

DESCRIPTION
DoSphereList creates a sphere list primitive object containing any number of spheres.

The parameter colormodel specifies the color model to use if sphere colors are provided. The number of spheres in the sphere list is specified by spherecount.

Each sphere in the sphere list has a location, radius and color associated with it. Locations is an array of x,y,z triples that specify the location of the center of each sphere in the list. Radii is an array of real numbers with each entry representing the radius of a sphere. If NULL is passed for radii, each sphere will have a radius of 1.0. The parameter colors is an array of RGB triples that specify a sphere's color. If NULL is passed for colors, the created sphere list will use whatever the current diffuse color setting is.

ERRORS
DoSphereList will fail if it cannot allocate enough memory to hold the vertex list for all the spheres.

[SEVERE - unable to allocate memory]