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

qnxgl_init()

Initialize the QNXGL API

Synopsis:

int qnxgl_init  (
  char *  path,
  char *  pattern,
  uint32_t  flags );

Arguments:

path

The path or paths to scan for OpenGL renderers. Separate multiple paths with a colon, for example: /lib/dll/gl:/usr/lib:/usr/local/lib. If NULL, the function scans /lib/dll/gl.

pattern

A filename pattern to match against (for example: so or gl- or mesa) to limit the number of renderers that can be active for your application. If set to NULL, all renderers found are made available.

flags

Flags to modify the behavior of the function:

• QNXGL_INIT_ONE_PLUGIN -- path points to the full path of the GL renderer the application wishes to use. That renderer only is made available to the application.
• 0 -- path points to one or more renderers.

Library:

qnxgl

Description:

This function initializes the QNXGL API. You must call it before calling any OpenGL^TM or any other QNXGL functions.

Returns:

The number of OpenGL renderers found, or -1 on error.

Examples:

See the code example in the OpenGL section of "Raw Drawing and Animation" in the Photon Programmer's Guide.

Classification:

Neutrino

See also:

"OpenGL" section of the Raw Drawing and Animation chapter in the Photon Programmer's Guide