gf_context_set_bgcolor()

Replace the background rendering color

Synopsis:

#include <gf/gf.h>

gf_color_t gf_context_set_bgcolor( gf_context_t context,
                                   gf_color_t color );

Arguments:

context

The draw context handle.

color

The new background color, in packed ARGB8888 format.

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:

• patterns
• backfilled bitmaps
• dashed lines

---

Make sure you set the upper 8 bits (the alpha channel) in the color argument to 0xFF to ensure that objects drawn in the frame buffer have the correct opacity associated with them. For example, if the frame buffer surface includes an alpha component, objects drawn without opacity may not show up in a multi-layered environment.

---

Returns:

The previous background color.

Classification:

QNX Graphics Framework

See also:

gf_context_set_bgcolor_native(), gf_context_set_fgcolor(), gf_context_set_fgcolor_native()