ForHosting KIT · تحرير الصور وتحليلها

منشئ تخطيط ورقة الاتصال

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

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

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

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

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

جهّز أبعاد الصور وحد العرض

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

تعرّف على طريقة اختيار الشبكة

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

استخدم النتيجة في أداة العرض

تتضمن الاستجابة count وcolumns وrows وthumbnail_size وsheet_size وmax_sheet_width ووضع fit. أنشئ لوحة بأبعاد sheet_size.width وsheet_size.height، ثم ضع العنصر ذي الفهرس i في العمود الناتج من i modulo columns وفي الصف الموافق للجزء الصحيح من قسمة i على columns. تستخدم كل خلية عرض المصغرة وارتفاعها الواردين في النتيجة. غيّر حجم المصدر بعملية contain، ووسّطه داخل الخلية إذا رغبت، وحافظ على نسبة أبعاده الأصلية. قد لا يكتمل الصف الأخير؛ لذلك يمكن للعارض ترك الخلايا الأخيرة فارغة أو توسيط ذلك الصف، بينما تحافظ اللوحة المحسوبة عمداً على هندسة مستطيلة بسيطة. لا تشمل النتيجة الفواصل أو التسميات التوضيحية. لإضافة فاصل قدره 10 بكسل مثلاً، احجز العرض الإجمالي للفواصل قبل استدعاء الحاسبة، أو قلّل أبعاد كل خلية بالقدر نفسه. تلائم نقطة النهاية الاستخدام التفاعلي والمهام الدفعية القابلة للتكرار: يعطي الإدخال نفسه الإخراج نفسه، ولا تُجرى طلبات شبكية، ولا يُفحص محتوى الصور مطلقاً. تبلغ تكلفة استخدام API مقدار $0.002 لكل طلب، بينما يستطيع المتصفح تشغيل الحساب النقي نفسه محلياً.

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

تخطيط ورقة بروفات للصور

اختر شبكة متوازنة تلائم عرض تصدير ثابتاً قبل تحميل الصور الأصلية أو تغيير مقاسها.

إنشاء معاينة لمكتبة وسائط

حوّل بيانات أبعاد الصور المحفوظة إلى أعمدة وصفوف ومقاسات خلايا حتمية لاستخدامها في معرض.

إعداد صفحات ملخص لمجموعة بيانات

رتّب العينات الرأسية والأفقية والمربعة داخل إطارات contain موحدة من دون اقتصاص.

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

ما التكلفة؟

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

هل تُغيّر أحجام صوري أو تُدمج؟

لا. تُعاد أرقام التخطيط فقط، أما تغيير الحجم والتركيب الفعليان فتجريهما أداة العرض لديك.

هل ستُقتص الصور الرأسية أو الأفقية؟

لا حاجة إلى الاقتصاص. حجم المصغرة إطار معدّ لوضع contain يحافظ على نسبة الأبعاد.

هل تشمل النتيجة الفواصل والتسميات والهوامش؟

لا. احجز مساحة للفواصل والعناوين والحدود والهوامش وهوامش الطباعة النازفة قبل تحديد أقصى عرض.

لماذا تسبب قائمة الصور الخالية خطأ؟

لا تملك الشبكة الخالية من العناصر عدداً مفيداً للصفوف أو حجماً للمصغرات، ولذلك يُرفض الإدخال صراحةً.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/image/contact-sheet-layout

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

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

curl -X POST https://api.kit.forhosting.com/image/contact-sheet-layout \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"images":[{"width":1600,"height":900},{"width":1200,"height":1600},{"width":2048,"height":1365},{"width":800,"height":800},{"width":1920,"height":1080}],"max_sheet_width":1200}'

const res = await fetch("https://api.kit.forhosting.com/image/contact-sheet-layout", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "images": [
      {
        "width": 1600,
        "height": 900
      },
      {
        "width": 1200,
        "height": 1600
      },
      {
        "width": 2048,
        "height": 1365
      },
      {
        "width": 800,
        "height": 800
      },
      {
        "width": 1920,
        "height": 1080
      }
    ],
    "max_sheet_width": 1200
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/contact-sheet-layout",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "images": [
        {
            "width": 1600,
            "height": 900
        },
        {
            "width": 1200,
            "height": 1600
        },
        {
            "width": 2048,
            "height": 1365
        },
        {
            "width": 800,
            "height": 800
        },
        {
            "width": 1920,
            "height": 1080
        }
    ],
    "max_sheet_width": 1200
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/contact-sheet-layout", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"images":[{"width":1600,"height":900},{"width":1200,"height":1600},{"width":2048,"height":1365},{"width":800,"height":800},{"width":1920,"height":1080}],"max_sheet_width":1200}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"images":[{"width":1600,"height":900},{"width":1200,"height":1600},{"width":2048,"height":1365},{"width":800,"height":800},{"width":1920,"height":1080}],"max_sheet_width":1200}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/contact-sheet-layout", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "images": [
    {
      "width": 1600,
      "height": 900
    },
    {
      "width": 1200,
      "height": 1600
    },
    {
      "width": 2048,
      "height": 1365
    },
    {
      "width": 800,
      "height": 800
    },
    {
      "width": 1920,
      "height": 1080
    }
  ],
  "max_sheet_width": 1200
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`max_mb`	15
`max_megapixels`	12

الأخطاء

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

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