EIC code displayed by LXR master/​include/​opencascade/​Graphic3d_Group.hxx	Source navigation Diff markup Identifier search General search
	Version: master test Revert   Change

Warning, file /include/opencascade/Graphic3d_Group.hxx was not indexed or was modified since last indexation (in which case cross-reference links may be missing, inaccurate or erroneous).

 // Created on: 1991-09-06
 // Created by: NW,JPB,CAL
 // Copyright (c) 1991-1999 Matra Datavision
 // Copyright (c) 1999-2014 OPEN CASCADE SAS
 //
 // This file is part of Open CASCADE Technology software library.
 //
 // This library is free software; you can redistribute it and/or modify it under
 // the terms of the GNU Lesser General Public License version 2.1 as published
 // by the Free Software Foundation, with special exception defined in the file
 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
 // distribution for complete text of the license and disclaimer of any warranty.
 //
 // Alternatively, this file may be used under the terms of Open CASCADE
 // commercial license or contractual agreement.
 
 #ifndef _Graphic3d_Group_HeaderFile
 #define _Graphic3d_Group_HeaderFile
 
 #include <Graphic3d_BndBox4f.hxx>
 #include <Graphic3d_AspectFillArea3d.hxx>
 #include <Graphic3d_Flipper.hxx>
 #include <NCollection_DataMap.hxx>
 #include <Standard_CString.hxx>
 #include <Graphic3d_Vertex.hxx>
 #include <Graphic3d_TextPath.hxx>
 #include <Graphic3d_HorizontalTextAlignment.hxx>
 #include <Graphic3d_VerticalTextAlignment.hxx>
 #include <Graphic3d_TypeOfPrimitiveArray.hxx>
 #include <Graphic3d_IndexBuffer.hxx>
 #include <Graphic3d_Buffer.hxx>
 #include <Graphic3d_BoundBuffer.hxx>
 #include <gp_Ax2.hxx>
 #include <TCollection_ExtendedString.hxx>
 class Graphic3d_Aspects;
 
 class Graphic3d_Structure;
 class Graphic3d_ArrayOfPrimitives;
 class Graphic3d_Text;
 class Graphic3d_TransformPers;
 
 //! This class allows the definition of groups
 //! of primitives inside of graphic objects (presentations).
 //! A group contains the primitives and attributes
 //! for which the range is limited to this group.
 //! The primitives of a group can be globally suppressed.
 //!
 //! There are two main group usage models:
 //!
 //! 1) Non-modifiable, or unbounded, group ('black box').
 //! Developers can repeat a sequence of
 //! SetPrimitivesAspect() with AddPrimitiveArray() methods arbitrary number of times
 //! to define arbitrary number of primitive "blocks" each having individual aspect values.
 //! Any modification of such a group is forbidden, as aspects and primitives are mixed
 //! in memory without any high-level logical structure, and any modification is very likely to
 //! result in corruption of the group internal data. It is necessary to recreate such a group as a
 //! whole when some attribute should be changed. (for example, in terms of AIS it is necessary to
 //! re-Compute() the whole presentation each time). 2) Bounded group. Developers should specify the
 //! necessary group aspects with help of SetGroupPrimitivesAspect() and then add primitives to the
 //! group. Such a group have simplified organization in memory (a single block of attributes
 //! followed by a block of primitives) and therefore it can be modified, if it is necessary to
 //! change parameters of some aspect that has already been set, using methods:
 //! IsGroupPrimitivesAspectSet() to detect which aspect was set for primitives;
 //! GroupPrimitivesAspect() to read current aspect values
 //! and SetGroupPrimitivesAspect() to set new values.
 //!
 //! Developers are strongly recommended to take all the above into account when filling
 //! Graphic3d_Group with aspects and primitives and choose the group usage model beforehand out of
 //! application needs. Note that some Graphic3d_Group class virtual methods contain only base
 //! implementation that is extended by the descendant class in OpenGl package.
 class Graphic3d_Group : public Standard_Transient
 {
   friend class Graphic3d_Structure;
   DEFINE_STANDARD_RTTIEXT(Graphic3d_Group, Standard_Transient)
 
 public:
   //! Suppress all primitives and attributes of <me>.
   //! To clear group without update in Graphic3d_StructureManager
   //! pass false as <theUpdateStructureMgr>. This
   //! used on context and viewer destruction, when the pointer
   //! to structure manager in Graphic3d_Structure could be
   //! already released (pointers are used here to avoid handle
   //! cross-reference);
   Standard_EXPORT virtual void Clear(const bool theUpdateStructureMgr = true);
 
   //! Suppress the group <me> in the structure.
   Standard_EXPORT ~Graphic3d_Group() override;
 
   //! Suppress the group <me> in the structure.
   //! Warning: No more graphic operations in <me> after this call.
   //! Modifies the current modelling transform persistence (pan, zoom or rotate)
   //! Get the current modelling transform persistence (pan, zoom or rotate)
   Standard_EXPORT void Remove();
 
 public:
   //! Return fill area aspect.
   virtual occ::handle<Graphic3d_Aspects> Aspects() const = 0;
 
   //! Modifies the context for all the face primitives of the group.
   virtual void SetGroupPrimitivesAspect(const occ::handle<Graphic3d_Aspects>& theAspect) = 0;
 
   //! Modifies the current context of the group to give another aspect for all the primitives
   //! created after this call in the group.
   virtual void SetPrimitivesAspect(const occ::handle<Graphic3d_Aspects>& theAspect) = 0;
 
   //! Update presentation aspects after their modification.
   virtual void SynchronizeAspects() = 0;
 
   //! Replace aspects specified in the replacement map.
   virtual void ReplaceAspects(
     const NCollection_DataMap<occ::handle<Graphic3d_Aspects>, occ::handle<Graphic3d_Aspects>>&
       theMap) = 0;
 
   //! Adds a text for display
   Standard_EXPORT virtual void AddText(const occ::handle<Graphic3d_Text>& theTextParams,
                                        const bool                         theToEvalMinMax = true);
 
   //! Adds an array of primitives for display
   Standard_EXPORT virtual void AddPrimitiveArray(
     const Graphic3d_TypeOfPrimitiveArray      theType,
     const occ::handle<Graphic3d_IndexBuffer>& theIndices,
     const occ::handle<Graphic3d_Buffer>&      theAttribs,
     const occ::handle<Graphic3d_BoundBuffer>& theBounds,
     const bool                                theToEvalMinMax = true);
 
   //! Adds an array of primitives for display
   Standard_EXPORT void AddPrimitiveArray(const occ::handle<Graphic3d_ArrayOfPrimitives>& thePrim,
                                          const bool theToEvalMinMax = true);
 
 public:
   //! sets the stencil test to theIsEnabled state;
   Standard_EXPORT virtual void SetStencilTestOptions(const bool theIsEnabled) = 0;
 
   //! sets the flipping to theIsEnabled state.
   Standard_EXPORT virtual void SetFlippingOptions(const bool    theIsEnabled,
                                                   const gp_Ax2& theRefPlane) = 0;
 
   //! Return flipper metadata describing the runtime flip of this group, or null if not flipped.
   const occ::handle<Graphic3d_Flipper>& Flipper() const { return myFlipper; }
 
   //! Return transformation.
   const gp_Trsf& Transformation() const { return myTrsf; }
 
   //! Assign transformation.
   virtual void SetTransformation(const gp_Trsf& theTrsf) { myTrsf = theTrsf; }
 
   //! Return transformation persistence.
   const occ::handle<Graphic3d_TransformPers>& TransformPersistence() const { return myTrsfPers; }
 
   //! Set transformation persistence.
   Standard_EXPORT virtual void SetTransformPersistence(
     const occ::handle<Graphic3d_TransformPers>& theTrsfPers);
 
   //! Returns true if the group <me> is deleted.
   //! <me> is deleted after the call Remove (me) or the
   //! associated structure is deleted.
   Standard_EXPORT bool IsDeleted() const;
 
   //! Returns true if the group <me> is empty.
   Standard_EXPORT bool IsEmpty() const;
 
   //! Returns the coordinates of the boundary box of the group.
   Standard_EXPORT void MinMaxValues(double& theXMin,
                                     double& theYMin,
                                     double& theZMin,
                                     double& theXMax,
                                     double& theYMax,
                                     double& theZMax) const;
 
   //! Sets the coordinates of the boundary box of the group.
   Standard_EXPORT void SetMinMaxValues(const double theXMin,
                                        const double theYMin,
                                        const double theZMin,
                                        const double theXMax,
                                        const double theYMax,
                                        const double theZMax);
 
   //! Returns boundary box of the group <me> without transformation applied,
   const Graphic3d_BndBox4f& BoundingBox() const { return myBounds; }
 
   //! Returns non-const boundary box of the group <me> without transformation applied,
   Graphic3d_BndBox4f& ChangeBoundingBox() { return myBounds; }
 
   //! Returns the structure containing the group <me>.
   Standard_EXPORT occ::handle<Graphic3d_Structure> Structure() const;
 
   //! Changes property shown that primitive arrays within this group form closed volume (do no
   //! contain open shells).
   void SetClosed(const bool theIsClosed) { myIsClosed = theIsClosed; }
 
   //! Return true if primitive arrays within this graphic group form closed volume (do no contain
   //! open shells).
   bool IsClosed() const { return myIsClosed; }
 
   //! @name obsolete methods
 public:
   Standard_DEPRECATED(
     "Deprecated method Marker(), pass Graphic3d_ArrayOfPoints to AddPrimitiveArray() instead")
   Standard_EXPORT void Marker(const Graphic3d_Vertex& thePoint, const bool theToEvalMinMax = true);
 
   //! Creates the string <AText> at position <APoint>.
   //! The 3D point of attachment is projected. The text is
   //! written in the plane of projection.
   //! The attributes are given with respect to the plane of
   //! projection.
   //! AHeight : Height of text.
   //! (Relative to the Normalized Projection
   //! Coordinates (NPC) Space).
   //! AAngle  : Orientation of the text
   //! (with respect to the horizontal).
   Standard_DEPRECATED(
     "Deprecated method Text() with obsolete arguments, use AddText() instead of it")
   Standard_EXPORT virtual void Text(const char* const                       AText,
                                     const Graphic3d_Vertex&                 APoint,
                                     const double                            AHeight,
                                     const double                            AAngle,
                                     const Graphic3d_TextPath                ATp,
                                     const Graphic3d_HorizontalTextAlignment AHta,
                                     const Graphic3d_VerticalTextAlignment   AVta,
                                     const bool                              EvalMinMax = true);
 
   //! Creates the string <AText> at position <APoint>.
   //! The 3D point of attachment is projected. The text is
   //! written in the plane of projection.
   //! The attributes are given with respect to the plane of
   //! projection.
   //! AHeight : Height of text.
   //! (Relative to the Normalized Projection
   //! Coordinates (NPC) Space).
   //! The other attributes have the following default values:
   //! AAngle  : PI / 2.
   //! ATp     : TP_RIGHT
   //! AHta    : HTA_LEFT
   //! AVta    : VTA_BOTTOM
   Standard_DEPRECATED(
     "Deprecated method Text() with obsolete arguments, use AddText() instead of it")
   Standard_EXPORT void Text(const char* const       AText,
                             const Graphic3d_Vertex& APoint,
                             const double            AHeight,
                             const bool              EvalMinMax = true);
 
   //! Creates the string <AText> at position <APoint>.
   //! The 3D point of attachment is projected. The text is
   //! written in the plane of projection.
   //! The attributes are given with respect to the plane of
   //! projection.
   //! AHeight : Height of text.
   //! (Relative to the Normalized Projection
   //! Coordinates (NPC) Space).
   //! AAngle  : Orientation of the text
   //! (with respect to the horizontal).
   Standard_DEPRECATED(
     "Deprecated method Text() with obsolete arguments, use AddText() instead of it")
   Standard_EXPORT void Text(const TCollection_ExtendedString&       AText,
                             const Graphic3d_Vertex&                 APoint,
                             const double                            AHeight,
                             const double                            AAngle,
                             const Graphic3d_TextPath                ATp,
                             const Graphic3d_HorizontalTextAlignment AHta,
                             const Graphic3d_VerticalTextAlignment   AVta,
                             const bool                              EvalMinMax = true);
 
   //! Creates the string <AText> at position <APoint>.
   //! The 3D point of attachment is projected. The text is
   //! written in the plane of projection.
   //! The attributes are given with respect to the plane of
   //! projection.
   //! AHeight : Height of text.
   //! (Relative to the Normalized Projection
   //! Coordinates (NPC) Space).
   //! The other attributes have the following default values:
   //! AAngle  : PI / 2.
   //! ATp     : TP_RIGHT
   //! AHta    : HTA_LEFT
   //! AVta    : VTA_BOTTOM
   Standard_DEPRECATED(
     "Deprecated method Text() with obsolete arguments, use AddText() instead of it")
   Standard_EXPORT void Text(const TCollection_ExtendedString& AText,
                             const Graphic3d_Vertex&           APoint,
                             const double                      AHeight,
                             const bool                        EvalMinMax = true);
 
   //! Creates the string <theText> at orientation <theOrientation> in 3D space.
   Standard_DEPRECATED(
     "Deprecated method Text() with obsolete arguments, use AddText() instead of it")
   Standard_EXPORT virtual void Text(const char* const                       theTextUtf,
                                     const gp_Ax2&                           theOrientation,
                                     const double                            theHeight,
                                     const double                            theAngle,
                                     const Graphic3d_TextPath                theTp,
                                     const Graphic3d_HorizontalTextAlignment theHTA,
                                     const Graphic3d_VerticalTextAlignment   theVTA,
                                     const bool                              theToEvalMinMax = true,
                                     const bool                              theHasOwnAnchor = true);
 
   //! Creates the string <theText> at orientation <theOrientation> in 3D space.
   Standard_DEPRECATED(
     "Deprecated method Text() with obsolete arguments, use AddText() instead of it")
   Standard_EXPORT virtual void Text(const TCollection_ExtendedString&       theText,
                                     const gp_Ax2&                           theOrientation,
                                     const double                            theHeight,
                                     const double                            theAngle,
                                     const Graphic3d_TextPath                theTp,
                                     const Graphic3d_HorizontalTextAlignment theHTA,
                                     const Graphic3d_VerticalTextAlignment   theVTA,
                                     const bool                              theToEvalMinMax = true,
                                     const bool                              theHasOwnAnchor = true);
 
   //! Dumps the content of me into the stream
   Standard_EXPORT virtual void DumpJson(Standard_OStream& theOStream, int theDepth = -1) const;
 
 protected:
   //! Creates a group in the structure <AStructure>.
   Standard_EXPORT Graphic3d_Group(const occ::handle<Graphic3d_Structure>& theStructure);
 
   //! Calls the Update method of the StructureManager which
   //! contains the associated Structure of the Group <me>.
   Standard_EXPORT void Update() const;
 
 protected:
   occ::handle<Graphic3d_TransformPers> myTrsfPers;  //!< current transform persistence
   occ::handle<Graphic3d_Flipper>       myFlipper;   //!< current group flipping
   Graphic3d_Structure*                 myStructure; //!< pointer to the parent structure
   Graphic3d_BndBox4f                   myBounds;    //!< bounding box
   gp_Trsf                              myTrsf;      //!< group transformation
   bool                                 myIsClosed;  //!< flag indicating closed volume
 };
 
 #endif // _Graphic3d_Group_HeaderFile

This page was automatically generated by the 2.3.7 LXR engine. The LXR team