THotPDF.RegisterLuminositySoftMaskState-Methode

Baut ein begrenztes DeviceGray-Transparency-Group-Form XObject und liefert den ExtGState-Ressourcennamen, der das Form als Luminosity-Soft-Mask anwendet

Deklarationen

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;

Parameter

• BBoxLLx, BBoxLLy, BBoxURx und BBoxURy definieren endliche positive Form-Grenzen
• Content enthält höchstens 16 MiB vom Aufrufer bereitgestellte PDF-Zeichenoperatoren
• PatternNames liefert höchstens 1024 zuvor registrierte Pattern-Namen
• ImageResources liefert höchstens 1024 vorhandene Farbbilder oder gemeinsame Graustufen-Bild-Soft-Masks

Verhalten

Das erzeugte Form deklariert /Group << /S /Transparency /CS /DeviceGray /I true >>, und das erzeugte Mask-Dictionary verwendet /S /Luminosity mit schwarzem /BC [0]-Hintergrund

Alpha-Quellen müssen vor der Registrierung als Graustufenwerte gezeichnet werden, damit die PDF-Luminosity-Operation Alpha reproduziert, statt die Opazität aus der visuellen Helligkeit einer RGB-Farbe abzuleiten

Patterns und Image-XObjects werden in das Form-Ressourcendictionary verlinkt, ohne ihre kodierten Streams zu duplizieren

Die Methode erfordert PDF-1.4-Transparenz, weist PDF/A-1-Ausgabe zurück und validiert alle Grenzen, Ressourcenzähler, Namen, Indizes und Soft-Mask-Verweise, bevor das Form allokiert wird

Rückgabewert

Liefert einen stabilen ExtGState-Ressourcennamen für THPDFPage.SetGraphicsState oder einen leeren String, wenn die konfigurierte PDF-Versions-Policy PDF 1.4 ablehnt

Verwandte APIs

THPDFFormImageResource · THotPDF.RegisterSoftMaskState · THotPDF.RegisterImageTilingPattern