تخطَّ إلى المحتوى الرئيسي
PPDF123

أضف صورة إلى ملف PDF

إضافة صورة تضع صورة PNG أو JPEG أو SVG على ملف PDF عند الموضع x وy الذي تحدده، بالنقاط من الزاوية السفلية اليسرى. تختم الصفحة الأولى فقط ما لم تختر كل الصفحات.

اسحب الملفات وأفلتها هنا، أو انقر للاختيار

يقبل PDF · حتى 500.0 MB لكل ملف · حتى 20 ملفات في المرة الواحدة

يمكنك أيضًا لصق ملف باستخدام Ctrl/Cmd+V أو من قائمة الحافظة.

إضافة صورة تضع `imageFile` عند إحداثيات نقاط PDF `(x,y)` (الأصل أسفل اليسار). الملفات النقطية تصبح XObject بـ Flate. أما SVG فيُطبع عبر WeasyPrint ثم يُستورد كـ Form. `everyPage=true` يضع الصورة على كل الصفحات، وإلا فعلى الصفحة الأولى فقط.

اسم التنزيل `overlayed_{base}.pdf`. الملفات المحمية بكلمة مرور تُفتح لك في هذه الصفحة بمجرد إدخال كلمة المرور؛ ومستخدمو API يجرون «إزالة كلمة المرور» أولًا.

لا يوجد حقل تحجيم؛ الحجم هو العرض والارتفاع الأصليان للصورة في مصفوفة `cm`. العتامة ليست معاملًا.

لعلامة نصية استخدم إضافة ختم. ولاستخدام PDF آخر كطبقة استخدم تراكب PDF.

تُرسم الصورة فوق محتوى الصفحة الموجود، في آخر موضع من ترتيب رسم الصفحة. هي لا تستبدل ما تحتها ولا تُخفيه على مستوى البنية: النص والرسومات تحتها ما زالت في الملف، ومغطاة فقط حيث تكون الصورة معتمة. لذلك تصلح لشعار في زاوية فارغة ولا تصلح لتغطية محتوى سري، فهذا يحتاج أداة تسويد حقيقية.

التموضع بنقطة ارتكاز واحدة. يحدد `x` و`y` الزاوية السفلية اليسرى للصورة بالنقاط من الزاوية السفلية اليسرى للصفحة، وتمتد الصورة يمينًا وأعلى من هناك. أنت لا تختار الحجم: تُوضع الصورة النقطية بنقطة PDF واحدة لكل بكسل، فصورة PNG بحجم 300 في 100 بكسل تشغل 300 في 100 نقطة، أي نحو 4.2 في 1.4 بوصة. صفحة letter حجمها 612 في 792 نقطة، فأي شيء أعرض من ذلك بكثير سيخرج من الصفحة. غيّر حجم الصورة إلى الحجم المطلوب قبل رفعها.

الصور النقطية (PNG وJPEG) تُفكّ ترميزها وتُحفظ من جديد بصيغة RGB بعمق 8 بت. لا تُحفظ الشفافية، فقد تظهر صورة PNG ذات الخلفية الشفافة ككتلة صلبة مكان المنطقة الشفافة. إن أردت شعارًا يمتزج مع الصفحة فصدّره أولًا بخلفية بيضاء أو بخلفية مطابقة، أو ضعه فقط على منطقة بيضاء.

`everyPage=false` يضع الصورة على الصفحة 1 فقط؛ و`everyPage=true` يكررها بالإحداثيات نفسها على كل صفحة. الصفحات ذات الأحجام المختلفة تأخذ نقطة الارتكاز نفسها، لذا في ملف متنوع الأحجام قد تقع العلامة في مواضع بصرية مختلفة. لا توجد طريقة لاختيار الصفحتين 2 و5 فقط؛ قسّم الملف وضع الصورة على الجزء الذي تريده ثم أعد دمجه إن احتجت ذلك.

إذا فشل الرفع فالسبب المعتاد ملف ليس صورة يفهمها المفكّك، فتصل رسالة نوع ملف غير مدعوم، أو غياب `imageFile`. أعد تصدير الصورة بصيغة PNG أو JPEG وحاول مجددًا.

الميزات

  • XObject نقطي أو Form من SVG عبر WeasyPrint
  • `x` و`y` بالنقاط؛ الصفحة الأولى أو كل الصفحات
  • بلا تحكم في العتامة ولا في التحجيم
  • نقطة API مجهولة: /api/v1/misc/add-image

حالات الاستخدام

  • وضع شعار PNG على الصفحة 1
  • تكرار علامة على كل صفحة عند نقطة ثابتة
  • إسقاط SVG عبر WeasyPrint حين تقبل دقة الطباعة
  • إضافة صورة توقيع ممسوحة إلى سطر التوقيع في اتفاقية من صفحة واحدة
  • وضع ختم شركة في تذييل كل صفحة من تقرير موحّد أحجام الصفحات

كيف أضيف صورة إلى PDF؟

  1. ارفع ملف PDF وصورة (PNG أو JPEG أو SVG).
  2. اضبط x وy من الزاوية السفلية اليسرى، بالنقاط.
  3. اختر الصفحة الأولى فقط أو كل الصفحات.
  4. نزّل overlayed_*.pdf وتحقق من موضع الصورة.

الحدود والحالات الحدّية

  • لا حقول تحجيم ولا عتامة
  • نقطة ارتكاز واحدة فقط: لا اختيار لصفحات بعينها سوى الصفحة الأولى أو كل الصفحات
  • لا يزيل المحتوى الذي تحت الصورة ولا يخفيه
  • الصور النقطية الضخمة تصبح عناصر ضخمة في PDF
  • مناطق PNG الشفافة لا تُحفظ: تُحوَّل الصور إلى RGB، فتأخذ البكسلات الشفافة اللون المخزَّن تحتها، وغالبًا ما يكون أسود
  • الملفات المحمية بكلمة مرور تحتاج إلى كلمة المرور؛ ومستخدمو API يجرون «إزالة كلمة المرور» أولًا
  • حد الرفع في هذا الموقع: 500 ميغابايت لكل ملف، ويُرسل على أجزاء عندما يتجاوز نحو 95 ميغابايت. أما جسم طلب API المباشر الواحد فحده الأقصى 100 ميغابايت.

أمثلة

  • x=0 y=0 يضع الزاوية السفلية اليسرى للصورة عند الزاوية السفلية اليسرى للصفحة
  • everyPage=false يترك الصفحات 2 فما بعدها دون تغيير
  • شعار PNG بحجم 200 في 80 بكسل مع x=400 وy=20 وeveryPage=true يقع في الزاوية السفلية اليمنى من كل صفحة بحجم letter، بعرض 200 نقطة، ويُسمّى التنزيل overlayed_report.pdf للملف المُدخل report.pdf
  • صورة بعرض 1800 بكسل موضوعة عند x=0 وy=0 تتجاوز كثيرًا صفحة عرضها 612 نقطة، وهذا يبيّن أن حجم الوضع يتبع البكسلات؛ صغّر الصورة أولًا إلى نحو 150 بكسل عرضًا

خصوصية هذه الأداة

تُرفع الملفات عبر HTTPS، وتُعالَج في الذاكرة أو في مجلد مؤقت قصير العمر على خوادمنا، ثم تُحذف عندما يصبح الناتج جاهزًا. لا نحتفظ بنسخ للتصفح لاحقًا أو لتدريب النماذج أو لملفات الإعلانات. راجع سياسة الخصوصية لمدد الاحتفاظ وإفصاحات ملفات تعريف الارتباط الخاصة بـ AdSense.

أسئلة شائعة

لماذا الشعار ضخم؟
تستخدم مصفوفة cm عرض الصورة وارتفاعها بالبكسل كوحدات PDF. صورة PNG بعرض 2000 بكسل تصبح بعرض 2000 نقطة.
هل y محسوبة من الأعلى؟
لا. فضاء PDF أصله أسفل اليسار في الصفحات المعتادة.
هل يمكنني ضبط العتامة؟
لا. التراكب عبارة عن عوامل رسم معتمة.
هل يحتفظ SVG بالمتجهات؟
يُطبع SVG عبر WeasyPrint إلى PDF من صفحة واحدة ثم يوضع كـ form. توقع طباعة لا SVG قابلًا للتحرير.
كيف أجعل الصورة أصغر؟
غيّر حجمها قبل الرفع. لا يوجد حقل تحجيم، والحجم الموضوع يتبع أبعاد الصورة بالبكسل، فشعار بحجم 150 في 50 بكسل يشغل 150 في 50 نقطة.
لماذا تظهر صورة PNG الشفافة في مربع أسود أو صلب؟
تُحوَّل الصور إلى RGB وتُسقَط قناة ألفا. أعد تصدير الشعار على خلفية بيضاء، أو ضعه في جزء أبيض من الصفحة.
هل يمكنني وضع الصورة على الصفحة 3 فقط؟
ليس مباشرة. الخيار هو الصفحة 1 أو كل الصفحات. افصل الصفحة التي تريدها، وأضف الصورة هناك، ثم ادمج الملفات بالترتيب.
هل أستخدمها لإخفاء نص في الصفحة؟
ليس بأمان. يبقى النص في الملف تحت الصورة ويمكن تحديده أو استخراجه. استخدم تسويد النص عندما يجب إزالة المحتوى.
الصورة خارج الصفحة. كيف أجد الإحداثيات الصحيحة؟
قِس من الزاوية السفلية اليسرى بالنقاط. في صفحة letter يكون الحجم 612 في 792، فيضع x=450 وy=40 الزاوية السفلية اليسرى لشعار قرب أسفل اليمين، بشرط أن يتسع الشعار في الـ 162 نقطة المتبقية من العرض.

آخر تحديث:

الاستدعاء من الشيفرة

كل أداة هنا نقطة نهاية REST عادية. الاستخدام المجهول بلا حساب ولا مفتاح API. للمتصفح والمطوّرين والوكلاء على حد سواء.

curl -X POST "https://pdf123.xyz/api/v1/misc/add-image" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "x=0" \
  -F "y=0" \
  -F "everyPage=false" \
  -o output.pdf

متاحة أيضًا كأداة MCP لأي عميل وكيل يدعم Model Context Protocol (JSON-RPC 2.0 عبر POST /mcp). مرجع API الكامل

استخدمها من وكيل ذكاء اصطناعي

مهارة

بهذه المهارة يستطيع Claude Code وCodex وCursor وغيرها من وكلاء الذكاء الاصطناعي تشغيل «إضافة صورة» نيابةً عنك: /skills/pdf123-add-image.md

كل مهارات الوكلاء

الملفات لهذه المعالجة فقط، وتُحذف تلقائيًا بعدها.