Graphics Attributes

Every graphics presentation space has a set of graphics attributes. A normal presentation space has a larger set of graphics attributes than a micro or cached micro presentation space. (Segment-related attributes, for example, do not apply in micro presentation spaces.) These attributes all have default values, which means that they always have an effect on graphics, even if you have not explicitly specified their values. The attributes can be broken into two general groups. The first group comprises those attributes that form a part of the picture and that can vary as the picture is drawn. These are:

All primitive attributes
The segment attributes
The primitive tag
The current position
The viewing window
The clipping path
The model and segment transformations
The viewing transformation.

With the exception of the segment attributes and the viewing transformation, these attributes are reset to their default values at the start of a root segment, unless the fast-chaining attribute is set. If the fast-chaining attribute is set, their values cannot be guaranteed. You should, therefore, explicitly set any attribute values required in the segment. Similarly, the values of these attributes cannot be guaranteed following a call to:

Any GpiDraw... function Any GpiCorrelate... function
GpiCallSegmentMatrix
GpiCloseSegment

Therefore, if any of these functions is followed by primitives outside a segment, you should explicitly set required attribute values. When GpiCloseSegment is followed by GpiOpenSegment (and also between any two segments in the chain), the fast-chaining attribute determines what happens to the current values of these attributes. The viewing transformation and the segment attributes are unaffected by fast-chaining.

These attributes take effect when graphics are sent to an output device, not when graphics are defined. For this reason, the calls to GpiQuery... that retrieve the current values of these attributes are invalid in retain mode. The majority of the group-one attribute-setting functions cause graphics orders to be added to the current segment.

The second group of attributes defines the environment in which the picture is drawn. These attributes do not normally vary as the picture is drawn, but have an overall effect on the result of any drawing or correlation operation. This group includes:

The default viewing transformation

The page viewport

The graphics field

The clipping region

The pick-aperture size

The drawing controls.

The functions to GpiQuery... that retrieve the current values of these attribute are valid in all drawing modes. None of the group-two attribute-setting functions causes graphics orders to be added to the current segment.

The following table lists the graphics attributes, identifies the GPI function or functions that you use to change current settings, and lists the default value of each one. Note that these default values are the initial settings. The table also indicates whether the attribute is a group-one or a group-two attribute.

кФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФТФФФФФПГGraphics      ГGPI Function                  ГDefault Value                ГGroupГGroupГ
ГAttribute     Г                              Г                             ГOne  ГTwo  Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГArc parametersГGpiSetArcParams               Г(1,1,0,0)                    ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГForeground    ГGpiSetColor(1)                ГCLR_DEFAULT                  ГYes  Г     Г
Гcolor         Г                              Г(device-dependent)           Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГForeground mixГGpiSetMix(1)                  ГFM_DEFAULT (overpaint)       ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГBackground    ГGpiSetBackColor(1)            ГCLR_DEFAULT                  ГYes  Г     Г
Гcolor         Г                              Г(device-dependent)           Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГBackground mixГGpiSetBackMix(1)              ГBM_DEFAULT (leave-alone)     ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГCharacter     ГGpiSetCharAngle(1)            Г(1,0)                        ГYes  Г     Г
Гangle         Г                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГCharacter box ГGpiSetCharBox(1)              ГDevice-dependent             ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГCharacter     ГGpiSetCharDirection(1)        ГCHDIRN_DEFAULT (left to      ГYes  Г     Г
ГDirection     Г                              Гright)                       Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГCharacter modeГGpiSetCharMode(1)             ГCM_DEFAULT (mode 1)          ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГCharacter set ГGpiSetCharSet(1)              ГLCID_DEFAULT (system font)   ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГCharacter     ГGpiSetCharShear(1)            Г(0,1)                        ГYes  Г     Г
Гshear         Г                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГLine end      ГGpiSetLineEnd(1)              ГLINEEND_DEFAULT (flat)       ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГLine join     ГGpiSetLineJoin(1)             ГLINEJOIN_DEFAULT (beveled)   ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГLine type     ГGpiSetLineType(1)             ГLINETYPE_DEFAULT (solid)     ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГLine width    ГGpiSetLineWidth(1)            ГLINEWIDTH_DEFAULT (1.0)      ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГGeometric lineГGpiSetLineWidthGeom(1)        Г1                            ГYes  Г     Г
Гwidth         Г                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГMarker        ГGpiSetMarker(1)               ГMARKSYM_DEFAULT (cross)      ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГMarker box    ГGpiSetMarkerBox(1)            ГDevice-dependent             ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГMarker set    ГGpiSetMarkerSet(1)            ГLCID_DEFAULT (system marker  ГYes  Г     Г
Г              Г                              Гset)                         Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГPattern       ГGpiSetPattern(1)              ГPATSYM_DEFAULT (solid)       ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГPattern       ГGpiSetPatternRefPoint(1)      Г(0,0)                        ГYes  Г     Г
Гreference     Г                              Г                             Г     Г     Г
Гpoint         Г                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГPattern set   ГGpiSetPatternSet(1)           ГLCID_DEFAULT (system pattern ГYes  Г     Г
Г              Г                              Гset)                         Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГModel         ГGpiSetModelTransformMatrix    ГIdentity                     ГYes  Г     Г
ГtransformationГ                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГInstance      ГGpiCallSegmentMatrix          ГIdentity                     ГYes  Г     Г
ГtransformationГ                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГSegment       ГGpiSetSegmentTransformMatrix  ГIdentity                     ГYes  Г     Г
ГtransformationГ                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГViewing       ГGpiSetViewingTransformMatrix  ГIdentity                     ГYes  Г     Г
ГtransformationГ                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГDefault       ГGpiSetDefaultViewMatrix       ГIdentity                     Г     ГYes  Г
Гviewing       Г                              Г                             Г     Г     Г
ГtransformationГ                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГPage viewport ГGpiSetPageViewport            ГDevice-dependent             Г     ГYes  Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГClipping path ГGpiSetClipPath                ГNo clipping                  ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГViewing windowГGpiSetViewingLimits           ГNo clipping                  ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГGraphics fieldГGpiSetGraphicsField           ГNo clipping                  Г     ГYes  Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГClipping      ГGpiSetClipRegion              ГNo clipping                  Г     ГYes  Г
Гregion        Г                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГTag           ГGpiSetTag                     Г0                            ГYes  Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГSegment       ГGpiSetInitialSegmentAttrs     ГATTR_DETECTABLE      - OFF   ГYes  Г     Г
Гattributes    ГGpiSetSegmentAttrs            ГATTR_VISIBLE         - ON    Г     Г     Г
Г              Г                              ГATTR_CHAINED         - ON    Г     Г     Г
Г              Г                              ГATTR_DYNAMIC         - OFF   Г     Г     Г
Г              Г                              ГATTR_FASTCHAIN       - ON    Г     Г     Г
Г              Г                              ГATTR_PROP_DETECTABLE - ON    Г     Г     Г
Г              Г                              ГATTR_PROP_VISIBLE    - ON    Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГPick-aperture ГGpiSetPickAperturePosition    ГDevice-dependent             Г     ГYes  Г
Гsize          Г                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГCurrent       ГGpiSetCurrentPosition GpiMove§Г(0,0)                        ГYes  Г     Г
Гposition      Г                              Г                             Г     Г     Г
УФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФХФФФФФД
ГDrawing       ГGpiSetDrawControl             ГDCTL_ERASE     - OFF         Г     ГYes  Г
Гcontrols      Г                              ГDCTL_DISPLAY   - ON          Г     Г     Г
Г              Г                              ГDCTL_BOUNDARY  - OFF         Г     Г     Г
Г              Г                              ГDCTL_DYNAMIC   - OFF         Г     Г     Г
Г              Г                              ГDCTL_CORRELATE - OFF         Г     Г     Г
РФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФСФФФФФй

Notes: (1). Can also be set using GpiSetAttrs.
(2). Is also updated indirectly by most primitive-drawing functions.

Each of the following functions causes all group-one and group-two graphics attributes to be set to their default values:

GpiCreatePS
GpiSetPS
GpiResetPS, if GRES_ALL or GRES_SEGMENTS is specified
WinGetPS
WinGetScreenPS
WinBeginPaint, with a NULL presentation space handle.

In specific circumstances, some of the GPI functions modify the group-one attributes and thus make their values unpredictable. Therefore, when you call any of these functions, you should respecify attribute values that have a particular importance to your application. For example, if the current foreground color is CLR_RED before you call GpiDrawChain you cannot always rely on the current color remaining CLR_RED when GpiDrawChain completes. If you want to continue working in red, respecify the color when GpiDrawChain completes. In general, the functions that affect group-one-attribute values are those related to the drawing and correlation of retained graphics, and to the creation, closing, and deletion of graphics segments.

With the exception of the viewing transformation and the segment attributes, the default values of these attributes apply to all primitive-drawing that occurs outside a segment bracket.

The following function sets the group-one attributes to their default values, and in addition sets the current clipping region and page viewport to their default values.
- GpiAssociate.