ForHosting KIT · المستندات وملفات PDF

صفحات PDF بنظام N-up

تحول حاسبة تخطيط صفحات PDF بنظام N-up أبعاد الصفحة الأصلية وعدد الصفحات المدعوم في الورقة إلى خطة مواضع كاملة. وهي تعرض أبعاد الشبكة وعرض ورقة الإخراج وارتفاعها المطلوبين والموضع الدقيق لكل خلية صفحة. استخدموا الوحدة نفسها للعرض والارتفاع، وستبقى النتائج بهذه الوحدة. الحساب حتمي، ولا تعدل الأداة المستند أو ترفعه أو تصيره.

● Betaمجاني · داخل متصفحك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

ابدؤوا بأبعاد صفحة PDF الأصلية

يبدأ تخطيط N-up بمقاس الوسائط لصفحة PDF أصلية واحدة. أدخلوا هذا المقاس في page_width وpage_height، واستخدموا الوحدة نفسها للقيمتين. تعرض برامج PDF الأبعاد عادة بالنقاط، حيث تساوي اثنتان وسبعون نقطة بوصة واحدة، لكن الحاسبة لا تفرض وحدة بعينها. تصلح المليمترات أو البوصات أو أي وحدة قياس متسقة، لأن كل نتيجة تنتج من الضرب لا من تحويل الوحدات. تفترض الأداة أن جميع الصفحات المصدر لها الأبعاد المدخلة. إذا جمع المستند بين صفحات عمودية وأفقية أو مقاسات مخصصة، فاحسبوا خطة مستقلة لكل مجموعة أو وحدوا الصفحات أولا. يجب أن يكون البعدان عددين محدودين أكبر من صفر؛ وترفض القيم المفقودة أو السالبة أو اللانهائية أو غير الرقمية أو الصفرية. يمنع هذا التحقق الصارم إنشاء مواصفات ورقة تبدو معقولة اعتمادا على هندسة غير صالحة. تستقبل الإمكانية هندسة الصفحة لا وحدات بايت PDF، لذلك استخرجوا عرض صندوق الوسائط وارتفاعه قبل استدعائها ضمن سير عمل آلي.

اختاروا شبكة مدعومة لعدد الصفحات في الورقة

اضبطوا n على 2 أو 4 أو 6 أو 9. تقابل كل قيمة شبكة ثابتة: تستخدم صفحتان عمودين وصفا واحدا، وتستخدم أربع صفحات عمودين وصفين، وتستخدم ست صفحات ثلاثة أعمدة وصفين، وتستخدم تسع صفحات ثلاثة أعمدة وثلاثة صفوف. تمنع هذه المطابقة الصريحة الترتيبات الملتبسة وتحافظ على استقرار المهام المتكررة بين الأنظمة. يساوي عرض ورقة الإخراج عرض الصفحة الأصلية مضروبا في عدد الأعمدة، بينما يساوي ارتفاعها ارتفاع الصفحة الأصلية مضروبا في عدد الصفوف. يحافظ التخطيط على كل صفحة مصدر بحجمها الكامل، من دون تحجيم أو تدوير أو هوامش أو فواصل أو نزف أو علامات قص. يمكن تطبيق خيارات الإنتاج هذه لاحقا بأداة فرض طباعي أو تصيير PDF. ترفض القيم خارج المجموعة المدعومة بدلا من تقريبها أو إجبارها على شبكة ناقصة. ويكشف ذلك أخطاء الإعداد مبكرا، ولا سيما عندما تأتي n من تفضيل مستخدم أو قالب مهمة محفوظ أو خيار في سطر الأوامر.

استخدموا خطة المواضع لإنشاء كل ورقة

تصف مصفوفة placements الخلايا بترتيب الصفوف من خلال page_index وrow وcolumn التي تبدأ قيمها من صفر. توضع الصفحة المصدر الأولى في الخلية العلوية اليسرى، ثم تتحرك الصفحات التالية عبر الصف، ويبدأ صف جديد بعد العمود الأخير. يتضمن كل موضع الإحداثيين x وy، إضافة إلى عرض الخلية وارتفاعها من دون تغيير. تتبع الإحداثيات عرف نقطة الأصل العلوية اليسرى: تزداد x نحو اليمين وتزداد y نحو الأسفل. إذا كانت مكتبة PDF لديكم تستخدم نقطة أصل سفلية يسرى، فحولوا y أثناء التصيير بطرح y وارتفاع الخلية من sheet_height. خذوا لكل ورقة إخراج صفحات المصدر التالية وعددها n، وطبقوا إدخالات المواضع نفسها بالتتابع. قد تحتوي الورقة الأخيرة على صفحات أقل؛ تجاهلوا المواضع غير المستخدمة ما لم يتطلب سير الطباعة صفحات حشو. وبفضل هندسة الورقة الكاملة والمستطيلات المفردة، يمكن للنتيجة توجيه إنشاء PDF أو المعاينة أو فحص الفرض أو إعداد بطاقة العمل من دون تكرار حسابات الشبكة.

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

إعداد مهمة فرض طباعي

أنشئوا الورقة المستهدفة وضعوا كل صفحة بإحداثيات شبكة حتمية قبل كتابة ملف PDF الناتج.

تقدير أبعاد الورقة المطلوبة

احسبوا مساحة بالحجم الكامل لترتيب N-up مدعوم من دون فتح المستند المصدر أو تعديله.

التحقق من إعدادات سير الطباعة

ارفضوا أعداد الصفحات غير المدعومة مبكرا وقارنوا الشبكة المخططة بقيود الطابعة أو التشطيب.

الأسئلة الشائعة

ما التكلفة؟

يكلف كل طلب API مبلغ $0.002. ويمكن أيضا إجراء الحساب داخل المتصفح.

ما قيم N-up المدعومة؟

القيم المدعومة هي 2 و4 و6 و9. تعيد أي قيمة أخرى خطأ إدخال غير صالح.

ما وحدة القياس التي ينبغي استخدامها؟

استخدموا أي وحدة ما دام page_width وpage_height يستعملان الوحدة نفسها. تحتفظ كل الأبعاد والإحداثيات بها.

هل تغير الحاسبة حجم الصفحات أو تدورها؟

لا. تحافظ على العرض والارتفاع المدخلين وتحسب شبكة بالحجم الكامل بلا تدوير أو تحجيم أو هوامش أو فواصل.

هل ترفع الأداة ملف PDF أو تعيد كتابته؟

لا. تحسب الهندسة فقط من الأبعاد وn؛ ولا تقرأ وحدات بايت PDF أو تخزنها أو تصيرها أو تعدلها.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/pdf/n-up-layout

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/pdf/n-up-layout \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_width":612,"page_height":792,"n":4}'

const res = await fetch("https://api.kit.forhosting.com/pdf/n-up-layout", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "page_width": 612,
    "page_height": 792,
    "n": 4
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/n-up-layout",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "page_width": 612,
    "page_height": 792,
    "n": 4
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/n-up-layout", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"page_width":612,"page_height":792,"n":4}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"page_width":612,"page_height":792,"n":4}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/n-up-layout", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "page_width": 612,
  "page_height": 792,
  "n": 4
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.n_up_layout",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_mb`	25
`max_pages`	200

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←