Brief Index      Full Index      I.M. Reference

Show_Camera


Functions

void Show_Camera (HC_POINT *position, HC_POINT *target, HC_POINT *up, double *width, double *height, char *projection)
void DShow_Camera (HCD_POINT *position, HCD_POINT *target, HCD_POINT *up, double *width, double *height, char *projection)
void QShow_Camera (const char *segment, HC_POINT *position, HC_POINT *target, HC_POINT *up, float *width, float *height, char *projection)
void Show_Net_Camera (HC_POINT *position, HC_POINT *target, HC_POINT *up, float *width, float *height, char *projection)
void QShow_Net_Camera (const char *segment, HC_POINT *position, HC_POINT *target, HC_POINT *up, float *width, float *height, char *projection)
void PShow_Net_Camera (int keycount, HC_KEY *pathkeys, HC_POINT *position, HC_POINT *target, HC_POINT *up, float *width, float *height, char *projection)
void Show_Camera_Field (double *width, double *height)
void DShow_Camera_Field (double *width, double *height)
void QShow_Camera_Field (const char *segment, float *width, float *height)
void Show_Net_Camera_Field (float *width, float *height)
void PShow_Net_Camera_Field (int keycount, HC_KEY *pathkeys, float *width, float *height)
void QShow_Net_Camera_Field (const char *segment, float *width, float *height)
void Show_Camera_Position (float *x, float *y, float *z)
void DShow_Camera_Position (double *x, double *y, double *z)
void QShow_Camera_Position (const char *segment, float *x, float *y, float *z)
void Show_Net_Camera_Position (float *x, float *y, float *z)
void PShow_Net_Camera_Position (int keycount, HC_KEY *pathkeys, float *x, float *y, float *z)
void QShow_Net_Camera_Position (const char *segment, float *x, float *y, float *z)
void Show_Camera_Projection (char *projection)
void QShow_Camera_Projection (const char *segment, char *projection)
void Show_Net_Camera_Projection (char *projection)
void PShow_Net_Camera_Projection (int keycount, HC_KEY *pathkeys, char *projection)
void QShow_Net_Camera_Projection (const char *segment, char *projection)
void Show_Camera_Target (float *x, float *y, float *z)
void DShow_Camera_Target (double *x, double *y, double *z)
void QShow_Camera_Target (const char *segment, float *x, float *y, float *z)
void Show_Net_Camera_Target (float *x, float *y, float *z)
void PShow_Net_Camera_Target (int keycount, HC_KEY *pathkeys, float *x, float *y, float *z)
void QShow_Net_Camera_Target (const char *segment, float *x, float *y, float *z)
void Show_Camera_Up_Vector (float *x, float *y, float *z)
void DShow_Camera_Up_Vector (double *x, double *y, double *z)
void QShow_Camera_Up_Vector (const char *segment, float *x, float *y, float *z)
void Show_Net_Camera_Up_Vector (float *x, float *y, float *z)
void PShow_Net_Camera_Up_Vector (int keycount, HC_KEY *pathkeys, float *x, float *y, float *z)
void QShow_Net_Camera_Up_Vector (const char *segment, float *x, float *y, float *z)

Function Documentation

void Show_Camera ( HC_POINT *  position,
HC_POINT *  target,
HC_POINT *  up,
double *  width,
double *  height,
char *  projection 
)

void DShow_Camera ( HCD_POINT *  position,
HCD_POINT *  target,
HCD_POINT *  up,
double *  width,
double *  height,
char *  projection 
)

void QShow_Camera ( const char *  segment,
HC_POINT *  position,
HC_POINT *  target,
HC_POINT *  up,
float *  width,
float *  height,
char *  projection 
)

Similar to Show_Camera(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be queried.
position - Position in the scene, in user coordinates, at which the camera is set. Passed by reference. Returned to user.
target - Coordinates in the scene toward which the camera is pointed. Passed by reference. Returned to user.
up - Direction the top of the camera faces: the "upvector". Passed by reference. Returned to user.
width - Width of the minimum visible area around the target. Passed by reference. Returned to user.
height - Height of the minimum visible area around the target. Passed by reference. Returned to user.
projection - Special constant---either "Perspective", "Orthographic", "Stretched", or an "oblique" form (see Set_Camera_Projection() or Set_Camera_By_Volume() ). May be uppercase, lowe case, or mixed case. Passed by reference. Returned to user.

DETAILS

No additional details. See Show_Camera()

void Show_Net_Camera ( HC_POINT *  position,
HC_POINT *  target,
HC_POINT *  up,
float *  width,
float *  height,
char *  projection 
)

Similar to Show_Camera(), but returns the net effective setting rather than the local one.

Parameters:
position - Position in the scene, in user coordinates, at which the camera is set. Passed by reference. Returned to user.
target - Coordinates in the scene toward which the camera is pointed. Passed by reference. Returned to user.
up - Direction the top of the camera faces: the "upvector". Passed by reference. Returned to user.
width - Width of the minimum visible area around the target. Passed by reference. Returned to user.
height - Height of the minimum visible area around the target. Passed by reference. Returned to user.
projection - Special constant---either "Perspective", "Orthographic", "Stretched", or an "oblique" form (see Set_Camera_Projection() or Set_Camera_By_Volume() ). May be uppercase, lower case, or mixed case. Passed by reference. Returned to user.

DETAILS

No additional details. See Set_Camera()

void QShow_Net_Camera ( const char *  segment,
HC_POINT *  position,
HC_POINT *  target,
HC_POINT *  up,
float *  width,
float *  height,
char *  projection 
)

Similar to Show_Net_Camera(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment to be queried.
position - Position in the scene, in user coordinates, at which the camera is set. Passed by reference. Returned to user.
target - Coordinates in the scene toward which the camera is pointed. Passed by reference. Returned to user.
up - Direction the top of the camera faces: the "upvector". Passed by reference. Returned to user.
width - Width of the minimum visible area around the target. Passed by reference. Returned to user.
height - Height of the minimum visible area around the target. Passed by reference. Returned to user.
projection - Special constant---either "Perspective", "Orthographic", "Stretched", or an "oblique" form (see Set_Camera_Projection() or Set_Camera_By_Volume() ). May be uppercase, lower case, or mixed case. Passed by reference. Returned to user.

DETAILS

No additional details. See Set_Camera()

void PShow_Net_Camera ( int  keycount,
HC_KEY *  pathkeys,
HC_POINT *  position,
HC_POINT *  target,
HC_POINT *  up,
float *  width,
float *  height,
char *  projection 
)

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

Parameters:
keycount The size of pathkeys
pathkeys An array of HC_KEY's delineating a path of segments.
position - Position in the scene, in user coordinates, at which the camera is set. Passed by reference. Returned to user.
target - Coordinates in the scene toward which the camera is pointed. Passed by reference. Returned to user.
up - Direction the top of the camera faces: the "upvector". Passed by reference. Returned to user.
width - Width of the minimum visible area around the target. Passed by reference. Returned to user.
height - Height of the minimum visible area around the target. Passed by reference. Returned to user.
projection - Special constant---either "Perspective", "Orthographic", "Stretched", or an "oblique" form (see Set_Camera_Projection() or Set_Camera_By_Volume() ). May be uppercase, lower case, or mixed case. Passed by reference. Returned to user.

DETAILS

As with all PShow_Net_* routines, pathkeys[0] represents the lowest (a.k.a 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 KInclude_Segment().

For other details, see Show_Net_Camera()

void Show_Camera_Field ( double *  width,
double *  height 
)

void DShow_Camera_Field ( double *  width,
double *  height 
)

Similar to Show_Camera_Field(). This command should be used in conjunction with other set camera functions in the HOOPS double-precision header, hcd.h.

Parameters:
width - Width of the minimum visible area around the target. Passed by reference. Returned to user.
height - Height of the minimum visible area around the target. Passed by reference. Returned to user.

void QShow_Camera_Field ( const char *  segment,
float *  width,
float *  height 
)

Similar to Show_Camera_Field(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be queried.
width - Width of the minimum visible area around the target. Passed by reference. Returned to user.
height - Height of the minimum visible area around the target. Passed by reference. Returned to user.

DETAILS

No additional details. See Show_Camera()

void Show_Net_Camera_Field ( float *  width,
float *  height 
)

Similar to Show_Camera_Field() but returns the net effective setting rather than the local one.

Parameters:
width - Width of the minimum visible area around the target. Passed by reference. Returned to user.
height - Height of the minimum visible area around the target. Passed by reference. Returned to user.

void PShow_Net_Camera_Field ( int  keycount,
HC_KEY *  pathkeys,
float *  width,
float *  height 
)

Similar to Show_Net_Camera_Field() but returns the net effective setting along a discrete segment path.

Parameters:
keycount The size of pathkeys
pathkeys An array of HC_KEY's delineating a path of segments.
width - Width of the minimum visible area around the target. Passed by reference. Returned to user.
height - Height of the minimum visible area around the target. Passed by reference. Returned to user.

DETAILS

As with all PShow_Net_* routines, pathkeys[0] represents the lowest (a.k.a 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 KInclude_Segment().

For other details, see Show_Net_Camera_Field()

void QShow_Net_Camera_Field ( const char *  segment,
float *  width,
float *  height 
)

Similar to Show_Net_Camera_Field() but returns the net effective setting on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be queried.
width - Width of the minimum visible area around the target. Passed by reference. Returned to user.
height - Height of the minimum visible area around the target. Passed by reference. Returned to user.

void Show_Camera_Position ( float *  x,
float *  y,
float *  z 
)

Returns the viewing camera's position.

Parameters:
x - X-coordinate of the camera position. Passed by reference. Returned to user.
y - Y-coordinate of the camera position. Passed by reference. Returned to user.
z - Z-coordinate of the camera position. Passed by reference. Returned to user.

void DShow_Camera_Position ( double *  x,
double *  y,
double *  z 
)

Similar to Show_Camera_Position(). This command should be used in conjunction with other set camera functions in the HOOPS double-precision header, hcd.h.

Parameters:
x - X-coordinate of the camera position. Passed by reference. Returned to user.
y - Y-coordinate of the camera position. Passed by reference. Returned to user.
z - Z-coordinate of the camera position. Passed by reference. Returned to user.

void QShow_Camera_Position ( const char *  segment,
float *  x,
float *  y,
float *  z 
)

Similar to Show_Camera_Position(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be queried.
x - X-coordinate of the camera position. Passed by reference. Returned to user.
y - Y-coordinate of the camera position. Passed by reference. Returned to user.
z - Z-coordinate of the camera position. Passed by reference. Returned to user.

DETAILS

No additional details. See Show_Camera()

void Show_Net_Camera_Position ( float *  x,
float *  y,
float *  z 
)

Similar to Show_Camera_Position(), but returns the net effective setting rather than the local one.

Parameters:
x - X-coordinate of the camera position. Passed by reference. Returned to user.
y - Y-coordinate of the camera position. Passed by reference. Returned to user.
z - Z-coordinate of the camera position. Passed by reference. Returned to user.

void PShow_Net_Camera_Position ( int  keycount,
HC_KEY *  pathkeys,
float *  x,
float *  y,
float *  z 
)

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

Parameters:
keycount The size of pathkeys
pathkeys An array of HC_KEY's delineating a path of segments.
x - X-coordinate of the camera position. Passed by reference. Returned to user.
y - Y-coordinate of the camera position. Passed by reference. Returned to user.
z - Z-coordinate of the camera position. Passed by reference. Returned to user.

DETAILS

As with all PShow_Net_* routines, pathkeys[0] represents the lowest (a.k.a 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 KInclude_Segment().

For other details, see Show_Net_Camera_Position()

void QShow_Net_Camera_Position ( const char *  segment,
float *  x,
float *  y,
float *  z 
)

Similar to Show_Net_Camera_Position(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be queried.
x - X-coordinate of the camera position. Passed by reference. Returned to user.
y - Y-coordinate of the camera position. Passed by reference. Returned to user.
z - Z-coordinate of the camera position. Passed by reference. Returned to user.

DETAILS

No additional details. See Show_Camera()

void Show_Camera_Projection ( char *  projection  ) 

Returns the viewing camera's projection.

Parameters:
projection - Special constant---either "Perspective", "Orthographic", "Stretched", or an "oblique" form (see Set_Camera_Projection() or Set_Camera_By_Volume() ). May be uppercase, lower case, or mixed case. Passed by reference. Returned to user.

void QShow_Camera_Projection ( const char *  segment,
char *  projection 
)

Similar to Show_Camera_Projection(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be queried.
projection - Special constant---either "Perspective", "Orthographic", "Stretched", or an "oblique" form (see Set_Camera_Projection() or Set_Camera_By_Volume() ). May be uppercase, lower case, or mixed case. Passed by reference. Returned to user.

DETAILS

No additional details. See Show_Camera()

void Show_Net_Camera_Projection ( char *  projection  ) 

Similar to Show_Camera_Projection(), but returns the net effective setting rather than the local one.

Parameters:
projection - Special constant---either "Perspective", "Orthographic", "Stretched", or an "oblique" form (see Set_Camera_Projection() or Set_Camera_By_Volume() ). May be uppercase, lower case, or mixed case. Passed by reference. Returned to user.

void PShow_Net_Camera_Projection ( int  keycount,
HC_KEY *  pathkeys,
char *  projection 
)

Similar to Show_Net_Camera_Projection(), but returns the net effective setting along a discrete segment path specified with a set of keys.

Parameters:
keycount The size of pathkeys
pathkeys An array of HC_KEY's delineating a path of segments.
projection - Special constant---either "Perspective", "Orthographic", "Stretched", or an "oblique" form (see Set_Camera_Projection() or Set_Camera_By_Volume() ). May be uppercase, lower case, or mixed case. Passed by reference. Returned to user.

DETAILS

As with all PShow_Net_* routines, pathkeys[0] represents the lowest (a.k.a 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 KInclude_Segment(). For other details, see Show_Net_Camera_Projection()

void QShow_Net_Camera_Projection ( const char *  segment,
char *  projection 
)

Similar to Show_Net_Camera_Projection(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be queried.
projection - Special constant---either "Perspective", "Orthographic", "Stretched", or an "oblique" form (see Set_Camera_Projection() or Set_Camera_By_Volume() ). May be uppercase, lower case, or mixed case. Passed by reference. Returned to user.

DETAILS

No additional details. See Show_Camera()

void Show_Camera_Target ( float *  x,
float *  y,
float *  z 
)

Returns the viewing camera's target.

Parameters:
x - X-coordinate of the camera target. Passed by reference. Returned to user.
y - Y-coordinate of the camera target. Passed by reference. Returned to user.
z - Z-coordinate of the camera target. Passed by reference. Returned to user.

void DShow_Camera_Target ( double *  x,
double *  y,
double *  z 
)

Similar to Show_Camera_Target(). This command should be used in conjunction with other set camera functions in the HOOPS double-precision header, hcd.h.

Parameters:
x - X-coordinate of the camera target. Passed by reference. Returned to user.
y - Y-coordinate of the camera target. Passed by reference. Returned to user.
z - Z-coordinate of the camera target. Passed by reference. Returned to user.

void QShow_Camera_Target ( const char *  segment,
float *  x,
float *  y,
float *  z 
)

Similar to Show_Camera_Target(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be queried.
x - X-coordinate of the camera target. Passed by reference. Returned to user.
y - Y-coordinate of the camera target. Passed by reference. Returned to user.
z - Z-coordinate of the camera target. Passed by reference. Returned to user.

DETAILS

No additional details. See Show_Camera()

void Show_Net_Camera_Target ( float *  x,
float *  y,
float *  z 
)

Similar to Show_Camera_Target(), but returns the net effective setting rather than the local one.

Parameters:
x - X-coordinate of the camera target. Passed by reference. Returned to user.
y - Y-coordinate of the camera target. Passed by reference. Returned to user.
z - Z-coordinate of the camera target. Passed by reference. Returned to user.

void PShow_Net_Camera_Target ( int  keycount,
HC_KEY *  pathkeys,
float *  x,
float *  y,
float *  z 
)

Similar to Show_Camera_Target(), but returns the net effective setting along a specified path of keys rather than the local one.

Parameters:
keycount The size of pathkeys
pathkeys An array of HC_KEY's delineating a path of segments.
x - X-coordinate of the camera target. Passed by reference. Returned to user.
y - Y-coordinate of the camera target. Passed by reference. Returned to user.
z - Z-coordinate of the camera target. Passed by reference. Returned to user.

DETAILS

As with all PShow_Net_* routines, pathkeys[0] represents the lowest (a.k.a 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 KInclude_Segment(). For other details, see Show_Net_Camera_Target()

void QShow_Net_Camera_Target ( const char *  segment,
float *  x,
float *  y,
float *  z 
)

Similar to Show_Net_Camera_Target(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be queried.
x - X-coordinate of the camera target. Passed by reference. Returned to user.
y - Y-coordinate of the camera target. Passed by reference. Returned to user.
z - Z-coordinate of the camera target. Passed by reference. Returned to user.

DETAILS

No additional details. See Show_Camera()

void Show_Camera_Up_Vector ( float *  x,
float *  y,
float *  z 
)

Returns the viewing camera's up-vector.

Parameters:
x - X-coordinate of the camera up-vector. Passed by reference. Returned to user.
y - Y-coordinate of the camera up-vector. Passed by reference. Returned to user.
z - Z-coordinate of the camera up-vector. Passed by reference. Returned to user.

void DShow_Camera_Up_Vector ( double *  x,
double *  y,
double *  z 
)

Similar to Show_Camera_Up_Vector(). This command should be used in conjunction with other set camera functions in the HOOPS double-precision header, hcd.h.

Parameters:
x - X-coordinate of the camera up-vector. Passed by reference. Returned to user.
y - Y-coordinate of the camera up-vector. Passed by reference. Returned to user.
z - Z-coordinate of the camera up-vector. Passed by reference. Returned to user.

void QShow_Camera_Up_Vector ( const char *  segment,
float *  x,
float *  y,
float *  z 
)

Similar to Show_Camera_Up_Vector(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be queried.
x - X-coordinate of the camera up-vector. Passed by reference. Returned to user.
y - Y-coordinate of the camera up-vector. Passed by reference. Returned to user.
z - Z-coordinate of the camera up-vector. Passed by reference. Returned to user.

DETAILS

No additional details. See Show_Camera()

void Show_Net_Camera_Up_Vector ( float *  x,
float *  y,
float *  z 
)

Similar to Show_Camera_Up_Vector(), but returns the net effective setting rather than the local one.

Parameters:
x - X-coordinate of the camera up-vector. Passed by reference. Returned to user.
y - Y-coordinate of the camera up-vector. Passed by reference. Returned to user.
z - Z-coordinate of the camera up-vector. Passed by reference. Returned to user.

void PShow_Net_Camera_Up_Vector ( int  keycount,
HC_KEY *  pathkeys,
float *  x,
float *  y,
float *  z 
)

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

Parameters:
keycount The size of pathkeys
pathkeys An array of HC_KEY's delineating a path of segments.
x - X-coordinate of the camera up-vector. Passed by reference. Returned to user.
y - Y-coordinate of the camera up-vector. Passed by reference. Returned to user.
z - Z-coordinate of the camera up-vector. Passed by reference. Returned to user.

DETAILS

As with all PShow_Net_* routines, pathkeys[0] represents the lowest (a.k.a 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 KInclude_Segment(). For other details, see Show_Net_Camera_Up_Vector()

void QShow_Net_Camera_Up_Vector ( const char *  segment,
float *  x,
float *  y,
float *  z 
)

Similar to Show_Net_Camera_Up_Vector(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be queried.
x - X-coordinate of the camera up-vector. Passed by reference. Returned to user.
y - Y-coordinate of the camera up-vector. Passed by reference. Returned to user.
z - Z-coordinate of the camera up-vector. Passed by reference. Returned to user.

DETAILS

No additional details. See Show_Camera()

Main Index
Brief Index      Full Index      I.M. Functions