# lv_opengles_private.h (/api/private/drivers/opengles/lv_opengles_private_h) Functions [#functions] lv_opengles_render_params_init [#lv_opengles_render_params_init] Initialize the render parameters with default values ```c title=" " lineNumbers=1 void lv_opengles_render_params_init(lv_opengles_render_params_t *params) ``` Parameters | Name | Type | Description | | -------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | | `params` | | pointer to an initialized struct | lv_opengles_render [#lv_opengles_render] Render the content of the window/framebuffer using OpenGL ```c title=" " lineNumbers=1 void lv_opengles_render(const lv_opengles_render_params_t *params) ``` Parameters | Name | Type | Description | | -------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | | `params` | | pointer to an initialized struct | lv_opengles_render_texture_cf [#lv_opengles_render_texture_cf] Render a texture holding pixels of an LVGL color format, using alternate blending mode. The channel order and the grayscale handling are derived from `cf`. ```c title=" " lineNumbers=1 void lv_opengles_render_texture_cf(unsigned int texture, const lv_area_t *texture_area, lv_opa_t opa, int32_t disp_w, int32_t disp_h, const lv_area_t *texture_clip_area, bool h_flip, bool v_flip, lv_color_format_t cf) ``` Parameters | Name | Type | Description | | ------------------- | -------------------------------------------------------- | --------------------------------------------------- | | `texture` | `unsigned int` | OpenGL texture ID | | `texture_area` | | the area in the window to render the texture in | | `opa` | | opacity to blend the texture with existing contents | | `disp_w` | `int32_t` | width of the window/framebuffer being rendered to | | `disp_h` | `int32_t` | height of the window/framebuffer being rendered to | | `texture_clip_area` | | the area of the texture to draw | | `h_flip` | `bool` | horizontal flip | | `v_flip` | `bool` | vertical flip | | `cf` | | the LVGL color format the texture was uploaded from | lv_opengles_regular_viewport [#lv_opengles_regular_viewport] Set the OpenGL viewport, with vertical co-ordinate conversion ```c title=" " lineNumbers=1 void lv_opengles_regular_viewport(int32_t x, int32_t y, int32_t w, int32_t h) ``` Parameters | Name | Type | Description | | ---- | --------- | -------------------------- | | `x` | `int32_t` | x position of the viewport | | `y` | `int32_t` | y position of the viewport | | `w` | `int32_t` | width of the viewport | | `h` | `int32_t` | height of the viewport | lv_opengles_render_display [#lv_opengles_render_display] ```c title=" " lineNumbers=1 void lv_opengles_render_display(lv_display_t *display, const lv_opengles_render_params_t *params) ``` Parameters | Name | Type | | --------- | -------------------------------------------------------------------------------------------- | | `display` | | | `params` | | lv_opengles_render_texture_internal [#lv_opengles_render_texture_internal] ```c title=" " lineNumbers=1 void lv_opengles_render_texture_internal(unsigned int texture, const lv_area_t *texture_area, lv_opa_t opa, int32_t disp_w, int32_t disp_h, const lv_area_t *texture_clip_area, bool h_flip, bool v_flip) ``` Parameters | Name | Type | | ------------------- | -------------------------------------------------------- | | `texture` | `unsigned int` | | `texture_area` | | | `opa` | | | `disp_w` | `int32_t` | | `disp_h` | `int32_t` | | `texture_clip_area` | | | `h_flip` | `bool` | | `v_flip` | `bool` | lv_opengles_render_display_texture_internal [#lv_opengles_render_display_texture_internal] ```c title=" " lineNumbers=1 void lv_opengles_render_display_texture_internal(lv_display_t *display, bool h_flip, bool v_flip) ``` Parameters | Name | Type | | --------- | -------------------------------------------------------- | | `display` | | | `h_flip` | `bool` | | `v_flip` | `bool` | lv_opengles_gl_format_from_color_format [#lv_opengles_gl_format_from_color_format] Get the `glTexImage2D` arguments to upload a buffer of an LVGL color format with ```c title=" " lineNumbers=1 lv_result_t lv_opengles_gl_format_from_color_format(lv_color_format_t cf, lv_opengles_gl_format_t *gl_format) ``` Parameters | Name | Type | Description | | ----------- | ------------------------------------------------------------------------------ | ----------------------------- | | `cf` | | the LVGL color format | | `gl_format` | | pointer to the struct to fill | **Returns:** — `LV_RESULT_OK` on success, `LV_RESULT_INVALID` if `cf` has no OpenGL equivalent lv_opengles_color_format_is_rb_swap [#lv_opengles_color_format_is_rb_swap] ```c title=" " lineNumbers=1 bool lv_opengles_color_format_is_rb_swap(lv_color_format_t cf) ``` Parameters | Name | Type | | ---- | ------------------------------------ | | `cf` | | lv_opengles_color_format_is_premultiplied [#lv_opengles_color_format_is_premultiplied] ```c title=" " lineNumbers=1 bool lv_opengles_color_format_is_premultiplied(lv_color_format_t cf) ``` Parameters | Name | Type | | ---- | ------------------------------------ | | `cf` | | lv_opengles_texture_upload_buf [#lv_opengles_texture_upload_buf] Upload a pixel buffer into an OpenGL texture ```c title=" " lineNumbers=1 lv_result_t lv_opengles_texture_upload_buf(unsigned int texture_id, const void *buf, int32_t w, int32_t h, uint32_t stride, lv_color_format_t cf) ``` Parameters | Name | Type | Description | | ------------ | ------------------------------------ | ------------------------------------------------------------------------------------------ | | `texture_id` | `unsigned int` | the OpenGL texture ID to upload into | | `buf` | `const void *` | the pixel buffer. **May** be `NULL`.. Can be `NULL` to only define the size and the format | | `w` | `int32_t` | width of the buffer in pixels | | `h` | `int32_t` | height of the buffer in pixels | | `stride` | `uint32_t` | stride of the buffer in bytes. Ignored when `buf` is `NULL` | | `cf` | | the LVGL color format of the buffer | **Returns:** — `LV_RESULT_OK` on success, `LV_RESULT_INVALID` if `cf` has no OpenGL equivalent lv_opengles_texture_upload_display_buf [#lv_opengles_texture_upload_display_buf] Upload the rendered buffer of a display into an OpenGL texture. The size and the color format are taken from the display. ```c title=" " lineNumbers=1 lv_result_t lv_opengles_texture_upload_display_buf(unsigned int texture_id, lv_display_t *display, const void *buf) ``` Parameters | Name | Type | Description | | ------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | `texture_id` | `unsigned int` | the OpenGL texture ID to upload into | | `display` | | the display the buffer belongs to | | `buf` | `const void *` | the pixel buffer. **May** be `NULL`.. Can be `NULL` to only define the size and the format | **Returns:** — `LV_RESULT_OK` on success, `LV_RESULT_INVALID` if the color format of the display has no OpenGL equivalent Structs [#structs] lv_opengles_render_params_t [#lv_opengles_render_params_t] | Member | Type | Description | | ------------------- | ------------------------------------------------------------ | ----------- | | `texture` | `unsigned int` | | | `texture_area` | | | | `opa` | | | | `disp_w` | `int32_t` | | | `disp_h` | `int32_t` | | | `texture_clip_area` | | | | `h_flip` | `bool` | | | `v_flip` | `bool` | | | `rb_swap` | `bool` | | | `fill_color` | | | | `blend_opt` | `bool` | | | `matrix` | | | | `cf` | | | * `lv_opengles_render_params_init` — param `params` * `lv_opengles_render` — param `params` * `lv_opengles_render_display` — param `params` lv_opengles_gl_format_t [#lv_opengles_gl_format_t] The `glTexImage2D` arguments describing an LVGL color format | Member | Type | Description | | ----------------- | ---------- | ---------------------------------------------------------------- | | `internal_format` | `int32_t` | the `internalformat` argument of `glTexImage2D` | | `format` | `uint32_t` | the `format` argument of `glTexImage2D` | | `type` | `uint32_t` | the `type` argument of `glTexImage2D` | | `rb_swap` | `bool` | the red and blue channels have to be swapped while rendering | | `premultiplied` | `bool` | the color channels are multiplied with the alpha channel already | * `lv_opengles_gl_format_from_color_format` — param `gl_format` Macros [#macros] GL_BGRA [#gl_bgra] ```c title=" " lineNumbers=1 #define GL_BGRA GL_BGRA_EXT ``` GL_TEXTURE_MAX_LEVEL [#gl_texture_max_level] ```c title=" " lineNumbers=1 #define GL_TEXTURE_MAX_LEVEL GL_TEXTURE_MAX_LEVEL_APPLE ``` GL_UNPACK_ROW_LENGTH [#gl_unpack_row_length] ```c title=" " lineNumbers=1 #define GL_UNPACK_ROW_LENGTH GL_UNPACK_ROW_LENGTH_EXT ``` glGenVertexArrays [#glgenvertexarrays] ```c title=" " lineNumbers=1 #define glGenVertexArrays glGenVertexArraysOES ``` glBindVertexArray [#glbindvertexarray] ```c title=" " lineNumbers=1 #define glBindVertexArray glBindVertexArrayOES ``` glDeleteVertexArrays [#gldeletevertexarrays] ```c title=" " lineNumbers=1 #define glDeleteVertexArrays glDeleteVertexArraysOES ``` glTexStorage2D [#gltexstorage2d] ```c title=" " lineNumbers=1 #define glTexStorage2D glTexStorage2DEXT ``` GL_RGBA32F [#gl_rgba32f] ```c title=" " lineNumbers=1 #define GL_RGBA32F 0x8814 ``` GL_NUM_EXTENSIONS [#gl_num_extensions] ```c title=" " lineNumbers=1 #define GL_NUM_EXTENSIONS 0x821D ``` GL_RGB8 [#gl_rgb8] ```c title=" " lineNumbers=1 #define GL_RGB8 0x8051 ``` GL_RGBA8 [#gl_rgba8] ```c title=" " lineNumbers=1 #define GL_RGBA8 0x8058 ``` GL_R8 [#gl_r8] ```c title=" " lineNumbers=1 #define GL_R8 GL_LUMINANCE ``` GL_RED [#gl_red] ```c title=" " lineNumbers=1 #define GL_RED GL_LUMINANCE ``` LV_GL_PREFERRED_DEPTH [#lv_gl_preferred_depth] ```c title=" " lineNumbers=1 #define LV_GL_PREFERRED_DEPTH GL_DEPTH_COMPONENT16 ``` Dependencies [#dependencies]