/src/ogre/OgreMain/include/OgreRectangle2D.h
Line | Count | Source |
1 | | /* |
2 | | ----------------------------------------------------------------------------- |
3 | | This source file is part of OGRE |
4 | | (Object-oriented Graphics Rendering Engine) |
5 | | For the latest info, see http://www.ogre3d.org/ |
6 | | |
7 | | Copyright (c) 2000-2014 Torus Knot Software Ltd |
8 | | |
9 | | Permission is hereby granted, free of charge, to any person obtaining a copy |
10 | | of this software and associated documentation files (the "Software"), to deal |
11 | | in the Software without restriction, including without limitation the rights |
12 | | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
13 | | copies of the Software, and to permit persons to whom the Software is |
14 | | furnished to do so, subject to the following conditions: |
15 | | |
16 | | The above copyright notice and this permission notice shall be included in |
17 | | all copies or substantial portions of the Software. |
18 | | |
19 | | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
20 | | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
21 | | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
22 | | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
23 | | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, |
24 | | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN |
25 | | THE SOFTWARE. |
26 | | ----------------------------------------------------------------------------- |
27 | | */ |
28 | | #ifndef _Rectangle2D_H__ |
29 | | #define _Rectangle2D_H__ |
30 | | |
31 | | #include "OgrePrerequisites.h" |
32 | | |
33 | | #include "OgreSimpleRenderable.h" |
34 | | |
35 | | namespace Ogre { |
36 | | |
37 | | /** \addtogroup Core |
38 | | * @{ |
39 | | */ |
40 | | /** \addtogroup Scene |
41 | | * @{ |
42 | | */ |
43 | | /** Allows the rendering of a simple 2D rectangle |
44 | | This class renders a simple 2D rectangle; this rectangle has no depth and |
45 | | therefore is best used with specific render queue and depth settings, |
46 | | like RENDER_QUEUE_BACKGROUND and 'depth_write off' for backdrops, and |
47 | | RENDER_QUEUE_OVERLAY and 'depth_check off' for fullscreen quads. |
48 | | */ |
49 | | class _OgreExport Rectangle2D : public SimpleRenderable |
50 | | { |
51 | | protected: |
52 | | /** Override this method to prevent parent transforms (rotation,translation,scale) |
53 | | */ |
54 | | void getWorldTransforms( Matrix4* xform ) const override; |
55 | | |
56 | | void _initRectangle2D(bool includeTextureCoords, HardwareBuffer::Usage vBufUsage); |
57 | | |
58 | | public: |
59 | | |
60 | | Rectangle2D(bool includeTextureCoordinates = false, HardwareBuffer::Usage vBufUsage = HBU_GPU_ONLY); |
61 | | Rectangle2D(const String& name, bool includeTextureCoordinates = false, HardwareBuffer::Usage vBufUsage = HBU_GPU_ONLY); |
62 | | ~Rectangle2D(); |
63 | | |
64 | | /** Sets the corners of the rectangle, in relative coordinates. |
65 | | @param |
66 | | left Left position in screen relative coordinates, -1 = left edge, 1.0 = right edge |
67 | | @param top Top position in screen relative coordinates, 1 = top edge, -1 = bottom edge |
68 | | @param right Right position in screen relative coordinates |
69 | | @param bottom Bottom position in screen relative coordinates |
70 | | @param updateAABB Tells if you want to recalculate the AABB according to |
71 | | the new corners. If false, the axis aligned bounding box will remain identical. |
72 | | */ |
73 | | void setCorners(float left, float top, float right, float bottom, bool updateAABB = false); |
74 | | |
75 | | /** Sets the normals of the rectangle |
76 | | */ |
77 | | void setNormals(const Vector3& topLeft, const Vector3& bottomLeft, const Vector3& topRight, |
78 | | const Vector3& bottomRight); |
79 | | |
80 | | /** Sets the UVs of the rectangle |
81 | | |
82 | | Doesn't do anything if the rectangle wasn't built with texture coordinates |
83 | | */ |
84 | | void setUVs(const Vector2& topLeft, const Vector2& bottomLeft, const Vector2& topRight, |
85 | | const Vector2& bottomRight); |
86 | | |
87 | | void setDefaultUVs(); |
88 | | |
89 | | Real getSquaredViewDepth(const Camera* cam) const override |
90 | 0 | { (void)cam; return 0; } |
91 | | |
92 | 0 | Real getBoundingRadius(void) const override { return 0; } |
93 | | |
94 | | const String& getMovableType() const override; |
95 | | }; |
96 | | /** @} */ |
97 | | /** @} */ |
98 | | |
99 | | }// namespace |
100 | | |
101 | | #endif |
102 | | |
103 | | |