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

حساب خطوط ونقاط شبكة قاعدة الأثلاث بالبكسل

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

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

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

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

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

ما الذي تمثله إحداثيات قاعدة الأثلاث

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

كيفية معالجة كسور البكسل والتحقق من الإدخال

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

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

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

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

رسم أدلة في محرر صور

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

إضافة أهداف تكوين إلى معاينة الكاميرا

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

التحقق من تخطيطات الاقتصاص

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

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

ما الإحداثيات التي تعيدها الحاسبة؟

تتضمن النتيجة موضعين عموديين على محور x وموضعين أفقيين على محور y والنقاط الأربع التي تتقاطع عندها الخطوط.

أين يقع أصل الإحداثيات؟

يقع الأصل في الزاوية العلوية اليسرى للصورة. تزداد x نحو اليمين وتزداد y نحو الأسفل.

هل تُقرّب مواضع البكسل الكسرية؟

لا. تبقى القيم الكسرية كي يختار نظام العرض المستهلك سياسة المحاذاة إلى بكسل كامل أو جزء منه.

ماذا يحدث إذا كان العرض أو الارتفاع صفراً؟

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

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

يكلف كل طلب API مبلغ $0.002. ويمكن أيضاً تشغيل الحساب الحتمي نفسه مجاناً في المتصفح.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/image/grid-overlay-thirds

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

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

curl -X POST https://api.kit.forhosting.com/image/grid-overlay-thirds \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1200,"height":800}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/grid-overlay-thirds",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "width": 1200,
    "height": 800
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"width":1200,"height":800}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/grid-overlay-thirds", 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
}

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

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