HI_colorformats

EGL_HI_colorformats

Guillaume Portier

HI support. (support_renderion 'at' hicorp.co.jp)

Shipping (Revision 2)

Last Modified Date: June 7, 2010
Revision 2.1

EGL Extension #25

These extensions are written against the wording of the EGL 1.4
Specification.

The extensions specified in this document provide a mechanism for
creating ARGB color-buffers, as opposed to the default RGBA
format used by other EGL configurations.

None.

None.

  Accepted in the <attrib_list> parameter of eglChooseConfig.

      EGL_COLOR_FORMAT_HI				0x8F70

  Accepted as a value for the EGL_COLOR_FORMAT_HI token:

      EGL_COLOR_RGB_HI				0x8F71
      EGL_COLOR_RGBA_HI				0x8F72
      EGL_COLOR_ARGB_HI				0x8F73


  The default value for EGL_COLOR_FORMAT_HI is EGL_DONT_CARE.
  If EGL_COLOR_FORMAT_HI is used with a value other than
  EGL_DONT_CARE, EGL_COLOR_RGB_HI, EGL_COLOR_RGBA_HI or
  EGL_COLOR_ARGB_HI then an EGL_BAD_ATTRIBUTE is generated.

  EGL_COLOR_RGB_HI, EGL_COLOR_RGBA_HI and EGL_COLOR_ARGB_HI 
  specify the order of the color components in the color-buffer.
  EGL_COLOR_RGB_HI must be used only with configurations having no
  alpha component, currently only 565.

  EGL_COLOR_RGBA_HI and EGL_COLOR_ARGB_HI must be used with
  configurations having an alpha component. Currently available
  configurations are:
      - 4444
      - 5551
      - 8888
  Currently EGL_COLOR_ARGB_HI can be used only with the
  8888 configuration.

  If the value used for EGL_COLOR_FORMAT_HI does not match
  the other specified attributes of the EGL config then an
  EGL_BAD_MATCH is generated.

  When EGL_COLOR_FORMAT_HI is unspecified or equals EGL_DONT_CARE,
  eglChooseConfig returns configurations having all kinds of color
  component ordering.

  If eglCreatePixmapSurface is called with a configuration that
  does not match the pixmap's native ordering then an EGL_BAD_MATCH
  is generated. To be sure to call eglCreatePixmapSurface with a
  compatible configuration, the application should either parse
  the <configs> list returned by eglChooseConfig or explicitly specify
  EGL_COLOR_FORMAT_HI to match the pixmap native format.

EGLint attrib_list[] = {
    EGL_RED_SIZE, 8,
    EGL_GREEN_SIZE, 8,
    EGL_BLUE_SIZE, 8,
    EGL_ALPHA_SIZE, 8,
    EGL_SURFACE_TYPE, EGL_PIXMAP_BIT,

    #ifdef USE_ARGB           // Specifying ARGB as a color format
    EGL_COLOR_FORMAT_HI, EGL_COLOR_ARGB_HI,
    #else                     // Specifying RGBA as a color format
    EGL_COLOR_FORMAT_HI, EGL_COLOR_RGBA_HI,
    #endif

    EGL_NONE
};

// Get one of the configuration matching the config_list
eglChooseConfig(dpy, attrib_list, &config, 1, &num_config);

// Create the pixmap
eglCreatePixmapSurface(dpy, config[0], pixmap, NULL);

None.

June 7, 2010 (r2.1)
    - Corrected mistaken description of EGL_COLOR_FORMAT_HI as
      attribute for eglCreatePixmapSurface. Clarified other text.

June 16, 2009 (r2)
- Split HI_clientpixmap into two different extensions:
      -  HI_colorformats
      -  HI_clientpixmap

March 3, 2009 (r1)