Crazy Eddie's GUI System  0.8.5
RendererModules/Null/Renderer.h
1 /***********************************************************************
2  created: Fri Jan 15 2010
3  author: Eugene Marcotte
4 *************************************************************************/
5 /***************************************************************************
6  * Copyright (C) 2004 - 2011 Paul D Turner & The CEGUI Development Team
7  *
8  * Permission is hereby granted, free of charge, to any person obtaining
9  * a copy of this software and associated documentation files (the
10  * "Software"), to deal in the Software without restriction, including
11  * without limitation the rights to use, copy, modify, merge, publish,
12  * distribute, sublicense, and/or sell copies of the Software, and to
13  * permit persons to whom the Software is furnished to do so, subject to
14  * the following conditions:
15  *
16  * The above copyright notice and this permission notice shall be
17  * included in all copies or substantial portions of the Software.
18  *
19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
20  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
21  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
22  * IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
23  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
24  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
25  * OTHER DEALINGS IN THE SOFTWARE.
26  ***************************************************************************/
27 #ifndef _CEGUINullRenderer_h_
28 #define _CEGUINullRenderer_h_
29 
30 #include "../../Renderer.h"
31 #include "../../Size.h"
32 #include "../../Vector.h"
33 
34 #include <vector>
35 #include <map>
36 
37 #if (defined( __WIN32__ ) || defined( _WIN32 )) && !defined(CEGUI_STATIC)
38 # ifdef CEGUINULLRENDERER_EXPORTS
39 # define NULL_GUIRENDERER_API __declspec(dllexport)
40 # else
41 # define NULL_GUIRENDERER_API __declspec(dllimport)
42 # endif
43 #else
44 # define NULL_GUIRENDERER_API
45 #endif
46 
47 #if defined(_MSC_VER)
48 # pragma warning(push)
49 # pragma warning(disable : 4251)
50 #endif
51 
52 
53 // Start of CEGUI namespace section
54 namespace CEGUI
55 {
56 class NullGeometryBuffer;
57 class NullTexture;
58 
60 class NULL_GUIRENDERER_API NullRenderer : public Renderer
61 {
62 public:
80  static NullRenderer& bootstrapSystem(const int abi = CEGUI_VERSION_ABI);
81 
97  static void destroySystem();
98 
103  static NullRenderer& create(const int abi = CEGUI_VERSION_ABI);
104 
106  static void destroy(NullRenderer& renderer);
107 
123  bool isTexCoordSystemFlipped() const { return false; }
124 
125  // implement CEGUI::Renderer interface
126  RenderTarget& getDefaultRenderTarget();
127  GeometryBuffer& createGeometryBuffer();
128  void destroyGeometryBuffer(const GeometryBuffer& buffer);
129  void destroyAllGeometryBuffers();
130  TextureTarget* createTextureTarget();
131  void destroyTextureTarget(TextureTarget* target);
132  void destroyAllTextureTargets();
133  Texture& createTexture(const String& name);
134  Texture& createTexture(const String& name,
135  const String& filename,
136  const String& resourceGroup);
137  Texture& createTexture(const String& name, const Sizef& size);
138  void destroyTexture(Texture& texture);
139  void destroyTexture(const String& name);
140  void destroyAllTextures();
141  Texture& getTexture(const String& name) const;
142  bool isTextureDefined(const String& name) const;
143  void beginRendering();
144  void endRendering();
145  void setDisplaySize(const Sizef& sz);
146  const Sizef& getDisplaySize() const;
147  const Vector2f& getDisplayDPI() const;
148  uint getMaxTextureSize() const;
149  const String& getIdentifierString() const;
150 
151 protected:
153  NullRenderer();
155  void constructor_impl();
157  virtual ~NullRenderer();
158 
160  void throwIfNameExists(const String& name) const;
162  static void logTextureCreation(const String& name);
164  static void logTextureDestruction(const String& name);
165 
175  typedef std::vector<TextureTarget*> TextureTargetList;
177  TextureTargetList d_textureTargets;
179  typedef std::vector<NullGeometryBuffer*> GeometryBufferList;
181  GeometryBufferList d_geometryBuffers;
183  typedef std::map<String, NullTexture*, StringFastLessCompare
184  CEGUI_MAP_ALLOC(String, NullTexture*)> TextureMap;
189 };
190 
191 
192 } // End of CEGUI namespace section
193 
194 #if defined(_MSC_VER)
195 # pragma warning(pop)
196 #endif
197 
198 #endif // end of guard _CEGUINullRenderer_h_
Functor that can be used as comparator in a std::map with String keys. It's faster than using the def...
Definition: String.h:5579
Main namespace for Crazy Eddie's GUI Library.
Definition: arch_overview.dox:1
std::vector< NullGeometryBuffer * > GeometryBufferList
container type used to hold GeometryBuffers we create.
Definition: RendererModules/Null/Renderer.h:179
TextureMap d_textures
Container used to track textures.
Definition: RendererModules/Null/Renderer.h:186
Abstract class defining the interface for objects that buffer geometry for later rendering.
Definition: GeometryBuffer.h:42
Specialisation of RenderTarget interface that should be used as the base class for RenderTargets that...
Definition: TextureTarget.h:40
std::vector< TextureTarget * > TextureTargetList
container type used to hold TextureTargets we create.
Definition: RendererModules/Null/Renderer.h:175
Vector2f d_displayDPI
What the renderer considers to be the current display DPI resolution.
Definition: RendererModules/Null/Renderer.h:171
GeometryBufferList d_geometryBuffers
Container used to track geometry buffers.
Definition: RendererModules/Null/Renderer.h:181
TextureTargetList d_textureTargets
Container used to track texture targets.
Definition: RendererModules/Null/Renderer.h:177
Abstract base class specifying the required interface for Texture objects.
Definition: Texture.h:52
static String d_rendererID
String holding the renderer identification text.
Definition: RendererModules/Null/Renderer.h:167
CEGUI::Renderer implementation for no particular engine.
Definition: RendererModules/Null/Renderer.h:60
Abstract class defining the basic required interface for Renderer objects.
Definition: Renderer.h:82
uint d_maxTextureSize
What the renderer thinks the max texture size is.
Definition: RendererModules/Null/Renderer.h:188
std::map< String, NullTexture *, StringFastLessCompare CEGUI_MAP_ALLOC(String, NullTexture *)> TextureMap
container type used to hold Textures we create.
Definition: RendererModules/Null/Renderer.h:184
Defines interface to some surface that can be rendered to. Concrete instances of objects that impleme...
Definition: RenderTarget.h:57
bool isTexCoordSystemFlipped() const
Returns if the texture coordinate system is vertically flipped or not. The original of a texture coor...
Definition: RendererModules/Null/Renderer.h:123
Sizef d_displaySize
What the renderer considers to be the current display size.
Definition: RendererModules/Null/Renderer.h:169
Implementation of the CEGUI::Texture class for no particular engine.
Definition: RendererModules/Null/Texture.h:42
String class used within the GUI system.
Definition: String.h:62
RenderTarget * d_defaultTarget
The default RenderTarget.
Definition: RendererModules/Null/Renderer.h:173