Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 20 - QuickDraw 3D Mathematical Utilities / QuickDraw 3D Mathematical Utilities Reference

QuickDraw 3D Mathematical Utilities / Managing Bounding Spheres

Q3BoundingSphere_SetFromPoints3D

You can use the Q3BoundingSphere_SetFromPoints3D function to find the bounding sphere that bounds an arbitrary list of three-dimensional points.

TQ3BoundingSphere *Q3BoundingSphere_SetFromPoints3D (
TQ3BoundingSphere *bSphere, 
const TQ3Point3D *pts, 
unsigned long nPts, 
unsigned long structSize);

bSphere

A pointer to a bounding sphere.

pts

A pointer to a list of three-dimensional points.

nPts

The number of points in the specified list.

structSize

The number of bytes of data that separate two successive points in the specified list of points.

DESCRIPTION

The Q3BoundingSphere_SetFromPoints3D function returns, as its function result and in the bSphere parameter, a pointer to a bounding sphere that contains all the points in the list of three-dimensional points specified by the pts parameter. The nPts parameter indicates how many points are in that list, and the structSize parameter indicates the offset between any two successive points in the list. By suitably specifying the value of the structSize parameter, you can have QuickDraw 3D extract points that are embedded in an array of larger data structures.