function AddJpegImage(JpegImage: TStream; X, Y, Width, Height: Double): Boolean;
| JpegImage | TStream. Een stream met ruwe JPEG-gecomprimeerde gegevens. De streampositie moet aan het begin van de JPEG-gegevens staan wanneer deze methode wordt aangeroepen |
True terug als de JPEG-gegevens succesvol zijn gedecodeerd en op de pagina zijn ingesloten. Geeft False terug als de stream geen geldige JPEG-gegevens bevat of als het insluiten misluktAddJpegImage sluit een JPEG-afbeelding die als ruwe bytestroom wordt aangeleverd in op de huidige PDF-pagina. Omdat de JPEG-gegevens rechtstreeks worden doorgegeven zonder opnieuw te coderen, blijft de beeldkwaliteit exact behouden zoals die in de bronstrream is opgeslagen. Daardoor is de methode goed geschikt voor documentgeneratie op grote schaal, waarbij decoderen en opnieuw comprimeren onnodig kwaliteitsverlies of CPU-overhead zou opleveren
De JpegImage-stream moet een compleet, geldig JPEG-bestand bevatten dat begint bij de SOI-marker. De huidige streampositie moet aan het begin van de JPEG-gegevens staan voordat u deze methode aanroept. Elke afgeleide van TStream wordt geaccepteerd — TFileStream, TMemoryStream, database-blobstreams en dergelijke
De parameters X en Y geven de linkeronderhoek van de plaatsingsrechthoek op in PDF-gebruikerseenheden (oorsprong linksonder op de pagina, Y loopt omhoog). Width en Height bepalen de weergegeven grootte op de pagina; de JPEG wordt naar die maat geschaald ongeacht de pixelafmetingen
De methode geeft bij succes True terug. Als de stream geen geldige JPEG-gegevens bevat, geeft zij False terug zonder een exceptie op te gooien, dus aanroepers moeten de retourwaarde controleren wanneer ze werken met gegevens van onzekere herkomst
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;