kc3-lang/angle/extensions/ANGLE_platform_angle_d3d.txt

Branch : - branch - main - tag -

• Show log

  Commit

• Author : Cooper Partin
  Date : 2015-03-11 12:26:30
  Hash : 0110e172
  Message : Update ANGLE_platform_angle_d3d to be able to disable automatic trim. BUG=angleproject:946 Change-Id: I5652495842b057998318b1583f8e1a586eba39aa Reviewed-on: https://chromium-review.googlesource.com/258940 Tested-by: Cooper Partin <coopp@microsoft.com> Reviewed-by: Geoff Lang <geofflang@chromium.org> Reviewed-by: Jamie Madill <jmadill@chromium.org>

• extensions/ANGLE_platform_angle_d3d.txt

• Name
  
      ANGLE_platform_angle_d3d
  
  Name Strings
  
      EGL_ANGLE_platform_angle_d3d
  
  Contributors
  
      Shannon Woods, Google
      Geoff Lang, Google
  
  Contacts
  
      Geoff Lang, Google (geofflang 'at' chromium 'dot' org)
  
  Status
  
      Draft
  
  Version
  
      Version 3, 2014-11-26
  
  Number
  
      EGL Extension XXX
  
  Extension Type
  
      EGL client extension
  
  Dependencies
  
      Requires ANGLE_platform_angle.
  
  Overview
  
      This extension enables selection of D3D display types.
  
  New Types
  
      None
  
  New Procedures and Functions
  
      None
  
  New Tokens
  
      Accepted as values for the EGL_PLATFORM_ANGLE_TYPE_ANGLE attribute:
  
          EGL_PLATFORM_ANGLE_TYPE_D3D9_ANGLE                 0x3207
          EGL_PLATFORM_ANGLE_TYPE_D3D11_ANGLE                0x3208
  
      Accepted as an attribute name in the <attrib_list> argument of
      eglGetPlatformDisplayEXT:
  
          EGL_PLATFORM_ANGLE_DEVICE_TYPE_ANGLE               0x3209
          EGL_PLATFORM_ANGLE_ENABLE_AUTOMATIC_TRIM_ANGLE     0x320F
  
      Accepted as values for the EGL_PLATFORM_ANGLE_DEVICE_TYPE_ANGLE attribute:
  
          EGL_PLATFORM_ANGLE_DEVICE_TYPE_HARDWARE_ANGLE      0x320A
          EGL_PLATFORM_ANGLE_DEVICE_TYPE_WARP_ANGLE          0x320B
          EGL_PLATFORM_ANGLE_DEVICE_TYPE_REFERENCE_ANGLE     0x320C
  
  Additions to the EGL Specification
  
      None.
  
  New Behavior
  
      To request a display that is backed by Direct3D resources, the value of
      EGL_PLATFORM_ANGLE_TYPE_ANGLE should be:
        - EGL_PLATFORM_ANGLE_TYPE_D3D9_ANGLE for a D3D9 display,
        - EGL_PLATFORM_ANGLE_TYPE_D3D11_ANGLE for a D3D11 display.
  
      To request a specific maximum feature level to be used by the D3D11
      display, EGL_PLATFORM_ANGLE_MAX_VERSION_MAJOR_ANGLE and
      EGL_PLATFORM_ANGLE_MAX_VERSION_MINOR_ANGLE can be used.  Only feature
      levels that are capable of supporting all available client APIs will be
      used unless explicitly requested.
      EGL_PLATFORM_ANGLE_MAX_VERSION_MAJOR_ANGLE and
      EGL_PLATFORM_ANGLE_MAX_VERSION_MINOR_ANGLE have no effect when requesting
      a D3D9 display.
  
      If no <attrib_list> is specified to eglGetPlatformDisplayEXT, the value of
      EGL_PLATFORM_ANGLE_DEVICE_TYPE_ANGLE is implicitly set to
      EGL_PLATFORM_ANGLE_DEVICE_TYPE_HARDWARE_ANGLE. Otherwise, the value of
      EGL_PLATFORM_ANGLE_DEVICE_TYPE_ANGLE should be:
        - EGL_PLATFORM_ANGLE_DEVICE_TYPE_HARDWARE_ANGLE to request a hardware
          accelerated device.
        - EGL_PLATFORM_ANGLE_DEVICE_TYPE_WARP_ANGLE to request an
          optimized software rasterizer.
        - EGL_PLATFORM_ANGLE_DEVICE_TYPE_REFERENCE_ANGLE to request a
          reference rasterizer.
  
      If EGL_PLATFORM_ANGLE_TYPE_ANGLE is set to
      EGL_PLATFORM_ANGLE_TYPE_D3D11_ANGLE, the display can automatically respond
      to trim events from the operating system.  If the attribute
      EGL_PLATFORM_ANGLE_ENABLE_AUTOMATIC_TRIM_ANGLE is unspecified, it is
      implicitly set to EGL_FALSE.  Otherwise, the value of
      EGL_PLATFORM_ANGLE_ENABLE_AUTOMATIC_TRIM_ANGLE should be EGL_TRUE or
      EGL_FALSE.
  
      If EGL_PLATFORM_ANGLE_DEVICE_TYPE_ANGLE is set to
      EGL_PLATFORM_ANGLE_DEVICE_TYPE_WARP_ANGLE and EGL_PLATFORM_ANGLE_TYPE_ANGLE
      is not set to EGL_PLATFORM_ANGLE_TYPE_D3D11_ANGLE, an EGL_BAD_ATTRIBUTE
      error is generated and EGL_NO_DISPLAY is returned.
  
      If EGL_PLATFORM_ANGLE_ENABLE_AUTOMATIC_TRIM_ANGLE is specified when
      EGL_PLATFORM_ANGLE_TYPE_ANGLE is not EGL_PLATFORM_ANGLE_TYPE_D3D11_ANGLE
      or a value other than EGL_TRUE or EGL_FALSE is used, an EGL_BAD_ATTRIBUTE
      error is generated and EGL_NO_DISPLAY is returned.
  
  Issues
  
      1) Some multithreaded applications can crash if the display automatically
         responds to trim events while the application is rendering from another
         thread.
  
         RESOLVED: Added an EGL_PLATFORM_ANGLE_ENABLE_AUTOMATIC_TRIM_ANGLE
         enum to specify if the display should respond to trim events.
         Applications that do multithreaded rendering should disable automatic
         trim and handle the trim events on their own.
  
  Revision History
  
      Version 1, 2014-06-05 (Geoff Lang)
        - Initial draft
      Version 2, 2014-10-27 (Geoff Lang)
        - Separate WARP devices into a new attribute instead of a platform type.
        - Moved descriptions of platforms and major/minor versions from
          EGL_ANGLE_platform_angle spec to EGL_ANGLE_platform_angle_d3d.
      Version 3, 2014-11-26 (Geoff Lang)
        - Remove the USE_WARP bool and replace it with a DEVICE_TYPE enum.
      Version 4, 2015-03-11 (Geoff Lang)
        - Add the ENABLE_AUTOMATIC_TRIM enum.