function AddJpegImage(JpegImage: TStream; X, Y, Width, Height: Double): Boolean;
| JpegImage | TStream. Ein Stream mit rohen JPEG-komprimierten Daten. Die Stream-Position sollte beim Aufruf dieser Methode am Anfang der JPEG-Daten stehen |
True wenn die JPEG-Daten erfolgreich decodiert und auf der Seite eingebettet wurden. Gibt False if the stream does not contain valid JPEG data or if the embedding operation fails.AddJpegImage embeds a JPEG image supplied as a raw byte stream onto the current PDF page. Because the JPEG data is passed directly without re-encoding, image quality is preserved exactly as stored in the source stream. This makes the method well-suited for high-volume document generation where decoding and re-compressing images would introduce unnecessary quality loss or CPU overhead.
The JpegImage Stream muss eine vollständige, gültige JPEG-Datei enthalten, beginnend mit dem SOI-Marker. Die aktuelle Position des Streams sollte vor dem Aufruf dieser Methode am Anfang der JPEG-Daten stehen. Jeder TStream descendant is accepted — TFileStream, TMemoryStream, database blob streams, and so on.
The X and Y parameters specify the lower-left corner of the placement rectangle in PDF user units (origin at page lower-left, Y increases upward). Width and Height legt die gerenderte Größe auf der Seite fest; das JPEG wird unabhängig von seinen Pixelabmessungen passend skaliert
The method returns True on success. If the stream does not contain valid JPEG data, it returns False ohne eine Ausnahme auszulösen, sodass Aufrufer den Rückgabewert prüfen sollten, wenn sie mit Daten unsicheren Ursprungs arbeiten
var
Stream: TFileStream;
begin
Stream := TFileStream.Create('C:\Images\photo.jpg', fmOpenRead or fmShareDenyNone);
try
Pdf1.NewPage(595, 842);
if not Pdf1.AddJpegImage(Stream, 72, 400, 300, 225) then
ShowMessage('Failed to embed JPEG image.');
finally
Stream.Free;
end;
end;