GPE Base Classes

Article
06/30/2006

The Graphics Primitive Engine (GPE) base class library is a device-independent bitmap (DIB) driver. GPE can use the emulation library, ClearType, antialiasing and gradient fill. The GPE base class library implements all basic drawing functions for video adapters that have the following characteristics:

Video buffers are accessible in system address space.
Video buffer is non-banked.
Video buffer is non-planar and has one plane.
Video buffers have one of the following bits-per-pixel: 1, 2, 4, 8, 16, 24, or 32.

A 5-, 6-, or 15-bpp driver cannot be GPE-based.
GPE enables device-specific accelerations for the drawing of either raster (bitmap) or vector (lines and filled areas) graphic primitives. You have the freedom to tune the performance of a given display solution to use whatever hardware drawing support that is available.

The source code for Gpe.lib is located in %_WINCEROOT%\Public\Common\OAK\Drivers\Display\GPE.

Raster drawing functions are commonly referred to as blits. GPE relies on the emulation library for basic raster drawing support. The source files for Emul.lib are located in the Platform Builder directory tree in %_WINCEROOT%\Public\Common\OAK\Drivers\Display\Emul. To remove the emulation library, set SYSGEN_GPE_NOEMUL.

The GPE classes require that your display hardware use a linear-frame buffer; that is, the display's memory must lie in a contiguous memory range. Modifying the GPE classes to use a non-contiguous frame buffer would require significant effort.

The following list shows the GPE classes:

GPE Base Classes

See Also

Additional resources