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

قص الصورة حسب نسبة الأبعاد

يبدو قص الصورة وفق نسبة أبعاد دقيقة أمرًا بسيطًا، لكن الخطأ في حسابه سهل. تستقبل هذه الأداة عرض الصورة الأصلية وارتفاعها مع نسبة مستهدفة مثل 16:9، ثم تعيد أكبر مستطيل بهذه النسبة يمكن احتواؤه داخل الصورة.

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

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

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

يكون الإطار في المنتصف، ولذلك تُزال كميات متساوية من الجانبين المتقابلين. لا تُرفع الصورة ولا تُحوّل؛ فالنتيجة مجموعة إحداثيات قابلة لإعادة الاستخدام في محرر أو برنامج نصي أو مسار لمعالجة الصور أو تصميم متجاوب.

حوّلوا الأبعاد والنسبة إلى مستطيل قص

أدخلوا عرض الصورة وارتفاعها بالبكسل، ثم اكتبوا النسبة المطلوبة بصيغة العرض إلى الارتفاع مع وضع نقطتين بين القيمتين. من الخيارات الشائعة 1:1 للصور المصغرة المربعة، و4:3 للتصوير التقليدي، و16:9 للوسائط العريضة، و9:16 للقصص العمودية. تقارن الحاسبة نسبة المصدر بالنسبة المطلوبة لتحديد البعد الملائم أصلًا. إذا كانت الصورة أعرض من اللازم، يُحفظ الارتفاع كاملًا ويُخفض العرض. وإذا كانت أطول من اللازم، يُحفظ العرض كاملًا ويُخفض الارتفاع. تحدد القيمتان x وy موضع الزاوية العلوية اليسرى، بينما تصف width وheight حجم الإطار. تكوّن القيم الأربع معًا صندوق قص كاملًا. ولأن الحساب يبحث عن أكبر مستطيل ملائم، فإنه لا يهدر المساحة القابلة للاستخدام بتقليص البعدين معًا. لا يعاد أخذ عينات الصورة ولا تمدد ولا تضاف إليها حواف؛ فالنتيجة تصف فقط المنطقة المركزية التي ينبغي الاحتفاظ بها.

افهموا التوسيط والإحداثيات الكسرية

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

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

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

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

إعداد أصول متسقة للشبكات الاجتماعية

احسبوا إطارات مركزية بنسبة 1:1 أو 4:5 أو 9:16 قبل إنتاج النسخ الخاصة بكل قناة.

إنشاء مسارات للصور المصغرة

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

معاينة القص التحريري

اعرضوا أكبر منطقة مركزية قبل أن يقرر المحرر ما إذا كان الموضوع يحتاج إلى تعديل موضع الإطار.

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

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

لا. إنها تحسب الإحداثيات من الأبعاد والنسبة، ولا تستقبل بيانات الصورة أو تخزنها أو تفك ترميزها أو تعدلها.

ما تكلفة الحساب؟

سعر API هو $0.002 لكل طلب. تنفذ نسخة المتصفح الحساب الحتمي نفسه محليًا.

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

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

ما صيغة النسبة المقبولة؟

استخدموا عددين موجبين تفصل بينهما نقطتان، مثل 16:9 أو 4:3 أو 1:1 أو 1.85:1. تُرفض الفواصل الأخرى والنصوص الإضافية.

هل يمكن أن يمتد القص خارج الصورة الأصلية؟

لا. يساوي أحد البعدين دائمًا بعد المصدر المقابل، بينما يُخفض البعد الآخر ليلائم النسبة المطلوبة.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/image/crop-to-aspect

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

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

curl -X POST https://api.kit.forhosting.com/image/crop-to-aspect \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1920,"height":1080,"ratio":"4:3"}'

const res = await fetch("https://api.kit.forhosting.com/image/crop-to-aspect", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "width": 1920,
    "height": 1080,
    "ratio": "4:3"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/crop-to-aspect",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "width": 1920,
    "height": 1080,
    "ratio": "4:3"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/crop-to-aspect", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"width":1920,"height":1080,"ratio":"4:3"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"width":1920,"height":1080,"ratio":"4:3"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/crop-to-aspect", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "width": 1920,
  "height": 1080,
  "ratio": "4:3"
}

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

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