This class allows the definition a graphic object. This graphic structure can be displayed, erased, or highlighted. This graphic structure can be connected with another graphic structure. More...

#include <Graphic3d_Structure.hxx>

Inheritance diagram for Graphic3d_Structure:

[legend]

Public Member Functions
	Graphic3d_Structure (const Handle< Graphic3d_StructureManager > &theManager, const Handle< Graphic3d_Structure > &theLinkPrs=Handle< Graphic3d_Structure >())
	Creates a graphic object in the manager theManager. It will appear in all the views of the visualiser. The structure is not displayed when it is created. More...

virtual void	Clear (const Standard_Boolean WithDestruction=Standard_True)
	if WithDestruction == Standard_True then suppress all the groups of primitives in the structure. and it is mandatory to create a new group in <me>. if WithDestruction == Standard_False then clears all the groups of primitives in the structure. and all the groups are conserved and empty. They will be erased at the next screen update. The structure itself is conserved. The transformation and the attributes of <me> are conserved. The childs of <me> are conserved. More...

virtual	~Graphic3d_Structure ()
	Suppresses the structure <me>. It will be erased at the next screen update. More...

virtual void	Display ()
	Displays the structure <me> in all the views of the visualiser. More...

Graphic3d_DisplayPriority	DisplayPriority () const
	Returns the current display priority for this structure. More...

void	SetDisplayPriority (const Graphic3d_DisplayPriority thePriority)
	Modifies the order of displaying the structure. Values are between 0 and 10. Structures are drawn according to their display priorities in ascending order. A structure of priority 10 is displayed the last and appears over the others. The default value is 5. Warning: If structure is displayed then the SetDisplayPriority method erases it and displays with the new priority. Raises Graphic3d_PriorityDefinitionError if Priority is greater than 10 or a negative value. More...

void	SetDisplayPriority (const Standard_Integer thePriority)

void	ResetDisplayPriority ()
	Reset the current priority of the structure to the previous priority. Warning: If structure is displayed then the SetDisplayPriority() method erases it and displays with the previous priority. More...

virtual void	Erase ()
	Erases this structure in all the views of the visualiser. More...

void	Highlight (const Handle< Graphic3d_PresentationAttributes > &theStyle, const Standard_Boolean theToUpdateMgr=Standard_True)
	Highlights the structure in all the views with the given style. More...

void	Remove ()
	Suppress the structure <me>. It will be erased at the next screen update. Warning: No more graphic operations in <me> after this call. Category: Methods to modify the class definition. More...

virtual void	CalculateBoundBox ()
	Computes axis-aligned bounding box of a structure. More...

void	SetInfiniteState (const Standard_Boolean theToSet)
	Sets infinite flag. When TRUE, the MinMaxValues method returns: theXMin = theYMin = theZMin = RealFirst(). theXMax = theYMax = theZMax = RealLast(). By default, structure is created not infinite but empty. More...

void	SetZLayer (const Graphic3d_ZLayerId theLayerId)
	Set Z layer ID for the structure. The Z layer mechanism allows to display structures presented in higher layers in overlay of structures in lower layers by switching off z buffer depth test between layers. More...

Graphic3d_ZLayerId	GetZLayer () const
	Get Z layer ID of displayed structure. The method returns -1 if the structure has no ID (deleted from graphic driver). More...

void	SetClipPlanes (const Handle< Graphic3d_SequenceOfHClipPlane > &thePlanes)
	Changes a sequence of clip planes slicing the structure on rendering. More...

const Handle< Graphic3d_SequenceOfHClipPlane > &	ClipPlanes () const
	Get clip planes slicing the structure on rendering. More...

void	SetVisible (const Standard_Boolean AValue)
	Modifies the visibility indicator to Standard_True or Standard_False for the structure <me>. The default value at the definition of <me> is Standard_True. More...

virtual void	SetVisual (const Graphic3d_TypeOfStructure AVisual)
	Modifies the visualisation mode for the structure <me>. More...

void	SetZoomLimit (const Standard_Real LimitInf, const Standard_Real LimitSup)
	Modifies the minimum and maximum zoom coefficients for the structure <me>. The default value at the definition of <me> is unlimited. Category: Methods to modify the class definition Warning: Raises StructureDefinitionError if <LimitInf> is greater than <LimitSup> or if <LimitInf> or <LimitSup> is a negative value. More...

void	SetIsForHighlight (const Standard_Boolean isForHighlight)
	Marks the structure <me> representing wired structure needed for highlight only so it won't be added to BVH tree. More...

void	UnHighlight ()
	Suppresses the highlight for the structure <me> in all the views of the visualiser. More...

virtual void	Compute ()

virtual void	computeHLR (const Handle< Graphic3d_Camera > &theProjector, Handle< Graphic3d_Structure > &theStructure)
	Returns the new Structure defined for the new visualization. More...

void	ReCompute ()
	Forces a new construction of the structure <me> if <me> is displayed and TOS_COMPUTED. More...

void	ReCompute (const Handle< Graphic3d_DataStructureManager > &aProjector)
	Forces a new construction of the structure <me> if <me> is displayed in <aProjetor> and TOS_COMPUTED. More...

const Graphic3d_SequenceOfGroup &	Groups () const
	Returns the groups sequence included in this structure. More...

Standard_Integer	NumberOfGroups () const
	Returns the current number of groups in this structure. More...

Handle< Graphic3d_Group >	NewGroup ()
	Append new group to this structure. More...

Handle< Graphic3d_Group >	CurrentGroup ()
	Returns the last created group or creates new one if list is empty. More...

const Handle< Graphic3d_PresentationAttributes > &	HighlightStyle () const
	Returns the highlight attributes. More...

Standard_Boolean	IsDeleted () const
	Returns TRUE if this structure is deleted (after Remove() call). More...

virtual Standard_Boolean	IsDisplayed () const
	Returns the display indicator for this structure. More...

Standard_Boolean	IsEmpty () const
	Returns Standard_True if the structure <me> is empty. Warning: A structure is empty if : it do not have group or all the groups are empties and it do not have descendant or all the descendants are empties. More...

Standard_Boolean	IsInfinite () const
	Returns Standard_True if the structure <me> is infinite. More...

virtual Standard_Boolean	IsHighlighted () const
	Returns the highlight indicator for this structure. More...

Standard_Boolean	IsTransformed () const
	Returns TRUE if the structure is transformed. More...

Standard_Boolean	IsVisible () const
	Returns the visibility indicator for this structure. More...

Bnd_Box	MinMaxValues (const Standard_Boolean theToIgnoreInfiniteFlag=Standard_False) const
	Returns the coordinates of the boundary box of the structure <me>. If <theToIgnoreInfiniteFlag> is TRUE, the method returns actual graphical boundaries of the Graphic3d_Group components. Otherwise, the method returns boundaries taking into account infinite state of the structure. This approach generally used for application specific fit operation (e.g. fitting the model into screen, not taking into account infinite helper elements). Warning: If the structure <me> is empty then the empty box is returned, If the structure <me> is infinite then the whole box is returned. More...

Graphic3d_TypeOfStructure	Visual () const
	Returns the visualisation mode for the structure <me>. More...

void	Ancestors (Graphic3d_MapOfStructure &SG) const
	Returns the group of structures to which <me> is connected. More...

void	Connect (Graphic3d_Structure *theStructure, Graphic3d_TypeOfConnection theType, Standard_Boolean theWithCheck=Standard_False)
	If Atype is TOC_DESCENDANT then add <AStructure> as a child structure of <me>. If Atype is TOC_ANCESTOR then add <AStructure> as a parent structure of <me>. The connection propagates Display, Highlight, Erase, Remove, and stacks the transformations. No connection if the graph of the structures contains a cycle and <WithCheck> is Standard_True;. More...

void	Connect (const Handle< Graphic3d_Structure > &thePrs)

void	Descendants (Graphic3d_MapOfStructure &SG) const
	Returns the group of structures connected to <me>. More...

void	Disconnect (Graphic3d_Structure *theStructure)
	Suppress the connection between <AStructure> and <me>. More...

void	Remove (const Handle< Graphic3d_Structure > &thePrs)

void	DisconnectAll (const Graphic3d_TypeOfConnection AType)
	If Atype is TOC_DESCENDANT then suppress all the connections with the child structures of <me>. If Atype is TOC_ANCESTOR then suppress all the connections with the parent structures of <me>. More...

void	RemoveAll ()

void	SetOwner (const Standard_Address theOwner)

Standard_Address	Owner () const

void	SetHLRValidation (const Standard_Boolean theFlag)

Standard_Boolean	HLRValidation () const
	Hidden parts stored in this structure are valid if: 1) the owner is defined. 2) they are not invalid. More...

const Handle< TopLoc_Datum3D > &	Transformation () const
	Return local transformation. More...

void	SetTransformation (const Handle< TopLoc_Datum3D > &theTrsf)
	Modifies the current local transformation. More...

void	SetTransformPersistence (const Handle< Graphic3d_TransformPers > &theTrsfPers)
	Modifies the current transform persistence (pan, zoom or rotate) More...

const Handle< Graphic3d_TransformPers > &	TransformPersistence () const

void	SetMutable (const Standard_Boolean theIsMutable)
	Sets if the structure location has mutable nature (content or location will be changed regularly). More...

Standard_Boolean	IsMutable () const
	Returns true if structure has mutable nature (content or location are be changed regularly). Mutable structure will be managed in different way than static onces. More...

Graphic3d_TypeOfStructure	ComputeVisual () const

void	GraphicClear (const Standard_Boolean WithDestruction)
	Clears the structure <me>. More...

void	GraphicConnect (const Handle< Graphic3d_Structure > &theDaughter)

void	GraphicDisconnect (const Handle< Graphic3d_Structure > &theDaughter)

void	GraphicTransform (const Handle< TopLoc_Datum3D > &theTrsf)
	Internal method which sets new transformation without calling graphic manager callbacks. More...

Standard_Integer	Identification () const
	Returns the identification number of this structure. More...

void	Remove (Graphic3d_Structure *thePtr, const Graphic3d_TypeOfConnection theType)
	Suppress the structure in the list of descendants or in the list of ancestors. More...

void	SetComputeVisual (const Graphic3d_TypeOfStructure theVisual)

const Handle< Graphic3d_CStructure > &	CStructure () const
	Returns the low-level structure. More...

virtual void	DumpJson (Standard_OStream &theOStream, Standard_Integer theDepth=-1) const
	Dumps the content of me into the stream. More...

Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor. More...

	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing. More...

Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter. More...

virtual	~Standard_Transient ()
	Destructor must be virtual. More...

virtual void	Delete () const
	Memory deallocator for transient classes. More...

virtual const opencascade::handle< Standard_Type > &	DynamicType () const
	Returns a type descriptor about this object. More...

Standard_Boolean	IsInstance (const opencascade::handle< Standard_Type > &theType) const
	Returns a true value if this is an instance of Type. More...

Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName. More...

Standard_Boolean	IsKind (const opencascade::handle< Standard_Type > &theType) const
	Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...

Standard_Boolean	IsKind (const Standard_CString theTypeName) const
	Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...

Standard_Transient *	This () const
	Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero. More...

Standard_Integer	GetRefCount () const
	Get the reference counter of this object. More...

void	IncrementRefCounter () const
	Increments the reference counter of this object. More...

Standard_Integer	DecrementRefCounter () const
	Decrements the reference counter of this object; returns the decremented value. More...

Static Public Member Functions
static Standard_Boolean	AcceptConnection (Graphic3d_Structure theStructure1, Graphic3d_Structure theStructure2, Graphic3d_TypeOfConnection theType)
	Returns Standard_True if the connection is possible between <AStructure1> and <AStructure2> without a creation of a cycle. More...

static void	Network (Graphic3d_Structure theStructure, const Graphic3d_TypeOfConnection theType, NCollection_Map< Graphic3d_Structure > &theSet)
	Returns <ASet> the group of structures : More...

static void	PrintNetwork (const Handle< Graphic3d_Structure > &AStructure, const Graphic3d_TypeOfConnection AType)
	Prints information about the network associated with the structure <AStructure>. More...

static void	Transforms (const gp_Trsf &theTrsf, const Standard_Real theX, const Standard_Real theY, const Standard_Real theZ, Standard_Real &theNewX, Standard_Real &theNewY, Standard_Real &theNewZ)
	Transforms theX, theY, theZ with the transformation theTrsf. More...

Static Public Member Functions inherited from Standard_Transient
static const char *	get_type_name ()
	Returns a type descriptor about this object. More...

static const opencascade::handle< Standard_Type > &	get_type_descriptor ()
	Returns type descriptor of Standard_Transient class. More...

Protected Member Functions
Standard_Boolean	AppendDescendant (Graphic3d_Structure *theDescendant)
	Appends new descendant structure. More...

Standard_Boolean	RemoveDescendant (Graphic3d_Structure *theDescendant)
	Removes the given descendant structure. More...

Standard_Boolean	AppendAncestor (Graphic3d_Structure *theAncestor)
	Appends new ancestor structure. More...

Standard_Boolean	RemoveAncestor (Graphic3d_Structure *theAncestor)
	Removes the given ancestor structure. More...

void	clear (const Standard_Boolean WithDestruction)
	Clears all the groups of primitives in the structure. More...

void	erase ()
	Erases this structure in all the views of the visualiser. More...

Static Protected Member Functions
static void	TransformBoundaries (const gp_Trsf &theTrsf, Standard_Real &theXMin, Standard_Real &theYMin, Standard_Real &theZMin, Standard_Real &theXMax, Standard_Real &theYMax, Standard_Real &theZMax)
	Transforms boundaries with <theTrsf> transformation. More...

Protected Attributes
Graphic3d_StructureManager *	myStructureManager

Handle< Graphic3d_CStructure >	myCStructure

NCollection_IndexedMap< Graphic3d_Structure * >	myAncestors

NCollection_IndexedMap< Graphic3d_Structure * >	myDescendants

Standard_Address	myOwner

Graphic3d_TypeOfStructure	myVisual

Graphic3d_TypeOfStructure	myComputeVisual

Additional Inherited Members
Public Types inherited from Standard_Transient
typedef void	base_type
	Returns a type descriptor about this object. More...

Detailed Description

This class allows the definition a graphic object. This graphic structure can be displayed, erased, or highlighted. This graphic structure can be connected with another graphic structure.

Constructor & Destructor Documentation

◆ Graphic3d_Structure()

Graphic3d_Structure::Graphic3d_Structure	(	const Handle< Graphic3d_StructureManager > &	theManager,
		const Handle< Graphic3d_Structure > &	theLinkPrs = `Handle< Graphic3d_Structure >()`
	)

Creates a graphic object in the manager theManager. It will appear in all the views of the visualiser. The structure is not displayed when it is created.

Parameters

theManager	structure manager holding this structure
theLinkPrs	another structure for creating a shadow (linked) structure

◆ ~Graphic3d_Structure()

virtual Graphic3d_Structure::~Graphic3d_Structure ( )

virtual

Suppresses the structure <me>. It will be erased at the next screen update.

Member Function Documentation

◆ AcceptConnection()

static Standard_Boolean Graphic3d_Structure::AcceptConnection	(	Graphic3d_Structure *	theStructure1,
		Graphic3d_Structure *	theStructure2,
		Graphic3d_TypeOfConnection	theType
	)

static

Returns Standard_True if the connection is possible between <AStructure1> and <AStructure2> without a creation of a cycle.

It's not possible to call the method AStructure1->Connect (AStructure2, TypeOfConnection) if

the set of all ancestors of <AStructure1> contains <AStructure1> and if the TypeOfConnection == TOC_DESCENDANT
the set of all descendants of <AStructure1> contains <AStructure2> and if the TypeOfConnection == TOC_ANCESTOR

◆ Ancestors()

void Graphic3d_Structure::Ancestors ( Graphic3d_MapOfStructure & SG ) const

Returns the group of structures to which <me> is connected.

◆ AppendAncestor()

Standard_Boolean Graphic3d_Structure::AppendAncestor ( Graphic3d_Structure * theAncestor )

protected

Appends new ancestor structure.

◆ AppendDescendant()

Standard_Boolean Graphic3d_Structure::AppendDescendant ( Graphic3d_Structure * theDescendant )

protected

Appends new descendant structure.

◆ CalculateBoundBox()

virtual void Graphic3d_Structure::CalculateBoundBox ( )

virtual

Computes axis-aligned bounding box of a structure.

Reimplemented in Prs3d_PresentationShadow.

◆ Clear()

virtual void Graphic3d_Structure::Clear ( const Standard_Boolean WithDestruction = Standard_True )

inlinevirtual

if WithDestruction == Standard_True then suppress all the groups of primitives in the structure. and it is mandatory to create a new group in <me>. if WithDestruction == Standard_False then clears all the groups of primitives in the structure. and all the groups are conserved and empty. They will be erased at the next screen update. The structure itself is conserved. The transformation and the attributes of <me> are conserved. The childs of <me> are conserved.

Reimplemented in PrsMgr_Presentation.

◆ clear()

void Graphic3d_Structure::clear ( const Standard_Boolean WithDestruction )

protected

Clears all the groups of primitives in the structure.

◆ ClipPlanes()

const Handle< Graphic3d_SequenceOfHClipPlane >& Graphic3d_Structure::ClipPlanes ( ) const

inline

Get clip planes slicing the structure on rendering.

Returns: set of clip planes.

◆ Compute()

virtual void Graphic3d_Structure::Compute ( )

inlinevirtual

Reimplemented in PrsMgr_Presentation.

◆ computeHLR()

virtual void Graphic3d_Structure::computeHLR	(	const Handle< Graphic3d_Camera > &	theProjector,
		Handle< Graphic3d_Structure > &	theStructure
	)

inlinevirtual

Returns the new Structure defined for the new visualization.

Reimplemented in PrsMgr_Presentation.

◆ ComputeVisual()

Graphic3d_TypeOfStructure Graphic3d_Structure::ComputeVisual ( ) const

inline

◆ Connect() [1/2]

void Graphic3d_Structure::Connect	(	Graphic3d_Structure *	theStructure,
		Graphic3d_TypeOfConnection	theType,
		Standard_Boolean	theWithCheck = `Standard_False`
	)

If Atype is TOC_DESCENDANT then add <AStructure> as a child structure of <me>. If Atype is TOC_ANCESTOR then add <AStructure> as a parent structure of <me>. The connection propagates Display, Highlight, Erase, Remove, and stacks the transformations. No connection if the graph of the structures contains a cycle and <WithCheck> is Standard_True;.

◆ Connect() [2/2]

void Graphic3d_Structure::Connect ( const Handle< Graphic3d_Structure > & thePrs )

inline

Deprecated:: ("Deprecated short-cut")

◆ CStructure()

const Handle< Graphic3d_CStructure >& Graphic3d_Structure::CStructure ( ) const

inline

Returns the low-level structure.

◆ CurrentGroup()

Handle< Graphic3d_Group > Graphic3d_Structure::CurrentGroup ( )

inline

Returns the last created group or creates new one if list is empty.

◆ Descendants()

void Graphic3d_Structure::Descendants ( Graphic3d_MapOfStructure & SG ) const

Returns the group of structures connected to <me>.

◆ Disconnect()

void Graphic3d_Structure::Disconnect ( Graphic3d_Structure * theStructure )

Suppress the connection between <AStructure> and <me>.

◆ DisconnectAll()

void Graphic3d_Structure::DisconnectAll ( const Graphic3d_TypeOfConnection AType )

If Atype is TOC_DESCENDANT then suppress all the connections with the child structures of <me>. If Atype is TOC_ANCESTOR then suppress all the connections with the parent structures of <me>.

◆ Display()

virtual void Graphic3d_Structure::Display ( )

virtual

Displays the structure <me> in all the views of the visualiser.

Reimplemented in PrsMgr_Presentation.

◆ DisplayPriority()

Graphic3d_DisplayPriority Graphic3d_Structure::DisplayPriority ( ) const

inline

Returns the current display priority for this structure.

◆ DumpJson()

virtual void Graphic3d_Structure::DumpJson	(	Standard_OStream &	theOStream,
		Standard_Integer	theDepth = `-1`
	)		const

virtual

Dumps the content of me into the stream.

Reimplemented in PrsMgr_Presentation, and Prs3d_PresentationShadow.

◆ Erase()

virtual void Graphic3d_Structure::Erase ( )

inlinevirtual

Erases this structure in all the views of the visualiser.

Reimplemented in PrsMgr_Presentation.

◆ erase()

void Graphic3d_Structure::erase ( )

protected

Erases this structure in all the views of the visualiser.

◆ GetZLayer()

Graphic3d_ZLayerId Graphic3d_Structure::GetZLayer ( ) const

inline

Get Z layer ID of displayed structure. The method returns -1 if the structure has no ID (deleted from graphic driver).

◆ GraphicClear()

void Graphic3d_Structure::GraphicClear ( const Standard_Boolean WithDestruction )

Clears the structure <me>.

◆ GraphicConnect()

void Graphic3d_Structure::GraphicConnect ( const Handle< Graphic3d_Structure > & theDaughter )

inline

◆ GraphicDisconnect()

void Graphic3d_Structure::GraphicDisconnect ( const Handle< Graphic3d_Structure > & theDaughter )

inline

◆ GraphicTransform()

void Graphic3d_Structure::GraphicTransform ( const Handle< TopLoc_Datum3D > & theTrsf )

inline

Internal method which sets new transformation without calling graphic manager callbacks.

◆ Groups()

const Graphic3d_SequenceOfGroup& Graphic3d_Structure::Groups ( ) const

inline

Returns the groups sequence included in this structure.

◆ Highlight()

void Graphic3d_Structure::Highlight	(	const Handle< Graphic3d_PresentationAttributes > &	theStyle,
		const Standard_Boolean	theToUpdateMgr = `Standard_True`
	)

Highlights the structure in all the views with the given style.

Parameters

theStyle	[in] the style (type of highlighting: box/color, color and opacity)
theToUpdateMgr	[in] defines whether related computed structures will be highlighted via structure manager or not

◆ HighlightStyle()

const Handle< Graphic3d_PresentationAttributes >& Graphic3d_Structure::HighlightStyle ( ) const

inline

Returns the highlight attributes.

◆ HLRValidation()

Standard_Boolean Graphic3d_Structure::HLRValidation ( ) const

inline

Hidden parts stored in this structure are valid if: 1) the owner is defined. 2) they are not invalid.

◆ Identification()

Standard_Integer Graphic3d_Structure::Identification ( ) const

inline

Returns the identification number of this structure.

◆ IsDeleted()

Standard_Boolean Graphic3d_Structure::IsDeleted ( ) const

inline

Returns TRUE if this structure is deleted (after Remove() call).

◆ IsDisplayed()

virtual Standard_Boolean Graphic3d_Structure::IsDisplayed ( ) const

inlinevirtual

Returns the display indicator for this structure.

Reimplemented in PrsMgr_Presentation.

◆ IsEmpty()

Standard_Boolean Graphic3d_Structure::IsEmpty ( ) const

Returns Standard_True if the structure <me> is empty. Warning: A structure is empty if : it do not have group or all the groups are empties and it do not have descendant or all the descendants are empties.

◆ IsHighlighted()

virtual Standard_Boolean Graphic3d_Structure::IsHighlighted ( ) const

inlinevirtual

Returns the highlight indicator for this structure.

◆ IsInfinite()

Standard_Boolean Graphic3d_Structure::IsInfinite ( ) const

inline

Returns Standard_True if the structure <me> is infinite.

◆ IsMutable()

Standard_Boolean Graphic3d_Structure::IsMutable ( ) const

inline

Returns true if structure has mutable nature (content or location are be changed regularly). Mutable structure will be managed in different way than static onces.

◆ IsTransformed()

Standard_Boolean Graphic3d_Structure::IsTransformed ( ) const

inline

Returns TRUE if the structure is transformed.

◆ IsVisible()

Standard_Boolean Graphic3d_Structure::IsVisible ( ) const

inline

Returns the visibility indicator for this structure.

◆ MinMaxValues()

Bnd_Box Graphic3d_Structure::MinMaxValues ( const Standard_Boolean theToIgnoreInfiniteFlag = Standard_False ) const

Returns the coordinates of the boundary box of the structure <me>. If <theToIgnoreInfiniteFlag> is TRUE, the method returns actual graphical boundaries of the Graphic3d_Group components. Otherwise, the method returns boundaries taking into account infinite state of the structure. This approach generally used for application specific fit operation (e.g. fitting the model into screen, not taking into account infinite helper elements). Warning: If the structure <me> is empty then the empty box is returned, If the structure <me> is infinite then the whole box is returned.

◆ Network()

static void Graphic3d_Structure::Network	(	Graphic3d_Structure *	theStructure,
		const Graphic3d_TypeOfConnection	theType,
		NCollection_Map< Graphic3d_Structure *> &	theSet
	)

static

Returns <ASet> the group of structures :

directly or indirectly connected to <AStructure> if the TypeOfConnection == TOC_DESCENDANT
to which <AStructure> is directly or indirectly connected if the TypeOfConnection == TOC_ANCESTOR

◆ NewGroup()

Handle< Graphic3d_Group > Graphic3d_Structure::NewGroup ( )

Append new group to this structure.

◆ NumberOfGroups()

Standard_Integer Graphic3d_Structure::NumberOfGroups ( ) const

inline

Returns the current number of groups in this structure.

◆ Owner()

Standard_Address Graphic3d_Structure::Owner ( ) const

inline

◆ PrintNetwork()

static void Graphic3d_Structure::PrintNetwork	(	const Handle< Graphic3d_Structure > &	AStructure,
		const Graphic3d_TypeOfConnection	AType
	)

static

Prints information about the network associated with the structure <AStructure>.

◆ ReCompute() [1/2]

void Graphic3d_Structure::ReCompute ( )

Forces a new construction of the structure <me> if <me> is displayed and TOS_COMPUTED.

◆ ReCompute() [2/2]

void Graphic3d_Structure::ReCompute ( const Handle< Graphic3d_DataStructureManager > & aProjector )

Forces a new construction of the structure <me> if <me> is displayed in <aProjetor> and TOS_COMPUTED.

◆ Remove() [1/3]

void Graphic3d_Structure::Remove ( )

Suppress the structure <me>. It will be erased at the next screen update. Warning: No more graphic operations in <me> after this call. Category: Methods to modify the class definition.

◆ Remove() [2/3]

void Graphic3d_Structure::Remove ( const Handle< Graphic3d_Structure > & thePrs )

inline

Deprecated:: ("Deprecated alias for Disconnect()")

◆ Remove() [3/3]

void Graphic3d_Structure::Remove	(	Graphic3d_Structure *	thePtr,
		const Graphic3d_TypeOfConnection	theType
	)

Suppress the structure in the list of descendants or in the list of ancestors.

◆ RemoveAll()

void Graphic3d_Structure::RemoveAll ( )

inline

Deprecated:: ("Deprecated alias for DisconnectAll()")

◆ RemoveAncestor()

Standard_Boolean Graphic3d_Structure::RemoveAncestor ( Graphic3d_Structure * theAncestor )

protected

Removes the given ancestor structure.

◆ RemoveDescendant()

Standard_Boolean Graphic3d_Structure::RemoveDescendant ( Graphic3d_Structure * theDescendant )

protected

Removes the given descendant structure.

◆ ResetDisplayPriority()

void Graphic3d_Structure::ResetDisplayPriority ( )

Reset the current priority of the structure to the previous priority. Warning: If structure is displayed then the SetDisplayPriority() method erases it and displays with the previous priority.

◆ SetClipPlanes()

void Graphic3d_Structure::SetClipPlanes ( const Handle< Graphic3d_SequenceOfHClipPlane > & thePlanes )

inline

Changes a sequence of clip planes slicing the structure on rendering.

Parameters

thePlanes [in] the set of clip planes.

◆ SetComputeVisual()

void Graphic3d_Structure::SetComputeVisual ( const Graphic3d_TypeOfStructure theVisual )

inline

◆ SetDisplayPriority() [1/2]

void Graphic3d_Structure::SetDisplayPriority ( const Graphic3d_DisplayPriority thePriority )

Modifies the order of displaying the structure. Values are between 0 and 10. Structures are drawn according to their display priorities in ascending order. A structure of priority 10 is displayed the last and appears over the others. The default value is 5. Warning: If structure is displayed then the SetDisplayPriority method erases it and displays with the new priority. Raises Graphic3d_PriorityDefinitionError if Priority is greater than 10 or a negative value.

◆ SetDisplayPriority() [2/2]

void Graphic3d_Structure::SetDisplayPriority ( const Standard_Integer thePriority )

inline

Deprecated:: ("Deprecated since OCCT7.7, Graphic3d_DisplayPriority should be passed instead of integer number to SetDisplayPriority()")

◆ SetHLRValidation()

void Graphic3d_Structure::SetHLRValidation ( const Standard_Boolean theFlag )

inline

◆ SetInfiniteState()

void Graphic3d_Structure::SetInfiniteState ( const Standard_Boolean theToSet )

inline

Sets infinite flag. When TRUE, the MinMaxValues method returns: theXMin = theYMin = theZMin = RealFirst(). theXMax = theYMax = theZMax = RealLast(). By default, structure is created not infinite but empty.

◆ SetIsForHighlight()

void Graphic3d_Structure::SetIsForHighlight ( const Standard_Boolean isForHighlight )

inline

Marks the structure <me> representing wired structure needed for highlight only so it won't be added to BVH tree.

◆ SetMutable()

void Graphic3d_Structure::SetMutable ( const Standard_Boolean theIsMutable )

inline

Sets if the structure location has mutable nature (content or location will be changed regularly).

◆ SetOwner()

void Graphic3d_Structure::SetOwner ( const Standard_Address theOwner )

inline

◆ SetTransformation()

void Graphic3d_Structure::SetTransformation ( const Handle< TopLoc_Datum3D > & theTrsf )

Modifies the current local transformation.

◆ SetTransformPersistence()

void Graphic3d_Structure::SetTransformPersistence ( const Handle< Graphic3d_TransformPers > & theTrsfPers )

Modifies the current transform persistence (pan, zoom or rotate)

◆ SetVisible()

void Graphic3d_Structure::SetVisible ( const Standard_Boolean AValue )

Modifies the visibility indicator to Standard_True or Standard_False for the structure <me>. The default value at the definition of <me> is Standard_True.

◆ SetVisual()

virtual void Graphic3d_Structure::SetVisual ( const Graphic3d_TypeOfStructure AVisual )

virtual

Modifies the visualisation mode for the structure <me>.

◆ SetZLayer()

void Graphic3d_Structure::SetZLayer ( const Graphic3d_ZLayerId theLayerId )

Set Z layer ID for the structure. The Z layer mechanism allows to display structures presented in higher layers in overlay of structures in lower layers by switching off z buffer depth test between layers.

◆ SetZoomLimit()

void Graphic3d_Structure::SetZoomLimit	(	const Standard_Real	LimitInf,
		const Standard_Real	LimitSup
	)

Modifies the minimum and maximum zoom coefficients for the structure <me>. The default value at the definition of <me> is unlimited. Category: Methods to modify the class definition Warning: Raises StructureDefinitionError if <LimitInf> is greater than <LimitSup> or if <LimitInf> or <LimitSup> is a negative value.

◆ Transformation()

const Handle< TopLoc_Datum3D >& Graphic3d_Structure::Transformation ( ) const

inline

Return local transformation.

◆ TransformBoundaries()

static void Graphic3d_Structure::TransformBoundaries	(	const gp_Trsf &	theTrsf,
		Standard_Real &	theXMin,
		Standard_Real &	theYMin,
		Standard_Real &	theZMin,
		Standard_Real &	theXMax,
		Standard_Real &	theYMax,
		Standard_Real &	theZMax
	)

staticprotected

Transforms boundaries with <theTrsf> transformation.

◆ TransformPersistence()

const Handle< Graphic3d_TransformPers >& Graphic3d_Structure::TransformPersistence ( ) const

inline

Returns: transform persistence of the presentable object.

◆ Transforms()

static void Graphic3d_Structure::Transforms	(	const gp_Trsf &	theTrsf,
		const Standard_Real	theX,
		const Standard_Real	theY,
		const Standard_Real	theZ,
		Standard_Real &	theNewX,
		Standard_Real &	theNewY,
		Standard_Real &	theNewZ
	)

static

Transforms theX, theY, theZ with the transformation theTrsf.

◆ UnHighlight()

void Graphic3d_Structure::UnHighlight ( )

Suppresses the highlight for the structure <me> in all the views of the visualiser.

◆ Visual()

Graphic3d_TypeOfStructure Graphic3d_Structure::Visual ( ) const

inline

Returns the visualisation mode for the structure <me>.

Field Documentation

◆ myAncestors

NCollection_IndexedMap<Graphic3d_Structure*> Graphic3d_Structure::myAncestors

protected

◆ myComputeVisual

Graphic3d_TypeOfStructure Graphic3d_Structure::myComputeVisual

protected

◆ myCStructure

Handle< Graphic3d_CStructure > Graphic3d_Structure::myCStructure

protected

◆ myDescendants

NCollection_IndexedMap<Graphic3d_Structure*> Graphic3d_Structure::myDescendants

protected

◆ myOwner

Standard_Address Graphic3d_Structure::myOwner

protected

◆ myStructureManager

Graphic3d_StructureManager* Graphic3d_Structure::myStructureManager

protected

◆ myVisual

Graphic3d_TypeOfStructure Graphic3d_Structure::myVisual

protected

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

Graphic3d_Structure.hxx

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Graphic3d_Structure()

◆ ~Graphic3d_Structure()

Member Function Documentation

◆ AcceptConnection()

◆ Ancestors()

◆ AppendAncestor()

◆ AppendDescendant()

◆ CalculateBoundBox()

◆ Clear()

◆ clear()

◆ ClipPlanes()

◆ Compute()

◆ computeHLR()

◆ ComputeVisual()

◆ Connect() [1/2]

◆ Connect() [2/2]

◆ CStructure()

◆ CurrentGroup()

◆ Descendants()

◆ Disconnect()

◆ DisconnectAll()

◆ Display()

◆ DisplayPriority()

◆ DumpJson()

◆ Erase()

◆ erase()

◆ GetZLayer()

◆ GraphicClear()

◆ GraphicConnect()

◆ GraphicDisconnect()

◆ GraphicTransform()

◆ Groups()

◆ Highlight()

◆ HighlightStyle()

◆ HLRValidation()

◆ Identification()

◆ IsDeleted()

◆ IsDisplayed()

◆ IsEmpty()

◆ IsHighlighted()

◆ IsInfinite()

◆ IsMutable()

◆ IsTransformed()

◆ IsVisible()

◆ MinMaxValues()

◆ Network()

◆ NewGroup()

◆ NumberOfGroups()

◆ Owner()

◆ PrintNetwork()

◆ ReCompute() [1/2]

◆ ReCompute() [2/2]

◆ Remove() [1/3]

◆ Remove() [2/3]

◆ Remove() [3/3]

◆ RemoveAll()

◆ RemoveAncestor()

◆ RemoveDescendant()

◆ ResetDisplayPriority()

◆ SetClipPlanes()

◆ SetComputeVisual()

◆ SetDisplayPriority() [1/2]

◆ SetDisplayPriority() [2/2]

◆ SetHLRValidation()

◆ SetInfiniteState()

◆ SetIsForHighlight()

◆ SetMutable()

◆ SetOwner()

◆ SetTransformation()

◆ SetTransformPersistence()

◆ SetVisible()

◆ SetVisual()