ForHosting KIT · أدوات المطورين

تحويل RGB إلى HSL

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

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

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

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

أدخل قنوات الأحمر والأخضر والأزرق بقيم بين 0 و255. يعيد المحول درجة اللون على دائرة من 0–360 درجة، ويعيد التشبع والإضاءة كنسبتين مئويتين من 0 إلى 100. ويرفض القنوات المفقودة أو غير الرقمية أو اللانهائية أو الخارجة عن النطاق بدل تصحيحها بصمت، وبذلك تظل الأخطاء ظاهرة وتبقى بيانات الألوان اللاحقة موثوقة.

أدخل قنوات RGB إدخالًا صحيحًا

قدّم ثلاثة حقول رقمية للأحمر والأخضر والأزرق باستخدام الأسماء المختصرة r وg وb. يجب أن تقع قيمة كل قناة بين 0 و255 مع احتساب الحدين. تعني القيمة صفر أن القناة لا تسهم بأي شدة، بينما تعني 255 الشدة الكاملة. وتُقبل القيم العشرية المتوسطة أيضًا، وهو أمر مفيد عندما تنتج عملية حسابية أخرى ألوانًا مستوفاة. لا يقتطع المحول القيم غير الصالحة عمدًا. فإذا كانت إحدى القنوات سالبة، أو أكبر من 255، أو مفقودة، أو غير رقمية، أو لانهائية، أعاد الطلب خطأ في الإدخال. يجعل هذا السلوك الصارم مسارات العمل الآلية أكثر أمانًا، لأن قيمة مصدر غير صالحة لا يمكن أن تتحول بصمت إلى لون يبدو معقولًا لكنه خاطئ. لإجراء اختبار أول مألوف، استخدم r بقيمة 255 وg بقيمة 0 وb بقيمة 0؛ وستكون النتيجة لونًا أحمر بدرجة لون صفر، وتشبع كامل، وإضاءة قدرها خمسون في المئة. عند نسخ القيم من CSS، أرسل أرقام القنوات فقط من دون غلاف rgb() أو الفواصل أو علامات النسبة المئوية. كما يمنع إبقاء الإدخال رقميًا الالتباس بين مقياس RGB من 0–255 والصيغة المئوية التي تستخدمها بعض أنظمة التصميم.

افهم طريقة حساب نتيجة HSL

تبدأ عملية التحويل بتطبيع كل قناة RGB عبر قسمتها على 255. ثم تحدد أكبر القنوات المطبّعة وأصغرها. يصبح متوسطهما هو الإضاءة، ويحدد الفرق بينهما، المسمى صفاء اللون، ما إذا كان للون تشبع ودرجة لون ذات معنى. عندما يكون صفاء اللون صفرًا، يكون اللون إحدى درجات الرمادي: يصبح التشبع صفرًا، وتُعاد درجة اللون صفرًا وفق العرف، لأنه لا يمكن تمييز أي موضع على دائرة الألوان بصريًا. أما في الألوان الصبغية، فيساوي التشبع صفاء اللون بعد تعديله وفق الإضاءة الحالية، بينما تعتمد درجة اللون على قناة RGB ذات القيمة الكبرى. يحتل الأحمر والأخضر والأزرق قطاعات مختلفة من دائرة الألوان، وتحدد الفروق النسبية بين القنوات الموضع داخل القطاع. تُعرض درجة اللون بالدرجات بدءًا من صفر وحتى قيمة أقل من 360. ويُضرب التشبع والإضاءة في 100 ويُعرضان كنسبتين مئويتين. تُقرّب النتائج إلى أربع منازل عشرية لتقديم دقة مفيدة مع الحفاظ على استقرار الاستجابة وسهولة قراءتها. هذا هو تحويل RGB إلى HSL القياسي؛ فهو يعيد تنظيم معلومات اللون نفسها ولا يطبق إدارة الألوان أو تصحيح غاما أو تحويل ملفات التعريف.

استخدم HSL في التصميم ومسارات التطبيقات

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

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

إنشاء عناصر التحكم في اللون

حوّل قنوات RGB المحفوظة قبل عرض منزلقات درجة اللون والتشبع والإضاءة في محرر.

إنتاج حالات مختلفة للواجهة

استخرج قيم HSL للون أساسي، ثم عدّل الإضاءة أو التشبع وفق حالات التفاعل.

توحيد سجلات الألوان

حوّل حقول RGB إلى بنية HSL متسقة لبيانات التطبيق أو الاختبارات أو التقارير.

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

ما قيم RGB المقبولة؟

يجب أن يكون كل من r وg وb عددًا محدودًا بين 0 و255 مع احتساب الحدين.

ما النطاقات التي تستخدمها النتيجة؟

تستخدم درجة اللون درجات من 0 إلى 360، ويستخدم التشبع والإضاءة نسبًا مئوية من 0 إلى 100.

ما درجة اللون المعادة للألوان الرمادية؟

ليس للرمادي درجة لون ذات معنى بصري؛ لذلك تُعاد درجة صفر وتشبع صفر في المئة وفق العرف.

هل تُقتطع القنوات الخارجة عن النطاق؟

لا. تؤدي كل قيمة أقل من 0 أو أكبر من 255 إلى خطأ إدخال كي تظل مشكلة بيانات المصدر ظاهرة.

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

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

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/color/rgb-to-hsl

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

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

curl -X POST https://api.kit.forhosting.com/color/rgb-to-hsl \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"r":255,"g":128,"b":64}'

const res = await fetch("https://api.kit.forhosting.com/color/rgb-to-hsl", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "r": 255,
    "g": 128,
    "b": 64
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/color/rgb-to-hsl",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "r": 255,
    "g": 128,
    "b": 64
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/rgb-to-hsl", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"r":255,"g":128,"b":64}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"r":255,"g":128,"b":64}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/rgb-to-hsl", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "r": 255,
  "g": 128,
  "b": 64
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.rgb_to_hsl",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

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