This class contains logics related to tracking and modification of clipping plane state for particular OpenGl context. It contains information about enabled clipping planes and provides method to change clippings in context. The methods should be executed within OpenGl context associated with instance of this class. More...

#include <OpenGl_Clipping.hxx>

Public Member Functions
general methods
	OpenGl_Clipping ()
	Default constructor.

void	Init ()
	Initialize.

void	Reset (const Handle< Graphic3d_SequenceOfHClipPlane > &thePlanes)
	Setup list of global (for entire view) clipping planes and clears local plane list if it was not released before.

void	SetLocalPlanes (const Handle< Graphic3d_SequenceOfHClipPlane > &thePlanes)
	Setup list of local (for current object) clipping planes.

Standard_Boolean	IsCappingOn () const

Standard_Boolean	IsClippingOrCappingOn () const

Standard_Integer	NbClippingOrCappingOn () const

Standard_Boolean	HasClippingChains () const
	Return TRUE if there are clipping chains in the list (defining more than 1 sub-plane)

advanced method for disabling defined planes
Standard_Boolean	HasDisabled () const
	Return true if some clipping planes have been temporarily disabled.

Standard_Boolean	SetEnabled (const OpenGl_ClippingIterator &thePlane, const Standard_Boolean theIsEnabled)
	Disable plane temporarily.

void	DisableGlobal ()
	Temporarily disable all planes from the global (view) list, keep only local (object) list.

void	RestoreDisabled ()
	Restore all temporarily disabled planes. Does NOT affect constantly disabled planes Graphic3d_ClipPlane::IsOn().

capping algorithm filter
const Handle< Graphic3d_ClipPlane > &	CappedChain () const
	Chain which is either temporary disabled or the only one enabled for Capping algorithm.

Standard_Integer	CappedSubPlane () const
	Sub-plane index within filtered Chain; positive number for DisableAllExcept and negative for EnableAllExcept.

bool	IsCappingFilterOn () const
	Return TRUE if capping algorithm is in state, when all clipping planes are temporarily disabled except currently processed one.

bool	IsCappingDisableAllExcept () const
	Return TRUE if capping algorithm is in state, when all clipping planes are temporarily disabled except currently processed one.

bool	IsCappingEnableAllExcept () const
	Return TRUE if capping algorithm is in state, when all clipping planes are enabled except currently rendered one.

void	DisableAllExcept (const Handle< Graphic3d_ClipPlane > &theChain, const Standard_Integer theSubPlaneIndex)
	Temporarily disable all planes except specified one for Capping algorithm. Does not affect already disabled planes.

void	EnableAllExcept (const Handle< Graphic3d_ClipPlane > &theChain, const Standard_Integer theSubPlaneIndex)
	Enable back planes disabled by DisableAllExcept() for Capping algorithm. Keeps only specified plane enabled.

void	ResetCappingFilter ()
	Resets chain filter for Capping algorithm.

clipping state modification commands
void	add (const Handle< Graphic3d_SequenceOfHClipPlane > &thePlanes, const Standard_Integer theStartIndex)
	Add planes to the context clipping at the specified system of coordinates. This methods loads appropriate transformation matrix from workspace to to transform equation coordinates. The planes become enabled in the context. If the number of the passed planes exceeds capabilities of OpenGl, the last planes are simply ignored.

void	remove (const Handle< Graphic3d_SequenceOfHClipPlane > &thePlanes, const Standard_Integer theStartIndex)
	Remove the passed set of clipping planes from the context state.

Detailed Description

This class contains logics related to tracking and modification of clipping plane state for particular OpenGl context. It contains information about enabled clipping planes and provides method to change clippings in context. The methods should be executed within OpenGl context associated with instance of this class.

Constructor & Destructor Documentation

◆ OpenGl_Clipping()

OpenGl_Clipping::OpenGl_Clipping ( )

Default constructor.

Member Function Documentation

◆ add()

void OpenGl_Clipping::add	(	const Handle< Graphic3d_SequenceOfHClipPlane > &	thePlanes,
		const Standard_Integer	theStartIndex )

protected

Add planes to the context clipping at the specified system of coordinates. This methods loads appropriate transformation matrix from workspace to to transform equation coordinates. The planes become enabled in the context. If the number of the passed planes exceeds capabilities of OpenGl, the last planes are simply ignored.

Within FFP, method also temporarily resets ModelView matrix before calling glClipPlane(). Otherwise the method just redirects to addLazy().

Parameters

thePlanes [in/out] the list of planes to be added The list then provides information on which planes were really added to clipping state. This list then can be used to fall back to previous state.

◆ CappedChain()

const Handle< Graphic3d_ClipPlane > & OpenGl_Clipping::CappedChain ( ) const

inline

Chain which is either temporary disabled or the only one enabled for Capping algorithm.

◆ CappedSubPlane()

Standard_Integer OpenGl_Clipping::CappedSubPlane ( ) const

inline

Sub-plane index within filtered Chain; positive number for DisableAllExcept and negative for EnableAllExcept.

◆ DisableAllExcept()

void OpenGl_Clipping::DisableAllExcept	(	const Handle< Graphic3d_ClipPlane > &	theChain,
		const Standard_Integer	theSubPlaneIndex )

Temporarily disable all planes except specified one for Capping algorithm. Does not affect already disabled planes.

◆ DisableGlobal()

void OpenGl_Clipping::DisableGlobal ( )

Temporarily disable all planes from the global (view) list, keep only local (object) list.

◆ EnableAllExcept()

void OpenGl_Clipping::EnableAllExcept	(	const Handle< Graphic3d_ClipPlane > &	theChain,
		const Standard_Integer	theSubPlaneIndex )

Enable back planes disabled by DisableAllExcept() for Capping algorithm. Keeps only specified plane enabled.

◆ HasClippingChains()

Standard_Boolean OpenGl_Clipping::HasClippingChains ( ) const

inline

Return TRUE if there are clipping chains in the list (defining more than 1 sub-plane)

◆ HasDisabled()

Standard_Boolean OpenGl_Clipping::HasDisabled ( ) const

inline

Return true if some clipping planes have been temporarily disabled.

◆ Init()

void OpenGl_Clipping::Init ( )

Initialize.

◆ IsCappingDisableAllExcept()

bool OpenGl_Clipping::IsCappingDisableAllExcept ( ) const

inline

Return TRUE if capping algorithm is in state, when all clipping planes are temporarily disabled except currently processed one.

◆ IsCappingEnableAllExcept()

bool OpenGl_Clipping::IsCappingEnableAllExcept ( ) const

inline

Return TRUE if capping algorithm is in state, when all clipping planes are enabled except currently rendered one.

◆ IsCappingFilterOn()

bool OpenGl_Clipping::IsCappingFilterOn ( ) const

inline

Return TRUE if capping algorithm is in state, when all clipping planes are temporarily disabled except currently processed one.

◆ IsCappingOn()

Standard_Boolean OpenGl_Clipping::IsCappingOn ( ) const

inline

Returns: true if there are enabled capping planes

◆ IsClippingOrCappingOn()

Standard_Boolean OpenGl_Clipping::IsClippingOrCappingOn ( ) const

inline

Returns: true if there are enabled clipping or capping planes

◆ NbClippingOrCappingOn()

Standard_Integer OpenGl_Clipping::NbClippingOrCappingOn ( ) const

inline

Returns: number of enabled clipping + capping planes

◆ remove()

void OpenGl_Clipping::remove	(	const Handle< Graphic3d_SequenceOfHClipPlane > &	thePlanes,
		const Standard_Integer	theStartIndex )

protected

Remove the passed set of clipping planes from the context state.

Parameters

thePlanes [in] the planes to remove from list.

◆ Reset()

void OpenGl_Clipping::Reset ( const Handle< Graphic3d_SequenceOfHClipPlane > & thePlanes )

Setup list of global (for entire view) clipping planes and clears local plane list if it was not released before.

◆ ResetCappingFilter()

void OpenGl_Clipping::ResetCappingFilter ( )

Resets chain filter for Capping algorithm.

◆ RestoreDisabled()

void OpenGl_Clipping::RestoreDisabled ( )

Restore all temporarily disabled planes. Does NOT affect constantly disabled planes Graphic3d_ClipPlane::IsOn().

◆ SetEnabled()

Standard_Boolean OpenGl_Clipping::SetEnabled	(	const OpenGl_ClippingIterator &	thePlane,
		const Standard_Boolean	theIsEnabled )

Disable plane temporarily.

◆ SetLocalPlanes()

void OpenGl_Clipping::SetLocalPlanes ( const Handle< Graphic3d_SequenceOfHClipPlane > & thePlanes )

Setup list of local (for current object) clipping planes.

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

OpenGl_Clipping.hxx

Public Member Functions

clipping state modification commands

Detailed Description

Constructor & Destructor Documentation

◆ OpenGl_Clipping()

Member Function Documentation

◆ add()

◆ CappedChain()

◆ CappedSubPlane()

◆ DisableAllExcept()

◆ DisableGlobal()

◆ EnableAllExcept()

◆ HasClippingChains()

◆ HasDisabled()

◆ Init()

◆ IsCappingDisableAllExcept()

◆ IsCappingEnableAllExcept()

◆ IsCappingFilterOn()

◆ IsCappingOn()

◆ IsClippingOrCappingOn()

◆ NbClippingOrCappingOn()

◆ remove()

◆ Reset()

◆ ResetCappingFilter()

◆ RestoreDisabled()

◆ SetEnabled()

◆ SetLocalPlanes()