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

محول HSL↔HSV

انقل لوناً من HSL الذي يستخدمه المصممون إلى HSV الذي تستخدمه برامج الصور: يحتفظ hsl(210, 80%, 45%) بالصبغة 210 وتصبح قيمته 81%، مع إعادة حساب التشبع للنموذج الجديد. ويعمل في الاتجاهين. مجاناً في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

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

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

مثال محلول

إذا أدخلت

اتجاه التحويل: hsl_to_hsv
H: 210
S: 80
L: 45

تحصل على

S الداخل: 80
S: 88.8888888889
الجهد (V): 81

HSL وHSV نموذجان لونيان أسطوانيان يشتركان في زاوية الصبغة نفسها على العجلة، لكنهما يعاملان المحور الثاني والثالث بطريقة مختلفة: يستخدم HSL التشبع والسطوع، بينما يستخدم HSV التشبع والقيمة (السطوع الأقصى). يستقبل هذا المحول اتجاهًا —من HSL إلى HSV أو من HSV إلى HSL— والصبغة بالدرجات من 0 إلى 360، والتشبع كنسبة مئوية، والسطوع أو القيمة كنسبة مئوية من 0 إلى 100، ثم يعيد الثلاثي المحوَّل مع ملء كائني النموذجين.

كيف يرتبط HSL وHSV على الصبغة نفسها

الصبغة مشتركة: 0 درجة أحمر نقي، و120 أخضر نقي، و240 أزرق نقي، و360 يغلق الدائرة عند الأحمر. يختلف النموذجان في كيفية تخزين الحيوية والسطوع. في HSL يمتد السطوع من الأسود عند 0 بالمئة مرورًا بنغمة وسطى نقية قرب 50 بالمئة حتى الأبيض عند 100 بالمئة، ويمدد تشبع HSL رماديًا بذلك السطوع نحو اللون كامل الكروم عند الصبغة المختارة.

في HSV تكون القيمة هي أقصى قنوات RGB الأساسية على مقياس الوحدة، فالقيمة 100 بالمئة هي أسطع لون لتلك الصبغة والتشبع، والقيمة 0 بالمئة سوداء دائمًا بغض النظر عن التشبع. ولأن الهندسات تختلف، فإن التشبع العددي في HSL ليس الرقم نفسه للتشبع العددي في HSV لمعظم الألوان حتى عندما يتطابق اللون المدرك بعد التحويل.

يعمل المسار ذو الصيغة المغلقة هنا على الفترة الوحدوية: لتحويل HSL إلى HSV تساوي القيمة السطوع زائد تشبع HSL مضروبًا في الحد الأدنى بين السطوع وواحد ناقص السطوع، وتشبع HSV يساوي 0 عندما تكون القيمة 0 وإلا مرتين واحد ناقص السطوع على القيمة. لتحويل HSV إلى HSL يساوي السطوع القيمة مضروبة في واحد ناقص نصف تشبع HSV، وتشبع HSL يساوي 0 عند الأسود أو الأبيض وإلا الفجوة بين القيمة والسطوع مقسومة على الحد الأدنى بين السطوع وواحد ناقص السطوع. تُنسخ الصبغة دون تغيير.

يجب أن تقع الصبغة في الفترة المغلقة من 0 إلى 360؛ ويجب أن يقع كل من التشبع والسطوع والقيمة بين 0 و100 بالمئة شمولًا.

أين يظهر تحويل HSL إلى HSV في العمل الفعلي

غالبًا ما تُؤلَّف أنظمة التصميم منحدرات العلامة في HSL حتى تتمكن فرق المنتج من تدريج السطوع لتباين يسهل الوصول إليه مع الإبقاء على الصبغة ونطاق تشبع إدراكي مستقرين؛ غير أن السمات الأصلية للجوال ومحددات مواد Unity وUnreal وكثيرًا من مكتبات الرسوم تتوقع HSV أو HSB لعناصر تحكم سطوع موجهة للفنان. تحتاج أدوات تصور البيانات والفن التوليدي التي تعرض عجلة صبغة مع منزلق قيمة إلى معكوس موثوق عند تصدير الرموز المخزَّنة كخصائص HSL مخصصة.

خطوط أنابيب الفيديو والبث التي توثق الألوان في HSV لتدريج الكاميرا ما زالت تحتاج HSL عند تغذية CSS وتوثيق التصميم. تُعلِّم المناهج والمعسكرات التدريبية النماذج الأسطوانية جنبًا إلى جنب وتحتاج إلى مصدر ثقة واحد لمفاتيح الواجبات التي تطابق هويات الكتب. إذا احتجت لاحقًا إلى HSL إلى RGB أو تحويل متعدد الصيغ HEX LAB CMYK أو فحوص تباين WCAG، فعاملها كنوايا بحث وصفحات هبوط منفصلة بدل تحميل هذه الصفحة المخصصة لمحول HSL إلى HSV فوق طاقتها.

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

رموز تصميم عبر أدوات HSL وHSV

حوّل منحدرات العلامة HSL إلى ثلاثيات HSV لسمات الجوال ومحددات مواد الألعاب ومحررات الصور التي تعرض القيمة بدل السطوع.

جداول معاملات المحرك والتظليل

ارسم عينات HSV للفنانين عائدة إلى HSL لأنظمة تصميم CSS وجداول التوثيق التي يجب أن تبقى bit-stable عبر خطوط الأنابيب.

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

ما النطاقات التي تقبلها الصبغة والتشبع والسطوع والقيمة؟

يجب أن تكون الصبغة h بين 0 و360 درجة شمولًا. التشبع s والسطوع l والقيمة v نسب مئوية من 0 إلى 100.

هل تشبع HSL هو الرقم نفسه لتشبع HSV؟

لا. يعرّف النموذجان التشبع بشكل مختلف. يطبّق هذا المحول الهويات ذات الصيغة المغلقة ليطابق اللون الناتج بينما تختلف قيم S العددية عادة.

هل تتغير الصبغة بين HSL وHSV؟

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

ماذا يصبح hsl(210, 80%, 45%) في HSV؟

تبقى الصبغة 210 وتصبح القيمة 81%. ويرتفع التشبع فوق 80% الأصلية، لأن HSV يقيس حيوية اللون بطريقة تختلف عن HSL.

كيف يُحوَّل الأسود والرمادي؟

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

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/color/hsl-hsv

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

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

curl -X POST https://api.kit.forhosting.com/color/hsl-hsv \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"direction":"hsl_to_hsv","h":210,"s":80}'

const res = await fetch("https://api.kit.forhosting.com/color/hsl-hsv", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "direction": "hsl_to_hsv",
    "h": 210,
    "s": 80
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/color/hsl-hsv",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "direction": "hsl_to_hsv",
    "h": 210,
    "s": 80
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/hsl-hsv", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"direction":"hsl_to_hsv","h":210,"s":80}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"direction":"hsl_to_hsv","h":210,"s":80}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/hsl-hsv", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "direction": "hsl_to_hsv",
  "h": 210,
  "s": 80
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

ملاحظات تقنية

تفشل القنوات خارج النطاقات القانونية بخطأ واضح invalid_input حتى لا تُلفّ الرموز الخاطئة أو تُقصّ بصمت.

كيف يرتبط HSL وHSV على الصبغة نفسها

خط الأنابيب حساب عائم نقي بلا بذور عشوائية ولا طوابع زمنية للساعة ولا استدعاءات شبكة، فالمدخلات المتطابقة تنتج دائمًا JSON نفسه.

ما الذي ترسله وما الذي تستقبله

تشمل الفحوصات الكلاسيكية الأحمر الوسطي النقي في HSL بصبغة 0 وتشبع 100 وسطوع 50 الذي يُعرَض إلى قيمة HSV 100 بتشبع كامل؛ والأسود كسطوع 0 أو قيمة 0 ينهار إلى أسود عديم اللون؛ والرماديات بتشبع 0 التي تُعرَض إلى تشبع 0 في النموذج الآخر مع اتباع القيمة أو السطوع لمحور سطوع المصدر. استخدم نموذج المتصفح المجاني لاستكشاف اللوحات ومراجعات التصميم، ثم استدعِ العقد نفسه من السكربتات عند الحاجة إلى تحويل جماعي لرموز التصميم أو مواد المحرك. أرسل سلسلة اتجاه hsl_to_hsv أو hsv_to_hsl، وصبغة منتهية h بالدرجات، وتشبعًا منتهيًا s كنسبة مئوية في نموذج المصدر. عندما يكون الاتجاه hsl_to_hsv يجب أيضًا إرسال السطوع l كنسبة مئوية من 0 إلى 100؛ وعندما يكون الاتجاه hsv_to_hsl يجب إرسال القيمة v كنسبة مئوية في النطاق نفسه. الحقول الناقصة والسلاسل غير الرقمية وNaN وInfinity والقنوات خارج النطاق تفشل بـ invalid_input ولا تُحسب. عند نجاح HSL إلى HSV تعيد الاستجابة الاتجاه المنظَّف وh وتشبع المصدر كـ s_in وسطوع الإدخال l وتشبع HSV الناتج s والقيمة v وكائني hsl وhsv المتداخلين وملاحظة صيغة قصيرة. عند نجاح HSV إلى HSL تعيد الاتجاه وh وs_in وقيمة الإدخال v وتشبع HSL الناتج s والسطوع l وكائني hsv وhsl المتداخلين وملاحظة الصيغة العكسية. تسعير استدعاءات API الناجحة هو القاعدة المنشورة $0.002 لكل عنصر؛ وإخفاقات التحقق لا تستهلك الرصيد المدفوع مسبقًا.

أين يظهر تحويل HSL إلى HSV في العمل الفعلي

مسارات إمكانية الوصول التي تضبط السطوع المدرك في HSL ثم تسلّم إلى محرر قائم على HSV ما زالت تحتاج تعيين قنوات دقيق دون واجهات API خاصة بالمتصفح فقط. وبما أن هذه القدرة محرك parse نقي، فإن تسعير API هو القاعدة المنشورة $0.002 لكل عنصر ناجح والتحقق الفاشل لا يستهلك الرصيد.

حالات التكامل

تجهيزات جماعية للرموز والمناهج

اكتب سكربتات تحويل ثنائي الاتجاه لتجهيزات الانحدار ومفاتيح الواجبات وتصدير اللوحات بواجهة API حتمية بسعر $0.002 لكل عنصر.

أسئلة تقنية

ماذا يفعل حقل الاتجاه؟

استخدم hsl_to_hsv عندما يكون الإدخال HSL (أرسل h وs وl). استخدم hsv_to_hsl عندما يكون الإدخال HSV (أرسل h وs وv). تُرفض سلاسل الاتجاه الأخرى.

كم التكلفة؟

أداة المتصفح مجانية وتعمل محليًا. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل عنصر ناجح؛ ولا يُحسب الإدخال غير الصالح.

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

شغّل الأداة مجانًا

مثال محلول

كيف يرتبط HSL وHSV على الصبغة نفسها

أين يظهر تحويل HSL إلى HSV في العمل الفعلي

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

رموز تصميم عبر أدوات HSL وHSV

جداول معاملات المحرك والتظليل

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

كيف يرتبط HSL وHSV على الصبغة نفسها

ما الذي ترسله وما الذي تستقبله

أين يظهر تحويل HSL إلى HSV في العمل الفعلي

حالات التكامل

تجهيزات جماعية للرموز والمناهج

أسئلة تقنية

شكرًا