ملاءمة صورة مع الأشرطة
ضع الصورة داخل مساحة ثابتة دون قص أو تمديد: صورة بمقاس 1920 في 1080 داخل مربع 1000 في 1000 تصبح 1000 في 562، مع شريطين بارتفاع 219 بكسل في الأعلى والأسفل. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- عرض المصدر
- 1,920
- ارتفاع المصدر
- 1,080
- عرض اللوحة
- 1,000
- ارتفاع القماش
- 1,000
- المقياس
- 0.5208333333
- Fit
- letterbox
لائم صورة داخل لوحة ثابتة من دون تخمين أو تشويه أو اقتطاع للمحتوى. أدخل عرض الصورة الأصلية وارتفاعها مع أبعاد اللوحة المستهدفة لتحصل على معامل القياس الموحّد، والحجم النهائي بالبكسل، وعرض الأشرطة الدقيق في الأعلى واليمين والأسفل واليسار. تميّز النتيجة بين الأشرطة الأفقية والأشرطة العمودية والتطابق التام لنسبة الأبعاد، ولذلك تناسب إطارات الفيديو والعروض التقديمية ومسارات معالجة الصور والمعاينات المتجاوبة.
حافظ على الصورة كاملة وعلى نسبتها الأصلية
يضمن الاحتواء بقاء كل بكسل من الصورة الأصلية ظاهرًا داخل اللوحة المستهدفة. تقارن الحاسبة نسبة أبعاد المصدر بنسبة أبعاد اللوحة، ثم تختار معامل القياس الأصغر بين الاتجاهين الأفقي والعمودي وتطبّق المعامل نفسه على البعدين. لذلك تبقى الدوائر دائرية، ولا تنضغط الوجوه، ولا يُقص أي جزء من التكوين.
يكون العرض والارتفاع الناتجان عددين صحيحين من البكسلات ولا يتجاوزان حدود اللوحة. إذا وقع البعد النسبي الدقيق بين بكسلين، يملأ البعد المقيّد حافة اللوحة ويُقرّب البعد الآخر إلى الأسفل، لأن التقريب إلى الأعلى قد يضع صفًا أو عمودًا خارج المساحة المطلوبة. تتضمن الاستجابة أيضًا معامل القياس الرياضي قبل تقريب البكسلات، وهو مفيد لإعداد برامج الرسوم أو مقارنة مقاسات لوحات متعددة.
يجب أن تكون الأبعاد الأربعة أعدادًا صحيحة موجبة؛ فالبعد 0 لا يكوّن نسبة أبعاد صالحة، ولذلك يُرفض بوصفه إدخالًا غير صالح بدل إنتاج قيمة لا نهائية أو غير معرّفة.
افهم قياسات الأشرطة الأفقية والعمودية
يعرض كائن الأشرطة مقدار الفراغ بالبكسل في الأعلى واليمين والأسفل واليسار. تترك الصورة العريضة داخل لوحة طويلة نسبيًا فراغًا عموديًا، فتظهر أشرطة فوقها وتحتها. أما الصورة الطويلة أو الضيقة داخل لوحة عريضة نسبيًا فتترك فراغًا أفقيًا، فتظهر أشرطة على اليسار واليمين.
إذا تطابقت نسبة أبعاد المصدر واللوحة كان الملاءمة تامة وكانت قيم الأشرطة الأربعة 0. تظل الصورة في المنتصف دائمًا. عندما يكون عدد البكسلات الفارغة زوجيًا تتساوى الأشرطة المتقابلة.
وعندما يكون فرديًا يحصل الشريط العلوي أو الأيسر على الحصة الأصغر، ويحصل الشريط السفلي أو الأيمن على البكسل المتبقي. تضمن هذه القاعدة الحتمية أن تجمع الصورة والأشرطة أبعاد اللوحة بدقة، كما تمنع مواضع نصف البكسل الملتبسة. يمكن استخدام القيم مباشرة بوصفها حشوات أو إزاحات أو إحداثيات رسم؛ إذ تبدأ الصورة عند إزاحتي اليسار والأعلى وتنتهي قبل شريطي اليمين والأسفل.
طبّق النتيجة في مسارات الصور والوسائط
استخدم هذه الأرقام قبل تغيير الحجم لا بعد التصدير. أنشئ اللوحة المستهدفة أو اخترها، ثم غيّر حجم المصدر إلى العرض والارتفاع الناتجين بطريقة إعادة أخذ العينات المناسبة، وضعه عند إزاحتي اليسار والأعلى. املأ المساحة الباقية بلون ثابت أو شفافية أو امتداد ضبابي أو خلفية أخرى.
لا يفحص الحساب بايتات الصورة، ولا يختار لونًا، ولا ينفذ إعادة أخذ العينات؛ بل يقدم خطوة هندسية مستقلة عن تنسيق الملف ومكتبة التصيير. في المعالجة الدفعية، تحقّق من الأبعاد مبكرًا واحفظ نتيجة الملاءمة مع طلب التصيير كي تستخدم المراحل اللاحقة هندسة واحدة متفقًا عليها. تعطي المدخلات المتطابقة دائمًا الأبعاد ومواضع الأشرطة نفسها، مما يلائم الاختبارات وعمليات البناء القابلة للتكرار.
حالات الاستخدام
تجهيز إطارات الفيديو
لائم اللقطات أو الصور الثابتة مع دقة إخراج محددة واحصل على الأشرطة الدقيقة قبل الترميز.
إنشاء معاينات بلا قص
وسّط صور المنتجات أو الأعمال أو المستندات داخل بطاقات موحّدة من دون فقد أي محتوى.
تخطيط العروض التقديمية
احسب مستطيل الصورة والهوامش المتوازنة للشرائح واللافتات الرقمية وشاشات العرض.
الأسئلة الشائعة
هل تُقص الصورة أو تتشوّه؟
لا. يُطبّق معامل موحّد على البعدين، وتبقى الصورة كاملة، وتملأ الأشرطة المساحة غير المستخدمة.
لماذا قد يختلف شريطان متقابلان بمقدار بكسل واحد؟
لا يمكن تقسيم عدد فردي من البكسلات بالتساوي إلى أعداد صحيحة، لذا يُضاف البكسل إلى اليمين أو الأسفل.
ماذا يحدث إذا كانت نسب الأبعاد متطابقة أصلًا؟
تُصنّف الملاءمة بأنها تامة، وتملأ الصورة اللوحة، وتكون قيم الأشرطة الأربعة 0.
هل يمكن إدخال 0 لبعد غير معروف؟
لا. يجب أن تكون الأبعاد كلها أعدادًا صحيحة موجبة، لأن 0 لا يحدد نسبة أبعاد صالحة.
هل تغيّر هذه القدرة حجم ملف الصورة؟
لا. فهي تحسب الهندسة فقط. استخدم الحجم والإزاحات الناتجة مع أداة التصيير التي تختارها.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/image/letterbox-fit \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"source_width":1920,"source_height":1080,"canvas_width":1000,"canvas_height":1000}'const res = await fetch("https://api.kit.forhosting.com/image/letterbox-fit", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"source_width": 1920,
"source_height": 1080,
"canvas_width": 1000,
"canvas_height": 1000
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/image/letterbox-fit",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"source_width": 1920,
"source_height": 1080,
"canvas_width": 1000,
"canvas_height": 1000
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/letterbox-fit", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"source_width":1920,"source_height":1080,"canvas_width":1000,"canvas_height":1000}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"source_width":1920,"source_height":1080,"canvas_width":1000,"canvas_height":1000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/letterbox-fit", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"source_width": 1920,
"source_height": 1080,
"canvas_width": 1000,
"canvas_height": 1000
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "image.letterbox_fit",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_mb | 15 |
max_megapixels | 12 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
طبّق النتيجة في مسارات الصور والوسائط
لذلك تصلح النتيجة مع CSS وCanvas وSVG وFFmpeg وImageMagick وواجهات API المحمولة وبرامج العروض ومهام الصور المصغرة. تبلغ كلفة طلب API مقدار $0.002، ويمكن إجراء الحساب الحتمي نفسه في المتصفح.
أسئلة تقنية
ما كلفة الحساب؟
تبلغ كلفة كل طلب API مقدار $0.002. ويمكن إجراء الحساب مجانًا في المتصفح أيضًا.