gpu/GLES2/extensions/CHROMIUM/CHROMIUM_subscribe_uniform.txt

   1 Name
   2
   3     CHROMIUM_subscribe_uniform
   4
   5 Name Strings
   6
   7     CHROMIUM_subscribe_uniform
   8
   9 Version
  10
  11     Last Modifed Date: October 30, 2014
  12
  13 Dependencies
  14
  15     OpenGL ES 2.0 is required.
  16
  17 Overview
  18
  19     Allows clients to subscribe to a set of input uniforms which can
  20     be populated within buffers and used to modify uniform variables within
  21     their programs.
  22
  23     Decreases percieved latency for operations performed against these
  24     uniforms.
  25
  26 New Tokens
  27
  28     Accepted by the <target> parameter of glBindValueBufferCHROMIUM,
  29     glSubscribeValueCHROMIUM, glPopulateSubscribedValuesCHROMIUM and
  30     glUniformValueBufferCHROMIUM
  31
  32     GL_SUBSCRIBED_VALUES_BUFFER_CHROMIUM                        0x924B
  33
  34     Accepted by the <subscription> parameter of glSubscribeValueCHROMIUM and
  35     glUniformValueBufferCHROMIUM:
  36
  37     GL_MOUSE_POSITION_CHROMIUM                                  0x924C
  38
  39 New Procedures and Functions
  40
  41     The command
  42
  43        void glGenValuebuffersCHROMIUM(GLsizei n, GLuint* buffers)
  44
  45     Generates value buffer object names.
  46     <n> Specifies the number of value buffer object names to be generated.
  47     <buffers> Specifies an array in which the generated value buffer object
  48               names are stored.
  49
  50    The command
  51
  52       void glDeleteValuebuffersCHROMIUM(GLsizei n, const GLuint* valuebuffers)
  53
  54    Deletes named value buffer objects.
  55    <n> Specifies the number of value buffer objects to be deleted.
  56    <buffers> Specifies an array of value buffer objects to be deleted.
  57
  58    The command
  59
  60       boolean glIsValuebufferCHROMIUM(GLuint buffer);
  61
  62    Returns whether an object is a value buffer object.
  63    <buffer> Specifies the name of a buffer object.
  64
  65    The command
  66
  67       void glBindValuebufferCHROMIUM(GLenum target, GLuint buffer);
  68
  69    Lets you use a named value buffer object.
  70    <target> Specifies the target to which the buffer object is bound.
  71    <buffer> Specifies the name of a buffer object.
  72
  73    The command
  74
  75       void glSubscribeValueCHROMIUM(GLenum target, GLenum subscription)
  76
  77    Subscribes the currently bound buffer object to a subscription target.
  78    <target> Specifies the target to which the buffer object is bound.
  79    <subscription> Specifies the subscription to which the currently bound
  80                   buffer object should be subscribed.
  81
  82    The command
  83
  84       void glPopulateSubscribedValuesCHROMIUM(GLenum target)
  85
  86    Populates the currently bound buffer object with all subscription states
  87    to which it is subscribed.
  88    <target> Specifies the target to which the buffer object is bound.
  89
  90    The command
  91
  92       void glUniformValueBufferCHROMIUM(GLint location, GLenum target,
  93                                        GLenum subscription)
  94
  95    Populates the uniform specified by location within the currently bound
  96    program with the value in the currently bound buffer for the subscription
  97    target.
  98    <location> Specifies the location of the uniform variable to by modified.
  99    <target> Specifies the target to which the buffer object is bound.
 100    <subscription> Specifies the subscription in the currently bound buffer
 101                   whose value should be used to populate the uniform.
 102
 103 Errors
 104
 105     None.
 106
 107 New State
 108
 109     None.
 110
 111 Revision History
 112
 113     10/30/2014    Documented the extension