blob: ed00bb4bbf063154c8e7d8222ad886579416fb22 [file] [log] [blame]
Name
QCOM_performance_monitor_global_mode
Name Strings
GL_QCOM_perfmon_global_mode
Contributors
Jari Komppa
James Ritts
Jeff Leger
Maurice Ribble
Contact
Jari Komppa, Qualcomm (jari.komppa 'at' qualcomm.com)
Status
Complete.
Version
Last Modified Date: May 5, 2009
Revision: #03
Number
OpenGL ES Extension #56
Dependencies
This extension interacts with AMD_performance_monitor.
Overview
This extension introduces a global tracking mode in the performance
monitors. When enabled, the counters increment in all operations,
including all "housekeeping" operations such as resolves/clears and
operations performed by other concurrent applications. The normal
operation is to track only the application's own operations.
Issues
(1) How do we filter operations from other applications?
RESOLVED: We don't. The user of this extension should be aware of the
consequences.
(2) What should happen if the global mode is enabled or disabled while
the performance monitors are in use?
RESOLVED: The results in this case are undefined.
New Tokens
Accepted by the <cap> parameter of Enable and Disable, and
IsEnabled, and by the <pname> parameter of GetBooleanv, GetIntegerv,
and GetFloatv:
PERFMON_GLOBAL_MODE_QCOM 0x8FA0
New Procedures and Functions
None.
Addition to the GL specification
Add this to the Performance Monitoring section that was added by
AMD_performance_monitor:
"A global tracking mode can be enabled and disabled with the generic
Enable and Disable commands using the symbolic constant
PERFMON_GLOBAL_MODE_QCOM. When enabled the counters increment in all
operations, contexts, and other applications using the hardware."
Errors
None
Sample Usage
// Activate global performance monitor tracking
glEnable(GL_PERFMON_GLOBAL_MODE_QCOM);
Revision History
#01 18/02/2009 Jari Komppa First draft.
#02 19/03/2009 Maurice Ribble Add in missing sections.
#03 05/05/2009 Jon Leech Reflow paragraphs and assign
extension number.