لون

مقدمة

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

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

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

فيما يلي قائمة بجميع الطرق:

الإجراءات — اكتشاف الأجسام باستخدام مستشعر الألوان.

• object_detected — يسجل دالة ليتم استدعاؤها عند اكتشاف كائن.

المُعدِّلات — تعديل الأضواء الموجودة على مستشعر الألوان.

• set_light — يقوم بتعيين مؤشر LED الخاص بمستشعر اللون إلى وضع التشغيل أو الإيقاف أو مستوى سطوع محدد.

• set_light_power — يحدد سطوع مؤشر LED الخاص بمستشعر الألوان.

المُسترجعات — تُعيد بيانات الكائن باستخدام مستشعر اللون.

• is_near_object — تُرجع ما إذا كان الكائن ضمن نطاق المستشعر.

• color — يُرجع رمز اللون السداسي العشري للون المكتشف.

• brightness — يعيد السطوع المكتشف.

• hue — تُرجع قيمة اللون المكتشفة.

• installed — إرجاع ما إذا كان مستشعر اللون متصلاً بالدماغ.

المنشئات — تهيئة وتكوين مستشعر الألوان يدويًا.

• ColorSensor — إنشاء مستشعر ألوان.

الإجراءات

object_detected

object_detected يسجل دالة ليتم استدعاؤها عندما يكتشف مستشعر اللون وجود جسم.

Usage:
color_1.object_detected(callback, args)

حدود	وصف
callback	A function that is previously defined to execute when the Color Sensor detects an object.
args	اختياري. مجموعة تحتوي على الوسائط التي يتم تمريرها إلى دالة الاستدعاء. راجع الدوال ذات المعاملات لمزيد من المعلومات.

المتحولون

set_light

set_light يقوم بتعيين مؤشر LED الخاص بمستشعر اللون إلى وضع التشغيل أو الإيقاف أو مستوى سطوع محدد.

Usage:
color_1.set_light(value, units)

حدود	وصف
value	يُحدد هذا الخيار ما إذا كان سيتم تشغيل أو إيقاف تشغيل مؤشر LED باستخدام أحد الخيارات التالية: LedStateType.ON — يضبط سطوع مؤشر LED على 100%. LedStateType.OFF — يضبط سطوع مؤشر LED على 0%. بدلاً من ذلك، يمكن استخدام نسبة مئوية من 0 إلى 100 لضبط سطوع مؤشر LED. القيمة 0 تُطفئ مؤشر LED؛ وأي قيمة أعلى من 0 تُشغّله بنفس السطوع.
units	اختياري. الوحدة التي تمثل قيمة السطوع: PERCENT.

# Turn the LED on and off forever
while True:
    color_1.set_light(LedStateType.ON)
    wait(0.5, SECONDS)
    color_1.set_light(LedStateType.OFF)
    wait(0.5, SECONDS)

# Turn the LED on and off forever
while True:
    color_1.set_light(LedStateType.ON, 75)
    wait(0.5, SECONDS)
    color_1.set_light(0)
    wait(0.5, SECONDS)

set_light_power

يُحدد set_light_power سطوع مؤشر LED الخاص بمستشعر الألوان. إذا لم يكن مؤشر LED مضاءً بالفعل، فسيقوم هذا الأمر بتشغيله أيضًا.

Usage:
color_1.set_light_power(value)

حدود	وصف
value	سطوع مؤشر LED كنسبة مئوية من 0 إلى 100. القيمة 0 تؤدي إلى إطفاء مؤشر LED.

# Turn the LED light on at different intensities
color_1.set_light_power(10)
wait(2, SECONDS)
color_1.set_light_power(100)

المحصلون

is_near_object

تُعيد الدالة is_near_object قيمة منطقية تُشير إلى ما إذا كان مستشعر الألوان يقع على بُعد 57 مليمترًا تقريبًا (2.25 بوصة) من جسم ما. يعتمد الكشف على الضوء المنعكس، لذا قد لا يتم الكشف عن الأسطح الداكنة أو غير العاكسة بدقة.

• True — الجسم المكتشف يقع على بعد حوالي 57 مليمترًا.

• False — الجسم المكتشف ليس ضمن مسافة 57 مليمترًا تقريبًا.

Usage:
color_1.is_near_object()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

color

color تُرجع رمز اللون السداسي العشري للون المكتشف كسلسلة نصية بالتنسيق “Color” متبوعة بصفرين وقيمة اللون السداسية العشرية.

على سبيل المثال، سيؤدي اكتشاف اللون الأحمر (#FF0000) إلى إرجاع “اللون 00FF0000”.

Usage:
color_1.color()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

# Display the currently detected hex value
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print(color_1.color())
    wait(0.5,SECONDS)

brightness

brightness يعيد مدى سطوع اللون المكتشف، كرقم صحيح من 0% إلى 100%.

نسبة أعلى تعني أن مستشعر الألوان يستشعر ضوءًا أكثر. نسبة أقل تعني أن مستشعر الألوان يستشعر ضوءًا أقل.

Usage:
color_1.brightness()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

# Display the currently detected brightness
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print("Brightness:")
    brain.screen.next_row()
    brain.screen.print(color_1.brightness())
    wait(0.5,SECONDS)

hue

hue تُرجع قيمة اللون المكتشفة كعدد عشري في نطاق من 0 إلى 359.99 درجة.

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

Usage:
color_1.hue()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

# Display the currently detected hue 
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print("Hue: ")
    brain.screen.print(color_1.hue())
    wait(0.5,SECONDS)

installed

installed يُرجع قيمة منطقية تشير إلى ما إذا كان مستشعر اللون متصلاً بالدماغ.

• True — مستشعر اللون متصل بالدماغ.

• False — مستشعر اللون غير متصل بالدماغ.

Usage:
color_1.installed()

حدود	وصف
	لا تحتوي هذه الطريقة على أي معلمات.

المُنشئون

تُستخدم الدوال البانية لإنشاء كائنات ColorSensor ColorSensor وهي ضرورية لتكوين مستشعر اللون خارج VEXcode.

ColorSensor

ColorSensor يقوم بإنشاء مستشعر ألوان.

Usage:
color_1 = ColorSensor(smartport)

المعلمة	وصف
smartport	المنفذ الذكي الذي يتصل به مستشعر الألوان، ويكتب على النحو التالي: PORTx حيث x هو رقم المنفذ.

# Create a Color Sensor object in Port 3
color_1 = ColorSensor(Ports.PORT3)