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.