Persits Software, Inc. Web Site
 Navigator:  Home |  Object Reference |  PdfGState
PdfImage PdfGraphics
  PdfState Object
PdfGState, introduced in Version 3.1, represents a graphics state object used primarily for transparency-related operations. Also represents a transparency group. This object is created via the PdfDocument.CreateGState method. For more information, see Chapter 17 - Transparency.

Properties Methods
Alpha
AlphaIsShape
FillAlpha
FillOverprint
IsGroup
Isolated
Knockout
Overprint
OverprintMode
TextKnockout
SetColorSpace
SetSoftMask

Properties


Alpha As Single (Read-only)

Returns the stroke alpha value for this graphics state. This property can only be used if this object represents a graphics state object (IsGroup = False).

For more information, see Section 17.1 - PdfGState Object: Overview.


AlphaIsShape As Boolean (Read-only)

Returns the alpha-is-shape flag for this graphics state. This property can only be used if this object represents a graphics state object (IsGroup = False).

For more information, see Section 17.5 - Miscellaneous Features.


BlendMode As Integer (Read-only)

Returns the blend mode value for this graphics state, a number between 1 and 16. This property can only be used if this object represents a graphics state object (IsGroup = False).

For more information, see Section 17.2 - Blend Mode.


FillAlpha As Single (Read-only)

Returns the fill alpha value for this graphics state. This property can only be used if this object represents a graphics state object (IsGroup = False).

For more information, see Section 17.1 - PdfGState Object: Overview.


FillOverprint As Boolean (Read-only)

Returns the fill overprint flag for this graphics state. This property can only be used if this object represents a graphics state object (IsGroup = False).

For more information, see Section 17.5 - Miscellaneous Features.


IsGroup As Boolean (Read-only)

Returns True if this object represents a transparency group, and False if it represents a graphics state object.

For more information, see Section 17.1 - PdfGState Object: Overview.


Isolated As Boolean (Read-only)

Returns the isolated flag for this transparency group. This property can only be used if this object represents a transparency group (IsGroup = True).

For more information, see Section 17.3 - Transparency Groups.


Knockout As Boolean (Read-only)

Returns the knockout flag for this transparency group. This property can only be used if this object represents a transparency group (IsGroup = True).

For more information, see Section 17.3 - Transparency Groups.


Overprint As Boolean (Read-only)

Returns the stroke overprint flag for this graphics state. This property can only be used if this object represents a graphics state object (IsGroup = False).

For more information, see Section 17.5 - Miscellaneous Features.


OverprintMode As Integer (Read-only)

Returns the overprint mode for this graphics state. This property can only be used if this object represents a graphics state object (IsGroup = False).

For more information, see Section 17.5 - Miscellaneous Features.


TextKnockout As Boolean (Read-only)

Returns the text knockout flag for this graphics state. This property can only be used if this object represents a graphics state object (IsGroup = False).

For more information, see Section 17.5 - Miscellaneous Features.


Methods

Sub SetColorSpace (ColorSpace As PdfColorSpace)
Specifies a color space for this transparency group. It is necessary call this method if this transparency group is used to represent a soft mask based on luminosity. This method can only be used if this object represents a transparency group (IsGroup = True).

For more information, see Section 17.4 - Soft Masks.


Sub SetSoftMask (Graphics As PdfGraphics, Param As Variant)
Specifies a graphics object whose alpha or luminosity is to be used as a soft mask for this graphics state. The Graphics object must have a transparency group associated with it via the PdfGraphics.SetGroup method. This method can only be used if this object represents a graphics state object (IsGroup = False).

Param is a PdfParam object or parameter string. The following parameters (all optional) are supported:

  • Alpha (Boolean) - if True, specifies that the alpha values of Graphics are to be used for the soft mask. If False or omitted, the luminocity values of Graphics are to be used. In the latter case, the transparency group associated with Graphics must have a color space linked to it via the SetColorSpace method.
  • C0, C1, ..., Cn - the color components in the range 0.0 to 1.0 specifying the color to be used as the backdrop against which to composite the transparency group. Only used if Alpha is False or omitted. The number of color components must match the color space linked to the transparency group associated with Graphics.

For more information, see Section 17.4 - Soft Masks.


PdfImage PdfGraphics
Search AspPDF.com

  This site is owned and maintained by Persits Software, Inc. Copyright © 2003. All Rights Reserved.