gf_context_set_hw_polygon()

Toggles the behavior of polygon software fallback rendering

Synopsis:

#include <gf/gf.h>

void gf_context_set_hw_polygon( gf_context_t context,
                                uint8_t hw_only );

Arguments:

context

The graphics context to enable hardware-only polygon rendering, or disable hardware-only polygon rendering (allow software fallback).

hw_only

Enable hardware-only polygon rendering, or disable hardware only polygon rendering (allow software fallback).

If hardware-only polygon rendering is enabled, and the driver does not support the request polygon operation, then gf_draw_polyline() and gf_draw_poly_fill() will return GF_ERR_NOSUPPORT.

Library:

gf

Description:

Polygon draw operations should be able to avoid software rendering.

Ideally, gf_draw_polyline() and gf_draw_poly_fill() should have options to prevent software fallback polygon rendering however, when the software fallback was initially implemented, it should have been turned on. Instead, it was made the default behaviour.

Classification:

QNX Graphics Framework