Class to define graphic driver capabilities. Notice that these options will be ignored if particular functionality does not provided by GL driver. More...
#include <OpenGl_Caps.hxx>
Data Fields | |
flags to disable particular functionality, should be used only for testing purposes! | |
| Standard_Boolean | vboDisable |
| flag permits VBO usage, will significantly affect performance (OFF by default) More... | |
| Standard_Boolean | pntSpritesDisable |
| flag permits Point Sprites usage, will significantly affect performance (OFF by default) More... | |
| Standard_Boolean | keepArrayData |
| Disables freeing CPU memory after building VBOs (OFF by default) More... | |
| Standard_Boolean | ffpEnable |
| Enables FFP (fixed-function pipeline), do not use built-in GLSL programs (ON by default on desktop OpenGL and OFF on OpenGL ES) More... | |
context creation parameters | |
| Standard_Boolean | buffersNoSwap |
| Standard_Boolean | contextStereo |
| Standard_Boolean | contextDebug |
| Standard_Boolean | contextSyncDebug |
| Standard_Boolean | contextNoAccel |
| Standard_Boolean | contextCompatible |
flags to activate verbose output | |
| Standard_Boolean | glslWarnings |
| Print GLSL program compilation/linkage warnings, if any. OFF by default. More... | |
| Standard_Boolean | suppressExtraMsg |
| Suppress redundant messages from debug GL context. ON by default. More... | |
class methods | |
| OpenGl_Caps () | |
| Default constructor - initialize with most optimal values. More... | |
| virtual | ~OpenGl_Caps () |
| Destructor. More... | |
| OpenGl_Caps & | operator= (const OpenGl_Caps &theCopy) |
| Copy maker. More... | |
Additional Inherited Members | |
 Public Member Functions inherited from Standard_Transient | |
| Standard_Transient () | |
| Empty constructor. More... | |
| Standard_Transient (const Standard_Transient &) | |
| Copy constructor – does nothing. More... | |
| Standard_Transient & | operator= (const Standard_Transient &) |
| Assignment operator, needed to avoid copying reference counter. More... | |
| virtual | ~Standard_Transient () |
| Destructor must be virtual. More... | |
| virtual void | Delete () const |
| Memory deallocator for transient classes. More... | |
| virtual const Handle_Standard_Type & | DynamicType () const |
| Returns a type information object about this object. More... | |
| Standard_Boolean | IsInstance (const Handle_Standard_Type &theType) const |
| Returns a true value if this is an instance of Type. More... | |
| Standard_Boolean | IsInstance (const Standard_CString theTypeName) const |
| Returns a true value if this is an instance of TypeName. More... | |
| Standard_Boolean | IsKind (const Handle_Standard_Type &theType) const |
| Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More... | |
| Standard_Boolean | IsKind (const Standard_CString theTypeName) const |
| Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More... | |
| virtual Handle_Standard_Transient | This () const |
| Returns a Handle which references this object. Must never be called to objects created in stack. More... | |
| Standard_Integer | GetRefCount () const |
| Get the reference counter of this object. More... | |
Detailed Description
Class to define graphic driver capabilities. Notice that these options will be ignored if particular functionality does not provided by GL driver.
Constructor & Destructor Documentation
| OpenGl_Caps::OpenGl_Caps | ( | ) |
Default constructor - initialize with most optimal values.
|
virtual |
Destructor.
Member Function Documentation
| OpenGl_Caps& OpenGl_Caps::operator= | ( | const OpenGl_Caps & | theCopy | ) |
Copy maker.
Field Documentation
| Standard_Boolean OpenGl_Caps::buffersNoSwap |
Specify that driver should not swap back/front buffers at the end of frame. Useful when OCCT Viewer is integrated into existing OpenGL rendering pipeline as part, thus swapping part is performed outside.
OFF by default.
| Standard_Boolean OpenGl_Caps::contextCompatible |
Request backward-compatible GL context. This flag requires support in OpenGL driver.
Backward-compatible profile includes deprecated functionality like FFP (fixed-function pipeline), and might be useful for compatibility with application OpenGL code.
Most drivers support all features within backward-compatibility profile, but some limit functionality to OpenGL 2.1 (e.g. OS X) when core profile is not explicitly requested.
Requires OpenGL 3.2+ drivers. Has no effect on OpenGL ES 2.0+ drivers (which do not provie FFP compatibility). Interacts with ffpEnable option, which should be disabled within core profile.
ON by default.
| Standard_Boolean OpenGl_Caps::contextDebug |
Request debug GL context. This flag requires support in OpenGL driver.
When turned on OpenGL driver emits error and warning messages to provided callback (see OpenGl_Context - messages will be printed to standard output). Affects performance - thus should not be turned on by products in released state.
OFF by default. Currently implemented only for Windows (WGL).
| Standard_Boolean OpenGl_Caps::contextNoAccel |
Disable hardware acceleration.
This flag overrides default behavior, when accelerated context always preferred over software ones:
- on Windows will force Microsoft software implementation;
- on Mac OS X, forces Apple software implementation.
Software implementations are dramatically slower - should never be used.
OFF by default. Currently implemented only for Windows (WGL) and Mac OS X (Cocoa).
| Standard_Boolean OpenGl_Caps::contextStereo |
Request stereoscopic context (with Quad Buffer). This flag requires support in OpenGL driver.
OFF by default.
| Standard_Boolean OpenGl_Caps::contextSyncDebug |
Request debug GL context to emit messages within main thread (when contextDebug is specified!).
Some implementations performs GL rendering within dedicated thread(s), in this case debug messages will be pushed from unknown thread making call stack useless, since it does not interconnected to application calls. This option asks GL driver to switch into synchronized implementation. Affects performance - thus should not be turned on by products in released state.
OFF by default.
| Standard_Boolean OpenGl_Caps::ffpEnable |
Enables FFP (fixed-function pipeline), do not use built-in GLSL programs (ON by default on desktop OpenGL and OFF on OpenGL ES)
| Standard_Boolean OpenGl_Caps::glslWarnings |
Print GLSL program compilation/linkage warnings, if any. OFF by default.
| Standard_Boolean OpenGl_Caps::keepArrayData |
Disables freeing CPU memory after building VBOs (OFF by default)
| Standard_Boolean OpenGl_Caps::pntSpritesDisable |
flag permits Point Sprites usage, will significantly affect performance (OFF by default)
| Standard_Boolean OpenGl_Caps::suppressExtraMsg |
Suppress redundant messages from debug GL context. ON by default.
| Standard_Boolean OpenGl_Caps::vboDisable |
flag permits VBO usage, will significantly affect performance (OFF by default)
The documentation for this class was generated from the following file:
