تكميم اللون إلى أقرب درجة في لوحة الألوان

افهموا طريقة حساب المسافة الحتمية

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

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

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