vg-tiger

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

Display hardware-rendered content using OpenVG

Syntax:

vg-tiger     [-config=egl_configuration]
             [-display=display_id]
             [-double-buffer]
             [-interval=swap_interval]
             [-pbuffer]
             [-pipeline=pipeline_id]
             [-pos=x,y]
             [-single-buffer]
             [-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:

  • 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 the EGL configurations that are supported on your target.

-display=display_id
Specify which display the window will appear on by using display_id. You can specify display_id as one of the following:
  • an integer that identifies the display
  • an ID string that identifies the name of the display (id_string)
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 vg-tiger 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, vg-tiger 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.
-size=widthxheight
Set the size as specified, using integer values for width and height, of the viewport. The default size is fullscreen.
-single-buffer
Use one buffer for rendering. If this option isn't specified, then vg-tiger uses two rendering buffers.
-verbose
Print information to display.

Description:

The vg-tiger binary is a command-line tool that can be used to confirm that all the necessary drivers for OpenVG are in place and can start successfully.

To run vg-tiger:

  1. Ensure that screen is running.
  2. Run vg-tiger from a shell.

Examples:

# vg-tiger


Page updated: