This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

Using the tutorials and demos

The Composition Manager ships with demos and well documented tutorials that help you to understand how the underlying code works, and let you build your own application using the Composition Manager.

Demos

The Composition Manager comes with EGL and OpenKODE versions of the gears application. The gears application renders a set of animated gears onto the user's display.

The EGL and OpenKODE versions of the gears application can be found at usr/src/composition/apps-egl/demos/gles1-egl-gears/ and usr/src/composition/apps-kd/demos/gles1-kd-gears/ respectively.

The gears application has the following usage information:

Options:

config=int

A comma-separated list of optional configuration specifiers.

size=widthxheight

The position of the viewport (if supported).

pos=x,y

The position of the viewport (if supported).

interval=int

The swap interval.

layer=int (OpenGL only)

Display contents on the specified layer.

global-alpha=[0..255]

The global transparency of the window.

source-alpha

Enable per-pixel alpha blending.

rotation=[0..7]

Change how the gears are rotated.

verbose

Print an information string.

Notes:

• The format string following the config option is a comma-separated list of optional configuration specifiers. These include pixel format specification, multi-sampling specification, or an EGL configuration number. Configuration numbers shouldn't be used with other specifiers.

  The syntax for each specifier is as follows:

  format=[rgba8888|rgba5551|rgb565|rgba4444]
  sampling=[int]x, e.g. 2x
  [int] (a valid EGL configuration number)

  A few examples:

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

• If no specific EGL configuration is provided, the application will get the best pixel format that can be rendered to with OpenGL ES and displayed on the layer.
• By default, the application will be displayed on the main layer.
• The default viewport size is full screen.
• The default viewport position is at (0,0).
• The default swap interval is 1.
• You can use the F key to pause and resume the animation of the gears.
• You can use the Escape key to exit the demo.

Tutorials

In addition to the demo applications, the Composition Manager provides a set of well-documented tutorials that guide you through the process of writing an application. In particular, the tutorials provide an example of vsync using each of the provided external APIs.

The tutorials are provided in the following file locations:

usr/src/composition/apps-egl/tutorials/

Examples of vsync using EGL.

usr/src/composition/apps-kd/tutorials/

Examples of vsync using OpenKODE.

Community

Do you have questions? Do you want in on the latest Composition Manager news?

Check out the graphics project on Foundry 27: Graphics project homepage

Do you want to see what other people are doing with Composition Manager? Do you want to share your experiences?

Check out the Composition Manager forum on Foundry 27: Composition Manager/Open KODE forum