Метод THotPDF.RegisterLuminositySoftMaskState

Строит ограниченную Form XObject с transparency group DeviceGray и возвращает имя ресурса ExtGState, которое применяет Form как luminosity soft mask

Объявления

function RegisterLuminositySoftMaskState(BBoxLLx, BBoxLLy,
  BBoxURx, BBoxURy: Single; const Content: AnsiString): AnsiString; overload;

function RegisterLuminositySoftMaskState(BBoxLLx, BBoxLLy,
  BBoxURx, BBoxURy: Single; const Content: AnsiString;
  const PatternNames: array of AnsiString;
  const ImageResources: array of THPDFFormImageResource): AnsiString; overload;

Параметры

• BBoxLLx, BBoxLLy, BBoxURx и BBoxURy задают конечные положительные границы Form
• Content содержит не более 16 МиБ PDF-операторов рисования, предоставленных вызывающим кодом
• PatternNames поставляет не более 1024 ранее зарегистрированных имён pattern
• ImageResources поставляет не более 1024 существующих цветных изображений или общих grayscale soft mask изображений

Поведение

Сгенерированная Form объявляет /Group << /S /Transparency /CS /DeviceGray /I true >>, а сгенерированный dictionary маски использует /S /Luminosity с чёрным фоном /BC [0]

Alpha-источники должны быть нарисованы как grayscale-значения до регистрации, чтобы операция luminosity в PDF воспроизводила alpha, а не выводила непрозрачность из визуальной яркости RGB-цвета

Pattern и image XObject подключаются в resource dictionary Form без дублирования их закодированных stream

Метод требует transparency из PDF 1.4, отклоняет вывод PDF/A-1 и проверяет все границы, количество ресурсов, имена, индексы и связи soft mask до выделения Form

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

Возвращает стабильное имя ресурса ExtGState для THPDFPage.SetGraphicsState или пустую строку, если настроенная политика версии PDF отклоняет PDF 1.4

Связанные API

THPDFFormImageResource · THotPDF.RegisterSoftMaskState · THotPDF.RegisterImageTilingPattern