مستشعر بصري#

مقدمة#

يكتشف المستشعر البصري V5 لون وسطوع ووجود الأجسام القريبة باستخدام مزيج من مستشعر ألوان RGB ومستشعر تقارب. كما يمكنه استخدام مصباح LED المدمج لإضاءة الأجسام من أجل اكتشاف أكثر دقة.

مستشعر VEX V5 البصري.

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

فيما يلي قائمة بالطرق المتاحة:

  • set_light – يقوم بتشغيل أو إيقاف تشغيل مؤشر LED الخاص بالمستشعر البصري.

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

  • is_near_object – تُرجع ما إذا كان المستشعر البصري يكتشف وجود جسم ضمن النطاق.

  • color – يعيد اللون الذي تم اكتشافه بواسطة المستشعر البصري.

  • brightness – تُرجع كمية الضوء المنعكس من الجسم.

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

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

  • object_lost – يسجل دالة يتم استدعاؤها عندما يفقد المستشعر البصري كائنًا.

المنشئ – تهيئة مستشعر بصري يدويًا.

  • Optical – إنشاء مستشعر بصري.

ضبط_الضوء#

يؤدي الأمر set_light إلى تشغيل أو إيقاف تشغيل مؤشر LED الخاص بالمستشعر البصري. وهذا يساعد على زيادة دقة المستشعر عند اكتشاف الألوان.

Usage:
optical_sensor.set_light(state)

حدود

وصف

ولاية

Sets the LED on or off. LEDStateType.ON turns the light on at 100% brightness. LEDStateType.OFF turns it off.

 
# Turn on the sensor's LED
optical_sensor.set_light(LEDStateType.ON)

ضبط_قوة_الإضاءة#

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

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

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

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

Usage:
optical_sensor.set_light_power(percent, units)

حدود

وصف

شهادة

يتم ضبط سطوع مؤشر LED كرقم صحيح.

وحدات

اختياري. وحدة قياس السطوع: PERCENT

 
# Turn on the sensor's light at half brightness
optical_sensor.set_light_power(50, PERCENT)

كائن قريب#

is_near_object تُرجع قيمة منطقية تشير إلى ما إذا كان المستشعر البصري يكتشف وجود جسم ضمن النطاق أم لا.

  • True – يكتشف المستشعر البصري وجود جسم.

  • False – لا يكتشف المستشعر البصري أي جسم.

Usage:
optical_sensor.is_near_object()

حدود

وصف

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

 
# Drive forward until an object is found
drivetrain.drive(FORWARD)
while not optical_sensor.is_near_object():
  pass
drivetrain.stop()

لون#

color returns an instance of a Color class, based on the detected hue value. These can be compared to predefined Color objects to create conditional statements.

الألوان الممكنة هي:

  • Color.BLACK

  • Color.WHITE

  • اللون Color.RED - قيمة لونية بين 340° - 20°

  • Color.GREEN - قيمة لونية بين 80° - 140°

  • اللون Color.BLUE - قيمة لونية بين 200° و 240°

  • اللون Color.YELLOW - قيمة لونية بين 40° و 60°

  • اللون Color.ORANGE - قيمة لونية بين 20° و 40°

  • اللون Color.PURPLE - قيمة لونية بين 240° و 280°

  • Color.CYAN - قيمة لونية بين 140° - 200°

ملاحظة: يبحث المستشعر البصري عن نطاقات ألوان تتطابق مع اللون المحدد. لاكتشاف نطاقات ألوان محددة، انظر hue.

Usage:
optical_sensor.color()

حدود

وصف

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

 
# Drive forward until red is found
drivetrain.drive(FORWARD)
while not optical_sensor.color() == Color.RED:
  pass
drivetrain.stop()

سطوع#

brightness يعيد كمية الضوء المنعكس من الجسم كعدد عشري (float) يمثل نسبة مئوية.

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

Usage:
optical_sensor.brightness()

حدود

وصف

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

لون#

hue تُرجع قيمة اللون المكتشف كعدد عشري (float) من 0 إلى 359.

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

عجلة ألوان VEX توضح درجات الألوان حول دائرة، حيث يكون اللون الأحمر عند الدرجة 0 ويتدرج عبر قوس قزح مع زيادة القيمة.

Usage: optical_sensor.hue()

حدود

وصف

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

 
# Look for the color pink using hue
while True:
  brain.screen.clear_screen()
  brain.screen.set_cursor(1, 1)

  if 300 < optical_sensor.hue() < 359:
    brain.screen.print("This is pink!")
  else:
    brain.screen.print("No pink detected!")

تم اكتشاف الكائن#

object_detected يسجل دالة ليتم استدعاؤها كلما اكتشف المستشعر البصري جسمًا جديدًا.

Usage:
optical_sensor.object_detected(callback, arg)

حدود

وصف

callback

A previously defined function that executes when the Optical Sensor detects a new object.

arg

Optional. A tuple containing arguments to pass to the callback function. See Using Functions with Parameters for more information.

 
def my_function():
  brain.screen.print("Optical Sensor detected an object")

# Call my_function whenever optical_sensor detects an object
optical_sensor.object_detected(my_function)

الكائن_المفقود#

object_lost يسجل دالة يتم استدعاؤها كلما فقد المستشعر البصري جسمًا تم اكتشافه.

Usage:
optical_sensor.object_lost(callback, arg)

حدود

وصف

callback

A previously defined function that executes when the Optical Sensor loses a detected object.

arg

Optional. A tuple containing arguments to pass to the callback function. See Using Functions with Parameters for more information.

 
def my_function():
  brain.screen.print("Optical Sensor lost an object")

# Call my_function whenever optical_sensor loses an object
optical_sensor.object_lost(my_function)

المُنشئ#

Constructors are used to manually create Optical objects, which are necessary for configuring an Optical Sensor outside of VEXcode.

Optical#

Optical يقوم بإنشاء مستشعر بصري.

Usage:
Optical(smartport)

المعلمة

وصف

smartport

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

 
# Create an Optical Sensor in Port 10
optical_sensor = Optical(Ports.PORT10)
On this page