Display hardware-rendered content using OpenGL ES 1.x
Syntax:
gles1-gears [-config=egl_configuration]
[-display=display_id]
[-double-buffer]
[-interval=swap_interval]
[-pbuffer]
[-pipeline=pipeline_id]
[-pos=x,y]
[-single-buffer]
[-size=widthxheight]
[-verbose]
[-zorder=zorder]
Options:
- -config=egl_configuration
-
Set optional EGL configuration specifiers. These optional configuration
specifiers are set 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:
- 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
configuation option:
- -config=rgb565
- -config=rgba8888,4x
- -config=12
If no specific EGL configuration is provided, this utility uses the platform-specific EGL configuration.
Use egl-configs to determine the
EGL configurations that are supported on your target.
- -display=display_id
-
Show the events on the display as specified by display_id.
You can specify display_id as one of the following:
- an integer that identifies the display
-
a string that identifies the connection type to the display; acceptable strings are:
- internal
- composite
- svideo
- YPbPr
- rgb
- rgbhv
- dvi
- hdmi
- other
Whether by integer or by string, the display that you specify using display_id must be one of the displays
that you've configured in the display
subsections of the winmgr section in your configuration file (e.g., graphics.conf).
If you don't have any display subsections
configured, or if you don't specify the display option, then events uses the default display.
- -double-buffer
- Use two rendering buffers, while alternating between the two.
- -interval=swap_interval
- Set the swap interval, as an integer (default is 1). The swap interval is the minimum
number of vsync periods between image updates.
- -pbuffer
-
Use an off-screen rendering surface. The default size of this surface is 256x256 pixels.
- -pipeline=pipeline_id
-
Set the pipeline as specified by pipeline_id (integer). If you don't specify this option,
gles1-gears uses the pipeline of the framebuffer.
If you use this option, Screen applies
the SCREEN_USAGE_OVERLAY usage flag and uses the pipeline specified by
pipeline_id.
- -pos=x,y
- Sets the x,y coordinates of the viewport.
The default coordinate of 0,0 is used if this option isn't specified.
- -single-buffer
-
Use one buffer for rendering. If this option isn't specified, then gles1-gears
uses two rendering buffers.
- -size=widthxheight
-
Set the size as specified, using integer values for width and height, of the viewport.
The default size is fullscreen.
- -verbose
- Print information to display.
- -zorder=zorder
-
Set the z-order specified by zorder, as an integer, of the window.
A z-order of 0 is used if this option isn't specified.
Description:
The gles1-gears binary is a command-line tool that can be used to confirm that
screen is running, and that all necessary drivers for OpenGL ES 1.x are in place,
and can start successfully.
To invoke gles1-gears:
- Ensure that screen is running.
- Run gles1-gears from a shell.
Examples:
# gles1-gears