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

احسب الألوان الفريدة في الصورة واعرض أكثر خمسة ألوان

يحوّل عدّاد الألوان الفريدة عينات بكسلات RGB إلى جرد واضح للألوان الموجودة فعليًا.

● Betaمجاني · داخل متصفحك
استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

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

جهّزوا عينات البكسلات للحصول على عدّ دقيق

قدّموا البكسلات كسجلات RGB تحتوي قنوات الأحمر والأخضر والأزرق بقيم من 0 إلى 255. يمثل كل سجل بكسلًا واحدًا ما لم تضيفوا عدًّا موجبًا، وهو مفيد عندما يكون محلل الصورة أو المدرج التكراري قد جمع القيم المتكررة مسبقًا. لا تُعدّ الألوان متطابقة إلا إذا تطابقت توليفة RGB كاملة. فمثلًا RGB 20, 40, 60 وRGB 20, 40, 61 لونان مختلفان رغم أنهما قد يبدوان متقاربين جدًا. استُبعدت قناة ألفا عمدًا من هذا العقد، لذلك ينبغي أن تعكس العينات مسبقًا سياسة الشفافية أو التركيب المعتمدة في سير عملكم. يمكنكم إرسال قيمة RGB نفسها أكثر من مرة؛ إذ تُجمع كل مرات الظهور وقيم العدّ قبل الترتيب. وبذلك تحمل تدفقات البكسلات الخام والمدرجات التكرارية المضغوطة المعنى نفسه. لا تصف القائمة الفارغة أي عينة صورة، ولذلك ينتج عنها خطأ إدخال بدل إظهار صفر مضلل. كما تُرفض قيم القنوات أو العدّ غير الصالحة، والحقول غير المدعومة، والقوائم التي تتجاوز الحد، حتى تظل مشكلات بنية البيانات واضحة ولا تغيّر النتيجة بصمت.

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

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

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

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

دقّقوا رسمًا مفهرسًا

تأكدوا من أن الأيقونة أو الصورة المتحركة المصدرة لا تحتوي ألوان RGB دقيقة أكثر من لوحة الألوان المقصودة.

اكشفوا درجات التصيير غير المتوقعة

اعثروا على الألوان الإضافية الناتجة من تنعيم الحواف أو الاستيفاء أو التركيب أو تغيير إعدادات التصدير.

لخّصوا مدرج محلل الصور التكراري

حوّلوا سجلات RGB الموزونة إلى عدد دقيق وقائمة ثابتة لأعلى خمسة تكرارات.

ما الذي يُعد لونًا مختلفًا؟

كل توليفة فريدة من القنوات الصحيحة للأحمر والأخضر والأزرق. ويؤدي اختلاف قناة واحدة فقط إلى لون آخر.

هل تجمع الأداة الألوان المتشابهة؟

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

ما فائدة حقل العدّ؟

يتيح لسجل RGB واحد أن يمثل عدة بكسلات متطابقة. وعند حذفه يمثل السجل بكسلًا واحدًا.

ماذا يحدث عند وجود أقل من خمسة ألوان؟

تعيد قائمة top_colors كل الألوان المرصودة، ولذلك تحتوي عندئذ أقل من خمسة عناصر.

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

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

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

POSThttps://api.kit.forhosting.com/image/color-count

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

curl -X POST https://api.kit.forhosting.com/image/color-count \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pixels":[{"r":255,"g":0,"b":0,"count":4},{"r":0,"g":0,"b":255,"count":2},{"r":255,"g":0,"b":0}]}'
{
  "pixels": [
    {
      "r": 255,
      "g": 0,
      "b": 0,
      "count": 4
    },
    {
      "r": 0,
      "g": 0,
      "b": 255,
      "count": 2
    },
    {
      "r": 255,
      "g": 0,
      "b": 0
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.color_count",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

لكل طلب$0.002

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

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

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