Show_Camera

Functions
void	Show_Camera (HC_POINT *position, HC_POINT *target, HC_POINT *up, float *width, float *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 (float *width, float *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	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	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	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,
		float *	width,
		float *	height,
		char *	projection
	)

Returns the complete specification of the viewing camera's position, orientation, and field of view.

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()

See also:

Set_Camera_By_Volume, 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 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	(	float *	width,
		float *	height
	)

Returns the viewing camera's field of view.

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 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 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 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()