HPS.SelectionOptionsControl Class Reference
Inheritance diagram for HPS.SelectionOptionsControl:
HPS.Control HPS.Object

Public Member Functions

override void Dispose ()
 
override HPS.Type ObjectType ()
 
 SelectionOptionsControl (HPS.WindowKey in_window)
 
 SelectionOptionsControl (HPS.SelectionOptionsControl in_that)
 
HPS.SelectionOptionsControl SetAlgorithm (HPS.Selection.Algorithm in_algorithm)
 
HPS.SelectionOptionsControl SetDeferralExtentCullingRespected (bool in_state)
 
HPS.SelectionOptionsControl SetDistanceCullingRespected (bool in_state)
 
HPS.SelectionOptionsControl SetExtentCullingRespected (bool in_state)
 
HPS.SelectionOptionsControl SetFrustumCullingRespected (bool in_state)
 
HPS.SelectionOptionsControl SetGranularity (HPS.Selection.Granularity in_granularity)
 
HPS.SelectionOptionsControl SetInternalLimit (ulong in_limit)
 
HPS.SelectionOptionsControl SetLevel (HPS.Selection.Level in_level)
 
HPS.SelectionOptionsControl SetProximity (float in_proximity)
 
HPS.SelectionOptionsControl SetRelatedLimit (ulong in_limit)
 
HPS.SelectionOptionsControl SetSorting (bool in_sorting)
 
HPS.SelectionOptionsControl SetSorting (HPS.Selection.Sorting in_sorting)
 
HPS.SelectionOptionsControl SetVectorCullingRespected (bool in_state)
 
HPS.SelectionOptionsControl SetVolumeCullingRespected (bool in_state)
 
bool ShowAlgorithm (out HPS.Selection.Algorithm out_algorithm)
 
bool ShowDeferralExtentCullingRespected (out bool out_state)
 
bool ShowDistanceCullingRespected (out bool out_state)
 
bool ShowExtentCullingRespected (out bool out_state)
 
bool ShowFrustumCullingRespected (out bool out_state)
 
bool ShowGranularity (out HPS.Selection.Granularity out_granularity)
 
bool ShowInternalLimit (out ulong out_limit)
 
bool ShowLevel (out HPS.Selection.Level out_level)
 
bool ShowProximity (out float out_proximity)
 
bool ShowRelatedLimit (out ulong out_limit)
 
bool ShowSorting (out HPS.Selection.Sorting out_sorting)
 
bool ShowVectorCullingRespected (out bool out_state)
 
bool ShowVolumeCullingRespected (out bool out_state)
 
override HPS.Type Type ()
 
HPS.SelectionOptionsControl UnsetAlgorithm ()
 
HPS.SelectionOptionsControl UnsetDeferralExtentCullingRespected ()
 
HPS.SelectionOptionsControl UnsetDistanceCullingRespected ()
 
HPS.SelectionOptionsControl UnsetEverything ()
 
HPS.SelectionOptionsControl UnsetExtentCullingRespected ()
 
HPS.SelectionOptionsControl UnsetFrustumCullingRespected ()
 
HPS.SelectionOptionsControl UnsetGranularity ()
 
HPS.SelectionOptionsControl UnsetInternalLimit ()
 
HPS.SelectionOptionsControl UnsetLevel ()
 
HPS.SelectionOptionsControl UnsetProximity ()
 
HPS.SelectionOptionsControl UnsetRelatedLimit ()
 
HPS.SelectionOptionsControl UnsetSorting ()
 
HPS.SelectionOptionsControl UnsetVectorCullingRespected ()
 
HPS.SelectionOptionsControl UnsetVolumeCullingRespected ()
 
- Public Member Functions inherited from HPS.Control
 Control (HPS.Control in_that)
 
- Public Member Functions inherited from HPS.Object
virtual bool Empty ()
 
IntPtr GetClassID ()
 
IntPtr GetInstanceID ()
 
bool HasType (HPS.Type in_mask)
 
 Object (HPS.Object that)
 
virtual void Reset ()
 

Protected Member Functions

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.SelectionOptionsControl class is a smart pointer that is tied to a database object. It is used to set selection related options on a HPS.WindowKey. Options include the selection algorithm, granularity, internal limit, related limit, level, proximity, and sorting. Default values for the various fields of HPS.SelectionOptionsControl can be found here.

Constructor & Destructor Documentation

◆ SelectionOptionsControl() [1/2]

HPS.SelectionOptionsControl.SelectionOptionsControl ( HPS.WindowKey  in_window)
inline

This constructor creates a SelectionOptionsControl object which is tied to the specified window.

Parameters
in_windowThe window which this SelectionOptionsControl should operate on.

◆ SelectionOptionsControl() [2/2]

HPS.SelectionOptionsControl.SelectionOptionsControl ( HPS.SelectionOptionsControl  in_that)
inline

The copy constructor creates a SelectionOptionsControl object that shares the underlying smart-pointer of the source SelectionOptionsControl.

Parameters
in_thatThe source SelectionOptionsControl to copy.

Member Function Documentation

◆ ObjectType()

override HPS.Type HPS.SelectionOptionsControl.ObjectType ( )
inlinevirtual

This function returns the type the object, as declared (if the object is derived, this does not give the true type of the derived object).

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

Reimplemented from HPS.Control.

◆ SetAlgorithm()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetAlgorithm ( HPS.Selection.Algorithm  in_algorithm)
inline

Sets the type of selection algorithm to use. This setting has no effect on object space selections (i.e., select by shell, volume and ray).

Parameters
in_algorithmThe type of selection algorithm to use.
Returns
A reference to this SelectionOptionsControl.
See also
Default value

◆ SetDeferralExtentCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetDeferralExtentCullingRespected ( bool  in_state)
inline

Sets whether to respect the deferral extent culling option during selection. If this value is set to false, the deferral extent culling option (see HPS.CullingControl) will be ignored.

Parameters
in_stateWhether to respect the deferral extent culling option during selection.
Returns
A reference to this SelectionOptionsControl.
See also
Default value

◆ SetDistanceCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetDistanceCullingRespected ( bool  in_state)
inline

Sets whether to respect the distance culling option during selection. If this value is set to false, the distance culling option (see HPS.CullingControl) will be ignored.

Parameters
in_stateWhether to respect the distance culling option during selection.
Returns
A reference to this SelectionOptionsControl.
See also
Default value

◆ SetExtentCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetExtentCullingRespected ( bool  in_state)
inline

Sets whether to respect the extent culling option during selection. If this value is set to false, the extent culling option (see HPS.CullingControl) will be ignored.

Parameters
in_stateWhether to respect the extent culling option during selection.
Returns
A reference to this SelectionOptionsControl.
See also
Default value

◆ SetFrustumCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetFrustumCullingRespected ( bool  in_state)
inline

Sets whether to respect the frustum culling option during selection. If this value is set to false, the frustum culling option (see HPS.CullingControl) will be ignored.

Parameters
in_stateWhether to respect the frustum culling option during selection.
Returns
A reference to this SelectionOptionsControl.
See also
Default value

◆ SetGranularity()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetGranularity ( HPS.Selection.Granularity  in_granularity)
inline

Sets the selection granularity to use.

Parameters
in_granularityThe selection granularity to use.
Returns
A reference to this SelectionOptionsControl.
See also
Default value

◆ SetInternalLimit()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetInternalLimit ( ulong  in_limit)
inline

Sets the internal selection limit. The internal selection limit is the maximum number of subentities for shells and meshes that will be returned if performing subentity selection.

Parameters
in_limitThe internal selection limit.
Returns
A reference to this SelectionOptionsControl.
See also
Default value

◆ SetLevel()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetLevel ( HPS.Selection.Level  in_level)
inline

Sets the level at which selection will occur.

Parameters
in_levelThe level at which selection will occur.
Returns
A reference to this SelectionOptionsControl.
See also
Default value

◆ SetProximity()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetProximity ( float  in_proximity)
inline

Sets the selection proximity in centimeters or object-relative-units (ORU), depending on the selection-routine being utilized. The selection proximity augments point-based or shell-based selections by also factoring in the area surrounding the selection-point or selection-shell. For HPS.SelectionControl.SelectByPoint, this specifies the radius in centimeters around the selection within which objects will be returned as selected. The value must be positive. For HPS.SelectionControl.SelectByShell, this specifies a distance in object-relative-units that determines whether a selection is performed. A positive proximity value will cause the selection algorithm to perform a selection when the distance between the two bodies is <= proximity, which means the bodies do not have to be touching in order for Visualize to perform a selection. If the proximity == 0, the bodies must be coincident or penetrating for a selection to occur. If proximity < 0, the shells must penetrate each other by at least that amount before a selection is performed. Selection proximity is not relevant for other selection types. When using HPS.SelectionControl.SelectByShell, false positives or negatives for selection may occur if the proximity and/or selection shells meet any of the following criteria:

  • The absolute value of a negative proximity is much larger than the actual intersection of the shells. An example would be a shell that represents a thin plate or a thinly-walled tube, and the specified proximity is larger than the thickness of the plate or tube.

  • Selection shells ("probes") have vertices with complex intersections

  • Selection shells ("probes") have concavities, especially multiple adjacent concavities.

Parameters
in_proximityThe radius around the selection within which objects will be returned as selected.
Returns
A reference to this SelectionOptionsKit.
See also
Default value
Collision detection proximity

◆ SetRelatedLimit()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetRelatedLimit ( ulong  in_limit)
inline

Sets the related selection limit. The related selection limit is the maximum number of items that will be returned as selected when performing a selection. A related selection limit of 0 would result in only the first item getting returned. If the value is greater than 0, this indicates the number of additional items beyond the first to return. The order of these additional items will depend on whether sorting is enabled (see SetSorting()).

Parameters
in_limitLimit on the number of items that will be returned as selected when performing a selection.
Returns
A reference to this SelectionOptionsControl.
See also
Default value
SetSorting(Selection.Sorting)

◆ SetSorting() [1/2]

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetSorting ( bool  in_sorting)
inline

Sets whether to sort selection results. This is only relevant if the related selection limit is greater than 0 (see SetRelatedLimit). Sorting works on an entity level. Subentity components like edges, vertices and faces are not sorted.

Deprecated:
This function exists for compatibility and SetSorting(Selection.Sorting) should be preferred in general usage.
Parameters
in_sortingWhether to sort selection results. A value of true is equivalent to passing Selection.Sorting.Default to SetSorting(Selection.Sorting), and a value of false is equivalent to passing Selection.Sorting.Off to SetSorting(Selection.Sorting).
Returns
A reference to this SelectionOptionsControl.
See also
Default value

◆ SetSorting() [2/2]

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetSorting ( HPS.Selection.Sorting  in_sorting)
inline

Sets how selection results will be sorted. This is only relevant if the related selection limit is greater than 0 (see SetRelatedLimit()). Sorting works on an entity level. Subentity components like edges, vertices, and faces are not sorted. This option has no effect on SelectByShell. For SelectByPoint, all values of the Selection.Sorting enum apply. Selection.Sorting.Default is an alias for Selection.Sorting.Proximity. For all other selection types, Selection.Sorting.Proximity does not apply. Selection.Sorting.Default is an alias for Selection.Sorting.ZSorting.

Parameters
in_sortingThe type of selection sorting to use.
Returns
A reference to this SelectionOptionsControl.
See also
Default value
Related limit in Programming Guide
SetRelatedLimit()

◆ SetVectorCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetVectorCullingRespected ( bool  in_state)
inline

Sets whether to respect the vector culling option during selection. If this value is set to false, the vector culling option (see HPS.CullingControl) will be ignored.

Parameters
in_stateWhether to respect the vector culling option during selection.
Returns
A reference to this SelectionOptionsControl.
See also
Default value

◆ SetVolumeCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.SetVolumeCullingRespected ( bool  in_state)
inline

Sets whether to respect the volume culling option during selection. If this value is set to false, the volume culling option (see HPS.CullingControl) will be ignored.

Parameters
in_stateWhether to respect the volume culling option during selection.
Returns
A reference to this SelectionOptionsControl.
See also
Default value

◆ ShowAlgorithm()

bool HPS.SelectionOptionsControl.ShowAlgorithm ( out HPS.Selection.Algorithm  out_algorithm)
inline

Shows the selection algorithm for the associated window.

Parameters
out_algorithmThe selection algorithm for the associated window.
Returns
true if the selection algorithm is valid, false otherwise.

◆ ShowDeferralExtentCullingRespected()

bool HPS.SelectionOptionsControl.ShowDeferralExtentCullingRespected ( out bool  out_state)
inline

Shows the deferral extent culling respected state for the associated window.

Parameters
out_stateThe deferral extent culling respected state.
Returns
true if the deferral extent culling respected state is valid, false otherwise.

◆ ShowDistanceCullingRespected()

bool HPS.SelectionOptionsControl.ShowDistanceCullingRespected ( out bool  out_state)
inline

Shows the distance culling respected state for the associated window.

Parameters
out_stateThe distance culling respected state.
Returns
true if the distance culling respected state is valid, false otherwise.

◆ ShowExtentCullingRespected()

bool HPS.SelectionOptionsControl.ShowExtentCullingRespected ( out bool  out_state)
inline

Shows the extent culling respected state for the associated window.

Parameters
out_stateThe extent culling respected state.
Returns
true if the extent culling respected state is valid, false otherwise.

◆ ShowFrustumCullingRespected()

bool HPS.SelectionOptionsControl.ShowFrustumCullingRespected ( out bool  out_state)
inline

Shows the frustum culling respected state for the associated window.

Parameters
out_stateThe frustum culling respected state.
Returns
true if the frustum culling respected state is valid, false otherwise.

◆ ShowGranularity()

bool HPS.SelectionOptionsControl.ShowGranularity ( out HPS.Selection.Granularity  out_granularity)
inline

Shows the selection granularity for the associated window.

Parameters
out_granularityThe selection granularity for the associated window.
Returns
true if the selection granularity is valid, false otherwise.

◆ ShowInternalLimit()

bool HPS.SelectionOptionsControl.ShowInternalLimit ( out ulong  out_limit)
inline

Shows the internal selection limit for the associated window.

Parameters
out_limitThe internal selection limit for the associated window.
Returns
true if the internal selection limit is valid, false otherwise.

◆ ShowLevel()

bool HPS.SelectionOptionsControl.ShowLevel ( out HPS.Selection.Level  out_level)
inline

Shows the selection level for the associated window.

Parameters
out_levelThe selection level for the associated window.
Returns
true if the level is valid, false otherwise.

◆ ShowProximity()

bool HPS.SelectionOptionsControl.ShowProximity ( out float  out_proximity)
inline

Shows the selection proximity for the associated window.

Parameters
out_proximityThe selection proximity for the associated window.
Returns
true if the proximity is valid, false otherwise.

◆ ShowRelatedLimit()

bool HPS.SelectionOptionsControl.ShowRelatedLimit ( out ulong  out_limit)
inline

Shows the related selection limit for the associated window.

Parameters
out_limitThe related selection limit for the associated window.
Returns
true if the related selection limit is valid, false otherwise.

◆ ShowSorting()

bool HPS.SelectionOptionsControl.ShowSorting ( out HPS.Selection.Sorting  out_sorting)
inline

Shows the type of selection sorting for the associated window.

Parameters
out_sortingThe type of selection sorting to use for the associated window.
Returns
true if the selection sorting type is valid, false otherwise.

◆ ShowVectorCullingRespected()

bool HPS.SelectionOptionsControl.ShowVectorCullingRespected ( out bool  out_state)
inline

Shows the vector culling respected state for the associated window.

Parameters
out_stateThe vector culling respected state.
Returns
true if the vector culling respected state is valid, false otherwise.

◆ ShowVolumeCullingRespected()

bool HPS.SelectionOptionsControl.ShowVolumeCullingRespected ( out bool  out_state)
inline

Shows the volume culling respected state for the associated window.

Parameters
out_stateThe volume culling respected state.
Returns
true if the volume culling respected state is valid, false otherwise.

◆ Type()

override HPS.Type HPS.SelectionOptionsControl.Type ( )
inlinevirtual

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.

Warning
This function must synchronize the database (by waiting for all pending database operations to complete) in order to know the type status of this object with certainty. Therefore this function can negatively impact performance. You should vigorously avoid using this function in high-traffic or peformance-critical areas of your code.
Returns
The true type of the object in question.

Reimplemented from HPS.Control.

◆ UnsetAlgorithm()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetAlgorithm ( )
inline

Removes the Algorithm setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetDeferralExtentCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetDeferralExtentCullingRespected ( )
inline

Removes the Deferral Culling setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetDistanceCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetDistanceCullingRespected ( )
inline

Removes the distance Culling setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetEverything()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetEverything ( )
inline

Removes all settings from this control. If the control is attached to a WindowKey this function restores the default settings of this control as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetExtentCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetExtentCullingRespected ( )
inline

Removes the Extent Culling setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetFrustumCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetFrustumCullingRespected ( )
inline

Removes the Frustum Culling setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetGranularity()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetGranularity ( )
inline

Removes the Granularity setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetInternalLimit()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetInternalLimit ( )
inline

Removes the Internal Limit setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetLevel()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetLevel ( )
inline

Removes the Selection Level setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetProximity()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetProximity ( )
inline

Removes the Proximity setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetRelatedLimit()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetRelatedLimit ( )
inline

Removes the Related Limit setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetSorting()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetSorting ( )
inline

Removes the Sorting setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetVectorCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetVectorCullingRespected ( )
inline

Removes the Vector Culling setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

◆ UnsetVolumeCullingRespected()

HPS.SelectionOptionsControl HPS.SelectionOptionsControl.UnsetVolumeCullingRespected ( )
inline

Removes the Volume Culling setting from this control. If the control is attached to a WindowKey this function restores the default setting as specified by SelectionOptionsKit.GetDefault().

Returns
A reference to this object.

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