Using the Tutorials and Demos

We provide some 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 demonstration programs include EGL and OpenKODE versions of the gears application. The gears application renders a set of animated gears onto the user's display.

To get the source code for the EGL and OpenKODE versions of the gears application, go to the Graphics project on our Foundry27 community website (http://community.qnx.com/sf/projects/graphics), and download apps/egl/demos/gles1-egl-gears/ and apps/egl/demos/demos/gles1-kd-gears/ from the source-code repository.

The gears application has the following usage information:

Options:

config=int

A comma-separated list of optional configuration specifiers.

display=[int]

EGL display id.

double-buffer

Alternate between two rendering buffers.

global-alpha=[0..255]

The global transparency of the window.

interval=int

The swap interval.

layer=int (OpenGL only)

Display contents on the specified layer.

pos=x,y

The position of the viewport (if supported).

single-buffer

Create a single rendering buffer.

size=widthxheight

The position of the viewport (if supported).

source-alpha

Enable per-pixel alpha blending.

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: To get the tutorials, go to the Graphics project on our Foundry27 community website (http://community.qnx.com/sf/projects/graphics), and look for the following directories in the source-code repository:

apps/egl/tutorials

Examples of vsync using EGL.

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