THPDFFormImageResource Record

Describes one image XObject resource used by THotPDF.RegisterLuminositySoftMaskState

Declaration

THPDFFormImageResource= record
  Name: AnsiString;
  ImageIndex: Integer;
  UseImageSoftMask: boolean;
end;

THPDFFormImageResources= array of THPDFFormImageResource;

Fields

• Name is the safe 1 to 127 character resource name used by the Form content stream
• ImageIndex selects an image already registered with the document
• UseImageSoftMask binds the image's existing greyscale /SMask XObject instead of its colour image stream

Behaviour

Using UseImageSoftMask avoids decoding or duplicating alpha pixels when a source image already owns an indirect soft-mask stream

Invalid names, duplicate names, invalid image indices and images without a usable soft mask are rejected before the Form XObject is created

Related APIs

THotPDF.RegisterLuminositySoftMaskState · THotPDF.RegisterImageTilingPattern