Functions
Show_Camera_By_Volume

Functions

void Show_Camera_By_Volume (char *projection, float *xmin, float *xmax, float *ymin, float *ymax)
 Returns the simple rectangular box in user data space as set in a previous call to Set_Camera_By_Volume(). More...
 
void DShow_Camera_By_Volume (char *projection, double *xmin, double *xmax, double *ymin, double *ymax)
 Similar to Show_Camera_By_Volume(), but operates on double-precision cameras. More...
 
void PShow_Net_Camera_By_Volume (int count, HC_KEY const *keys, char *proj, float *xmin, float *xmax, float *ymin, float *ymax)
 Similar to Show_Camera_By_Volume(), but returns the net effective camera along a discrete segment path. More...
 
void DPShow_Net_Camera_By_Volume (int count, const HC_KEY *keys, char *proj, double *xmin, double *xmax, double *ymin, double *ymax)
 Similar to PShow_Net_Camera_By_Volume(), but operates on double-precision cameras. More...
 

Detailed Description

Function Documentation

void DPShow_Net_Camera_By_Volume ( int  count,
const HC_KEY keys,
char *  proj,
double *  xmin,
double *  xmax,
double *  ymin,
double *  ymax 
)

Similar to PShow_Net_Camera_By_Volume(), but operates on double-precision cameras.

Parameters
count- The size of pathkeys
keys- An array of HC_KEY's delineating a path of segments.
proj- Special constant—either "Perspective", "Orthographic", "Stretched", or an "oblique" form ( see Set_Camera_By_Volume() ). Passed by reference. Returned to user.
xmin- Minimum limit of what will be visible along the X-axis. Passed by reference. Returned to user.
xmax- Maximum limit of what will be visible along the X-axis. Passed by reference. Returned to user.
ymin- Minimum limit of what will be visible along the Y-axis. Passed by reference. Returned to user.
ymax- Maximum limit of what will be visible along the Y-axis. Passed by reference. Returned to user.
Returns
An integer indicating what type of camera was found (see details).
void DShow_Camera_By_Volume ( char *  projection,
double *  xmin,
double *  xmax,
double *  ymin,
double *  ymax 
)

Similar to Show_Camera_By_Volume(), but operates on double-precision cameras.

Parameters
projection- Special constant—either "Perspective", "Orthographic", "Stretched", or an "oblique" form ( see Set_Camera_By_Volume() ). Passed by reference. Returned to user.
xmin- Minimum limit of what will be visible along the X-axis. Passed by reference. Returned to user.
xmax- Maximum limit of what will be visible along the X-axis. Passed by reference. Returned to user.
ymin- Minimum limit of what will be visible along the Y-axis. Passed by reference. Returned to user.
ymax- Maximum limit of what will be visible along the Y-axis. Passed by reference. Returned to user.
void PShow_Net_Camera_By_Volume ( int  count,
HC_KEY const *  keys,
char *  proj,
float *  xmin,
float *  xmax,
float *  ymin,
float *  ymax 
)

Similar to Show_Camera_By_Volume(), but returns the net effective camera along a discrete segment path.

Parameters
count- The size of pathkeys
keys- An array of HC_KEY's delineating a path of segments.
proj- Special constant—either "Perspective", "Orthographic", "Stretched", or an "oblique" form ( see Set_Camera_By_Volume() ). Passed by reference. Returned to user.
xmin- Minimum limit of what will be visible along the X-axis. Passed by reference. Returned to user.
xmax- Maximum limit of what will be visible along the X-axis. Passed by reference. Returned to user.
ymin- Minimum limit of what will be visible along the Y-axis. Passed by reference. Returned to user.
ymax- Maximum limit of what will be visible along the Y-axis. Passed by reference. Returned to user.
Returns
An integer indicating what type of camera was found (see details).

DETAILS

As with all PShow_Net_* routines, pathkeys[0] represents the lowest segment (the "most local" or "leaf"), and pathkeys[keycount-1] represents the highest segment. If the path is incomplete, missing segments are filled in if possible. Missing segments must be part of the same direct ancestry in order to be filled in. If the desired path contains an include link, the shortest unambiguous set of pathkeys would be [leaf, includelink, root], where includelink is the return value from Include_Segment().

By default, HOOPS Visualize will determine the net attribute from the last specified key all the way to the root. If you add -1 at the end of the array, the PShow_Net routines will not proceed beyond the end of the last specified key.

A return value of 0 indicates no camera was found. A value of 1 indicates a single-precision camera was found. A value of 2 indicates a double-precision camera was found.

DETAILS

No additional details. See Set_Camera_By_Volume().

See also
Set_Camera, Show_Camera, Set_Camera_Field, Set_Camera_Position, Set_Camera_Projection, Set_Camera_Target, Set_Camera_Up_Vector, Zoom_Camera, Orbit_Camera, Pan_Camera, Dolly_Camera, Roll_Camera, Set_Window, Translate_Object, Rotate_Object.
void Show_Camera_By_Volume ( char *  projection,
float *  xmin,
float *  xmax,
float *  ymin,
float *  ymax 
)

Returns the simple rectangular box in user data space as set in a previous call to Set_Camera_By_Volume().

Parameters
projection- Special constant—either "Perspective", "Orthographic", "Stretched", or an "oblique" form ( see Set_Camera_By_Volume() ). Passed by reference. Returned to user.
xmin- Minimum limit of what will be visible along the X-axis. Passed by reference. Returned to user.
xmax- Maximum limit of what will be visible along the X-axis. Passed by reference. Returned to user.
ymin- Minimum limit of what will be visible along the Y-axis. Passed by reference. Returned to user.
ymax- Maximum limit of what will be visible along the Y-axis. Passed by reference. Returned to user.

DETAILS

No additional details. See Set_Camera_By_Volume()

See also
Set_Camera, Show_Camera, Set_Camera_Field, Set_Camera_Position, Set_Camera_Projection, Set_Camera_Target, Set_Camera_Up_Vector, Zoom_Camera, Orbit_Camera, Pan_Camera, Dolly_Camera, Roll_Camera, Set_Window, Translate_Object, Rotate_Object.