3.1.1.2 Graphics Environment

The Graphics Environment describes the graphics state maintained during EMF metafile playback. A possible implementation is described by the following elements.

Element name

Type

Set by

PlaybackStateArray

PlaybackState[]

EMR_SAVEDC (section 2.3.11)

PlaybackState

UINT8[]

EMF records (section 2.3)

PlaybackStateArray: An array of saved PlaybackState elements, any of which can be used by the EMR_RESTOREDC record (section 2.3.11.6) to restore a previous graphics environment.

PlaybackState: The playback device context at some point in EMF record processing, including region definitions, color profiles, fonts and text properties, and graphics drawing metadata. The elements of the PlaybackState are grouped as shown in the following table.

Element group

Section

Description

Regions

3.1.1.2.1

The current clipping regions and related properties

Colors

3.1.1.2.2

The current color profile and related properties

Text

3.1.1.2.3

Properties related to fonts and rendering text

Drawing

3.1.1.2.4

The graphics properties that determine how drawing commands render the image

The sections that follow describe the elements in each group as well as the EMF records that set their values. Unreferenced intrinsic types are defined in [MS-DTYP].