HOpCameraOrbit
-
class
HOpCameraOrbit The
HOpCameraOrbitclass provides interactive orbiting of the camera around a scene.HOpCameraOrbitimplements three mouse event methods defined on the base class and maps the event information to the HOOPS routine #HC_Orbit_Camera. This operation consists of the following steps:- Left Button Down: The orbit is initiated.
- Left Button Down and Drag: The camera orbits.
- Left Button Up: The operation ends.
As the mouse moves through the scene, the 2D position of the pointer is mapped into 3D space like a trackball around the model. More Detailed Description: see event methods.
Inherits from:
HBaseOperator
Methods
-
HOpCameraOrbit::HOpCameraOrbit(HBaseView *view, int DoRepeat = 0, int DoCapture = 1) Constructs an
HOpCameraOrbitobject.Parameters
view: A pointer to an
HBaseViewobject.DoRepeat: An integer denoting whether this is a repeatable operator. This parameter has been deprecated.
DoCapture: An integer denoting whether the mouse state should be captured, which means that all mouse events should be received after a mousedown, even if it leaves the window. This parameter has been deprecated.
-
virtual
HOpCameraOrbit::~HOpCameraOrbit() virtual
-
virtual char const *
HOpCameraOrbit::GetName() virtual
Returns
A pointer to a character string denoting the name of the operator which is ‘HOpCameraOrbit‘.
-
virtual int
HOpCameraOrbit::OnLButtonDown(HEventInfo &hevent) virtual
OnLButtonDown draws a bounding box around the scene, records the mouse position, and maps the mouse position to spherical coordinates.
Parameters
hevent: AnHEventInfoobject containing information about the current event.Returns
AnHOperatorReturnindicating the status of the event.
-
virtual int
HOpCameraOrbit::OnLButtonDownAndMove(HEventInfo &hevent) virtual
OnLButtonDownAndMove records points as the mouse is moved, maps the points to spherical coordinates, and calculates the appropriate values for #HC_Orbit_Camera and #HC_Roll_Camera. It also updates the position of the default light depending on if you have set the light to follow the camera.
Parameters
hevent: AnHEventInfoobject containing information about the current event.Returns
AnHOperatorReturnindicating the status of the event.
-
virtual int
HOpCameraOrbit::OnLButtonUp(HEventInfo &hevent) virtual
OnLButtonUp updates the scene with the most recent camera and lighting information and cleans up.
Parameters
hevent: AnHEventInfoobject containing information about the current event.Returns
AnHOperatorReturnindicating the status of the event.
-
void
HOpCameraOrbit::SetLightFollowsCamera(bool follow) SetLightFollowsCamera sets the lights to follow the camera or to stay in one place during orbit. This has the effect of either lighting the scene during orbit or allowing the camera to move through shadow. The default is off.
Parameters
follow: Pass true to have the light follow the camera.
-
bool
HOpCameraOrbit::GetLightFollowsCamera() Returns
True if the light follows the camera or false if it doesn’t.
-
void
HOpCameraOrbit::SetSceneBoundingBoxVis(bool vis) SetSceneBoundingBoxVis controls whether a bounding box denoting the scene extents should be drawn during a camera orbit.
Parameters
vis: Pass true if you want HOOPS to draw the bounding box or false if you don’t.
-
bool
HOpCameraOrbit::GetSceneBoundingBoxVis() Returns
True if the bounding box is visible or false if it isn’t.
-
virtual HBaseOperator *
HOpCameraOrbit::Clone() virtual
Creates a new operator which is a copy of the current operator. The user is responsible for deleting the newly created operator.
Returns
A pointer to the newly createdHOpCameraOrbitobject.
-
bool
HOpCameraOrbit::GetSingleClick() Returns
True if the mouse has moved between the left mouse button down and left mouse button up events.
Variables
-
float
HOpCameraOrbit::m_Angle2 - float
For internal use only!
-
float
HOpCameraOrbit::m_Angle1 - float
-
float
HOpCameraOrbit::m_Angle3 - float
-
bool
HOpCameraOrbit::m_bLightFollowsCamera protected
boolThis member indicates whether the light should follow the camera.
-
bool
HOpCameraOrbit::m_bSceneBoundingBoxVis protected
boolThis member indicates whether a bounding box denoting the scene extents should be drawn during a camera orbit.
-
bool
HOpCameraOrbit::m_bSingleClick protected
boolThis member indicates whether the mouse has moved in between lbuttondown/lbuttonup.
-
HPoint
HOpCameraOrbit::m_ptRealOld protected
For internal use only.
-
HPoint
HOpCameraOrbit::m_ptRealFirst private