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

gf_3d_target_create()

Create a target for 3D rendering

Synopsis:

#include <gf3d.h>

int gf_3d_target_create( gf_3d_target_t *   ptarget,
                         gf_layer_t         layer,
                         gf_surface_t *     surfaces,
                         int                nsurfaces,
                         int                width,
                         int                height,
                         gf_format_t        format );

Arguments:

ptarget: A pointer to a gf_3d_target_t handle for a 3D rendering target which you want to create.
layer: The layer used to display the 3D content.
surfaces: An array of preallocated surfaces for 3D rendering. If NULL, the function allocates the required surfaces.
nsurfaces: The number of items in the surfaces array.
width, height: The width and height, in pixels, of the viewport for the displayed 3D content.
format: The gf_format_t format of the data in the 3D color buffer displayed on the layer.

Library:

gf

Description:

This function creates a 3D rendering target.

Returns:

GF_ERR_OK: Success.
GF_ERR_MEM: Memory allocation failure.

Classification:

QNX Graphics Framework

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes