Describes a frame buffer / surface configuration for a given egldisplay_t.
| EGL-Framebuffer-Configuration | Describes a frame buffer / surface configuration for a given egldisplay_t. |
| Copyright | This program is free software. |
| Files | |
| C-kern/ | Header file EGL-Framebuffer-Configuration. |
| C-kern/ | Implementation file EGL-Framebuffer-Configuration impl. |
| Types | |
| struct opengl_config_t | Export <opengl_config_t > into global namespace. |
| struct eglconfig_t | Export eglconfig_t into global namespace. |
| eglconfig_filter_f | Declares filter to select between different possible configuration. |
| Functions | |
| test | |
| unittest_platform_opengl_egl_eglconfig | Test eglconfig_t functionality. |
| eglconfig_t | Contains an EGL frame buffer configuration. |
| lifetime | |
| eglconfig_FREE | Static initializer. |
| init_eglconfig | Returns a configuration which matches the given attributes. |
| initfiltered_eglconfig | Same as init_eglconfig except that more than one possible configuration is considered. |
| initfromconfigid_eglconfig | Returns a configuration with ID id. |
| free_eglconfig | Frees any associated resources. |
| query | |
| value_eglconfig | Returns the value of attribute. |
| visualconfigid_eglconfig | Returns the native visualid of the configuration. |
| configid_eglconfig | Returns the ID of configuration eglconf in id. |
| maxpbuffer_eglconfig | Returns the maximum size of an off-screen pixel buffer. |
| inline implementation | |
| Macros | |
| free_eglconfig | Implements eglconfig_t.free_eglconfig. |
This program is free software. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
© 2014 Jörg Seebohn
Header file EGL-Framebuffer-Configuration.
Implementation file EGL-Framebuffer-Configuration impl.
Export eglconfig_t into global namespace.
typedef bool ( * eglconfig_filter_f ) (eglconfig_t eglconf, int32_t visualid, void * user)
Declares filter to select between different possible configuration. The filter function must return true if it accepts the visual ID given in parameter visualid else false. If no visualid passes the filter <initfiltered_eglconfig> returns ESRCH.
| test | |
| unittest_platform_opengl_egl_eglconfig | Test eglconfig_t functionality. |
int unittest_platform_opengl_egl_eglconfig( void )
Test eglconfig_t functionality.
typedef struct opengl_config_t * eglconfig_t
Contains an EGL frame buffer configuration.
| lifetime | |
| eglconfig_FREE | Static initializer. |
| init_eglconfig | Returns a configuration which matches the given attributes. |
| initfiltered_eglconfig | Same as init_eglconfig except that more than one possible configuration is considered. |
| initfromconfigid_eglconfig | Returns a configuration with ID id. |
| free_eglconfig | Frees any associated resources. |
| query | |
| value_eglconfig | Returns the value of attribute. |
| visualconfigid_eglconfig | Returns the native visualid of the configuration. |
| configid_eglconfig | Returns the ID of configuration eglconf in id. |
| maxpbuffer_eglconfig | Returns the maximum size of an off-screen pixel buffer. |
int init_eglconfig( /*out*/eglconfig_t * eglconf, struct opengl_display_t * egldisp, const int32_t config_attributes[] )
Returns a configuration which matches the given attributes. The configuration determines the type of frame buffer supported by surfaces or OpenGL contexts. The parameters stored in config_attributes must be tupels of type (gconfig_e value, int value) followed by the termination value gconfig_NONE.
| 0 | Success, eglconf is valid. |
| E2BIG | Attributes list in config_attributes is too long, eglconf is not changed. |
| EINVAL | Either egldisp is invalid, an invalid gconfig_e is supplied or the supplied integer value is invalid for the corresponding gconfig_e attribute id. |
| ESRCH | No configuration matches the supplied attribues. |
int initfiltered_eglconfig( /*out*/eglconfig_t * eglconf, struct opengl_display_t * egldisp, const int32_t config_attributes[], eglconfig_filter_f filter, void * user )
Same as init_eglconfig except that more than one possible configuration is considered. The provided filter is repeatedly called for every possible configuration as long as it returns false. The first configuration which passes the filter is used. Parameter user is passed as user data into the filter function.
int value_eglconfig( eglconfig_t eglconf, struct opengl_display_t * egldisp, const int32_t attribute, /*out*/int32_t * value )
Returns the value of attribute. The parameter egldisp must be of type egldisplay_t and parameter attribute must be a value from gconfig_e. On error EINVAL is returned else 0.
int maxpbuffer_eglconfig( eglconfig_t eglconf, struct opengl_display_t * egldisp, /*out*/uint32_t * maxwidth, /*out*/uint32_t * maxheight, /*out*/uint32_t * maxpixels )
Returns the maximum size of an off-screen pixel buffer. The values are returned in maxwidth(in pixels), maxheight(in pixels) and maxpixels(width*height). If one of the out parameter is set to NULL no value is returned.
| Macros | |
| free_eglconfig | Implements eglconfig_t.free_eglconfig. |
#define free_eglconfig( eglconf ) (*(eglconf) = eglconfig_FREE, 0)
Implements eglconfig_t.free_eglconfig.
Export <opengl_config_t > into global namespace.
typedef struct opengl_config_t * opengl_config_t
Contains an EGL frame buffer configuration.
typedef struct opengl_config_t * eglconfig_t
Declares filter to select between different possible configuration.
typedef bool ( * eglconfig_filter_f ) (eglconfig_t eglconf, int32_t visualid, void * user)
Test eglconfig_t functionality.
int unittest_platform_opengl_egl_eglconfig( void )
Static initializer.
#define eglconfig_FREE 0
Returns a configuration which matches the given attributes.
int init_eglconfig( /*out*/eglconfig_t * eglconf, struct opengl_display_t * egldisp, const int32_t config_attributes[] )
Same as init_eglconfig except that more than one possible configuration is considered.
int initfiltered_eglconfig( /*out*/eglconfig_t * eglconf, struct opengl_display_t * egldisp, const int32_t config_attributes[], eglconfig_filter_f filter, void * user )
Returns a configuration with ID id.
int initfromconfigid_eglconfig( /*out*/eglconfig_t * eglconf, struct opengl_display_t * egldisp, const uint32_t id )
Frees any associated resources.
int free_eglconfig( eglconfig_t * eglconf )
Returns the value of attribute.
int value_eglconfig( eglconfig_t eglconf, struct opengl_display_t * egldisp, const int32_t attribute, /*out*/int32_t * value )
Returns the native visualid of the configuration.
int visualconfigid_eglconfig( eglconfig_t eglconf, struct opengl_display_t * egldisp, /*out*/int32_t * visualid )
Returns the ID of configuration eglconf in id.
int configid_eglconfig( eglconfig_t eglconf, struct opengl_display_t * egldisp, /*out*/uint32_t * id )
Returns the maximum size of an off-screen pixel buffer.
int maxpbuffer_eglconfig( eglconfig_t eglconf, struct opengl_display_t * egldisp, /*out*/uint32_t * maxwidth, /*out*/uint32_t * maxheight, /*out*/uint32_t * maxpixels )
Implements eglconfig_t.free_eglconfig.
#define free_eglconfig( eglconf ) (*(eglconf) = eglconfig_FREE, 0)