kc3-lang/angle/extensions/ANGLE_get_serialized_context_string.txt

Branch : - branch - main - tag -

• Show log

  Commit

• Author : Jamie Madill
  Date : 2021-04-02 12:46:37
  Hash : 9b0911a0
  Message : Add GL_ANGLE_get_serialized_context_string. This will provide a front-door entry point where we can get a serialized string representing the context state. Previously we would have to call ANGLE internal directly. This will enable a refactor of the replays to work more like standalone plugin libraries. Bug: angleproject:5811 Change-Id: I5a97d7aa3cd70c49199264c2eb7ca953943ac3c3 Reviewed-on: https://chromium-review.googlesource.com/c/angle/angle/+/2803391 Commit-Queue: Jamie Madill <jmadill@chromium.org> Reviewed-by: Cody Northrop <cnorthrop@google.com> Reviewed-by: Tim Van Patten <timvp@google.com>

• extensions/ANGLE_get_serialized_context_string.txt

• Name
  
      ANGLE_get_serialized_context_string
  
  Name Strings
  
      GL_ANGLE_get_serialized_context_string
  
  Contributors
  
      Jamie Madill, Google
  
  Contact
  
      Jamie Madill, Google (jmadill 'at' google.com)
  
  Status
  
      Implemented in ANGLE.
  
  Version
  
      Last Modified Date: April 2, 2021
      Revision: #1
  
  Number
  
      TBD
  
  Dependencies
  
      OpenGL ES 2.0 is required.
  
  Overview
  
      Adds a query for a serialized string representation of a context.
      Useful for testing to easily compare two states.
  
  New Tokens
  
      Accepted by the <name> parameter of glGetString:
  
          SERIALIZED_CONTEXT_STRING_ANGLE   0x96B0
  
  Additions to Chapter 6 of the OpenGL ES 2.0 Specification (Querying GL State)
  
      Update Section 6.1.5 "String Queries" to accept the new enum specified
      above. The SERIALIZED_CONTEXT_STRING_ANGLE string is an implementation-
      dependent representation of the current context state. Two contexts
      with the same internal state are guaranteed to have the same value. Note
      that the reverse is not true - two contexts with different states are
      may also have the same serialized string.
  
  New State
  
      None.
  
  Issues
  
      1) Should two contexts with different states return different strings?
  
      RESOLVED: We don't provide a guarantee that every state is serialized
        into the string. This loose wording lets the extension provide
        some additional extra validation without being overly strict and
        making the implementation difficult. It also allow a no-op
        implementation to satisfy the extension requirements.
  
  Revision History
  
      2021/04/02  jmadill  Initial revision.