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

تغيير حجم لوحة الصورة بهوامش وتوسيطها دون اقتصاص

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

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

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

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

وسّعوا اللوحة مع الحفاظ على كل بكسل في المصدر

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

افهموا التوسيط عندما يكون عدد البكسلات المتبقية فرديًا

يكون التوسيط التام مباشرًا عندما يكون الفرق بين أبعاد اللوحة والصورة عددًا زوجيًا. فعلى سبيل المثال، تؤدي إضافة 400 بكسل أفقي إلى 200 بكسل على اليسار و200 على اليمين. أما الفرق الفردي فلا يمكن تقسيمه إلى نصفين من البكسلات الصحيحة. في هذه الحالة تضع الحاسبة الحصة الأصغر على اليسار أو في الأعلى، وتضع البكسل الإضافي على اليمين أو في الأسفل. لذلك يصبح الفرق الأفقي البالغ 401 مقدار 200 بكسل يسارًا و201 يمينًا. تضمن هذه القاعدة موضعًا حتميًا وتتجنب الإحداثيات الكسرية التي لا تستطيع أدوات الصور النقطية تمثيلها. تتطابق قيمة image_position مع الهامشين الأيسر والعلوي، ولهذا يمكن تمريرها مباشرة إلى كثير من API الخاصة بالرسم أو التركيب أو سطر الأوامر. ويعيد جمع الهامش وبُعد الصورة والهامش المقابل دائمًا بُعد اللوحة نفسه، مما يسهّل التحقق الآلي قبل بدء معالجة الصورة الفعلية.

تحققوا من الأبعاد المستهدفة قبل إنشاء مسار معالجة الصور

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

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

توحيد لوحات صور المنتجات

وسّطوا صورة منتج ذات أبعاد جاهزة على لوحة موحدة للكتالوج دون تكبير المنتج أو اقتصاصه.

إعداد رسومات المنصات بأمان

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

ضبط مسار معالجة الصور

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

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

هل تغيّر هذه الأداة مقياس الصورة أو تعيد أخذ عيناتها؟

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

ماذا يحدث إذا كانت اللوحة المستهدفة أصغر؟

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

أين يوضع البكسل الإضافي عندما يكون الهامش فرديًا؟

يُضاف البكسل الزائد إلى اليمين أو الأسفل، بينما يستخدم اليسار والأعلى النصف الصحيح الأصغر.

ما صيغ ألوان الخلفية المدعومة؟

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

كم تبلغ تكلفة طلب API؟

تبلغ تكلفة كل طلب API مقدار $0.002. يستخدم الحساب الأبعاد ونص اللون فقط، ولا يستخدم ملف الصورة نفسه.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/image/canvas-resize-pad

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

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

curl -X POST https://api.kit.forhosting.com/image/canvas-resize-pad \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_width":1200,"image_height":800,"canvas_width":1600,"canvas_height":1000,"background_color":"#ffffff"}'

const res = await fetch("https://api.kit.forhosting.com/image/canvas-resize-pad", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "image_width": 1200,
    "image_height": 800,
    "canvas_width": 1600,
    "canvas_height": 1000,
    "background_color": "#ffffff"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/canvas-resize-pad",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "image_width": 1200,
    "image_height": 800,
    "canvas_width": 1600,
    "canvas_height": 1000,
    "background_color": "#ffffff"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/canvas-resize-pad", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"image_width":1200,"image_height":800,"canvas_width":1600,"canvas_height":1000,"background_color":"#ffffff"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"image_width":1200,"image_height":800,"canvas_width":1600,"canvas_height":1000,"background_color":"#ffffff"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/canvas-resize-pad", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "image_width": 1200,
  "image_height": 800,
  "canvas_width": 1600,
  "canvas_height": 1000,
  "background_color": "#ffffff"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.canvas_resize_pad",
  "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 الكامل ←