OCCT3D OCCT 8.0.1
OCCT documentation

Search guides and API reference

Enter at least two characters.

    Open CASCADE Technology Reference Manual 8.0.1
    StdSelect_FaceFilter Class Reference

    A framework to define a filter to select a specific type of face. The types available include: More...

    #include <StdSelect_FaceFilter.hxx>

    Inheritance diagram for StdSelect_FaceFilter:

    Public Member Functions

     StdSelect_FaceFilter (const StdSelect_TypeOfFace aTypeOfFace)
     Constructs a face filter object defined by the type of face aTypeOfFace.
    void SetType (const StdSelect_TypeOfFace aNewType)
     Sets the type of face aNewType. aNewType is to be highlighted in selection.
    StdSelect_TypeOfFace Type () const
     Returns the type of face to be highlighted in selection.
    bool IsOk (const occ::handle< SelectMgr_EntityOwner > &anobj) const override
     Indicates that the selected Interactive Object passes the filter. The owner, anObj, can be either direct or user. A direct owner is the corresponding construction element, whereas a user is the compound shape of which the entity forms a part. When an object is detected by the mouse - in AIS, this is done through a context selector - its owner is passed to the filter as an argument. If the object returns true, it is kept; if not, it is rejected. If you are creating a filter class inheriting this framework, and the daughter class is to be used in an AIS local context, you will need to implement the virtual function ActsOn.
    bool ActsOn (const TopAbs_ShapeEnum aStandardMode) const override
     Returns true in an AIS local context, if this filter operates on a type of subshape defined in a filter class inheriting this framework. This function completes IsOk in an AIS local context.
    Public Member Functions inherited from Standard_Transient
     Standard_Transient ()
     Empty constructor.
     Standard_Transient (const Standard_Transient &)
     Copy constructor – does nothing.
    Standard_Transientoperator= (const Standard_Transient &)
     Assignment operator, needed to avoid copying reference counter.
    virtual ~Standard_Transient ()=default
     Destructor must be virtual.
    virtual const opencascade::handle< Standard_Type > & DynamicType () const
     Returns a type descriptor about this object.
    bool IsInstance (const opencascade::handle< Standard_Type > &theType) const
     Returns a true value if this is an instance of Type.
    bool IsInstance (const char *const theTypeName) const
     Returns a true value if this is an instance of TypeName.
    bool 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.
    bool IsKind (const char *const 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_TransientThis () 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.
    int GetRefCount () const noexcept
     Get the reference counter of this object.
    void IncrementRefCounter () noexcept
     Increments the reference counter of this object. Uses relaxed memory ordering since incrementing only requires atomicity, not synchronization with other memory operations.
    int DecrementRefCounter () noexcept
     Decrements the reference counter of this object; returns the decremented value. Uses release ordering for the decrement to ensure all writes to the object are visible before the count reaches zero. An acquire fence is added only when the count reaches zero, ensuring proper synchronization before deletion. This is more efficient than using acq_rel for every decrement.
    virtual void Delete () const
     Memory deallocator for transient classes.

    Additional Inherited Members

    typedef void base_type
     Returns a type descriptor about this object.
    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

    A framework to define a filter to select a specific type of face. The types available include:

    • any face
    • a planar face
    • a cylindrical face
    • a spherical face
    • a toroidal face
    • a revol face.

    Constructor & Destructor Documentation

    ◆ StdSelect_FaceFilter()

    StdSelect_FaceFilter::StdSelect_FaceFilter ( const StdSelect_TypeOfFace aTypeOfFace)

    Constructs a face filter object defined by the type of face aTypeOfFace.

    Member Function Documentation

    ◆ ActsOn()

    bool StdSelect_FaceFilter::ActsOn ( const TopAbs_ShapeEnum aStandardMode) const
    overridevirtual

    Returns true in an AIS local context, if this filter operates on a type of subshape defined in a filter class inheriting this framework. This function completes IsOk in an AIS local context.

    Reimplemented from SelectMgr_Filter.

    ◆ IsOk()

    bool StdSelect_FaceFilter::IsOk ( const occ::handle< SelectMgr_EntityOwner > & anObj) const
    overridevirtual

    Indicates that the selected Interactive Object passes the filter. The owner, anObj, can be either direct or user. A direct owner is the corresponding construction element, whereas a user is the compound shape of which the entity forms a part. When an object is detected by the mouse - in AIS, this is done through a context selector - its owner is passed to the filter as an argument. If the object returns true, it is kept; if not, it is rejected. If you are creating a filter class inheriting this framework, and the daughter class is to be used in an AIS local context, you will need to implement the virtual function ActsOn.

    Implements SelectMgr_Filter.

    ◆ SetType()

    void StdSelect_FaceFilter::SetType ( const StdSelect_TypeOfFace aNewType)

    Sets the type of face aNewType. aNewType is to be highlighted in selection.

    ◆ Type()

    StdSelect_TypeOfFace StdSelect_FaceFilter::Type ( ) const

    Returns the type of face to be highlighted in selection.


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