ForHosting KIT · الفيديو

حساب حجم أشرطة letterbox بالبكسل للفيديو

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

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

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

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

ابدؤوا بنسبتي المصدر ولوحة العرض

تصف نسبة الأبعاد علاقة العرض بالارتفاع، ولذلك تمثل 16:9 و1.777777 الشكل نفسه. أدخلوا نسبة الصورة التي تريدون الحفاظ عليها ونسبة لوحة العرض النهائية. يحدد ارتفاع اللوحة المقياس الفعلي بالبكسل، بينما يُشتق عرضها من النسبة المستهدفة. تقبل الحاسبة الصيغ W:H أو W/H أو عددًا عشريًا موجبًا، لذا تصلح للتنسيقات الشائعة مثل 4:3 و16:9 و21:9 و2.39:1. إذا عرفتم فتحة العرض الفعلية، فاستخدموها بدل افتراض دقة الاسم التجاري. فبعض التنسيقات التي تُسمى عادة 21:9 تستعمل قيمًا عددية مختلفة قليلًا، وقد تُظهر الفروق الصغيرة أشرطة واضحة عند الدقات العالية. يجب أن تكون جميع الأبعاد موجبة ومحدودة، وأن يكون ارتفاع اللوحة عددًا صحيحًا من وحدات البكسل. إذا تساوت نسبتا المصدر والهدف فلا حاجة إلى حشو، وتعيد جميع أبعاد الأشرطة صفر بدل اعتبار الحالة خطأ.

ميّزوا بين الأشرطة الأفقية والجانبية

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

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

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

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

إعداد فيديو سينمائي لإطار قياسي

احسبوا حشوًا علويًا وسفليًا متساويًا قبل وضع مصدر عريض داخل لوحة تسليم بنسبة 16:9.

إنشاء نسخة أرشيفية بأشرطة جانبية

حدّدوا عرض الشريطين الأيسر والأيمن اللازم للحفاظ على مادة قديمة بنسبة 4:3 داخل إطار عريض حديث.

وضع العناصر خارج الصورة النشطة

احجزوا مساحات معلومة للأشرطة من أجل الترجمات أو التسميات أو أدوات التحكم من دون تغطية المصدر المحتوى.

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

ماذا يحدث عندما تتساوى نسبتا الأبعاد؟

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

هل يمثل bar_size_pixels شريطًا واحدًا أم مجموع الشريطين؟

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

لماذا قد تحتوي النتيجة على كسر من البكسل؟

لا تنتج هندسة نسب الأبعاد دائمًا وحدات بكسل صحيحة. تُحفظ القيمة الدقيقة كي يطبق المصيّر سياسة التقريب المناسبة.

هل يقص هذا الحساب المصدر أو يمدده؟

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

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

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/video2/aspect-ratio-letterbox-bars-size

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

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

curl -X POST https://api.kit.forhosting.com/video2/aspect-ratio-letterbox-bars-size \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source_aspect_ratio":"21:9","target_aspect_ratio":"16:9","canvas_height":1080}'

const res = await fetch("https://api.kit.forhosting.com/video2/aspect-ratio-letterbox-bars-size", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "source_aspect_ratio": "21:9",
    "target_aspect_ratio": "16:9",
    "canvas_height": 1080
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/video2/aspect-ratio-letterbox-bars-size",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "source_aspect_ratio": "21:9",
    "target_aspect_ratio": "16:9",
    "canvas_height": 1080
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/video2/aspect-ratio-letterbox-bars-size", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"source_aspect_ratio":"21:9","target_aspect_ratio":"16:9","canvas_height":1080}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"source_aspect_ratio":"21:9","target_aspect_ratio":"16:9","canvas_height":1080}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video2/aspect-ratio-letterbox-bars-size", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "source_aspect_ratio": "21:9",
  "target_aspect_ratio": "16:9",
  "canvas_height": 1080
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`max_mb`	500
`max_minutes`	60
`max_megapixels`	3.9

الأخطاء

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

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