This class allows the definition of a manager to which the graphic objects are associated. It allows them to be globally manipulated. It defines the global attributes. Keywords: Structure, Structure Manager, Update Mode, Destroy, Highlight, Visible. More...

#include <Graphic3d_StructureManager.hxx>

Inheritance diagram for Graphic3d_StructureManager:

[legend]

Public Member Functions
	Graphic3d_StructureManager (const Handle< Graphic3d_GraphicDriver > &theDriver)
	Initializes the ViewManager. Currently creating of more than 100 viewer instances is not supported and leads to InitializationError and initialization failure. This limitation might be addressed in some future OCCT releases. Warning: Raises InitialisationError if the initialization of the ViewManager failed.

	~Graphic3d_StructureManager ()
	Deletes the manager <me>.

virtual void	Update (const Graphic3d_ZLayerId theLayerId=Graphic3d_ZLayerId_UNKNOWN) const
	Invalidates bounding box of specified ZLayerId.

virtual void	Remove ()
	Deletes and erases the 3D structure manager.

virtual void	Erase ()
	Erases all the structures.

void	DisplayedStructures (Graphic3d_MapOfStructure &SG) const
	Returns the set of structures displayed in visualiser <me>.

void	HighlightedStructures (Graphic3d_MapOfStructure &SG) const
	Returns the set of highlighted structures in a visualiser <me>.

virtual void	ReCompute (const Handle< Graphic3d_Structure > &theStructure)
	Forces a new construction of the structure. if <theStructure> is displayed and TOS_COMPUTED.

virtual void	ReCompute (const Handle< Graphic3d_Structure > &theStructure, const Handle< Graphic3d_DataStructureManager > &theProjector)
	Forces a new construction of the structure. if <theStructure> is displayed in <theProjector> and TOS_COMPUTED.

virtual void	Clear (Graphic3d_Structure *theStructure, const Standard_Boolean theWithDestruction)
	Clears the structure.

virtual void	Connect (const Graphic3d_Structure theMother, const Graphic3d_Structure theDaughter)
	Connects the structures.

virtual void	Disconnect (const Graphic3d_Structure theMother, const Graphic3d_Structure theDaughter)
	Disconnects the structures.

virtual void	Display (const Handle< Graphic3d_Structure > &theStructure)
	Display the structure.

virtual void	Erase (const Handle< Graphic3d_Structure > &theStructure)
	Erases the structure.

virtual void	Highlight (const Handle< Graphic3d_Structure > &theStructure)
	Highlights the structure.

virtual void	SetTransform (const Handle< Graphic3d_Structure > &theStructure, const Handle< TopLoc_Datum3D > &theTrsf)
	Transforms the structure.

virtual void	ChangeDisplayPriority (const Handle< Graphic3d_Structure > &theStructure, const Graphic3d_DisplayPriority theOldPriority, const Graphic3d_DisplayPriority theNewPriority)
	Changes the display priority of the structure <AStructure>.

virtual void	ChangeZLayer (const Handle< Graphic3d_Structure > &theStructure, const Graphic3d_ZLayerId theLayerId)
	Change Z layer for structure. The Z layer mechanism allows to display structures in higher layers in overlay of structures in lower layers.

const Handle< Graphic3d_GraphicDriver > &	GraphicDriver () const
	Returns the graphic driver of <me>.

Standard_Integer	Identification (Graphic3d_CView *theView)
	Attaches the view to this structure manager and sets its identification number within the manager.

void	UnIdentification (Graphic3d_CView *theView)
	Detach the view from this structure manager and release its identification.

const Graphic3d_IndexedMapOfView &	DefinedViews () const
	Returns the group of views defined in the structure manager.

Standard_Integer	MaxNumOfViews () const
	Returns the theoretical maximum number of definable views in the manager. Warning: It's not possible to accept an infinite number of definable views because each view must have an identification and we have different managers.

virtual Handle< Graphic3d_Structure >	Identification (const Standard_Integer AId) const
	Returns the structure with the identification number <AId>.

virtual void	UnHighlight (const Handle< Graphic3d_Structure > &AStructure)
	Suppress the highlighting on the structure <AStructure>.

virtual void	UnHighlight ()
	Suppresses the highlighting on all the structures in <me>.

void	RecomputeStructures ()
	Recomputes all structures in the manager. Resets Device Lost flag.

void	RecomputeStructures (const NCollection_Map< Graphic3d_Structure * > &theStructures)
	Recomputes all structures from theStructures.

void	RegisterObject (const Handle< Standard_Transient > &theObject, const Handle< Graphic3d_ViewAffinity > &theAffinity)

void	UnregisterObject (const Handle< Standard_Transient > &theObject)

const Handle< Graphic3d_ViewAffinity > &	ObjectAffinity (const Handle< Standard_Transient > &theObject) const

Standard_Boolean	IsDeviceLost () const
	Returns TRUE if Device Lost flag has been set and presentation data should be reuploaded onto graphics driver.

void	SetDeviceLost ()
	Sets Device Lost flag.

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

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

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

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

virtual	~Standard_Transient ()
	Destructor must be virtual.

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

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

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

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.

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.

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.

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

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

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

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

Protected Member Functions
Standard_Integer	NumberOfDisplayedStructures () const
	Returns the number of structures displayed in visualizer <me>. Returns the structure displayed in visualizer <me>.

Protected Attributes
Aspect_GenId	myViewGenId

Graphic3d_MapOfStructure	myDisplayedStructure

Graphic3d_MapOfStructure	myHighlightedStructure

Graphic3d_MapOfObject	myRegisteredObjects

Handle< Graphic3d_GraphicDriver >	myGraphicDriver

Graphic3d_IndexedMapOfView	myDefinedViews

Standard_Boolean	myDeviceLostFlag

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

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

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

Detailed Description

This class allows the definition of a manager to which the graphic objects are associated. It allows them to be globally manipulated. It defines the global attributes. Keywords: Structure, Structure Manager, Update Mode, Destroy, Highlight, Visible.

Constructor & Destructor Documentation

◆ Graphic3d_StructureManager()

Graphic3d_StructureManager::Graphic3d_StructureManager ( const Handle< Graphic3d_GraphicDriver > & theDriver )

Initializes the ViewManager. Currently creating of more than 100 viewer instances is not supported and leads to InitializationError and initialization failure. This limitation might be addressed in some future OCCT releases. Warning: Raises InitialisationError if the initialization of the ViewManager failed.

◆ ~Graphic3d_StructureManager()

Graphic3d_StructureManager::~Graphic3d_StructureManager ( )

Deletes the manager <me>.

Member Function Documentation

◆ ChangeDisplayPriority()

virtual void Graphic3d_StructureManager::ChangeDisplayPriority	(	const Handle< Graphic3d_Structure > &	theStructure,
		const Graphic3d_DisplayPriority	theOldPriority,
		const Graphic3d_DisplayPriority	theNewPriority
	)

virtual

Changes the display priority of the structure <AStructure>.

◆ ChangeZLayer()

virtual void Graphic3d_StructureManager::ChangeZLayer	(	const Handle< Graphic3d_Structure > &	theStructure,
		const Graphic3d_ZLayerId	theLayerId
	)

virtual

Change Z layer for structure. The Z layer mechanism allows to display structures in higher layers in overlay of structures in lower layers.

◆ Clear()

virtual void Graphic3d_StructureManager::Clear	(	Graphic3d_Structure *	theStructure,
		const Standard_Boolean	theWithDestruction
	)

virtual

Clears the structure.

◆ Connect()

virtual void Graphic3d_StructureManager::Connect	(	const Graphic3d_Structure *	theMother,
		const Graphic3d_Structure *	theDaughter
	)

virtual

Connects the structures.

◆ DefinedViews()

const Graphic3d_IndexedMapOfView & Graphic3d_StructureManager::DefinedViews ( ) const

Returns the group of views defined in the structure manager.

◆ Disconnect()

virtual void Graphic3d_StructureManager::Disconnect	(	const Graphic3d_Structure *	theMother,
		const Graphic3d_Structure *	theDaughter
	)

virtual

Disconnects the structures.

◆ Display()

virtual void Graphic3d_StructureManager::Display ( const Handle< Graphic3d_Structure > & theStructure )

virtual

Display the structure.

◆ DisplayedStructures()

void Graphic3d_StructureManager::DisplayedStructures ( Graphic3d_MapOfStructure & SG ) const

Returns the set of structures displayed in visualiser <me>.

◆ DumpJson()

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

Dumps the content of me into the stream.

◆ Erase() [1/2]

virtual void Graphic3d_StructureManager::Erase ( )

virtual

Erases all the structures.

◆ Erase() [2/2]

virtual void Graphic3d_StructureManager::Erase ( const Handle< Graphic3d_Structure > & theStructure )

virtual

Erases the structure.

◆ GraphicDriver()

const Handle< Graphic3d_GraphicDriver > & Graphic3d_StructureManager::GraphicDriver ( ) const

Returns the graphic driver of <me>.

◆ Highlight()

virtual void Graphic3d_StructureManager::Highlight ( const Handle< Graphic3d_Structure > & theStructure )

virtual

Highlights the structure.

◆ HighlightedStructures()

void Graphic3d_StructureManager::HighlightedStructures ( Graphic3d_MapOfStructure & SG ) const

Returns the set of highlighted structures in a visualiser <me>.

◆ Identification() [1/2]

virtual Handle< Graphic3d_Structure > Graphic3d_StructureManager::Identification ( const Standard_Integer AId ) const

virtual

Returns the structure with the identification number <AId>.

◆ Identification() [2/2]

Standard_Integer Graphic3d_StructureManager::Identification ( Graphic3d_CView * theView )

Attaches the view to this structure manager and sets its identification number within the manager.

◆ IsDeviceLost()

Standard_Boolean Graphic3d_StructureManager::IsDeviceLost ( ) const

inline

Returns TRUE if Device Lost flag has been set and presentation data should be reuploaded onto graphics driver.

◆ MaxNumOfViews()

Standard_Integer Graphic3d_StructureManager::MaxNumOfViews ( ) const

Returns the theoretical maximum number of definable views in the manager. Warning: It's not possible to accept an infinite number of definable views because each view must have an identification and we have different managers.

◆ NumberOfDisplayedStructures()

Standard_Integer Graphic3d_StructureManager::NumberOfDisplayedStructures ( ) const

protected

Returns the number of structures displayed in visualizer <me>. Returns the structure displayed in visualizer <me>.

◆ ObjectAffinity()

const Handle< Graphic3d_ViewAffinity > & Graphic3d_StructureManager::ObjectAffinity ( const Handle< Standard_Transient > & theObject ) const

◆ ReCompute() [1/2]

virtual void Graphic3d_StructureManager::ReCompute ( const Handle< Graphic3d_Structure > & theStructure )

virtual

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

◆ ReCompute() [2/2]

virtual void Graphic3d_StructureManager::ReCompute	(	const Handle< Graphic3d_Structure > &	theStructure,
		const Handle< Graphic3d_DataStructureManager > &	theProjector
	)

virtual

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

◆ RecomputeStructures() [1/2]

void Graphic3d_StructureManager::RecomputeStructures ( )

Recomputes all structures in the manager. Resets Device Lost flag.

◆ RecomputeStructures() [2/2]

void Graphic3d_StructureManager::RecomputeStructures ( const NCollection_Map< Graphic3d_Structure * > & theStructures )

Recomputes all structures from theStructures.

◆ RegisterObject()

void Graphic3d_StructureManager::RegisterObject	(	const Handle< Standard_Transient > &	theObject,
		const Handle< Graphic3d_ViewAffinity > &	theAffinity
	)

◆ Remove()

virtual void Graphic3d_StructureManager::Remove ( )

virtual

Deletes and erases the 3D structure manager.

◆ SetDeviceLost()

void Graphic3d_StructureManager::SetDeviceLost ( )

inline

Sets Device Lost flag.

◆ SetTransform()

virtual void Graphic3d_StructureManager::SetTransform	(	const Handle< Graphic3d_Structure > &	theStructure,
		const Handle< TopLoc_Datum3D > &	theTrsf
	)

virtual

Transforms the structure.

◆ UnHighlight() [1/2]

virtual void Graphic3d_StructureManager::UnHighlight ( )

virtual

Suppresses the highlighting on all the structures in <me>.

◆ UnHighlight() [2/2]

virtual void Graphic3d_StructureManager::UnHighlight ( const Handle< Graphic3d_Structure > & AStructure )

virtual

Suppress the highlighting on the structure <AStructure>.

◆ UnIdentification()

void Graphic3d_StructureManager::UnIdentification ( Graphic3d_CView * theView )

Detach the view from this structure manager and release its identification.

◆ UnregisterObject()

void Graphic3d_StructureManager::UnregisterObject ( const Handle< Standard_Transient > & theObject )

◆ Update()

virtual void Graphic3d_StructureManager::Update ( const Graphic3d_ZLayerId theLayerId = Graphic3d_ZLayerId_UNKNOWN ) const

virtual

Invalidates bounding box of specified ZLayerId.

Field Documentation

◆ myDefinedViews

Graphic3d_IndexedMapOfView Graphic3d_StructureManager::myDefinedViews

protected

◆ myDeviceLostFlag

Standard_Boolean Graphic3d_StructureManager::myDeviceLostFlag

protected

◆ myDisplayedStructure

Graphic3d_MapOfStructure Graphic3d_StructureManager::myDisplayedStructure

protected

◆ myGraphicDriver

Handle< Graphic3d_GraphicDriver > Graphic3d_StructureManager::myGraphicDriver

protected

◆ myHighlightedStructure

Graphic3d_MapOfStructure Graphic3d_StructureManager::myHighlightedStructure

protected

◆ myRegisteredObjects

Graphic3d_MapOfObject Graphic3d_StructureManager::myRegisteredObjects

protected

◆ myViewGenId

Aspect_GenId Graphic3d_StructureManager::myViewGenId

protected

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

Graphic3d_StructureManager.hxx

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Graphic3d_StructureManager()

◆ ~Graphic3d_StructureManager()

Member Function Documentation

◆ ChangeDisplayPriority()

◆ ChangeZLayer()

◆ Clear()

◆ Connect()

◆ DefinedViews()

◆ Disconnect()

◆ Display()

◆ DisplayedStructures()

◆ DumpJson()

◆ Erase() [1/2]

◆ Erase() [2/2]

◆ GraphicDriver()

◆ Highlight()

◆ HighlightedStructures()

◆ Identification() [1/2]

◆ Identification() [2/2]

◆ IsDeviceLost()

◆ MaxNumOfViews()

◆ NumberOfDisplayedStructures()

◆ ObjectAffinity()

◆ ReCompute() [1/2]

◆ ReCompute() [2/2]

◆ RecomputeStructures() [1/2]

◆ RecomputeStructures() [2/2]

◆ RegisterObject()

◆ Remove()

◆ SetDeviceLost()

◆ SetTransform()

◆ UnHighlight() [1/2]

◆ UnHighlight() [2/2]

◆ UnIdentification()

◆ UnregisterObject()

◆ Update()

Field Documentation

◆ myDefinedViews

◆ myDeviceLostFlag

◆ myDisplayedStructure

◆ myGraphicDriver

◆ myHighlightedStructure

◆ myRegisteredObjects

◆ myViewGenId