عين

مقدمة

يحتوي الروبوت VEX 123 على مستشعر عين مدمج يمكنه اكتشاف الأجسام والألوان. كما يمكنه الإبلاغ عن كمية الضوء المنعكس إلى المستشعر وقيمة درجة اللون المكتشف.

يحتوي مستشعر العين على ضوء يمكن تشغيله أو إيقافه لمساعدته على رؤية الأشياء والألوان بشكل أكثر وضوحًا.

توجد طرق عديدة لبرمجة مستشعر العين. فيما يلي قائمة بجميع طرق برمجة مستشعر العين:

المُعدِّلات — اضبط إعدادات مستشعر العين.

• set_light — يقوم بتشغيل أو إيقاف ضوء مستشعر العين.

• set_light_power — يحدد مستوى طاقة الضوء لمستشعر العين.

المستقبلون — يعيدون ما يكتشفه مستشعر العين.

• get_hue — تُرجع اللون الذي تم اكتشافه بواسطة مستشعر العين.

• get_brightness — تُرجع السطوع الذي تم اكتشافه بواسطة مستشعر العين.

• is_object_detected — تُرجع ما إذا كان مستشعر العين يكتشف وجود جسم ضمن النطاق.

• is_color_detected — تُرجع ما إذا كان مستشعر العين يكتشف لونًا معينًا.

• is_bright — تُرجع ما إذا كان مستشعر العين يكتشف جسمًا ساطعًا.

المتحولون

set_light

set_light يقوم بتشغيل أو إيقاف ضوء مستشعر العين.

Usage:
robot.eye.set_light(state)

حدود	وصف
state	حالة ضوء مستشعر العين: OFF أو ON.

# Continuously blink the light.
while True:
    robot.eye.set_light(ON)
    wait(2, SECONDS)
    robot.eye.set_light(OFF)
    wait(2, SECONDS)

set_light_power

يُحدد الخيار set_light_power مدى سطوع ضوء مستشعر العين. يساعد هذا الضوء مستشعر العين على اكتشاف الأجسام والألوان بشكل أوضح.

نسبة أعلى تجعل الضوء أكثر سطوعاً. نسبة أقل تجعل الضوء أقل سطوعاً.

إذا كان ضوء مستشعر العين مطفأً، فإن ضبط قوة الإضاءة فوق 0% سيؤدي إلى تشغيل الضوء.

إذا كان ضوء مستشعر العين مضاءً، فإن ضبط طاقة الضوء على 0% سيؤدي إلى إطفاء الضوء.

Usage:
robot.eye.set_light_power(value)

حدود	وصف
value	مستوى السطوع الذي يجب ضبط ضوء مستشعر العين عليه، من 0% إلى 100%. استخدم أعدادًا صحيحة.

# Set the light to different power levels.
robot.eye.set_light_power(25)
wait(2, SECONDS)
robot.eye.set_light_power(50)
wait(2, SECONDS)
robot.eye.set_light_power(100)

المحصلون

get_hue

get_hue تُرجع اللون الذي تم اكتشافه بواسطة مستشعر العين كرقم صحيح من 0 إلى 359.00 درجة.

اللون هو طريقة لوصف اللون باستخدام الأرقام الموجودة على عجلة الألوان.

Usage:
robot.eye.get_hue()

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

# Display if an object is pink.
while True:
    console.clear()
    if 290 < robot.eye.get_hue() < 350:
        console.print("Pink!")
    else:
        console.print("Not pink!")
    wait(0.1, SECONDS)

get_brightness

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

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

Usage:
robot.eye.get_brightness()

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

# Display whether a detected object is bright.
robot.eye.set_light_power(100)
robot.drive(FORWARD)
while not robot.eye.is_object_detected():
    wait(0.1, SECONDS)
wait(0.1, SECONDS)
if robot.eye.get_brightness() < 70:
    console.print("Object not bright.")
else:
    console.print("Bright object!")

is_object_detected

is_object_detected تُرجع Boolean التي تُبلغ عما إذا كان مستشعر العين يكتشف وجود جسم ضمن النطاق أم لا.

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

• False — لا يكتشف مستشعر العين أي جسم.

Usage:
robot.eye.is_object_detected()

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

# Stop driving after detecting an object.
robot.eye.set_light(ON)
robot.drive(FORWARD)
wait(0.1, SECONDS)
while not robot.eye.is_object_detected():
    wait(0.1, SECONDS)
robot.stop()

is_color_detected

is_color_detected تُرجع Boolean التي تُبلغ عما إذا كان مستشعر العين يكتشف لونًا محددًا، بناءً على قيمة اللون المكتشفة.

• True — يكتشف مستشعر العين اللون المحدد.

• False — لا يكتشف مستشعر العين اللون المحدد.

يعمل مستشعر العين بشكل أفضل عندما يكون الجسم قريبًا والإضاءة واضحة.

Usage:
robot.eye.is_color_detected(color)

حدود	وصف
color	اللون الذي يجب على مستشعر العين فحصه: BLUE - قيمة اللون بين 160° و254°. GREEN - قيمة اللون بين 75° و154°. NONE RED - قيمة اللون بين 340° و20°.

# Stop driving after detecting a green object.
robot.eye.set_light(ON)
robot.drive(FORWARD)
wait(0.1, SECONDS)
while not robot.eye.is_color_detected(GREEN):
    wait(0.1, SECONDS)
robot.stop()

is_bright

is_bright تُرجع Boolean التي تُبلغ عما إذا كان الكائن الذي تم اكتشافه بواسطة مستشعر العين ساطعًا.

يُعتبر الجسم ساطعًا عندما يعكس أكثر من 70% من سطوعه إلى مستشعر العين.

• True — يعكس الجسم المكتشف سطوعًا يزيد عن 70%.

• False — يعكس الجسم المكتشف سطوعًا بنسبة 70% أو أقل.

Usage:
robot.eye.is_bright()

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

# Display whether a detected object is bright.
robot.eye.set_light_power(100)
robot.drive(FORWARD)
while not robot.eye.is_object_detected():
    wait(0.1, SECONDS)
wait(0.1, SECONDS)
if robot.eye.is_bright():
    console.print("Bright object!")
else:
    console.print("Object not bright.")