gf_context_set_bgcolor_native()

Replace the background rendering color

Synopsis:

#include <gf/gf.h>

void gf_context_set_bgcolor_native(
        gf_context_t context,
        unsigned color );

Arguments:

context
The draw context handle.
color
The new background color, in native format (see below).

Library:

gf

Description:

This function replaces the current secondary (background) rendering color for the given graphics context. The background color applies only to a few rendering operations, such as:

This variant of gf_context_set_bgcolor() bypasses the color-conversion routines and takes the color in native form. To effectively use this function, you must be aware of the target surface's pixel format and how data is encoded in that format. See gf_format_t for more details on data encoding for the different supported formats.


Note: Unlike gf_context_set_bgcolor(), setting a color using this function is not persistent. If you switch surfaces using gf_context_set_surface(), then the setting will be lost, and background color will be recalculated based on the last setting made using gf_context_set_bgcolor().

Classification:

QNX Graphics Framework

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

gf_context_set_bgcolor(), gf_context_set_fgcolor(), gf_context_set_fgcolor_native(), gf_format_t