NewSoftMaskGraphicsState

Векторная графика, прозрачность, Form XObjects

Описание

Creates or reuses an ExtGState that applies a captured Form XObject as an alpha or luminosity soft mask, or creates a reset state that writes /SMask /None

Синтаксис

Delphi

Function TPDFlib.NewSoftMaskGraphicsState(CaptureID, MaskType: Integer; Const Backdrop, TransferFunction: WideString): Integer;

Параметры

CaptureIDCaptured Form XObject ID, or 0 when MaskType is PDF_SOFT_MASK_NONE
MaskTypePDF_SOFT_MASK_ALPHA, PDF_SOFT_MASK_LUMINOSITY или PDF_SOFT_MASK_NONE
BackdropПустая строка либо PDF-числовой массив ровно из трёх составляющих подложки от 0 до 1 для изолированной группы прозрачности DeviceRGB
TransferFunctionПустая строка, /Identity или словарь функции PDF, поток или косвенная ссылка с числовым FunctionType

Возвращаемые значения

Возвращает переиспользуемый ID состояния графики, иначе 0

Примечания

Захваченная форма настраивается как изолированная группа прозрачности DeviceRGB, а идентичные конфигурации переиспользуют один ExtGState

Примените возвращенный ID через SetGraphicsState перед рисованием замаскированного содержимого, затем примените состояние PDF_SOFT_MASK_NONE, чтобы завершить область действия маски

CaptureID 0 and empty backdrop and transfer-function strings The document version is raised to PDF 1.4, while PDF/A-1 and PDF/X-1 modes reject this operation

Версия документа поднимается до PDF 1.4, при этом режимы PDF/A-1 и PDF/X-1 отклоняют эту операцию

См. также

SetGraphicsState, BeginFormXObject, SetCapturedPageTransparencyGroup, SetImageSoftMaskEx