function AddJpegImage(JpegImage: TStream; X, Y, Width, Height: Double): Boolean;
| JpegImage | TStream. Un flux contenant des données JPEG compressées brutes. La position du flux doit être au début des données JPEG lorsque cette méthode est appelée |
True si les données JPEG ont été décodées et intégrées avec succès sur la page. Renvoie False si le flux ne contient pas de données JPEG valides ou si l’opération d’intégration échoueAddJpegImage incorpore une image JPEG fournie sous forme de flux d’octets brut sur la page PDF courante. Comme les données JPEG sont passées directement sans ré-encodage, la qualité de l’image est préservée exactement telle qu’elle est stockée dans le flux source. Cela rend la méthode bien adaptée à la génération de documents en grand volume, où le décodage et la recompression des images introduiraient une perte de qualité ou une surcharge CPU inutiles
Le paramètre JpegImage doit contenir un fichier JPEG complet et valide à partir du marqueur SOI. La position actuelle du flux doit se trouver au début des données JPEG avant d’appeler cette méthode. N’importe quel descendant de TStream convient — TFileStream, TMemoryStream, flux blob de base de données, etc.
Les paramètres X et Y spécifient le coin inférieur gauche du rectangle de placement en unités utilisateur PDF (origine en bas à gauche de la page, Y croît vers le haut). Width et Height définissent la taille rendue sur la page ; le JPEG est mis à l’échelle pour s’adapter quelle que soit sa taille en pixels
La méthode renvoie True en cas de succès. Si le flux ne contient pas de données JPEG valides, elle renvoie False sans lever d’exception, de sorte que les appelants doivent vérifier la valeur de retour lorsqu’ils travaillent avec des données d’origine incertaine
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;