Tool to create specific selections (sets of primitives) for Shapes from Topology. These Selections may be used in dynamic selection Mechanism Given a Shape and a mode of selection (selection of vertices, edges,faces ...) , This Tool Computes corresponding sensitive primitives, puts them in an entity called Selection (see package SelectMgr) and returns it. More...

#include <StdSelect_BRepSelectionTool.hxx>

Static Public Member Functions
static void	Load (const occ::handle< SelectMgr_Selection > &aSelection, const TopoDS_Shape &aShape, const TopAbs_ShapeEnum aType, const double theDeflection, const double theDeviationAngle, const bool AutoTriangulation=true, const int aPriority=-1, const int NbPOnEdge=9, const double MaximalParameter=500)
	Decomposition of <aShape> into sensitive entities following a mode of decomposition <aType>. These entities are stored in <aSelection>. BrepOwners are created to store the identity of the picked shapes during the selection process. In those BRepOwners is also stored the original shape. But One can't get the selectable object which was decomposed to give the sensitive entities. maximal parameter is used for infinite objects, to limit the sensitive Domain.... If AutoTriangulation = True, a Triangulation will be computed for faces which have no existing one. if AutoTriangulation = False the old algorithm will be called to compute sensitive entities on faces.

static void	Load (const occ::handle< SelectMgr_Selection > &aSelection, const occ::handle< SelectMgr_SelectableObject > &Origin, const TopoDS_Shape &aShape, const TopAbs_ShapeEnum aType, const double theDeflection, const double theDeviationAngle, const bool AutoTriangulation=true, const int aPriority=-1, const int NbPOnEdge=9, const double MaximalParameter=500)
	Same functionalities. The only difference is that the selectable object from which the selection comes is stored in each Sensitive EntityOwner; decomposition of <aShape> into sensitive entities following a mode of decomposition <aType>. These entities are stored in <aSelection> The Major difference is that the known users are first inserted in the BRepOwners. the original shape is the last user... (see EntityOwner from SelectBasics and BrepOwner)...

static int	GetStandardPriority (const TopoDS_Shape &theShape, const TopAbs_ShapeEnum theType)
	Returns the standard priority of the shape aShap having the type aType. This priority is passed to a StdSelect_BRepOwner object. You can use the function Load to modify the selection priority of an owner to make one entity more selectable than another one.

static void	ComputeSensitive (const TopoDS_Shape &theShape, const occ::handle< SelectMgr_EntityOwner > &theOwner, const occ::handle< SelectMgr_Selection > &theSelection, const double theDeflection, const double theDeflAngle, const int theNbPOnEdge, const double theMaxiParam, const bool theAutoTriang=true)
	Computes the sensitive primitives, stores them in the SelectMgr_Selection object, and returns this object.

static bool	GetSensitiveForFace (const TopoDS_Face &theFace, const occ::handle< SelectMgr_EntityOwner > &theOwner, NCollection_Sequence< occ::handle< Select3D_SensitiveEntity > > &theOutList, const bool theAutoTriang=true, const int theNbPOnEdge=9, const double theMaxiParam=500, const bool theInteriorFlag=true)
	Creates the 3D sensitive entities for Face selection.

static bool	GetSensitiveForCylinder (const NCollection_IndexedMap< TopoDS_Shape, TopTools_ShapeMapHasher > &theSubfacesMap, const occ::handle< SelectMgr_EntityOwner > &theOwner, const occ::handle< SelectMgr_Selection > &theSelection)
	Creates a sensitive cylinder.

static void	GetEdgeSensitive (const TopoDS_Shape &theShape, const occ::handle< SelectMgr_EntityOwner > &theOwner, const occ::handle< SelectMgr_Selection > &theSelection, const double theDeflection, const double theDeviationAngle, const int theNbPOnEdge, const double theMaxiParam, occ::handle< Select3D_SensitiveEntity > &theSensitive)
	Create a sensitive edge or sensitive wire.

static void	PreBuildBVH (const occ::handle< SelectMgr_Selection > &theSelection)
	Traverses the selection given and pre-builds BVH trees for heavyweight sensitive entities containing more than BVH_PRIMITIVE_LIMIT (defined in .cxx file) sub-elements.

Detailed Description

Tool to create specific selections (sets of primitives) for Shapes from Topology. These Selections may be used in dynamic selection Mechanism Given a Shape and a mode of selection (selection of vertices, edges,faces ...) , This Tool Computes corresponding sensitive primitives, puts them in an entity called Selection (see package SelectMgr) and returns it.

A Priority for the decomposed pickable objects can be given ; by default There is A Preset Hierarchy: Vertex priority : 5 Edge priority : 4 Wire priority : 3 Face priority : 2 Shell,solid,shape priority : 1 the default priority in the following methods has no sense - it's only taken in account when the user gives a value between 0 and 10. IMPORTANT : This decomposition creates BRepEntityOwner instances (from StdSelect). which are stored in the Sensitive Entities coming from The Decomposition.

the result of picking in a ViewerSelector return EntityOwner from SelectMgr; to know what kind of object was picked :

ENTITY_OWNER -> Selectable() gives the selectableobject which was decomposed into pickable elements. occ::down_cast<StdSelect_BRepOwner>(ENTITY_OWNER) -> Shape() gives the real picked shape (edge,vertex,shape...)

Member Function Documentation

◆ ComputeSensitive()

static void StdSelect_BRepSelectionTool::ComputeSensitive	(	const TopoDS_Shape &	theShape,
		const occ::handle< SelectMgr_EntityOwner > &	theOwner,
		const occ::handle< SelectMgr_Selection > &	theSelection,
		const double	theDeflection,
		const double	theDeflAngle,
		const int	theNbPOnEdge,
		const double	theMaxiParam,
		const bool	theAutoTriang = true )

static

Computes the sensitive primitives, stores them in the SelectMgr_Selection object, and returns this object.

Parameters

[in]	theShape	shape to compute sensitive entities
[in]	theOwner	selectable owner object
[in]	theSelection	selection to append new sensitive entities
[in]	theDeflection	linear deflection
[in]	theDeflAngle	angular deflection
[in]	theNbPOnEdge	sensitivity parameters for edges and wires
[in]	theMaxiParam	sensitivity parameters for infinite objects (the default value is 500)
[in]	theAutoTriang	flag to compute triangulation for the faces which have none

◆ GetEdgeSensitive()

static void StdSelect_BRepSelectionTool::GetEdgeSensitive	(	const TopoDS_Shape &	theShape,
		const occ::handle< SelectMgr_EntityOwner > &	theOwner,
		const occ::handle< SelectMgr_Selection > &	theSelection,
		const double	theDeflection,
		const double	theDeviationAngle,
		const int	theNbPOnEdge,
		const double	theMaxiParam,
		occ::handle< Select3D_SensitiveEntity > &	theSensitive )

static

Create a sensitive edge or sensitive wire.

Parameters

[in]	theShape	either TopoDS_Edge or TopoDS_Wire to compute sensitive entities
[in]	theOwner	selectable owner object
[in]	theSelection	selection to append new sensitive entities
[in]	theDeflection	linear deflection
[in]	theDeviationAngle	angular deflection
[in]	theNbPOnEdge	sensitivity parameters
[out]	theMaxiParam	sensitivity parameters

◆ GetSensitiveForCylinder()

static bool StdSelect_BRepSelectionTool::GetSensitiveForCylinder	(	const NCollection_IndexedMap< TopoDS_Shape, TopTools_ShapeMapHasher > &	theSubfacesMap,
		const occ::handle< SelectMgr_EntityOwner > &	theOwner,
		const occ::handle< SelectMgr_Selection > &	theSelection )

static

Creates a sensitive cylinder.

Parameters

[in]	theSubfacesMap	map of cylinder faces
[in]	theOwner	selectable owner object
[in]	theSelection	selection to append new sensitive entities

◆ GetSensitiveForFace()

static bool StdSelect_BRepSelectionTool::GetSensitiveForFace	(	const TopoDS_Face &	theFace,
		const occ::handle< SelectMgr_EntityOwner > &	theOwner,
		NCollection_Sequence< occ::handle< Select3D_SensitiveEntity > > &	theOutList,
		const bool	theAutoTriang = true,
		const int	theNbPOnEdge = 9,
		const double	theMaxiParam = 500,
		const bool	theInteriorFlag = true )

static

Creates the 3D sensitive entities for Face selection.

Parameters

[in]	theFace	face to compute sensitive entities
[in]	theOwner	selectable owner object
[out]	theOutList	output result list to append created entities
[in]	theAutoTriang	obsolete flag (has no effect)
[in]	theNbPOnEdge	sensitivity parameters
[in]	theMaxiParam	sensitivity parameters
[in]	theInteriorFlag	flag indicating that face interior (TRUE) or face boundary (FALSE) should be selectable

◆ GetStandardPriority()

static int StdSelect_BRepSelectionTool::GetStandardPriority	(	const TopoDS_Shape &	theShape,
		const TopAbs_ShapeEnum	theType )

inlinestatic

Returns the standard priority of the shape aShap having the type aType. This priority is passed to a StdSelect_BRepOwner object. You can use the function Load to modify the selection priority of an owner to make one entity more selectable than another one.

◆ Load() [1/2]

static void StdSelect_BRepSelectionTool::Load	(	const occ::handle< SelectMgr_Selection > &	aSelection,
		const occ::handle< SelectMgr_SelectableObject > &	Origin,
		const TopoDS_Shape &	aShape,
		const TopAbs_ShapeEnum	aType,
		const double	theDeflection,
		const double	theDeviationAngle,
		const bool	AutoTriangulation = true,
		const int	aPriority = -1,
		const int	NbPOnEdge = 9,
		const double	MaximalParameter = 500 )

static

Same functionalities. The only difference is that the selectable object from which the selection comes is stored in each Sensitive EntityOwner; decomposition of <aShape> into sensitive entities following a mode of decomposition <aType>. These entities are stored in <aSelection> The Major difference is that the known users are first inserted in the BRepOwners. the original shape is the last user... (see EntityOwner from SelectBasics and BrepOwner)...

◆ Load() [2/2]

static void StdSelect_BRepSelectionTool::Load	(	const occ::handle< SelectMgr_Selection > &	aSelection,
		const TopoDS_Shape &	aShape,
		const TopAbs_ShapeEnum	aType,
		const double	theDeflection,
		const double	theDeviationAngle,
		const bool	AutoTriangulation = true,
		const int	aPriority = -1,
		const int	NbPOnEdge = 9,
		const double	MaximalParameter = 500 )

static

Decomposition of <aShape> into sensitive entities following a mode of decomposition <aType>. These entities are stored in <aSelection>. BrepOwners are created to store the identity of the picked shapes during the selection process. In those BRepOwners is also stored the original shape. But One can't get the selectable object which was decomposed to give the sensitive entities. maximal parameter is used for infinite objects, to limit the sensitive Domain.... If AutoTriangulation = True, a Triangulation will be computed for faces which have no existing one. if AutoTriangulation = False the old algorithm will be called to compute sensitive entities on faces.

◆ PreBuildBVH()

static void StdSelect_BRepSelectionTool::PreBuildBVH ( const occ::handle< SelectMgr_Selection > & theSelection )

static

Traverses the selection given and pre-builds BVH trees for heavyweight sensitive entities containing more than BVH_PRIMITIVE_LIMIT (defined in .cxx file) sub-elements.

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

StdSelect_BRepSelectionTool.hxx

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ ComputeSensitive()

◆ GetEdgeSensitive()

◆ GetSensitiveForCylinder()

◆ GetSensitiveForFace()

◆ GetStandardPriority()

◆ Load() [1/2]

◆ Load() [2/2]

◆ PreBuildBVH()