Ogre::RenderSystemCapabilities Class Reference

This class stores the capabilities of the graphics card. More...

#include <OgreRenderSystemCapabilities.h>

Inheritance diagram for Ogre::RenderSystemCapabilities:

Public Types
typedef std::set< String >	ShaderProfiles

Public Member Functions
	RenderSystemCapabilities ()
void	addShaderProfile (const String &profile)
	Adds the profile to the list of supported profiles. More...
ushort	getComputeProgramConstantBoolCount (void) const
	The number of boolean constants fragment programs support. More...
ushort	getComputeProgramConstantFloatCount (void) const
	The number of floating-point constants fragment programs support. More...
ushort	getComputeProgramConstantIntCount (void) const
	The number of integer constants fragment programs support. More...
String	getDeviceName () const
	gets the device name for render system More...
DriverVersion	getDriverVersion () const
ushort	getFragmentProgramConstantBoolCount (void) const
	The number of boolean constants fragment programs support. More...
ushort	getFragmentProgramConstantFloatCount (void) const
	The number of floating-point constants fragment programs support. More...
ushort	getFragmentProgramConstantIntCount (void) const
	The number of integer constants fragment programs support. More...
ushort	getGeometryProgramConstantBoolCount (void) const
	The number of boolean constants geometry programs support. More...
ushort	getGeometryProgramConstantFloatCount (void) const
	The number of floating-point constants geometry programs support. More...
ushort	getGeometryProgramConstantIntCount (void) const
	The number of integer constants geometry programs support. More...
int	getGeometryProgramNumOutputVertices (void) const
	Get the number of vertices a single geometry program run can emit. More...
Real	getMaxPointSize (void) const
	Maximum point screen size in pixels. More...
Real	getMaxSupportedAnisotropy () const
	Get the maximum supported anisotropic filtering. More...
bool	getNonPOW2TexturesLimited (void) const
	Are non-power of two textures limited in features? More...
ushort	getNumMultiRenderTargets (void) const
	The number of simultaneous render targets supported. More...
ushort	getNumTextureUnits (void) const
	Returns the number of texture units the current output hardware supports. More...
ushort	getNumVertexAttributes (void) const
ushort	getNumVertexBlendMatrices (void) const
	Returns the number of matrices available to hardware vertex blending for this rendering system. More...
ushort	getNumVertexTextureUnits (void) const
	Get the number of vertex texture units supported. More...
const String &	getRenderSystemName (void) const
	Get the identifier of the rendersystem from which these capabilities were generated. More...
ushort	getStencilBufferBitDepth (void) const
	Determines the bit depth of the hardware accelerated stencil buffer, if supported. More...
const ShaderProfiles &	getSupportedShaderProfiles () const
	Returns a set of all supported shader profiles. More...
ushort	getTessellationDomainProgramConstantBoolCount (void) const
	The number of boolean constants fragment programs support. More...
ushort	getTessellationDomainProgramConstantFloatCount (void) const
	The number of floating-point constants fragment programs support. More...
ushort	getTessellationDomainProgramConstantIntCount (void) const
	The number of integer constants fragment programs support. More...
ushort	getTessellationHullProgramConstantBoolCount (void) const
	The number of boolean constants fragment programs support. More...
ushort	getTessellationHullProgramConstantFloatCount (void) const
	The number of floating-point constants fragment programs support. More...
ushort	getTessellationHullProgramConstantIntCount (void) const
	The number of integer constants fragment programs support. More...
GPUVendor	getVendor () const
ushort	getVertexProgramConstantBoolCount (void) const
	The number of boolean constants vertex programs support. More...
ushort	getVertexProgramConstantFloatCount (void) const
	The number of floating-point constants vertex programs support. More...
ushort	getVertexProgramConstantIntCount (void) const
	The number of integer constants vertex programs support. More...
bool	getVertexTextureUnitsShared (void) const
	Get whether the vertex texture units are shared with the fragment processor. More...
bool	hasCapability (const Capabilities c) const
	Checks for a capability. More...
bool	isCapabilityRenderSystemSpecific (const Capabilities c) const
	Returns true if capability is render system specific. More...
bool	isCategoryRelevant (CapabilitiesCategory cat)
	Return whether a category is 'relevant' or not, ie will it be reported. More...
bool	isDriverOlderThanVersion (const DriverVersion &v) const
bool	isShaderProfileSupported (const String &profile) const
	Returns true if profile is in the list of supported profiles. More...
void	log (Log *pLog) const
	Write the capabilities to the pass in Log. More...
void	parseDriverVersionFromString (const String &versionString)
void	parseVendorFromString (const String &vendorString)
	Parse and set vendor. More...
void	removeShaderProfile (const String &profile)
	Remove a given shader profile, if present. More...
void	setCapability (const Capabilities c)
	Adds a capability flag. More...
void	setCategoryRelevant (CapabilitiesCategory cat, bool relevant)
	Mark a category as 'relevant' or not, ie will it be reported. More...
void	setComputeProgramConstantBoolCount (ushort c)
	The number of boolean constants compute programs support. More...
void	setComputeProgramConstantFloatCount (ushort c)
	The number of floating-point constants compute programs support. More...
void	setComputeProgramConstantIntCount (ushort c)
	The number of integer constants compute programs support. More...
void	setDeviceName (const String &name)
	sets the device name for Render system More...
void	setDriverVersion (const DriverVersion &version)
	Set the driver version. More...
void	setFragmentProgramConstantBoolCount (ushort c)
	The number of boolean constants fragment programs support. More...
void	setFragmentProgramConstantFloatCount (ushort c)
	The number of floating-point constants fragment programs support. More...
void	setFragmentProgramConstantIntCount (ushort c)
	The number of integer constants fragment programs support. More...
void	setGeometryProgramConstantBoolCount (ushort c)
	The number of boolean constants geometry programs support. More...
void	setGeometryProgramConstantFloatCount (ushort c)
	The number of floating-point constants geometry programs support. More...
void	setGeometryProgramConstantIntCount (ushort c)
	The number of integer constants geometry programs support. More...
void	setGeometryProgramNumOutputVertices (int numOutputVertices)
	Set the number of vertices a single geometry program run can emit. More...
void	setMaxPointSize (Real s)
	Maximum point screen size in pixels. More...
void	setMaxSupportedAnisotropy (Real s)
	Set the maximum supported anisotropic filtering. More...
void	setNonPOW2TexturesLimited (bool l)
	Non-POW2 textures limited. More...
void	setNumMultiRenderTargets (ushort num)
	The number of simultaneous render targets supported. More...
void	setNumTextureUnits (ushort num)
void	setNumVertexAttributes (ushort num)
void	setNumVertexBlendMatrices (ushort num)
void	setNumVertexTextureUnits (ushort n)
	Set the number of vertex texture units supported. More...
void	setRenderSystemName (const String &rs)
	Set the identifier of the rendersystem from which these capabilities were generated. More...
void	setStencilBufferBitDepth (ushort num)
void	setTessellationDomainProgramConstantBoolCount (ushort c)
	The number of boolean constants tessellation Domain programs support. More...
void	setTessellationDomainProgramConstantFloatCount (ushort c)
	The number of floating-point constants tessellation Domain programs support. More...
void	setTessellationDomainProgramConstantIntCount (ushort c)
	The number of integer constants tessellation Domain programs support. More...
void	setTessellationHullProgramConstantBoolCount (ushort c)
	The number of boolean constants tessellation Domain programs support. More...
void	setTessellationHullProgramConstantFloatCount (ushort c)
	The number of floating-point constants tessellation Hull programs support. More...
void	setTessellationHullProgramConstantIntCount (ushort c)
	The number of integer constants tessellation Domain programs support. More...
void	setVendor (GPUVendor v)
void	setVertexProgramConstantBoolCount (ushort c)
	The number of boolean constants vertex programs support. More...
void	setVertexProgramConstantFloatCount (ushort c)
	The number of floating-point constants vertex programs support. More...
void	setVertexProgramConstantIntCount (ushort c)
	The number of integer constants vertex programs support. More...
void	setVertexTextureUnitsShared (bool shared)
	Set whether the vertex texture units are shared with the fragment processor. More...
void	unsetCapability (const Capabilities c)
	Remove a capability flag. More...

Static Public Member Functions
static GPUVendor	vendorFromString (const String &vendorString)
	Convert a vendor string to an enum. More...
static const String &	vendorToString (GPUVendor v)
	Convert a vendor enum to a string. More...

Detailed Description

This class stores the capabilities of the graphics card.

Remarks

This information is set by the individual render systems.

Member Typedef Documentation

ShaderProfiles

typedef std::set<String> Ogre::RenderSystemCapabilities::ShaderProfiles

Constructor & Destructor Documentation

RenderSystemCapabilities()

Ogre::RenderSystemCapabilities::RenderSystemCapabilities

(

)

Member Function Documentation

setDriverVersion()

void Ogre::RenderSystemCapabilities::setDriverVersion ( const DriverVersion &  version )

inline

Set the driver version.

parseDriverVersionFromString()

void Ogre::RenderSystemCapabilities::parseDriverVersionFromString ( const String &  versionString )

inline

References Ogre::DriverVersion::fromString().

getDriverVersion()

DriverVersion Ogre::RenderSystemCapabilities::getDriverVersion ( ) const

inline

getVendor()

GPUVendor Ogre::RenderSystemCapabilities::getVendor ( ) const

inline

setVendor()

void Ogre::RenderSystemCapabilities::setVendor ( GPUVendor  v )

inline

parseVendorFromString()

void Ogre::RenderSystemCapabilities::parseVendorFromString ( const String &  vendorString )

inline

Parse and set vendor.

vendorFromString()

static GPUVendor Ogre::RenderSystemCapabilities::vendorFromString ( const String &  vendorString )

static

Convert a vendor string to an enum.

vendorToString()

static const String& Ogre::RenderSystemCapabilities::vendorToString ( GPUVendor  v )

static

Convert a vendor enum to a string.

isDriverOlderThanVersion()

bool Ogre::RenderSystemCapabilities::isDriverOlderThanVersion ( const DriverVersion &  v ) const

inline

References Ogre::DriverVersion::build, Ogre::DriverVersion::major, Ogre::DriverVersion::minor, and Ogre::DriverVersion::release.

setNumTextureUnits()

void Ogre::RenderSystemCapabilities::setNumTextureUnits ( ushort  num )

inline

setStencilBufferBitDepth()

void Ogre::RenderSystemCapabilities::setStencilBufferBitDepth ( ushort  num )

inline

setNumVertexBlendMatrices()

void Ogre::RenderSystemCapabilities::setNumVertexBlendMatrices ( ushort  num )

inline

setNumMultiRenderTargets()

void Ogre::RenderSystemCapabilities::setNumMultiRenderTargets ( ushort  num )

inline

The number of simultaneous render targets supported.

setNumVertexAttributes()

void Ogre::RenderSystemCapabilities::setNumVertexAttributes ( ushort  num )

inline

getNumVertexAttributes()

ushort Ogre::RenderSystemCapabilities::getNumVertexAttributes ( void  ) const

inline

getNumTextureUnits()

ushort Ogre::RenderSystemCapabilities::getNumTextureUnits ( void  ) const

inline

Returns the number of texture units the current output hardware supports.

For use in rendering, this determines how many texture units the are available for multitexturing (i.e. rendering multiple textures in a single pass). Where a Material has multiple texture layers, it will try to use multitexturing where available, and where it is not available, will perform multipass rendering to achieve the same effect. This property only applies to the fixed-function pipeline, the number available to the programmable pipeline depends on the shader model in use.

getStencilBufferBitDepth()

ushort Ogre::RenderSystemCapabilities::getStencilBufferBitDepth ( void  ) const

inline

Determines the bit depth of the hardware accelerated stencil buffer, if supported.

Remarks

If hardware stencilling is not supported, the software will provide an 8-bit software stencil.

getNumVertexBlendMatrices()

ushort Ogre::RenderSystemCapabilities::getNumVertexBlendMatrices ( void  ) const

inline

Returns the number of matrices available to hardware vertex blending for this rendering system.

getNumMultiRenderTargets()

ushort Ogre::RenderSystemCapabilities::getNumMultiRenderTargets ( void  ) const

inline

The number of simultaneous render targets supported.

isCapabilityRenderSystemSpecific()

bool Ogre::RenderSystemCapabilities::isCapabilityRenderSystemSpecific ( const Capabilities  c ) const

inline

Returns true if capability is render system specific.

References Ogre::CAPS_CATEGORY_D3D9, Ogre::CAPS_CATEGORY_GL, and OGRE_CAPS_BITSHIFT.

setCapability()

void Ogre::RenderSystemCapabilities::setCapability ( const Capabilities  c )

inline

Adds a capability flag.

References CAPS_CATEGORY_MASK, and OGRE_CAPS_BITSHIFT.

unsetCapability()

void Ogre::RenderSystemCapabilities::unsetCapability ( const Capabilities  c )

inline

Remove a capability flag.

References CAPS_CATEGORY_MASK, and OGRE_CAPS_BITSHIFT.

hasCapability()

bool Ogre::RenderSystemCapabilities::hasCapability ( const Capabilities  c ) const

inline

Checks for a capability.

References CAPS_CATEGORY_MASK, and OGRE_CAPS_BITSHIFT.

addShaderProfile()

void Ogre::RenderSystemCapabilities::addShaderProfile ( const String &  profile )

inline

Adds the profile to the list of supported profiles.

removeShaderProfile()

void Ogre::RenderSystemCapabilities::removeShaderProfile ( const String &  profile )

inline

Remove a given shader profile, if present.

isShaderProfileSupported()

bool Ogre::RenderSystemCapabilities::isShaderProfileSupported ( const String &  profile ) const

inline

Returns true if profile is in the list of supported profiles.

getSupportedShaderProfiles()

const ShaderProfiles& Ogre::RenderSystemCapabilities::getSupportedShaderProfiles ( ) const

inline

Returns a set of all supported shader profiles.

getVertexProgramConstantFloatCount()

ushort Ogre::RenderSystemCapabilities::getVertexProgramConstantFloatCount ( void  ) const

inline

The number of floating-point constants vertex programs support.

getVertexProgramConstantIntCount()

ushort Ogre::RenderSystemCapabilities::getVertexProgramConstantIntCount ( void  ) const

inline

The number of integer constants vertex programs support.

getVertexProgramConstantBoolCount()

ushort Ogre::RenderSystemCapabilities::getVertexProgramConstantBoolCount ( void  ) const

inline

The number of boolean constants vertex programs support.

getGeometryProgramConstantFloatCount()

ushort Ogre::RenderSystemCapabilities::getGeometryProgramConstantFloatCount ( void  ) const

inline

The number of floating-point constants geometry programs support.

getGeometryProgramConstantIntCount()

ushort Ogre::RenderSystemCapabilities::getGeometryProgramConstantIntCount ( void  ) const

inline

The number of integer constants geometry programs support.

getGeometryProgramConstantBoolCount()

ushort Ogre::RenderSystemCapabilities::getGeometryProgramConstantBoolCount ( void  ) const

inline

The number of boolean constants geometry programs support.

getFragmentProgramConstantFloatCount()

ushort Ogre::RenderSystemCapabilities::getFragmentProgramConstantFloatCount ( void  ) const

inline

The number of floating-point constants fragment programs support.

getFragmentProgramConstantIntCount()

ushort Ogre::RenderSystemCapabilities::getFragmentProgramConstantIntCount ( void  ) const

inline

The number of integer constants fragment programs support.

getFragmentProgramConstantBoolCount()

ushort Ogre::RenderSystemCapabilities::getFragmentProgramConstantBoolCount ( void  ) const

inline

The number of boolean constants fragment programs support.

setDeviceName()

void Ogre::RenderSystemCapabilities::setDeviceName ( const String &  name )

inline

sets the device name for Render system

getDeviceName()

String Ogre::RenderSystemCapabilities::getDeviceName ( ) const

inline

gets the device name for render system

setVertexProgramConstantFloatCount()

void Ogre::RenderSystemCapabilities::setVertexProgramConstantFloatCount ( ushort  c )

inline

The number of floating-point constants vertex programs support.

setVertexProgramConstantIntCount()

void Ogre::RenderSystemCapabilities::setVertexProgramConstantIntCount ( ushort  c )

inline

The number of integer constants vertex programs support.

setVertexProgramConstantBoolCount()

void Ogre::RenderSystemCapabilities::setVertexProgramConstantBoolCount ( ushort  c )

inline

The number of boolean constants vertex programs support.

setGeometryProgramConstantFloatCount()

void Ogre::RenderSystemCapabilities::setGeometryProgramConstantFloatCount ( ushort  c )

inline

The number of floating-point constants geometry programs support.

setGeometryProgramConstantIntCount()

void Ogre::RenderSystemCapabilities::setGeometryProgramConstantIntCount ( ushort  c )

inline

The number of integer constants geometry programs support.

setGeometryProgramConstantBoolCount()

void Ogre::RenderSystemCapabilities::setGeometryProgramConstantBoolCount ( ushort  c )

inline

The number of boolean constants geometry programs support.

setFragmentProgramConstantFloatCount()

void Ogre::RenderSystemCapabilities::setFragmentProgramConstantFloatCount ( ushort  c )

inline

The number of floating-point constants fragment programs support.

setFragmentProgramConstantIntCount()

void Ogre::RenderSystemCapabilities::setFragmentProgramConstantIntCount ( ushort  c )

inline

The number of integer constants fragment programs support.

setFragmentProgramConstantBoolCount()

void Ogre::RenderSystemCapabilities::setFragmentProgramConstantBoolCount ( ushort  c )

inline

The number of boolean constants fragment programs support.

setMaxPointSize()

void Ogre::RenderSystemCapabilities::setMaxPointSize ( Real  s )

inline

Maximum point screen size in pixels.

getMaxPointSize()

Real Ogre::RenderSystemCapabilities::getMaxPointSize ( void  ) const

inline

Maximum point screen size in pixels.

setNonPOW2TexturesLimited()

void Ogre::RenderSystemCapabilities::setNonPOW2TexturesLimited ( bool  l )

inline

Non-POW2 textures limited.

getNonPOW2TexturesLimited()

bool Ogre::RenderSystemCapabilities::getNonPOW2TexturesLimited ( void  ) const

inline

Are non-power of two textures limited in features?

Remarks

If the RSC_NON_POWER_OF_2_TEXTURES capability is set, but this method returns true, you can use non power of 2 textures only if:

• You load them explicitly with no mip maps
• You don't use DXT texture compression
• You use clamp texture addressing

setMaxSupportedAnisotropy()

void Ogre::RenderSystemCapabilities::setMaxSupportedAnisotropy ( Real  s )

inline

Set the maximum supported anisotropic filtering.

getMaxSupportedAnisotropy()

Real Ogre::RenderSystemCapabilities::getMaxSupportedAnisotropy ( ) const

inline

Get the maximum supported anisotropic filtering.

setNumVertexTextureUnits()

void Ogre::RenderSystemCapabilities::setNumVertexTextureUnits ( ushort  n )

inline

Set the number of vertex texture units supported.

getNumVertexTextureUnits()

ushort Ogre::RenderSystemCapabilities::getNumVertexTextureUnits ( void  ) const

inline

Get the number of vertex texture units supported.

setVertexTextureUnitsShared()

void Ogre::RenderSystemCapabilities::setVertexTextureUnitsShared ( bool  shared )

inline

Set whether the vertex texture units are shared with the fragment processor.

getVertexTextureUnitsShared()

bool Ogre::RenderSystemCapabilities::getVertexTextureUnitsShared ( void  ) const

inline

Get whether the vertex texture units are shared with the fragment processor.

Deprecated:

only needed for D3D9

setGeometryProgramNumOutputVertices()

void Ogre::RenderSystemCapabilities::setGeometryProgramNumOutputVertices ( int  numOutputVertices )

inline

Set the number of vertices a single geometry program run can emit.

getGeometryProgramNumOutputVertices()

int Ogre::RenderSystemCapabilities::getGeometryProgramNumOutputVertices ( void  ) const

inline

Get the number of vertices a single geometry program run can emit.

getRenderSystemName()

const String& Ogre::RenderSystemCapabilities::getRenderSystemName ( void  ) const

inline

Get the identifier of the rendersystem from which these capabilities were generated.

setRenderSystemName()

void Ogre::RenderSystemCapabilities::setRenderSystemName ( const String &  rs )

inline

Set the identifier of the rendersystem from which these capabilities were generated.

setCategoryRelevant()

void Ogre::RenderSystemCapabilities::setCategoryRelevant ( CapabilitiesCategory  cat, bool  relevant  )

inline

Mark a category as 'relevant' or not, ie will it be reported.

isCategoryRelevant()

bool Ogre::RenderSystemCapabilities::isCategoryRelevant ( CapabilitiesCategory  cat )

inline

Return whether a category is 'relevant' or not, ie will it be reported.

log()

void Ogre::RenderSystemCapabilities::log

(

Log *

pLog

)

const

Write the capabilities to the pass in Log.

setTessellationHullProgramConstantFloatCount()

void Ogre::RenderSystemCapabilities::setTessellationHullProgramConstantFloatCount ( ushort  c )

inline

The number of floating-point constants tessellation Hull programs support.

setTessellationHullProgramConstantIntCount()

void Ogre::RenderSystemCapabilities::setTessellationHullProgramConstantIntCount ( ushort  c )

inline

The number of integer constants tessellation Domain programs support.

setTessellationHullProgramConstantBoolCount()

void Ogre::RenderSystemCapabilities::setTessellationHullProgramConstantBoolCount ( ushort  c )

inline

The number of boolean constants tessellation Domain programs support.

getTessellationHullProgramConstantFloatCount()

ushort Ogre::RenderSystemCapabilities::getTessellationHullProgramConstantFloatCount ( void  ) const

inline

The number of floating-point constants fragment programs support.

getTessellationHullProgramConstantIntCount()

ushort Ogre::RenderSystemCapabilities::getTessellationHullProgramConstantIntCount ( void  ) const

inline

The number of integer constants fragment programs support.

getTessellationHullProgramConstantBoolCount()

ushort Ogre::RenderSystemCapabilities::getTessellationHullProgramConstantBoolCount ( void  ) const

inline

The number of boolean constants fragment programs support.

setTessellationDomainProgramConstantFloatCount()

void Ogre::RenderSystemCapabilities::setTessellationDomainProgramConstantFloatCount ( ushort  c )

inline

The number of floating-point constants tessellation Domain programs support.

setTessellationDomainProgramConstantIntCount()

void Ogre::RenderSystemCapabilities::setTessellationDomainProgramConstantIntCount ( ushort  c )

inline

The number of integer constants tessellation Domain programs support.

setTessellationDomainProgramConstantBoolCount()

void Ogre::RenderSystemCapabilities::setTessellationDomainProgramConstantBoolCount ( ushort  c )

inline

The number of boolean constants tessellation Domain programs support.

getTessellationDomainProgramConstantFloatCount()

ushort Ogre::RenderSystemCapabilities::getTessellationDomainProgramConstantFloatCount ( void  ) const

inline

The number of floating-point constants fragment programs support.

getTessellationDomainProgramConstantIntCount()

ushort Ogre::RenderSystemCapabilities::getTessellationDomainProgramConstantIntCount ( void  ) const

inline

The number of integer constants fragment programs support.

getTessellationDomainProgramConstantBoolCount()

ushort Ogre::RenderSystemCapabilities::getTessellationDomainProgramConstantBoolCount ( void  ) const

inline

The number of boolean constants fragment programs support.

setComputeProgramConstantFloatCount()

void Ogre::RenderSystemCapabilities::setComputeProgramConstantFloatCount ( ushort  c )

inline

The number of floating-point constants compute programs support.

setComputeProgramConstantIntCount()

void Ogre::RenderSystemCapabilities::setComputeProgramConstantIntCount ( ushort  c )

inline

The number of integer constants compute programs support.

setComputeProgramConstantBoolCount()

void Ogre::RenderSystemCapabilities::setComputeProgramConstantBoolCount ( ushort  c )

inline

The number of boolean constants compute programs support.

getComputeProgramConstantFloatCount()

ushort Ogre::RenderSystemCapabilities::getComputeProgramConstantFloatCount ( void  ) const

inline

The number of floating-point constants fragment programs support.

getComputeProgramConstantIntCount()

ushort Ogre::RenderSystemCapabilities::getComputeProgramConstantIntCount ( void  ) const

inline

The number of integer constants fragment programs support.

getComputeProgramConstantBoolCount()

ushort Ogre::RenderSystemCapabilities::getComputeProgramConstantBoolCount ( void  ) const

inline

The number of boolean constants fragment programs support.

---

The documentation for this class was generated from the following file:

• OgreRenderSystemCapabilities.h