src/third_party/webgl/src/extensions/OES_texture_half_float/extension.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <ratified href="OES_texture_half_float/">
   3   <name>OES_texture_half_float</name>
   4
   5   <contact> <a href="https://www.khronos.org/webgl/public-mailing-list/">WebGL
   6   working group</a> (public_webgl 'at' khronos.org) </contact>
   7
   8   <contributors>
   9     <contributor>Members of the WebGL working group</contributor>
  10   </contributors>
  11
  12   <number>2</number>
  13
  14   <depends>
  15     <api version="1.0"/>
  16   </depends>
  17
  18   <overview>
  19     <mirrors href="http://www.khronos.org/registry/gles/extensions/OES/OES_texture_float.txt"
  20              name="OES_texture_half_float">
  21       <addendum>Optional support for <code>HALF_FLOAT</code> textures as FBO
  22       attachments (deprecated).</addendum>
  23     </mirrors>
  24
  25     <features>
  26       <feature> The <code>texImage2D</code> and <code>texSubImage2D</code>
  27       entry points taking <code>ArrayBufferView</code> are extended to accept
  28       <code>Uint16Array</code> with the pixel type <code>HALF_FLOAT_OES</code>.
  29       </feature>
  30
  31       <feature> The <code>texImage2D</code> and <code>texSubImage2D</code>
  32       entry points taking <code>ImageData</code>,
  33       <code>HTMLImageElement</code>, <code>HTMLCanvasElement</code> and
  34       <code>HTMLVideoElement</code> are extended to accept the pixel type
  35       <code>HALF_FLOAT_OES</code>. </feature>
  36
  37       <feature>Implementations supporting float rendering via this extension
  38       will implicitly enable the <a
  39       href="../EXT_color_buffer_half_float/">EXT_color_buffer_half_float</a>
  40       extension and follow its requirements. This ensures correct behavior
  41       when a texture with pixel type <code>HALF_FLOAT_OES</code> is attached
  42       to an FBO. Although this feature has historically been allowed, new
  43       implementations should not implicitly support float rendering and
  44       applications should be modified to explicitly enable <a
  45       href="../EXT_color_buffer_half_float/">EXT_color_buffer_half_float</a>.</feature>
  46     </features>
  47   </overview>
  48
  49   <idl xml:space="preserve">
  50 [NoInterfaceObject]
  51 interface OES_texture_half_float {
  52   const GLenum HALF_FLOAT_OES = 0x8D61;
  53 };
  54 </idl>
  55
  56   <history>
  57     <revision date="2010/11/29">
  58       <change>Initial revision.</change>
  59     </revision>
  60
  61     <revision date="2011/09/12">
  62       <change> Added similar text about <code>texImage2D</code> and
  63       <code>texSubImage2D</code> as in OES_texture_float spec. </change>
  64
  65       <change> Added optional ability to use a HALF_FLOAT_OES type texture as
  66       an FBO's color attachment. </change>
  67     </revision>
  68
  69     <revision date="2012/01/03">
  70       <change>Removed webgl module per changes to Web IDL spec.</change>
  71     </revision>
  72
  73     <revision date="2012/12/04">
  74       <change>Specify that implementations supporting HALF_FLOAT_OES color
  75       attachments implicitly enable EXT_color_buffer_half_float.</change>
  76     </revision>
  77
  78     <revision date="2013/05/15">
  79       <change>Ratified by Khronos Board of Promoters.</change>
  80     </revision>
  81
  82     <revision date="2014/02/12">
  83       <change>Allow texture uploads of half-floats via Uint16Arrays.</change>
  84     </revision>
  85
  86     <revision date="2014/07/15">
  87       <change>Added NoInterfaceObject extended attribute.</change>
  88     </revision>
  89
  90     <revision date="2014/09/11">
  91       <change>Corrected link to EXT_color_buffer_half_float.</change>
  92     </revision>
  93   </history>
  94 </ratified>