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

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

إذا وضعت 4 صفحات بحجم 612 × 792 نقطة على ورقة واحدة، فأنت تحتاج إلى ورقة بحجم 1224 × 1584 في عمودين وصفين. وتحصل أيضًا على الموضع الدقيق لكل صفحة، سواء وضعت 2 أو 4 أو 6 أو 9 صفحات في الورقة. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

عرض الصفحة: 612
ارتفاع الصفحة: 792
N: 4

تحصل على

الأعمدة: 2
الصفوف: 2
عرض اللوح: 1,224
ارتفاع اللوح: 1,584

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

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

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

تفترض الأداة أن جميع الصفحات المصدر لها الأبعاد المدخلة. إذا جمع المستند بين صفحات عمودية وأفقية أو مقاسات مخصصة، فاحسبوا خطة مستقلة لكل مجموعة أو وحدوا الصفحات أولا. يجب أن يكون البعدان عددين محدودين أكبر من صفر؛ وترفض القيم المفقودة أو السالبة أو اللانهائية أو غير الرقمية أو الصفرية.

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

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

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

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

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

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

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

خذوا لكل ورقة إخراج صفحات المصدر التالية وعددها n، وطبقوا إدخالات المواضع نفسها بالتتابع. قد تحتوي الورقة الأخيرة على صفحات أقل؛ تجاهلوا المواضع غير المستخدمة ما لم يتطلب سير الطباعة صفحات حشو. وبفضل هندسة الورقة الكاملة والمستطيلات المفردة، يمكن للنتيجة توجيه إنشاء PDF أو المعاينة أو فحص الفرض أو إعداد بطاقة العمل من دون تكرار حسابات الشبكة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ما وحدة القياس التي أستخدمها؟

أي وحدة تريدها، بشرط أن يكون العرض والارتفاع بالوحدة نفسها: نقاط 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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

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

أدخلوا هذا المقاس في page_width وpage_height، واستخدموا الوحدة نفسها للقيمتين.

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

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

أسئلة تقنية

ما التكلفة؟

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

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

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

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

شغّل الأداة مجانًا

مثال محلول

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

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

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

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

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

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

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

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الحدود

الأخطاء

ملاحظات تقنية

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

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

أسئلة تقنية

شكرًا