DecodeModernImageToPNG

Bildverarbeitung

Beschreibung

Dekodiert einen Modern-Image-Stream in einen PNG-Bildstream

Ein registrierter Backend-Callback läuft zuerst; ohne einen rendert die native Codec-Bibliothek das Bild, wendet bei Bedarf die EXIF-Orientierung an und erhält das eingebettete ICC-Profil

Syntax

Delphi

Function DecodeModernImageToPNG(InStream, OutPNG: TStream;
  ImageFormat: TPDFlibModernImageFormat;
  ApplyOrientation: Boolean= True): Boolean;

Parameter

InStreamStream mit dem vollständigen Modern Image; die Position wird gesichert und wiederhergestellt
OutPNGStream, der die PNG-Bytes aufnimmt; mit Backend-Callback wird er bei Erfolg auf Position 0 zurückgesetzt und auf die Ausgabegröße gebracht
ImageFormatZu dekodierendes Format, von DetermineModernImageFormat; mifUnknown scheitert sofort
ApplyOrientationWendet die gespeicherte Orientierung an, damit das PNG aufrecht steht, standardmäßig an

Rückgabewerte

FalseKein Backend ist registriert und das Codec-Modul fehlt oder hat den Coder nicht, das Format ist unbekannt oder das Dekodieren ist fehlgeschlagen
TrueOutPNG hält ein vollständiges PNG-Bild

Anmerkungen

Die AddModernImageFromStream-Familie wickelt diesen Helfer ein und bettet das PNG in die Seite ein; der direkte Aufruf ist der Weg, Bilder ohne TPDFlib-Instanz vorzukonvertieren oder zu inspizieren

Siehe auch

DetermineModernImageFormat, RegisterModernImageDecoderBackend, AddModernImageFromStream, ModernImageCodecAvailable