NavigationCubeOperator
-
class NavigationCubeOperator : public HPS::Operator
- HPS::NavigationCubeControl::SetInteractivity() “HPS::NavigationCubeControl::SetInteractivity(true)” first.
<p>The NavigationCubeOperator class defines an operator which allows the user to interact with the navigation cube.</p> <p>This Operator works for both mouse- and touch-driven devices.</p> <p><strong>Mouse-Driver Devices:</strong></p> <table> <tr><td>Left Button Down:</td><td> Snap view to plane</td></tr> <tr><td>Left Button Down and Move:</td><td> Rotates the scene</td></tr> </table> <p><strong>Touch-Driven Devices:</strong></p> <table> <tr><td>Tap:</td><td>Snaps view to plane</td></tr> <tr><td>Tap and Move:</td><td>Rotates the scene</td></tr> </table> <p>In order to use the NavigationCubeOperator, it's necessary to call <span class='code'>\ref
Note
The orientation of the NavigationCubeControl is specified by the model in the associated view. See HPS::Model::SetOrientation().
Public Functions
-
HPS::Time GetTransitionTime() const
Gets the duration of transitions, specified in seconds.
- Returns:
How long it will take the navigation cube to complete a transition when a user clicks on one of its faces, in seconds
-
NavigationCubeOperator(MouseButtons in_mouse_trigger = MouseButtons::ButtonLeft(), ModifierKeys in_modifier_trigger = ModifierKeys())
-
virtual void OnModelAttached()
This function is called whenever a model is attached to the view that is attached to this operator. If no view is attached to this operator, this function will not be called.
-
virtual bool OnMouseDown(MouseState const &in_state)
This function is called whenever HPS receives a MouseEvent that signals a mouse button was pressed. This function starts the operator and computes the position of the starting point.
- Parameters:
in_state – A MouseState object describing the current mouse state.
- Returns:
true if the input event was handled, false otherwise.
-
virtual bool OnMouseMove(MouseState const &in_state)
This function is called whenever HPS receives a MouseEvent that signals the mouse moved This function orbits the camera.
- Parameters:
in_state – A MouseState object describing the current mouse state.
- Returns:
true if the input event was handled, false otherwise.
-
virtual bool OnMouseUp(MouseState const &in_state)
This function is called whenever HPS receives a MouseEvent that signals a mouse button was released. This function stops the operator.
- Parameters:
in_state – A MouseState object describing the current mouse state.
- Returns:
true if the input event was handled, false otherwise.
-
virtual bool OnTouchDown(TouchState const &in_state)
This function is called whenever HPS receives a TouchEvent that signals the device was touched.
- Parameters:
in_state – A TouchState object describing the current touch state.
- Returns:
true if the input event was handled, false otherwise.
-
virtual bool OnTouchMove(TouchState const &in_state)
This function is called whenever HPS receives a TouchEvent that signals a point of contact has moved. This function orbits the camera as needed.
- Parameters:
in_state – A TouchState object describing the current touch state.
- Returns:
true if the input event was handled, false otherwise.
-
virtual bool OnTouchUp(TouchState const &in_state)
This function is called whenever HPS receives a TouchEvent that signals a point of contact has been released. This function stops the operator.
- Parameters:
in_state – A TouchState object describing the current touch state.
- Returns:
true if the input event was handled, false otherwise.
-
virtual void OnViewAttached(HPS::View const &in_attached_view)
This function is called whenever a view is attached to this operator.
- Parameters:
in_attached_view – The view attached to this operator.
-
virtual void OnViewDetached(HPS::View const &in_attached_view)
This function is called whenever a view is detached from this operator.
- Parameters:
in_detached_view – The view detached from this operator.
-
void SetReferenceSegment(HPS::KeyPath const &in_path_to_segment)
Sets a key path to the segment used as a reference. All rotations use the transformed bounding of the segment pointed to by the path provided in order to correctly position the camera. By default the reference segment is the View segment.
- Parameters:
in_path_to_segment – the key path to the segment to rotate around.
-
void SetReferenceSegment(HPS::KeyPathArray const &in_path_to_segments)
Sets a group of key paths to segments to be used as a reference. All rotations happen around the combined bounding box of the reference segments, taking into account transformation sets along their key paths By default the reference segment is the View segment.
- Parameters:
in_path_to_segments – the key paths to the segments to rotate around.
-
void SetTransitionTime(HPS::Time const &in_time)
Sets how long the navigation cube will take to complete a transition when a user clicks on one of its faces.
- Parameters:
in_time – how long the navigation cube will take to complete a transition when a user clicks on one of its faces. Specified in seconds.
- Returns:
A reference to this object. By default the navigation cube will take 0.5 seconds to complete transitions.
-
HPS::KeyPathArray ShowReferenceSegment()
Returns the key paths to the segments used as a reference for rotations By default the reference segment is the View segment.
- Returns:
the key paths to segments the navigation cube rotates around.
-
inline ~NavigationCubeOperator()
-
HPS::Time GetTransitionTime() const