gles2-gears-offscreen

Graphics and Screen4.0 (8.x)Screen Graphics Subsystem Developer's GuideAPIProgrammingUtilities

Render animated gears to offscreen buffers

Syntax:

gles2-gears-offline [-config=egl_configuration]
                    [-dumpframe=frame_number]
                    [-egl-display-id=display_id]
                    [-fpsprefix=fps_prefix]
                    [-frame-limit=frame_limit]
                    [-nbuffers=count]
                    [-pixmap]
                    [-size=widthxheight]
                    [-verbose]
            

Runs on:

QNX OS

Options:

-config=egl_configuration

Set optional EGL configuration specifiers. These optional configuration specifiers are set using a comma-separated list. The specifiers may include the following: pixel format and/or multi-sampling specifications, or an EGL configuration number. If you're using an EGL configuration number, it must not be specified with other specifiers.

Pixel format

Specify pixel format as one of the following:

  • rgba1010102 or rgbx1010102
  • rgba8888 or rgbx8888
  • rgba5551 or rgbx5551
  • rgb565
  • rgba4444 or rgbx4444

where "a" indicates alpha bits and "x" indicates ignored bits.

Sampling

Specify multi-sampling as:

[rate]x

where rate is a valid sampling rate (e.g., 2, 4, 8, ...).

EGL configuration number
Specify as an integer. The integer must be a valid EGL configuration ID (EGL_CONFIG_ID).

For example, the following are all valid ways of specifying the EGL configuration option:

  • -config=rgb565
  • -config=rgba8888,4x
  • -config=12

If no specific EGL configuration is provided, this utility uses the first listed RBG pixel format.

-dumpframe=frame_number
Set the frame_number to be saved in a BMP file where frame_number is greater than zero (0). Once set, a file is created in the current working directory using the following naming convention:
pixel_format-widthxheight-frame_number
This feature supports only 32-bit RGBA formats.
-egl-display-id=display_id
Choose the egl display section in graphics.conf.
-fpsprefix=fps_prefix
Choose the fps prefix for fps prints.
-frame-limit=frame_limit
Limit the number of frames rendered to the value specified by frame_limit (integer); after the frame limit is reached, gles2-gears-offscreen exits. By default, this utility assumes an unlimited number of frames (-1).
-nbuffers=count
Set the number of offscreen buffers to be cycled. The default is 1.
-pixmap
Use native pixmap buffers as the render target allocated as Screen pixmaps. If not set, the render target is allocated as an EGL Pbuffer surface.
-size=widthxheight
Set the size as specified, using integer values for width and height, of the viewport. The default size is 1920x1080.
-verbose
Print information to display.

Description:

The gles2-gears-offscreen binary is a command-line tool that renders animated gears to offscreen buffers with the option to dump given frames to a BMP file. As a default, the offscreen buffers are allocated entirely within the EGL/GL stack as EFL Pbuffers. You can use the pixmap to allocates the offscreen buffers as native Screen pixmap buffers imported to the EGL stack as an EGL pixmap surface.

Page updated: