display-image

Display the specified image

Syntax:

display-image [-display=display_id]
              -file=filename
              [-format=pixel_format]
              [-pipeline=pipeline_id]
              [-pos=x,y]
              [-size=widthxheight]
              [-transparency=transparency_mode]
              [-verbose]
              [-zorder=zorder]

Runs on:

QNX Neutrino

Options:

-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
    • rgbhv
    • 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 display-image uses the default display.

-file=filename
Show the image specified by filename on the display. Specify the full path in filename for your image.
-format=pixel_format
Set the pixel format, as a string, of the window (default is rgbx8888). The pixel format can be one of the following strings:
  • rgba8888
  • rgbx8888
  • rgb565
-pipeline=pipeline_id
Set the pipeline as specified by pipeline_id (integer). If you don't specify this option, display-image 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.
-transparency=transparency_mode
Set the transparency mode of the window. Valid transparency modes are:
Transparency mode Description
none Default mode; result is an opaque window
test Destination pixels are replaced by source pixels; pixels may be opaque or fully transparent
src Destination pixels are replaced by source pixels, including the alpha channel; window will be blended with contents underneath it
-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 display binary is a command-line tool that can be used to show an image on the display.

This tool uses the Image library. Therefore, you must ensure that the LIBIMG_CFGFILE environment variable is set to the full path for an image configuration file. Otherwise, the Image libarary uses the file /etc/system/config/img.conf on your target. The codecs that you specify in your image configuration file must be available from your library search path (i.e., LD_LIBRARY_PATH). For more information on the image configuration file, see lib_img_attach() from the Image Library Reference.

To run display-image:

  1. Ensure that screen is running.
  2. Run display-image from a shell.

Examples:

# display-image /usr/share/gles/textures/bubble.png