Hoops Visualize HPS  version 2018-SP2
Hoops Visualize HPS 3D Rendering Engine
Looking for a senior C++ dev?
I'm looking for work. Hire me!
HPS::AxisTriadControl Class Reference

The AxisTriadControl allows you to turn on or off the axis triad, move it to a specific corner of the screen, change the material palette used to style it, or otherwise manipulate it. More...

#include <sprk.h>

Inheritance diagram for HPS::AxisTriadControl:
Collaboration diagram for HPS::AxisTriadControl:

Public Types

enum  Location {
  Location::TopRight,
  Location::TopLeft,
  Location::BottomRight,
  Location::BottomLeft,
  Location::Custom
}
 

Public Member Functions

 AxisTriadControl (View const &in_view)
 Initializes a control tied to the view in_view. More...
 
 AxisTriadControl (AxisTriadControl const &in_that)
 Initializes a control tied to the same object as in_that. More...
 
 AxisTriadControl (AxisTriadControl &&in_that)
 The move constructor creates a AxisTriadControl by transferring the underlying impl of the rvalue reference to this AxisTriadControl thereby avoiding a copy and allocation. More...
 
AxisTriadControloperator= (AxisTriadControl &&in_that)
 The move assignment operator transfers the underlying impl of the rvalue reference to this AxisTriadControl thereby avoiding a copy. More...
 
 ~AxisTriadControl ()
 Releases a reference to the database object this control is tied to. More...
 
HPS::Type ObjectType () const
 
AxisTriadControloperator= (AxisTriadControl const &in_that)
 Share the smart-pointer. More...
 
HPS::AxisTriadControlSetLocation (Location in_location, HPS::Rectangle const &in_position=HPS::Rectangle(), HPS::IntRectangle in_offsets=HPS::IntRectangle::Zero())
 Sets the location of this axis triad. More...
 
Location GetLocation () const
 Gets the location of the axis triad. More...
 
AxisTriadControlSetPosition (HPS::Rectangle const &in_position)
 Sets the position of the subwindow containing the axis triad. More...
 
HPS::Rectangle GetPosition () const
 Gets the position of the subwindow containing the axis triad. More...
 
AxisTriadControlSetPositionOffsets (HPS::IntRectangle const &in_offsets)
 Sets the position of the subwindow containing this axis triad. More...
 
HPS::IntRectangle GetPositionOffsets () const
 Gets the poition of the subwindow containing the axis triad. More...
 
HPS::AxisTriadControlSetVisibility (bool in_visibility)
 Sets the visibility of this axis triad. More...
 
bool GetVisibility () const
 Gets the visibility of the axis triad. More...
 
HPS::AxisTriadControlSetTextVisibility (bool in_text_visibility)
 Sets the text visibility of this axis triad. More...
 
bool GetTextVisibility () const
 Gets the text visibility of the axis triad. More...
 
HPS::AxisTriadControlSetMaterialPalette (char const *in_material_palette)
 Sets the material palette of this axis triad. More...
 
HPS::UTF8 GetMaterialPalette () const
 Gets the material palette used for this axis triad. More...
 
HPS::AxisTriadControlSetInteractivity (bool in_interactivity)
 Sets the interactivity of this axis triad. More...
 
bool GetInteractivity () const
 Gets the interactivity of this axis triad. More...
 
AxisTriadControlSetSize (float in_size)
 Sets the size of the subwindow containing the axis triad, as a percentage of the main window. More...
 
float GetSize () const
 Gets the size of the subwindow containing the axis triad, as a percentage of the main window. More...
 
HPS::SegmentKey GetSegmentKey () const
 Gets the segment where this axis triad resides. More...
 
virtual HPS::Type Type () const
 This function returns the true type of the underlying object. More...
 
virtual bool Empty () const
 Indicates whether this object has any values set on it. More...
 
virtual void Reset ()
 Resets this object to its initial, uninitialized state. More...
 
bool HasType (HPS::Type in_mask) const
 This function indicates whether this Object has the given Type mask. More...
 
intptr_t GetClassID () const
 Returns a unique identifier that is shared by all objects of the same class. More...
 
intptr_t GetInstanceID () const
 Returns an identifier that can be used to identify which instance of a class an object is. More...
 

Static Public Member Functions

template<typename T >
static intptr_t ClassID ()
 Unique identifier for this class. More...
 

Static Public Attributes

static const HPS::Type staticType = HPS::Type::AxisTriadControl
 

Private Member Functions

 AxisTriadControl ()
 Private default constructor to prevent instantiation without a view. More...
 
HPS::SegmentKey GetAxisTriadSegment () const
 Returns the axis triad segment key. More...
 

Detailed Description

The AxisTriadControl allows you to turn on or off the axis triad, move it to a specific corner of the screen, change the material palette used to style it, or otherwise manipulate it.

Member Enumeration Documentation

◆ Location

Enumerator
TopRight 

Position Axis Triad on the top right corner.

TopLeft 

Position Axis Triad on the top left corner.

BottomRight 

Position Axis Triad on the bottom right corner.

BottomLeft 

Position Axis Triad on the bottom left corner.

Custom 

Position Axis Triad at a custom location.

Constructor & Destructor Documentation

◆ AxisTriadControl() [1/4]

HPS::AxisTriadControl::AxisTriadControl ( View const &  in_view)
explicit

Initializes a control tied to the view in_view.

◆ AxisTriadControl() [2/4]

HPS::AxisTriadControl::AxisTriadControl ( AxisTriadControl const &  in_that)

Initializes a control tied to the same object as in_that.

◆ AxisTriadControl() [3/4]

HPS::AxisTriadControl::AxisTriadControl ( AxisTriadControl &&  in_that)

The move constructor creates a AxisTriadControl by transferring the underlying impl of the rvalue reference to this AxisTriadControl thereby avoiding a copy and allocation.

Parameters
in_thatAn rvalue reference to a AxisTriadControl to take the impl from.

◆ ~AxisTriadControl()

HPS::AxisTriadControl::~AxisTriadControl ( )

Releases a reference to the database object this control is tied to.

◆ AxisTriadControl() [4/4]

HPS::AxisTriadControl::AxisTriadControl ( )
inlineprivate

Private default constructor to prevent instantiation without a view.

Member Function Documentation

◆ ClassID()

template<typename T >
static intptr_t HPS::Object::ClassID ( )
inlinestaticinherited

Unique identifier for this class.

Note: this method uses construction of static objects. If used in a constructor, it should be used in the body not the initializer list.

◆ Empty()

virtual bool HPS::Object::Empty ( ) const
inlinevirtualinherited

Indicates whether this object has any values set on it.

Returns
true if no values are set on this object, false otherwise.

Reimplemented in HPS::STL::ImportResultsKit, HPS::STL::ImportOptionsKit, HPS::OBJ::ImportResultsKit, HPS::OBJ::ImportOptionsKit, HPS::Hardcopy::File::ExportOptionsKit, HPS::Stream::ExportOptionsKit, HPS::Stream::ImportResultsKit, HPS::Stream::ImportOptionsKit, HPS::PointCloud::ImportOptionsKit, HPS::PointCloud::ImportResultsKit, HPS::UpdateOptionsKit, HPS::HighlightSearchOptionsKit, HPS::HighlightOptionsKit, HPS::SelectionOptionsKit, HPS::SearchOptionsKit, HPS::CutGeometryGatheringOptionsKit, HPS::ShapeKit, HPS::ShaderKit, HPS::Shader::ImportOptionsKit, HPS::ImageKit, HPS::Image::ImportOptionsKit, HPS::Image::ExportOptionsKit, HPS::TextureOptionsKit, HPS::LinePatternKit, HPS::LinePatternParallelKit, HPS::LinePatternOptionsKit, HPS::GlyphKit, HPS::ApplicationWindowOptionsKit, HPS::OffScreenWindowOptionsKit, HPS::StandAloneWindowOptionsKit, HPS::GridKit, HPS::PolygonKit, HPS::MeshKit, HPS::ShellKit, HPS::ShellRelationResultsKit, HPS::ShellRelationOptionsKit, HPS::ShellOptimizationOptionsKit, HPS::TextKit, HPS::EllipticalArcKit, HPS::EllipseKit, HPS::TrimKit, HPS::NURBSSurfaceKit, HPS::NURBSCurveKit, HPS::SpotlightKit, HPS::InfiniteLineKit, HPS::CuttingSectionKit, HPS::CircularWedgeKit, HPS::CircularArcKit, HPS::CircleKit, HPS::SphereKit, HPS::CylinderKit, HPS::DistantLightKit, HPS::MarkerKit, HPS::LineKit, HPS::AttributeLockKit, HPS::FontInfoState, HPS::WindowInfoKit, HPS::DebuggingKit, HPS::SubwindowKit, HPS::ContourLineKit, HPS::VisualEffectsKit, HPS::TransformMaskKit, HPS::PostProcessEffectsKit, HPS::DrawingAttributeKit, HPS::HiddenLineAttributeKit, HPS::PerformanceKit, HPS::NURBSSurfaceAttributeKit, HPS::MaterialKit, HPS::MaterialMappingKit, HPS::MatrixKit, HPS::CurveAttributeKit, HPS::EdgeAttributeKit, HPS::LineAttributeKit, HPS::TextAttributeKit, HPS::CuttingSectionAttributeKit, HPS::CylinderAttributeKit, HPS::LightingAttributeKit, HPS::SphereAttributeKit, HPS::MarkerAttributeKit, HPS::CullingKit, HPS::ColorInterpolationKit, HPS::TransparencyKit, HPS::SelectabilityKit, HPS::CameraKit, HPS::VisibilityKit, HPS::BoundingKit, HPS::SegmentOptimizationOptionsKit, HPS::Publish::ExportOptionsKit, HPS::Publish::TextFieldKit, HPS::Publish::SignatureFieldKit, HPS::Publish::DropDownListKit, HPS::Exchange::TessellationOptionsKit, HPS::Publish::ListBoxKit, HPS::Exchange::ExportSTEPOptionsKit, HPS::Exchange::ExportParasolidOptionsKit, HPS::Publish::RadioButtonKit, HPS::Exchange::ExportIGESOptionsKit, HPS::Exchange::ExportXMLOptionsKit, HPS::Publish::CheckBoxKit, HPS::Exchange::ExportU3DOptionsKit, HPS::Exchange::ExportSTLOptionsKit, HPS::Publish::ButtonKit, HPS::Exchange::ExportPRCOptionsKit, HPS::Publish::LinkKit, HPS::Exchange::ExportJTOptionsKit, HPS::Publish::SlideTableKit, HPS::Exchange::ExportACISOptionsKit, HPS::Publish::TableKit, HPS::Exchange::Export3MFOptionsKit, HPS::Publish::ImageKit, HPS::Publish::TextKit, HPS::Exchange::ModelFileImportOptionsKit, HPS::Publish::ViewKit, HPS::Exchange::TranslationOptionsKit, HPS::Publish::ArtworkKit, HPS::Publish::AnnotationKit, HPS::ComponentPath, HPS::Exchange::ImportOptionsKit, HPS::Parasolid::ExportOptionsKit, HPS::Exchange::NURBSConversionOptionsKit, HPS::Parasolid::LineTessellationKit, HPS::Exchange::Configuration, HPS::Publish::PageKit, HPS::Parasolid::FacetTessellationKit, HPS::Publish::DocumentKit, HPS::Parasolid::ImportOptionsKit, HPS::DWG::ImportOptionsKit, HPS::OOC::ImportOptionsKit, HPS::Sketchup::ImportOptionsKit, and HPS::Sketchup::ImportResultsKit.

◆ GetAxisTriadSegment()

HPS::SegmentKey HPS::AxisTriadControl::GetAxisTriadSegment ( ) const
private

Returns the axis triad segment key.

◆ GetClassID()

intptr_t HPS::Object::GetClassID ( ) const
inherited

Returns a unique identifier that is shared by all objects of the same class.

Returns
A unique value shared by all objects of the same class.

◆ GetInstanceID()

intptr_t HPS::Object::GetInstanceID ( ) const
inherited

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.

Returns
A value unique to an instance of an object and all objects that are backed by the same database resource.

◆ GetInteractivity()

bool HPS::AxisTriadControl::GetInteractivity ( ) const

Gets the interactivity of this axis triad.

Returns
true if the axis triad is interactive, false otherwise.

◆ GetLocation()

Location HPS::AxisTriadControl::GetLocation ( ) const

Gets the location of the axis triad.

Returns
The location of the axis triad relative to the view.

◆ GetMaterialPalette()

HPS::UTF8 HPS::AxisTriadControl::GetMaterialPalette ( ) const

Gets the material palette used for this axis triad.

Returns
The name of the material palette used for this axis triad.

◆ GetPosition()

HPS::Rectangle HPS::AxisTriadControl::GetPosition ( ) const

Gets the position of the subwindow containing the axis triad.

Returns
The position of the subwindow containing the axis triad.

◆ GetPositionOffsets()

HPS::IntRectangle HPS::AxisTriadControl::GetPositionOffsets ( ) const

Gets the poition of the subwindow containing the axis triad.

Returns
The position of the subwindow containing the axis triad.

◆ GetSegmentKey()

HPS::SegmentKey HPS::AxisTriadControl::GetSegmentKey ( ) const

Gets the segment where this axis triad resides.

Returns
The segment key associated with this axis triad.

◆ GetSize()

float HPS::AxisTriadControl::GetSize ( ) const

Gets the size of the subwindow containing the axis triad, as a percentage of the main window.

Returns
the size of the subwindow containing the axis triad, as a percentage of the main window. If the location is Custom, this will return -1.0f.

◆ GetTextVisibility()

bool HPS::AxisTriadControl::GetTextVisibility ( ) const

Gets the text visibility of the axis triad.

Returns
true if the axis triad text is visible, false otherwise.

◆ GetVisibility()

bool HPS::AxisTriadControl::GetVisibility ( ) const

Gets the visibility of the axis triad.

Returns
true if the axis triad is visible, false otherwise.

◆ HasType()

bool HPS::Object::HasType ( HPS::Type  in_mask) const
inherited

This function indicates whether this Object has the given Type mask.

Parameters
in_maskThe Type mask to check against this Object.
Returns
true if this Object has the given Type mask, false otherwise.

◆ ObjectType()

HPS::Type HPS::AxisTriadControl::ObjectType ( ) const
inlinevirtual

Reimplemented from HPS::SprocketControl.

Here is the call graph for this function:

◆ operator=() [1/2]

AxisTriadControl& HPS::AxisTriadControl::operator= ( AxisTriadControl &&  in_that)

The move assignment operator transfers the underlying impl of the rvalue reference to this AxisTriadControl thereby avoiding a copy.

Parameters
in_thatAn rvalue reference to a AxisTriadControl to take the impl from.
Returns
A reference to this AxisTriadControl.

◆ operator=() [2/2]

AxisTriadControl& HPS::AxisTriadControl::operator= ( AxisTriadControl const &  in_that)

Share the smart-pointer.

◆ Reset()

◆ SetInteractivity()

HPS::AxisTriadControl& HPS::AxisTriadControl::SetInteractivity ( bool  in_interactivity)

Sets the interactivity of this axis triad.

When the axis triad is interactive, dragging the triad will rotate the scene. Making the Axis Triad interactive pushes the Axis Triad operator on the current View's operator stack with High priority

Parameters
in_interactivitythe interactivity of this axis triad
Returns
A reference to this object. By default the axis triad is not interactive.

◆ SetLocation()

HPS::AxisTriadControl& HPS::AxisTriadControl::SetLocation ( Location  in_location,
HPS::Rectangle const &  in_position = HPS::Rectangle(),
HPS::IntRectangle  in_offsets = HPS::IntRectangle::Zero() 
)

Sets the location of this axis triad.

Parameters
in_locationthe location of this axis triad
in_positionthe position of the subwindow containing the axis triad. only used when in_location is Custom
in_offsetsthe pixel-space rectangle to offset to the given position. only used when in_location is Custom
Returns
A reference to this object. By default the axis triad is placed on the bottom left corner of the View

◆ SetMaterialPalette()

HPS::AxisTriadControl& HPS::AxisTriadControl::SetMaterialPalette ( char const *  in_material_palette)

Sets the material palette of this axis triad.

The material palette supplied to this function should originate from a material kit array with 3 entries. The entries in the material kit array are applied to the navigation cube as follows: Entry 0 - x-axis color Entry 1 - y-axis color Entry 2 - z-axis color

Parameters
in_material_palettethe name of the material palette to be used for this axis triad
Returns
A reference to this object.

◆ SetPosition()

AxisTriadControl& HPS::AxisTriadControl::SetPosition ( HPS::Rectangle const &  in_position)

Sets the position of the subwindow containing the axis triad.

Parameters
in_positiona rectangle describing the subwindow containing the axis triad.
Returns
A reference to this object.

◆ SetPositionOffsets()

AxisTriadControl& HPS::AxisTriadControl::SetPositionOffsets ( HPS::IntRectangle const &  in_offsets)

Sets the position of the subwindow containing this axis triad.

Parameters
in_offsetsa rectangle describing the offsets being applied to the current position
Returns
A reference to this object.

◆ SetSize()

AxisTriadControl& HPS::AxisTriadControl::SetSize ( float  in_size)

Sets the size of the subwindow containing the axis triad, as a percentage of the main window.

Parameters
in_sizeThe size of the subwindow containing the axis triad, as a percentage of the main window. [0-1]
Returns
A reference to this object. By default the axis triad subwindow is 20% of the main window

◆ SetTextVisibility()

HPS::AxisTriadControl& HPS::AxisTriadControl::SetTextVisibility ( bool  in_text_visibility)

Sets the text visibility of this axis triad.

Parameters
in_text_visibilitythe visibility of the text for this axis triad
Returns
A reference to this object.

◆ SetVisibility()

HPS::AxisTriadControl& HPS::AxisTriadControl::SetVisibility ( bool  in_visibility)

Sets the visibility of this axis triad.

Parameters
in_visibilitythe visibility of this axis triad
Returns
A reference to this object. By default the axis triad is not visible

◆ Type()

Member Data Documentation

◆ staticType

const HPS::Type HPS::AxisTriadControl::staticType = HPS::Type::AxisTriadControl
static

The documentation for this class was generated from the following file: