OgreMaterialManager.h
Go to the documentation of this file.
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-2013 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 __MATERIALMANAGER_H__
29 #define __MATERIALMANAGER_H__
30 
31 #include "OgrePrerequisites.h"
32 
33 #include "OgreSingleton.h"
34 #include "OgreResourceManager.h"
35 #include "OgreMaterial.h"
36 #include "OgreStringVector.h"
37 #include "OgreMaterialSerializer.h"
38 #include "OgreHeaderPrefix.h"
39 
40 namespace Ogre {
41 
42 
64  class _OgreExport MaterialManager : public ResourceManager, public Singleton<MaterialManager>
65  {
66  public:
70  class Listener
71  {
72  public:
74  virtual ~Listener() { }
104  virtual Technique* handleSchemeNotFound(unsigned short schemeIndex,
105  const String& schemeName, Material* originalMaterial, unsigned short lodIndex,
106  const Renderable* rend) = 0;
107 
108  };
109 
110  protected:
111 
120 
123 
125  unsigned int mDefaultMaxAniso;
130 
132  Resource* createImpl(const String& name, ResourceHandle handle,
133  const String& group, bool isManual, ManualResourceLoader* loader,
134  const NameValuePairList* params);
135 
143  unsigned short mActiveSchemeIndex;
144 
149 
150  public:
153 
156  MaterialPtr create (const String& name, const String& group,
157  bool isManual = false, ManualResourceLoader* loader = 0,
158  const NameValuePairList* createParams = 0);
159 
162  MaterialPtr getByName(const String& name, const String& groupName = ResourceGroupManager::AUTODETECT_RESOURCE_GROUP_NAME);
163 
166  MaterialManager();
167 
170  virtual ~MaterialManager();
171 
174  void initialise(void);
175 
178  void parseScript(DataStreamPtr& stream, const String& groupName);
179 
180 
187  virtual void setDefaultTextureFiltering(TextureFilterOptions fo);
192  virtual void setDefaultTextureFiltering(FilterType ftype, FilterOptions opts);
197  virtual void setDefaultTextureFiltering(FilterOptions minFilter, FilterOptions magFilter, FilterOptions mipFilter);
198 
200  virtual FilterOptions getDefaultTextureFiltering(FilterType ftype) const;
201 
208  void setDefaultAnisotropy(unsigned int maxAniso);
210  unsigned int getDefaultAnisotropy() const;
211 
242  virtual MaterialPtr getDefaultSettings(void) const { return mDefaultSettings; }
243 
247  virtual unsigned short _getSchemeIndex(const String& name);
251  virtual const String& _getSchemeName(unsigned short index);
255  virtual unsigned short _getActiveSchemeIndex(void) const;
256 
260  virtual const String& getActiveScheme(void) const;
261 
265  virtual void setActiveScheme(const String& schemeName);
266 
271  virtual void addListener(Listener* l, const Ogre::String& schemeName = StringUtil::BLANK);
272 
277  virtual void removeListener(Listener* l, const Ogre::String& schemeName = StringUtil::BLANK);
278 
280  virtual Technique* _arbitrateMissingTechniqueForActiveScheme(
281  Material* mat, unsigned short lodIndex, const Renderable* rend);
282 
298  static MaterialManager& getSingleton(void);
314  static MaterialManager* getSingletonPtr(void);
315 
316  };
320 }
321 
322 #include "OgreHeaderSuffix.h"
323 
324 #endif
OgreHeaderSuffix.h
Ogre::ResourceHandle
unsigned long long int ResourceHandle
Definition: OgreResource.h:41
Ogre::MaterialManager::mDefaultMaxAniso
unsigned int mDefaultMaxAniso
Default Texture anisotropy.
Definition: OgreMaterialManager.h:125
Ogre
Definition: OgreAndroidLogListener.h:34
Ogre::MaterialManager::mDefaultCompare
FilterOptions mDefaultCompare
Default Texture filtering - comparison.
Definition: OgreMaterialManager.h:119
OGRE_THREAD_POINTER
#define OGRE_THREAD_POINTER(T, var)
Definition: OgreThreadDefinesBoost.h:66
Ogre::MaterialManager::ListenerMap
map< String, ListenerList >::type ListenerMap
Definition: OgreMaterialManager.h:147
Ogre::map
Definition: OgrePrerequisites.h:533
OgreSingleton.h
Ogre::MaterialManager::getDefaultSettings
virtual MaterialPtr getDefaultSettings(void) const
Returns a pointer to the default Material settings.
Definition: OgreMaterialManager.h:242
Ogre::MaterialManager::ListenerList
list< Listener * >::type ListenerList
The list of per-scheme (and general) material listeners.
Definition: OgreMaterialManager.h:146
Ogre::MaterialManager
Class for managing Material settings for Ogre.
Definition: OgreMaterialManager.h:64
Ogre::MaterialManager::Listener
Listener on any general material events.
Definition: OgreMaterialManager.h:70
Ogre::Material
Class encapsulates rendering properties of an object.
Definition: OgreMaterial.h:88
Ogre::MaterialManager::mListenerMap
ListenerMap mListenerMap
Definition: OgreMaterialManager.h:148
Ogre::ResourceGroupManager::AUTODETECT_RESOURCE_GROUP_NAME
static String AUTODETECT_RESOURCE_GROUP_NAME
Special resource group name which causes resource group to be automatically determined based on searc...
Definition: OgreResourceGroupManager.h:270
Ogre::TextureFilterOptions
TextureFilterOptions
High-level filtering options providing shortcuts to settings the minification, magnification and mip ...
Definition: OgreCommon.h:78
OgreMaterialSerializer.h
Ogre::MaterialManager::mDefaultCompareFunction
CompareFunction mDefaultCompareFunction
Definition: OgreMaterialManager.h:122
Ogre::String
_StringBase String
Definition: OgrePrerequisites.h:439
Ogre::MaterialManager::DEFAULT_SCHEME_NAME
static String DEFAULT_SCHEME_NAME
Default material scheme.
Definition: OgreMaterialManager.h:152
Ogre::MaterialManager::Listener::~Listener
virtual ~Listener()
Virtual destructor needed as class has virtual methods.
Definition: OgreMaterialManager.h:74
Ogre::Technique
Class representing an approach to rendering this particular Material.
Definition: OgreTechnique.h:53
Ogre::NameValuePairList
map< String, String >::type NameValuePairList
Name / value parameter pair (first = name, second = value)
Definition: OgreCommon.h:550
OgreMaterial.h
Ogre::CompareFunction
CompareFunction
Comparison functions used for the depth/stencil buffer operations and others.
Definition: OgreCommon.h:64
Ogre::StringUtil::BLANK
static const String BLANK
Constant blank string, useful for returning by ref where local does not exist.
Definition: OgreString.h:196
OgreHeaderPrefix.h
Ogre::MaterialManager::SchemeMap
map< String, unsigned short >::type SchemeMap
Scheme name -> index. Never shrinks! Should be pretty static anyway.
Definition: OgreMaterialManager.h:137
Ogre::list
Definition: OgrePrerequisites.h:505
OgrePrerequisites.h
Ogre::MaterialSerializer
Class for serializing Materials to / from a .material script.
Definition: OgreMaterialSerializer.h:106
Ogre::Singleton
Template class for creating single-instance global classes.
Definition: OgreSingleton.h:64
Ogre::FilterOptions
FilterOptions
Filtering options for textures / mipmaps.
Definition: OgreCommon.h:100
_OgreExport
#define _OgreExport
Definition: OgrePlatform.h:257
Ogre::ResourceManager
Defines a generic resource handler.
Definition: OgreResourceManager.h:122
Ogre::MaterialManager::mDefaultSettings
MaterialPtr mDefaultSettings
Default settings.
Definition: OgreMaterialManager.h:129
Ogre::MaterialManager::mDefaultMagFilter
FilterOptions mDefaultMagFilter
Default Texture filtering - magnification.
Definition: OgreMaterialManager.h:115
Ogre::SharedPtr< Material >
Ogre::Resource
Abstract class representing a loadable resource (e.g.
Definition: OgreResource.h:79
Ogre::MaterialManager::mSchemes
SchemeMap mSchemes
List of material schemes.
Definition: OgreMaterialManager.h:139
Ogre::MaterialManager::mActiveSchemeName
String mActiveSchemeName
Current material scheme.
Definition: OgreMaterialManager.h:141
Ogre::Renderable
Abstract class defining the interface all renderable objects must implement.
Definition: OgreRenderable.h:63
Ogre::MaterialManager::mActiveSchemeIndex
unsigned short mActiveSchemeIndex
Current material scheme.
Definition: OgreMaterialManager.h:143
Ogre::MaterialManager::mDefaultCompareEnabled
bool mDefaultCompareEnabled
Definition: OgreMaterialManager.h:121
OgreStringVector.h
Ogre::MaterialManager::mDefaultMinFilter
FilterOptions mDefaultMinFilter
Default Texture filtering - minification.
Definition: OgreMaterialManager.h:113
Ogre::ManualResourceLoader
Interface describing a manual resource loader.
Definition: OgreResource.h:514
Ogre::FilterType
FilterType
Definition: OgreCommon.h:90
OgreResourceManager.h
Ogre::MaterialManager::mDefaultMipFilter
FilterOptions mDefaultMipFilter
Default Texture filtering - mipmapping.
Definition: OgreMaterialManager.h:117

Copyright © 2012 Torus Knot Software Ltd
Creative Commons License
This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.