function AddJpegImage(JpegImage: TStream; X, Y, Width, Height: Double): Boolean;
| JpegImage | TStream. تيار يحتوي بيانات JPEG مضغوطة خام. يجب أن يكون موضع التيار عند بداية بيانات JPEG عند استدعاء هذه الطريقة. |
True إذا فُكَّ ترميز بيانات JPEG وضُمِّنت بنجاح على الصفحة. يعيد False إذا لم يحتوِ التيار على بيانات JPEG صالحة أو إذا فشلت عملية التضمين.يضمِّن AddJpegImage صورة JPEG مُزوَّدة كتيار بايتات خام على صفحة PDF الحالية. ولأن بيانات JPEG تُمرَّر مباشرة دون إعادة ترميز، تُحفظ جودة الصورة تمامًا كما خُزِّنت في التيار المصدر. يجعل هذا الطريقة مناسبة تمامًا لتوليد المستندات بكميات كبيرة حيث كان فك الترميز وإعادة الضغط سيفرزان فقدان جودة غير ضروري أو عبء CPU.
يجب أن يحتوي تيار JpegImage على ملف JPEG كامل صالح يبدأ من علامة SOI. يجب أن يكون موضع التيار الحالي عند بداية بيانات JPEG قبل استدعاء هذه الطريقة. يُقبل أي سليل TStream — مثل TFileStream و TMemoryStream وتيارات blobs قواعد البيانات وما إلى ذلك.
يحدد المعاملان X و Y ركن أسفل يسار مستطيل الموضع بوحدات مستخدم PDF (الأصل عند أسفل يسار الصفحة، و Y يزداد لأعلى). يعيّن Width و Height الحجم المُصيَّر على الصفحة؛ وتُقيَّس الصورة لتلائم بغض النظر عن أبعادها البكسلية.
تعيد الطريقة True عند النجاح. إذا لم يحتوِ التيار على بيانات JPEG صالحة، تعيد False دون رفع استثناء، لذا يجب على المستدعي التحقق من قيمة الإرجاع عند العمل مع بيانات غير مؤكدة المصدر.
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;