The HPS::CameraControl class is a smart pointer that is tied to a database object. The CameraControl is used to manipulate the viewpoint, or camera, in a scene. Using this control, the view position, orientation, target, and aspect ratio of a segment's camera can be set. Cameras are considered segment attributes, but unlink other attributes, they inherit as a group down the segment hierarchy. This table lists default values for the various segment attributes accessible from HPS::CameraControl. More...

Inheritance diagram for HPS.CameraControl:
HPS.Control HPS.Object

Public Member Functions

 CameraControl (HPS.SegmentKey in_seg)
 Initializes a control tied to the segment in_seg. More...
 
 CameraControl (HPS.CameraControl in_that)
 Initializes a control tied to the same object as in_that. More...
 
override void Dispose ()
 
HPS.CameraControl Dolly (float in_x_dir, float in_up, float in_forward)
 Moves the camera position and target the specified amount but maintains the up vector and field. If a complete camera is not already set up, one will be populated with default values before dollying. More...
 
override HPS.Type ObjectType ()
 This function returns the type the object, as declared. This does not necessarily give the true type of the underlying object. More...
 
HPS.CameraControl Orbit (float in_theta, float in_phi)
 Moves the camera around the target in_theta degrees to the right and in_phi degrees up. The target and field are maintained but position and up_vector may change. If a complete camera is not already set up, one will be populated with default values before orbiting. More...
 
HPS.CameraControl Pan (float in_theta, float in_phi)
 Pivots the camera on its location in_theta degrees to the right and in_phi degrees up. The position and field remain unchanged while the target and up vector may change. If a complete camera is not already set up, one will be populated with default values before panning. More...
 
HPS.CameraControl Roll (float in_theta)
 Spins the camera around its target in_theta degrees counter-clockwise (the scene will appear to move clockwise). The position, field, and target are unchanged while the up-vector may change. If a complete camera is not already set up, one will be populated with default values before rolling. More...
 
HPS.CameraControl SetField (float in_width, float in_height)
 Sets the camera field. More...
 
HPS.CameraControl SetNearLimit (float in_double)
 Sets the near_limit to in_double that defines the near limit of the camera. A value approaching 0.0 will place it close to the camera position (at the cost of poor z-buffer precision), whereas a value approaching 1.0 will place it near the camera target (at the cost of clipping away anything closer than the target). A value exactly equal to 0 will let HOOPS Visualize choose a limit based on the precision of the zbuffer as reported by the driver. More...
 
HPS.CameraControl SetPosition (HPS.Point in_position)
 Sets the location of the camera. More...
 
HPS.CameraControl SetProjection (HPS.Camera.Projection in_type, float in_oblique_x_skew, float in_oblique_y_skew)
 Sets the camera projection type and the oblique skew, if any. More...
 
HPS.CameraControl SetProjection (HPS.Camera.Projection in_type, float in_oblique_x_skew)
 Sets the camera projection type and the oblique skew, if any. More...
 
HPS.CameraControl SetProjection (HPS.Camera.Projection in_type)
 Sets the camera projection type and the oblique skew, if any. More...
 
HPS.CameraControl SetTarget (HPS.Point in_target)
 Sets the location that the camera is pointed at. More...
 
HPS.CameraControl SetUpVector (HPS.Vector in_up)
 Sets a vector that defines the vertical up direction of the camera. More...
 
bool ShowField (out float out_width, out float out_height)
 Shows the camera field. More...
 
bool ShowHeight (out float out_height)
 Shows the height of the camera field. More...
 
bool ShowNearLimit (out float out_near_limit)
 Shows the camera near limit. More...
 
bool ShowPosition (out HPS.Point out_position)
 Shows the camera position. More...
 
bool ShowProjection (out HPS.Camera.Projection out_type)
 Shows the camera projection type. More...
 
bool ShowProjection (out HPS.Camera.Projection out_type, out float out_oblique_x_skew, out float out_oblique_y_skew)
 Shows the camera projection type and the oblique skew, if any. More...
 
bool ShowTarget (out HPS.Point out_target)
 Shows the camera target. More...
 
bool ShowUpVector (out HPS.Vector out_up_vector)
 Shows the camera up-vector. More...
 
bool ShowWidth (out float out_width)
 Shows the width of the camera field. More...
 
HPS.CameraControl UnsetEverything ()
 Removes all settings from this object. Unlike other attributes, it is not possible to unset just a single field of a camera. More...
 
HPS.CameraControl Zoom (float in_zoom)
 Adjusts the field of view by dividing the width and height by the input value. Numbers greater than one will have the effect of making things on screen appear larger. Numbers between zero and one will have the opposite effect. Only the field is affected. If a complete camera is not already set up, one will be populated with default values before zooming. More...
 
- Public Member Functions inherited from HPS.Control
 Control (HPS.Control in_that)
 
override void Dispose ()
 
- Public Member Functions inherited from HPS.Object
virtual bool Empty ()
 Indicates whether this object has any values set on it. More...
 
IntPtr GetClassID ()
 
IntPtr GetInstanceID ()
 Returns an identifier that can be used to identify which instance of a class an object is. Different keys and controls will return the same value if they are backed by the same database resource. More...
 
bool HasType (HPS.Type in_mask)
 This function indicates whether this Object has the given Type mask. More...
 
 Object (HPS.Object that)
 
virtual void Reset ()
 Resets this object to its initial, uninitialized state. More...
 
HPS.Type Type ()
 This function returns the true type of the underlying object. This function is useful for finding the type of smart pointer objects that have been cast to more generic types. More...
 

Protected Member Functions

override void deleteCptr ()
 
- Protected Member Functions inherited from HPS.Control
override void deleteCptr ()
 
- Protected Member Functions inherited from HPS.Object
virtual IntPtr GetNonDirectorClassID ()
 

Additional Inherited Members

- Static Public Member Functions inherited from HPS.Object
static IntPtr ClassID< T > ()
 
- Protected Attributes inherited from HPS.Object
bool cMemOwn
 
HandleRef cptr
 

Detailed Description

The HPS::CameraControl class is a smart pointer that is tied to a database object. The CameraControl is used to manipulate the viewpoint, or camera, in a scene. Using this control, the view position, orientation, target, and aspect ratio of a segment's camera can be set. Cameras are considered segment attributes, but unlink other attributes, they inherit as a group down the segment hierarchy. This table lists default values for the various segment attributes accessible from HPS::CameraControl.

Constructor & Destructor Documentation

HPS.CameraControl.CameraControl ( HPS.SegmentKey  in_seg)
inline

Initializes a control tied to the segment in_seg.

HPS.CameraControl.CameraControl ( HPS.CameraControl  in_that)
inline

Initializes a control tied to the same object as in_that.

Member Function Documentation

HPS.CameraControl HPS.CameraControl.Dolly ( float  in_x_dir,
float  in_up,
float  in_forward 
)
inline

Moves the camera position and target the specified amount but maintains the up vector and field. If a complete camera is not already set up, one will be populated with default values before dollying.

Parameters
in_x_dirThe number of world-space units to move the camera in the x-direction.
in_upThe number of world-space units to move the camera up, or if negative, down.
in_forwardThe number of world-space units to move the camera toward the target, or if negative, away from the target.
Returns
A reference to this object.
override HPS.Type HPS.CameraControl.ObjectType ( )
inlinevirtual

This function returns the type the object, as declared. This does not necessarily give the true type of the underlying object.

Returns
The declared type of the object in question, which may differ from the true, underlying type.

Reimplemented from HPS.Object.

HPS.CameraControl HPS.CameraControl.Orbit ( float  in_theta,
float  in_phi 
)
inline

Moves the camera around the target in_theta degrees to the right and in_phi degrees up. The target and field are maintained but position and up_vector may change. If a complete camera is not already set up, one will be populated with default values before orbiting.

Parameters
in_thetaThe number of degrees to move the the camera position to the right.
in_phiThe number of degrees to move the the camera position up.
Returns
A reference to this object.
HPS.CameraControl HPS.CameraControl.Pan ( float  in_theta,
float  in_phi 
)
inline

Pivots the camera on its location in_theta degrees to the right and in_phi degrees up. The position and field remain unchanged while the target and up vector may change. If a complete camera is not already set up, one will be populated with default values before panning.

Parameters
in_thetaThe number of degrees to move the the camera target to the right.
in_phiThe number of degrees to move the the camera target up.
Returns
A reference to this object.
HPS.CameraControl HPS.CameraControl.Roll ( float  in_theta)
inline

Spins the camera around its target in_theta degrees counter-clockwise (the scene will appear to move clockwise). The position, field, and target are unchanged while the up-vector may change. If a complete camera is not already set up, one will be populated with default values before rolling.

Parameters
in_thetaThe number of degrees to roll the camera.
Returns
A reference to this object.
HPS.CameraControl HPS.CameraControl.SetField ( float  in_width,
float  in_height 
)
inline

Sets the camera field.

Parameters
in_widthThe width of the camera field, in object-space units.
in_heightThe height of the camera field, in object-space units.
Returns
A reference to this object.

camera field

HPS.CameraControl HPS.CameraControl.SetNearLimit ( float  in_double)
inline

Sets the near_limit to in_double that defines the near limit of the camera. A value approaching 0.0 will place it close to the camera position (at the cost of poor z-buffer precision), whereas a value approaching 1.0 will place it near the camera target (at the cost of clipping away anything closer than the target). A value exactly equal to 0 will let HOOPS Visualize choose a limit based on the precision of the zbuffer as reported by the driver.

Parameters
in_doubleThe value to set the near limit to
Returns
A reference to this object.

camera near limit

HPS.CameraControl HPS.CameraControl.SetPosition ( HPS.Point  in_position)
inline

Sets the location of the camera.

Parameters
in_positionThe location of the camera.
Returns
A reference to this object.

camera position

HPS.CameraControl HPS.CameraControl.SetProjection ( HPS.Camera.Projection  in_type,
float  in_oblique_x_skew,
float  in_oblique_y_skew 
)
inline

Sets the camera projection type and the oblique skew, if any.

Parameters
in_typeThe type of camera projection.
in_oblique_x_skewThe oblique skew in the horizontal direction.
in_oblique_y_skewThe oblique skew in the vertical direction.
Returns
A reference to this object.

camera target

HPS.CameraControl HPS.CameraControl.SetProjection ( HPS.Camera.Projection  in_type,
float  in_oblique_x_skew 
)
inline

Sets the camera projection type and the oblique skew, if any.

Parameters
in_typeThe type of camera projection.
in_oblique_x_skewThe oblique skew in the horizontal direction.
Returns
A reference to this object.

camera target

HPS.CameraControl HPS.CameraControl.SetProjection ( HPS.Camera.Projection  in_type)
inline

Sets the camera projection type and the oblique skew, if any.

Parameters
in_typeThe type of camera projection.
Returns
A reference to this object.

camera target

HPS.CameraControl HPS.CameraControl.SetTarget ( HPS.Point  in_target)
inline

Sets the location that the camera is pointed at.

Parameters
in_targetThe location that the camera is pointed at.
Returns
A reference to this object.

camera position

HPS.CameraControl HPS.CameraControl.SetUpVector ( HPS.Vector  in_up)
inline

Sets a vector that defines the vertical up direction of the camera.

Parameters
in_upA vector that defines the vertical up direction of the camera.
Returns
A reference to this object.

camera up vector

bool HPS.CameraControl.ShowField ( out float  out_width,
out float  out_height 
)
inline

Shows the camera field.

Parameters
out_widthThe width of the camera field, in object-space units.
out_heightThe height of the camera field, in object-space units.
Returns
true if the setting is valid, false otherwise.
bool HPS.CameraControl.ShowHeight ( out float  out_height)
inline

Shows the height of the camera field.

Parameters
out_heightThe height of the camera field, in object-space units.
Returns
true if the setting is valid, false otherwise.
bool HPS.CameraControl.ShowNearLimit ( out float  out_near_limit)
inline

Shows the camera near limit.

Returns
true if the setting is valid, false otherwise.
bool HPS.CameraControl.ShowPosition ( out HPS.Point  out_position)
inline

Shows the camera position.

Parameters
out_positionthe location of the camera.
Returns
true if the setting is valid, false otherwise.
bool HPS.CameraControl.ShowProjection ( out HPS.Camera.Projection  out_type)
inline

Shows the camera projection type.

Parameters
out_typeThe type of camera projection.
Returns
true if the setting is valid, false otherwise.
bool HPS.CameraControl.ShowProjection ( out HPS.Camera.Projection  out_type,
out float  out_oblique_x_skew,
out float  out_oblique_y_skew 
)
inline

Shows the camera projection type and the oblique skew, if any.

Parameters
out_typeThe type of camera projection.
out_oblique_x_skewThe oblique skew in the horizontal direction.
out_oblique_y_skewThe oblique skew in the vertical direction.
Returns
true if the setting is valid, false otherwise.
bool HPS.CameraControl.ShowTarget ( out HPS.Point  out_target)
inline

Shows the camera target.

Parameters
out_targetthe location that the camera is pointed at.
Returns
true if the setting is valid, false otherwise.
bool HPS.CameraControl.ShowUpVector ( out HPS.Vector  out_up_vector)
inline

Shows the camera up-vector.

Parameters
out_up_vectorA vector that defines the vertical up direction of the camera.
Returns
true if the setting is valid, false otherwise.
bool HPS.CameraControl.ShowWidth ( out float  out_width)
inline

Shows the width of the camera field.

Parameters
out_widthThe width of the camera field, in object-space units.
Returns
true if the setting is valid, false otherwise.
HPS.CameraControl HPS.CameraControl.UnsetEverything ( )
inline

Removes all settings from this object. Unlike other attributes, it is not possible to unset just a single field of a camera.

Returns
A reference to this object.
HPS.CameraControl HPS.CameraControl.Zoom ( float  in_zoom)
inline

Adjusts the field of view by dividing the width and height by the input value. Numbers greater than one will have the effect of making things on screen appear larger. Numbers between zero and one will have the opposite effect. Only the field is affected. If a complete camera is not already set up, one will be populated with default values before zooming.

Parameters
in_zoomThe zoom scale factor.
Returns
A reference to this object.

The documentation for this class was generated from the following file:
  • internals/hps_core/source/cs/HPS.CameraControl.cs