diff options
Diffstat (limited to 'glew/auto/EGL-Registry/extensions/HI')
| -rw-r--r-- | glew/auto/EGL-Registry/extensions/HI/EGL_HI_clientpixmap.txt | 144 | ||||
| -rw-r--r-- | glew/auto/EGL-Registry/extensions/HI/EGL_HI_colorformats.txt | 138 |
2 files changed, 282 insertions, 0 deletions
diff --git a/glew/auto/EGL-Registry/extensions/HI/EGL_HI_clientpixmap.txt b/glew/auto/EGL-Registry/extensions/HI/EGL_HI_clientpixmap.txt new file mode 100644 index 0000000..5ca366d --- /dev/null +++ b/glew/auto/EGL-Registry/extensions/HI/EGL_HI_clientpixmap.txt @@ -0,0 +1,144 @@ +Name + + HI_clientpixmap + +Name Strings + + EGL_HI_clientpixmap + +Contributors + + Guillaume Portier + +Contacts + + HI support. (support_renderion 'at' hicorp.co.jp) + +Status + + Shipping (Revision 3). + +Version + + Last Modified Date: June 7, 2010 + Revision 3 + +Number + + EGL Extension #24 + +Dependencies + + This extension is written against the wording of the EGL 1.4 + Specification. + +Overview + + The extension specified in this document provide a mechanism for + using memory allocated by the application as a color-buffer. + + +New Types + + EGLClientPixmapHI : specifies the width, height, stride, format + and memory pointer of the pixmap to be used by the function + eglCreatePixmapSurfaceHI to create the PixmapSurface. + + Members: + void* pData; + Pointer to a memory buffer allocated by the application + that will contain the result of the drawing operations. + It is up to the application to ensure that the buffer + size corresponds to iHeight * iStride * sizeof(pixel). + EGLint iWidth; + Width of the buffer in pixels. + EGLint iHeight; + Height of the buffer in pixels. The height of the buffer + can be negative; in that case the result of the + drawing operations will be vertically swapped. When + positive, pData will point at the bottom-left corner + of the image; when negative, to the top-left corner. + EGLint iStride; + Stride of the buffer, in pixels. It is important to note + that each row of the buffer must start on 32-bit + boundaries. + +New Procedures and Functions + + eglCreatePixmapSurfaceHI : creates an EGL ClientPixmap from + an EGLClientPixmapHI structure. eglCreatePixmapSurfaceHI usage + is identical to eglCreatePixmapSurface. In addition the ordering + of the color components in the color buffer can be specified by + the surface attribute described in the EGL_HI_colorformats + extension. + + In order to update the pointer to the data of the surface, the application + can call eglSurfaceAttrib with the EGL_CLIENT_PIXMAP_POINTER_HI attribute. + See below for an example. + +New Tokens + + None. + +Example + + + EGLClientPixmapHI pixmap; + 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, + // Specifying ARGB as a color format + EGL_COLOR_FORMAT_HI, EGL_COLOR_ARGB_HI, + EGL_NONE + }; + + // ‘access' being the memory to render into. + pixmap.pData = framebuffer.access; + pixmap.iWidht = framebuffer.width; + pixmap.iHeight = framebuffer.height; + pixmap.iStride = framebuffer.stride; + + + + //Get Config ARGB8 + eglChooseConfig(dpy, attrib_list, &config, 1, &num_config); + + // Create the pixmap + #ifdef EGL_EGLEXT_PROTOTYPES + + eglCreatePixmapSurfaceHI(eglDisplay, ppkConfig[0], &gHiPixmap); + + #else + + pfCreatePixmap = (PFNEGLCREATEPIXMAPSURFACEHIPROC) + eglGetProcAddress("eglCreatePixmapSurfaceHI"); + pfCreatePixmap(eglDisplay, ppkConfig[0], &gHiPixmap); + + #endif /* EGL_EGLEXT_PROTOTYPES */ + + + // Update the surface data pointer, from now we will render into the + // memory pointed by 'access2'. + eglSurfaceAttrib(eglDisplay, eglSurface, EGL_CLIENT_PIXMAP_POINTER_HI, + offscreen.access2); + +Issues + + None + + +Revision History + + June 7, 2010 (r3) + - Allow updating the pixmap data pointer using eglSurfaceAttrib with + the EGL_CLIENT_PIXMAP_POINTER_HI attribute. + + June 16, 2009 (r2) + - Split HI_clientpixmap into two different extensions: + - HI_colorformats + - HI_clientpixmap + + March 3, 2009 (r1) diff --git a/glew/auto/EGL-Registry/extensions/HI/EGL_HI_colorformats.txt b/glew/auto/EGL-Registry/extensions/HI/EGL_HI_colorformats.txt new file mode 100644 index 0000000..c8dc97a --- /dev/null +++ b/glew/auto/EGL-Registry/extensions/HI/EGL_HI_colorformats.txt @@ -0,0 +1,138 @@ +Name + + HI_colorformats + +Name Strings + + EGL_HI_colorformats + +Contributors + + Guillaume Portier + +Contacts + + HI support. (support_renderion 'at' hicorp.co.jp) + +Status + + Shipping (Revision 2) + +Version + + Last Modified Date: June 7, 2010 + Revision 2.1 + +Number + + EGL Extension #25 + +Dependencies + + These extensions are written against the wording of the EGL 1.4 + Specification. + +Overview + + 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. + +New Types + + None. + +New Procedures and Functions + + None. + +New Tokens + + 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. + +Example + + 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); + + +Issues + + None. + + +Revision History + + + 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) |