0024624: Lost word in license statement in source files
[occt.git] / src / OpenGl / OpenGl_CappingPlaneResource.hxx
1 // Created on: 2013-08-15
2 // Created by: Anton POLETAEV
3 // Copyright (c) 2013-2014 OPEN CASCADE SAS
4 //
5 // This file is part of Open CASCADE Technology software library.
6 //
7 // This library is free software; you can redistribute it and/or modify it under
8 // the terms of the GNU Lesser General Public License version 2.1 as published
9 // by the Free Software Foundation, with special exception defined in the file
10 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
11 // distribution for complete text of the license and disclaimer of any warranty.
12 //
13 // Alternatively, this file may be used under the terms of Open CASCADE
14 // commercial license or contractual agreement.
15
16 #ifndef _OpenGl_CappingPlaneResource_H__
17 #define _OpenGl_CappingPlaneResource_H__
18
19 #include <OpenGl_Resource.hxx>
20 #include <OpenGl_AspectFace.hxx>
21 #include <OpenGl_Matrix.hxx>
22 #include <Graphic3d_ClipPlane.hxx>
23
24 class Handle(OpenGl_Context);
25
26 DEFINE_STANDARD_HANDLE (OpenGl_CappingPlaneResource, OpenGl_Resource)
27
28 //! Container of graphical resources for rendering capping plane
29 //! associated to graphical clipping plane.
30 //! This resource holds data necessary for OpenGl_CappingAlgo.
31 //! This object is implemented as OpenGl resource for the following reasons:
32 //! - one instance should be shared between contexts.
33 //! - instance associated to Graphic3d_ClipPlane data by id.
34 //! - should created and released within context (owns OpenGl elements and resources).
35 class OpenGl_CappingPlaneResource : public OpenGl_Resource
36 {
37 public:
38
39   //! Constructor.
40   //! Create capping plane presentation associated to clipping plane data.
41   //! @param thePlane [in] the plane data.
42   Standard_EXPORT OpenGl_CappingPlaneResource (const Handle(Graphic3d_ClipPlane)& thePlane);
43
44   //! Destroy object.
45   Standard_EXPORT virtual ~OpenGl_CappingPlaneResource();
46
47   //! Update resource data in the passed context.
48   //! @param theContext [in] the context.
49   Standard_EXPORT void Update (const Handle(OpenGl_Context)& theContext);
50
51   //! Release associated OpenGl resources.
52   //! @param theContext [in] the resource context.
53   Standard_EXPORT void Release (const OpenGl_Context* theContext);
54
55   //! @return aspect face for rendering capping surface.
56   inline const OpenGl_AspectFace* AspectFace() const { return myAspect; }
57
58   //! @return evaluated orientation matrix to transform infinite plane.
59   inline const OpenGl_Matrix* Orientation() const { return &myOrientation; }
60
61 private:
62
63   //! Update precomputed plane orientation matrix.
64   void UpdateTransform();
65
66   //! Update resources.
67   //! @param theContext [in] the context.
68   void UpdateAspect (const Handle(OpenGl_Context)& theContext);
69
70 private:
71
72   OpenGl_Matrix               myOrientation;   //!< plane transformation matrix.
73   OpenGl_AspectFace*          myAspect;        //!< capping face aspect.
74   Handle(Graphic3d_ClipPlane) myPlaneRoot;     //!< parent clipping plane structure.
75   unsigned int                myEquationMod;   //!< modification counter for plane equation.
76   unsigned int                myAspectMod;     //!< modification counter for aspect.
77
78 public:
79
80   DEFINE_STANDARD_RTTI(OpenGl_CappingPlaneResource) // Type definition
81
82 };
83
84 #endif