![]() |
OGRE
1.10.8
Object-Oriented Graphics Rendering Engine
|
#include <OgreGL3PlusTexture.h>
Public Types | |
enum | LoadingFlags { LF_DEFAULT = 0, LF_INCLUDE_NON_RELOADABLE = 1, LF_ONLY_UNREFERENCED = 2, LF_ONLY_UNREFERENCED_INCLUDE_NON_RELOADABLE = 3, LF_PRESERVE_STATE = 4 } |
Enum that allow to choose subset of unloaded/reloaded resources and to adjust reloading behavior. More... | |
enum | LoadingState { LOADSTATE_UNLOADED, LOADSTATE_LOADING, LOADSTATE_LOADED, LOADSTATE_UNLOADING, LOADSTATE_PREPARED, LOADSTATE_PREPARING } |
Enum identifying the loading state of the resource. More... | |
Public Member Functions | |
GL3PlusTexture (ResourceManager *creator, const String &name, ResourceHandle handle, const String &group, bool isManual, ManualResourceLoader *loader, GL3PlusRenderSystem *renderSystem) | |
virtual | ~GL3PlusTexture () |
virtual void | _dirtyState () |
Manually mark the state of this resource as having been changed. More... | |
virtual void | _fireLoadingComplete (bool wasBackgroundLoaded) |
Firing of loading complete event. More... | |
virtual void | _firePreparingComplete (bool wasBackgroundLoaded) |
Firing of preparing complete event. More... | |
virtual void | _fireUnloadingComplete (void) |
Firing of unloading complete event. More... | |
virtual void | _loadImages (const ConstImagePtrList &images) |
Internal method to load the texture from a set of images. More... | |
virtual void | _notifyOrigin (const String &origin) |
Notify this resource of it's origin. More... | |
virtual void | addListener (Listener *lis) |
Register a listener on this resource. More... | |
virtual void | changeGroupOwnership (const String &newGroup) |
Change the resource group ownership of a Resource. More... | |
virtual void | convertToImage (Image &destImage, bool includeMipMaps=false) |
Populate an Image with the contents of this texture. More... | |
virtual void | copyParametersTo (StringInterface *dest) const |
Method for copying this object's parameters to another object. More... | |
virtual void | copyToTexture (TexturePtr &target) |
Copies (and maybe scales to fit) the contents of this texture to another texture. More... | |
virtual void | createInternalResources (void) |
Creates the internal texture resources for this texture. More... | |
void | createRenderTexture () |
void | createShaderAccessPoint (uint bindPoint, TextureAccess access=TA_READ_WRITE, int mipmapLevel=0, int textureArrayIndex=0, PixelFormat *format=NULL) |
Enable read and/or write privileges to the texture from shaders. More... | |
virtual void | escalateLoading () |
Escalates the loading of a background loaded resource. More... | |
virtual void | freeInternalResources (void) |
Frees internal texture resources for this texture. More... | |
virtual ResourceManager * | getCreator (void) |
Gets the manager which created this resource. More... | |
void | getCustomAttribute (const String &name, void *pData) |
Retrieve a platform or API-specific piece of information from this texture. More... | |
virtual uint32 | getDepth (void) const |
Returns the depth of the texture (only applicable for 3D textures). More... | |
virtual ushort | getDesiredFloatBitDepth (void) const |
gets desired bit depth for float pixel format textures. More... | |
virtual PixelFormat | getDesiredFormat (void) const |
Returns the desired pixel format for the texture surface. More... | |
virtual ushort | getDesiredIntegerBitDepth (void) const |
gets desired bit depth for integer pixel format textures. More... | |
virtual PixelFormat | getFormat () const |
Returns the pixel format for the texture surface. More... | |
virtual uint | getFSAA () const |
Get the level of multisample AA to be used if this texture is a rendertarget. More... | |
virtual const String & | getFSAAHint () const |
Get the multisample AA hint if this texture is a rendertarget. More... | |
virtual float | getGamma (void) const |
Returns the gamma adjustment factor applied to this texture on loading. More... | |
GLenum | getGL3PlusTextureTarget (void) const |
uint | getGLID () const |
virtual const String & | getGroup (void) const |
Gets the group which this resource is a member of. More... | |
virtual ResourceHandle | getHandle (void) const |
virtual uint32 | getHeight (void) const |
Returns the height of the texture. More... | |
virtual LoadingState | getLoadingState () const |
Returns the current loading state. More... | |
virtual bool | getMipmapsHardwareGenerated (void) const |
Are mipmaps hardware generated? More... | |
virtual const String & | getName (void) const |
Gets resource name. More... | |
virtual size_t | getNumFaces () const |
Return the number of faces this texture has. More... | |
virtual uint32 | getNumMipmaps (void) const |
Gets the number of mipmaps to be used for this texture. More... | |
virtual const String & | getOrigin (void) const |
Get the origin of this resource, e.g. More... | |
ParamDictionary * | getParamDictionary (void) |
Retrieves the parameter dictionary for this class. More... | |
const ParamDictionary * | getParamDictionary (void) const |
virtual String | getParameter (const String &name) const |
Generic parameter retrieval method. More... | |
const ParameterList & | getParameters (void) const |
Retrieves a list of parameters valid for this object. More... | |
virtual size_t | getSize (void) const |
Retrieves info about the size of the resource. More... | |
virtual uint32 | getSrcDepth (void) const |
Returns the original depth of the input texture (only applicable for 3D textures). More... | |
virtual PixelFormat | getSrcFormat (void) const |
Returns the pixel format of the original input texture (may differ due to hardware requirements and pixel format conversion). More... | |
virtual uint32 | getSrcHeight (void) const |
Returns the height of the original input texture (may differ due to hardware requirements). More... | |
virtual uint32 | getSrcWidth (void) const |
Returns the width of the original input texture (may differ due to hardware requirements). More... | |
virtual size_t | getStateCount () const |
Returns the number of times this resource has changed state, which generally means the number of times it has been loaded. More... | |
virtual TextureType | getTextureType (void) const |
Gets the type of texture. More... | |
virtual bool | getTreatLuminanceAsAlpha (void) const |
Gets whether luminace pixel format will treated as alpha format when load this texture. More... | |
virtual int | getUsage () const |
Returns the TextureUsage identifier for this Texture. More... | |
virtual uint32 | getWidth (void) const |
Returns the width of the texture. More... | |
virtual bool | hasAlpha (void) const |
Returns true if the texture has an alpha layer. More... | |
virtual bool | isBackgroundLoaded (void) const |
Returns whether this Resource has been earmarked for background loading. More... | |
virtual bool | isHardwareGammaEnabled () const |
Gets whether this texture will be set up so that on sampling it, hardware gamma correction is applied. More... | |
virtual bool | isLoaded (void) const |
Returns true if the Resource has been loaded, false otherwise. More... | |
virtual bool | isLoading () const |
Returns whether the resource is currently in the process of background loading. More... | |
virtual bool | isManuallyLoaded (void) const |
Is this resource manually loaded? More... | |
virtual bool | isPrepared (void) const |
Returns true if the Resource has been prepared, false otherwise. More... | |
virtual bool | isReloadable (void) const |
Returns true if the Resource is reloadable, false otherwise. More... | |
virtual void | load (bool backgroundThread=false) |
Loads the resource, if it is not already. More... | |
virtual void | loadImage (const Image &img) |
Loads the data from an image. More... | |
virtual void | loadRawData (DataStreamPtr &stream, ushort uWidth, ushort uHeight, PixelFormat eFormat) |
Loads the data from a raw stream. More... | |
virtual void | prepare (bool backgroundThread=false) |
Prepares the resource for load, if it is not already. More... | |
virtual void | reload (LoadingFlags flags=LF_DEFAULT) |
Reloads the resource, if it is already loaded. More... | |
virtual void | removeListener (Listener *lis) |
Remove a listener on this resource. More... | |
virtual void | setBackgroundLoaded (bool bl) |
Tells the resource whether it is background loaded or not. More... | |
virtual void | setDepth (uint32 d) |
Set the depth of the texture (only applicable for 3D textures); can only do this before load();. More... | |
virtual void | setDesiredBitDepths (ushort integerBits, ushort floatBits) |
Sets desired bit depth for integer and float pixel format. More... | |
virtual void | setDesiredFloatBitDepth (ushort bits) |
Sets desired bit depth for float pixel format textures. More... | |
virtual void | setDesiredIntegerBitDepth (ushort bits) |
Sets desired bit depth for integer pixel format textures. More... | |
virtual void | setFormat (PixelFormat pf) |
Sets the pixel format for the texture surface; can only be set before load(). More... | |
virtual void | setFSAA (uint fsaa, const String &fsaaHint) |
Set the level of multisample AA to be used if this texture is a rendertarget. More... | |
virtual void | setGamma (float g) |
Sets the gamma adjustment factor applied to this texture on loading the data. More... | |
virtual void | setHardwareGammaEnabled (bool enabled) |
Sets whether this texture will be set up so that on sampling it, hardware gamma correction is applied. More... | |
virtual void | setHeight (uint32 h) |
Set the height of the texture; can only do this before load();. More... | |
virtual void | setManuallyLoaded (bool isManual) |
Set "Is this resource manually loaded?". More... | |
virtual void | setNumMipmaps (uint32 num) |
Sets the number of mipmaps to be used for this texture. More... | |
virtual bool | setParameter (const String &name, const String &value) |
Generic parameter setting method. More... | |
virtual void | setParameterList (const NameValuePairList ¶mList) |
Generic multiple parameter setting method. More... | |
virtual void | setTextureType (TextureType ttype) |
Sets the type of texture; can only be changed before load() More... | |
virtual void | setToLoaded (void) |
Change the Resource loading state to loaded. More... | |
virtual void | setTreatLuminanceAsAlpha (bool asAlpha) |
Sets whether luminace pixel format will treated as alpha format when load this texture. More... | |
virtual void | setUsage (int u) |
Sets the TextureUsage identifier for this Texture; only useful before load() More... | |
virtual void | setWidth (uint32 w) |
Set the width of the texture; can only do this before load();. More... | |
virtual void | touch (void) |
'Touches' the resource to indicate it has been used. More... | |
virtual void | unload (void) |
Unloads the resource; this is not permanent, the resource can be reloaded later if required. More... | |
Static Public Member Functions | |
static void | cleanupDictionary () |
Cleans up the static 'msDictionary' required to reset Ogre, otherwise the containers are left with invalid pointers, which will lead to a crash as soon as one of the ResourceManager implementers (e.g. More... | |
Public Attributes | |
OGRE_AUTO_MUTEX | |
|
inherited |
|
inherited |
Enum that allow to choose subset of unloaded/reloaded resources and to adjust reloading behavior.
Ogre::GL3PlusTexture::GL3PlusTexture | ( | ResourceManager * | creator, |
const String & | name, | ||
ResourceHandle | handle, | ||
const String & | group, | ||
bool | isManual, | ||
ManualResourceLoader * | loader, | ||
GL3PlusRenderSystem * | renderSystem | ||
) |
|
virtual |
GLenum Ogre::GL3PlusTexture::getGL3PlusTextureTarget | ( | void | ) | const |
|
virtual |
Enable read and/or write privileges to the texture from shaders.
bindPoint | The buffer binding location for shader access. For OpenGL this must be unique and is not related to the texture binding point. |
access | The texture access privileges given to the shader. |
mipmapLevel | The texture mipmap level to use. |
textureArrayIndex | The index of the texture array to use. If texture is not a texture array, set to 0. |
format | Texture format to be read in by shader. For OpenGL this may be different than the bound texture format. |
Reimplemented from Ogre::Texture.
|
inlineinherited |
|
virtualinherited |
Retrieve a platform or API-specific piece of information from this texture.
This method of retrieving information should only be used if you know what you're doing.
name | The name of the attribute to retrieve. |
pData | Pointer to memory matching the type of data you want to retrieve. |
Reimplemented from Ogre::Texture.
|
inlineinherited |
|
inlinevirtualinherited |
Sets the type of texture; can only be changed before load()
|
inlinevirtualinherited |
Gets the type of texture.
|
inlinevirtualinherited |
Gets the number of mipmaps to be used for this texture.
|
inlinevirtualinherited |
Sets the number of mipmaps to be used for this texture.
|
inlinevirtualinherited |
Are mipmaps hardware generated?
|
inlinevirtualinherited |
Returns the gamma adjustment factor applied to this texture on loading.
|
inlinevirtualinherited |
Sets the gamma adjustment factor applied to this texture on loading the data.
|
inlinevirtualinherited |
Sets whether this texture will be set up so that on sampling it, hardware gamma correction is applied.
|
inlinevirtualinherited |
Gets whether this texture will be set up so that on sampling it, hardware gamma correction is applied.
Set the level of multisample AA to be used if this texture is a rendertarget.
fsaa | The number of samples |
fsaaHint | Any hinting text ( |
|
inlinevirtualinherited |
Get the level of multisample AA to be used if this texture is a rendertarget.
|
inlinevirtualinherited |
Get the multisample AA hint if this texture is a rendertarget.
|
inlinevirtualinherited |
Returns the height of the texture.
|
inlinevirtualinherited |
Returns the width of the texture.
|
inlinevirtualinherited |
Returns the depth of the texture (only applicable for 3D textures).
|
inlinevirtualinherited |
Returns the height of the original input texture (may differ due to hardware requirements).
|
inlinevirtualinherited |
Returns the width of the original input texture (may differ due to hardware requirements).
|
inlinevirtualinherited |
Returns the original depth of the input texture (only applicable for 3D textures).
|
inlinevirtualinherited |
Set the height of the texture; can only do this before load();.
|
inlinevirtualinherited |
Set the width of the texture; can only do this before load();.
|
inlinevirtualinherited |
Set the depth of the texture (only applicable for 3D textures); can only do this before load();.
|
inlinevirtualinherited |
Returns the TextureUsage identifier for this Texture.
|
inlinevirtualinherited |
Sets the TextureUsage identifier for this Texture; only useful before load()
u | is a combination of TU_STATIC, TU_DYNAMIC, TU_WRITE_ONLY TU_AUTOMIPMAP and TU_RENDERTARGET (see TextureUsage enum). You are strongly advised to use HBU_STATIC_WRITE_ONLY wherever possible, if you need to update regularly, consider HBU_DYNAMIC_WRITE_ONLY. |
|
virtualinherited |
Creates the internal texture resources for this texture.
|
virtualinherited |
Frees internal texture resources for this texture.
|
virtualinherited |
Copies (and maybe scales to fit) the contents of this texture to another texture.
Reimplemented in Ogre::D3D9Texture, and Ogre::D3D11Texture.
|
virtualinherited |
Loads the data from an image.
Reimplemented in Ogre::D3D11Texture.
|
virtualinherited |
Loads the data from a raw stream.
stream | Data stream containing the raw pixel data |
uWidth | Width of the image |
uHeight | Height of the image |
eFormat | The format of the pixel data |
|
virtualinherited |
Internal method to load the texture from a set of images.
|
inlinevirtualinherited |
Returns the pixel format for the texture surface.
|
inlinevirtualinherited |
Returns the desired pixel format for the texture surface.
|
inlinevirtualinherited |
Returns the pixel format of the original input texture (may differ due to hardware requirements and pixel format conversion).
|
virtualinherited |
Sets the pixel format for the texture surface; can only be set before load().
|
virtualinherited |
Returns true if the texture has an alpha layer.
|
virtualinherited |
Sets desired bit depth for integer pixel format textures.
|
virtualinherited |
gets desired bit depth for integer pixel format textures.
|
virtualinherited |
Sets desired bit depth for float pixel format textures.
|
virtualinherited |
gets desired bit depth for float pixel format textures.
|
virtualinherited |
Sets desired bit depth for integer and float pixel format.
|
virtualinherited |
Sets whether luminace pixel format will treated as alpha format when load this texture.
|
virtualinherited |
Gets whether luminace pixel format will treated as alpha format when load this texture.
|
virtualinherited |
Return the number of faces this texture has.
This will be 6 for a cubemap texture and 1 for a 1D, 2D or 3D one.
|
virtualinherited |
Populate an Image with the contents of this texture.
destImage | The target image (contents will be overwritten) |
includeMipMaps | Whether to embed mipmaps in the image |
|
virtualinherited |
Prepares the resource for load, if it is not already.
One can call prepare() before load(), but this is not required as load() will call prepare() itself, if needed. When OGRE_THREAD_SUPPORT==1 both load() and prepare() are thread-safe. When OGRE_THREAD_SUPPORT==2 however, only prepare() is thread-safe. The reason for this function is to allow a background thread to do some of the loading work, without requiring the whole render system to be thread-safe. The background thread would call prepare() while the main render loop would later call load(). So long as prepare() remains thread-safe, subclasses can arbitrarily split the work of loading a resource between load() and prepare(). It is best to try and do as much work in prepare(), however, since this will leave less work for the main render thread to do and thus increase FPS.
backgroundThread | Whether this is occurring in a background thread |
|
virtualinherited |
Loads the resource, if it is not already.
backgroundThread | Indicates whether the caller of this method is the background resource loading thread. |
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
virtualinherited |
Reloads the resource, if it is already loaded.
Reimplemented in Ogre::Mesh, and Ogre::UnifiedHighLevelGpuProgram.
|
inlinevirtualinherited |
Returns true if the Resource is reloadable, false otherwise.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
inlinevirtualinherited |
Is this resource manually loaded?
|
inlinevirtualinherited |
Set "Is this resource manually loaded?".
|
virtualinherited |
Unloads the resource; this is not permanent, the resource can be reloaded later if required.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
inlinevirtualinherited |
Retrieves info about the size of the resource.
Reimplemented in Ogre::CgProgram, and Ogre::UnifiedHighLevelGpuProgram.
|
virtualinherited |
'Touches' the resource to indicate it has been used.
Reimplemented in Ogre::Material, Ogre::CgProgram, and Ogre::UnifiedHighLevelGpuProgram.
Referenced by Ogre::Material::touch().
|
inlinevirtualinherited |
Gets resource name.
Reimplemented in Ogre::SkeletonInstance.
Referenced by Ogre::GpuProgramUsage::getProgramName(), and OgreBites::TrayManager::resourceLoadStarted().
|
inlinevirtualinherited |
Reimplemented in Ogre::SkeletonInstance.
|
inlinevirtualinherited |
Returns true if the Resource has been prepared, false otherwise.
References Ogre::AtomicScalar< T >::load().
|
inlinevirtualinherited |
Returns true if the Resource has been loaded, false otherwise.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
References Ogre::AtomicScalar< T >::load().
|
inlinevirtualinherited |
Change the Resource loading state to loaded.
References Ogre::AtomicScalar< T >::store().
|
inlinevirtualinherited |
Returns whether the resource is currently in the process of background loading.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
References Ogre::AtomicScalar< T >::load().
|
inlinevirtualinherited |
Returns the current loading state.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
References Ogre::AtomicScalar< T >::load().
|
inlinevirtualinherited |
Returns whether this Resource has been earmarked for background loading.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
inlinevirtualinherited |
Tells the resource whether it is background loaded or not.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
virtualinherited |
Escalates the loading of a background loaded resource.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
virtualinherited |
Register a listener on this resource.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
virtualinherited |
Remove a listener on this resource.
Reimplemented in Ogre::UnifiedHighLevelGpuProgram.
|
inlinevirtualinherited |
Gets the group which this resource is a member of.
Reimplemented in Ogre::SkeletonInstance.
|
virtualinherited |
Change the resource group ownership of a Resource.
newGroup | Name of the new group |
|
inlinevirtualinherited |
Gets the manager which created this resource.
|
inlinevirtualinherited |
Get the origin of this resource, e.g.
a script file name.
|
inlinevirtualinherited |
Notify this resource of it's origin.
|
inlinevirtualinherited |
Returns the number of times this resource has changed state, which generally means the number of times it has been loaded.
Objects that build derived data based on the resource can check this value against a copy they kept last time they built this derived data, in order to know whether it needs rebuilding. This is a nice way of monitoring changes without having a tightly-bound callback.
|
virtualinherited |
Manually mark the state of this resource as having been changed.
|
virtualinherited |
Firing of loading complete event.
wasBackgroundLoaded | Whether this was a background loaded event |
|
virtualinherited |
Firing of preparing complete event.
wasBackgroundLoaded | Whether this was a background loaded event |
|
virtualinherited |
Firing of unloading complete event.
|
inlineinherited |
Retrieves the parameter dictionary for this class.
|
inlineinherited |
|
inherited |
Retrieves a list of parameters valid for this object.
|
virtualinherited |
Generic parameter setting method.
name | The name of the parameter to set |
value | String value. Must be in the right format for the type specified in the parameter definition. See the StringConverter class for more information. |
Referenced by Ogre::StringInterface::copyParametersTo().
|
virtualinherited |
Generic multiple parameter setting method.
paramList | Name/value pair list |
|
inlinevirtualinherited |
Generic parameter retrieval method.
name | The name of the parameter to get |
References Ogre::ParamCommand::doGet().
|
inlinevirtualinherited |
Method for copying this object's parameters to another object.
dest | Pointer to object to have it's parameters set the same as this object. |
References Ogre::StringInterface::setParameter().
|
staticinherited |
Cleans up the static 'msDictionary' required to reset Ogre, otherwise the containers are left with invalid pointers, which will lead to a crash as soon as one of the ResourceManager implementers (e.g.
MaterialManager) initializes.
|
inherited |