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

إضافة إطار إلى الصورة

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

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

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

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

احسبوا حجم اللوحة قبل التصدير

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

افهموا معادلة حساب الإطار

المعادلة بسيطة ويمكن توقع نتيجتها: يساوي العرض الخارجي العرض الأصلي مضافًا إليه ضعفا سماكة الإطار، ويساوي الارتفاع الخارجي الارتفاع الأصلي مضافًا إليه ضعفا السماكة نفسها. يراعي الضرب في 2 الجانبين المتقابلين على كل محور. على سبيل المثال، تصبح صورة بعرض 1200 بكسل وارتفاع 800 بكسل، عند إضافة إطار بسماكة 24 بكسل، ذات أبعاد 1248 في 848 بكسل. لا يؤثر اللون في الأبعاد، لكنه يعود ضمن النتيجة لكي تحتفظ الشفرة اللاحقة بالإعداد المرئي مع القياسات. يجب أن يكون العرض والارتفاع الأصليان عددين صحيحين موجبين لأن أبعاد البكسل تصف لوحة نقطية فعلية. يمكن أن تكون سماكة الإطار 0 أو عددًا محدودًا موجبًا، ما يدعم قياسات التخطيط الكسرية والبكسلات الصحيحة المعتادة. تُرفض القيم السالبة لأنها تصف اقتصاصًا أو هندسة داخلية، لا إضافة إطار خارجي. استخدموا حسابًا مستقلًا للاقتصاص عندما يكون الهدف إزالة بكسلات من حواف الصورة.

استخدموا النتيجة في التصميم والأتمتة

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

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

إعداد لوحة ذات إطار

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

التحقق من صور المتاجر

تحققوا من بقاء صورة المنتج ضمن حد الرفع أو التخطيط بعد إضافة إطار موحد إليها.

تخطيط معالجة الصور على دفعات

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

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

كيف تُحسب الأبعاد الجديدة؟

تُضاف سماكة الإطار مضروبة في 2 إلى كل من العرض والارتفاع، لأن الإطار يظهر على جانبين من كل محور.

هل تعدّل هذه الأداة الصورة أو ترفعها؟

لا. تستقبل الأبعاد وإعدادات الإطار فقط، ثم تعيد القياسات المحسوبة من دون قراءة ملف صورة أو تغييره.

هل يمكن أن تكون سماكة الإطار 0؟

نعم. تُعد السماكة 0 قيمة صالحة، وتنتج عنها أبعاد خارجية مساوية للأبعاد الأصلية.

ماذا يحدث إذا كانت سماكة الإطار سالبة؟

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

ما صيغ الألوان التي يمكن إدخالها؟

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

ما تكلفة الحساب عبر API؟

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/image/add-border

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

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

curl -X POST https://api.kit.forhosting.com/image/add-border \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1200,"height":800,"border_width":24,"color":"#1d4ed8"}'

const res = await fetch("https://api.kit.forhosting.com/image/add-border", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "width": 1200,
    "height": 800,
    "border_width": 24,
    "color": "#1d4ed8"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/add-border",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "width": 1200,
    "height": 800,
    "border_width": 24,
    "color": "#1d4ed8"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/add-border", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"width":1200,"height":800,"border_width":24,"color":"#1d4ed8"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"width":1200,"height":800,"border_width":24,"color":"#1d4ed8"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/add-border", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "width": 1200,
  "height": 800,
  "border_width": 24,
  "color": "#1d4ed8"
}

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

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