function AddJpegImage(JpegImage: TStream; X, Y, Width, Height: Double): Boolean;
| JpegImage | TStream. Een stream met ruwe JPEG-gecomprimeerde gegevens. De streampositie moet bij het aanroepen van deze methode aan het begin van de JPEG-gegevens staan |
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 bytestream wordt aangeleverd in op de huidige PDF-pagina. Omdat de JPEG-gegevens rechtstreeks worden doorgegeven zonder opnieuw te coderen, blijft de beeldkwaliteit exact gelijk aan wat in de bronstream staat. Daarmee is de methode uitstekend geschikt voor het genereren van grote documentvolumes, waarbij decoderen en opnieuw comprimeren onnodig kwaliteitsverlies of CPU-overhead zou toevoegen
De JpegImage-stream moet een compleet, geldig JPEG-bestand bevatten, beginnend bij de SOI-marker. De huidige positie van de stream moet aan het begin van de JPEG-gegevens staan voordat u deze methode aanroept. Elke afgeleide van TStream wordt geaccepteerd — TFileStream, TMemoryStream, database-blobstreams enzovoort
De parameters X en Y geven de linkerbenedenhoek van de plaatsingsrechthoek aan, in PDF-gebruikerseenheden (oorsprong linksonder op de pagina, Y loopt omhoog). Width en Height stellen de weergegeven grootte op de pagina in; de JPEG wordt naar die afmetingen geschaald, ongeacht de pixerafmetingen
De methode geeft True terug bij succes. Bevat de stream geen geldige JPEG-gegevens, dan geeft hij False terug zonder een exceptie te genereren, dus controleer de retourwaarde wanneer u met gegevens van onzekere herkomst werkt
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;