DynaPDF Manual - Page 264
Previous Page 263 Index Next Page 265
Function Reference
Page 264 of 839
typedef enum
{
bmNotSet
= 0,
bmNormal
= 1,
bmColor
= 2,
bmColorBurn
= 3,
bmColorDodge = 4,
bmDarken
= 5,
bmDifference = 6,
bmExclusion
= 7,
bmHardLight
= 8,
bmHue
= 9,
bmLighten
= 10,
bmLuminosity = 11,
bmMultiply
= 12,
bmOverlay
= 13,
bmSaturation = 14,
bmScreen
= 15,
bmSoftLight
= 16
}TBlendMode;
typedef enum
{
riAbsoluteColorimetric = 0,
riPerceptual
= 1,
riRelativeColorimetric = 2,
riSaturation
= 3,
riNone
= 4 // Internal
}TRenderingIntent;
The function creates an extended graphics state object from the structure GS. An extended graphics
state can be used to adjust certain properties which are not part of the normal graphics state. Such
properties can only be modified with a special PDF object called the Extended Graphics State.
The most important properties of an extended graphics state are the transparency settings (PDF 1.4)
and the overprint control (PDF 1.2 or 1.3, see below).
The structure GS must always be initialized with InitGState(). After the structure was initialized
certain members of the structure can be changed. Pass the variable then to CreateExtGState(). The
function creates an internal graphics state object and returns the handle of it. The extended graphics
state can now be applied with SetExtGState().
Note that there is only way to restore the values of an extended graphics state, you must set a
second extended graphics state that restores the values changed before.
The following values are allowed:
• AlphaIsShape
-> 0 or 1 (PDF 1.4, default unknown, does nothing)
• AutoStrokeAdjust -> 0 or 1 (PDF 1.4, default 0)
• BlendMode
-> see enum TBlendMode (PDF 1.4, default bmNormal)
• FlatnessTol
-> 0.0..1.0, default none
• FillAlpha
-> 0.0..1.0 (PDF 1.4, default 1.0)
• OverPrintFill
-> 0 or 1 (PDF 1.2 if used alone, PDF 1.3
otherwise,
default 0)
• OverPrintStroke
-> 0 or 1 (PDF 1.3, default 0)
• OverPrintMode
-> 0 or 1 (PDF 1.3, default 0)
Previous topic: CreateExtGState
Next topic: CreateGeospatialMeasure