مؤشر LED يعمل باللمس#

مقدمة #

يُعدّ مؤشر VEX IQ Touch LED بمثابة ضوء وزر في آن واحد. فهو يضيء بألوان مختلفة لتقديم معلومات، مثل الإشارة إلى جاهزية الروبوت، أو توضيح الوضع المُختار، أو مطابقة لون تم رصده بواسطة مستشعر آخر. كما أنه قادر على استشعار اللمس، مما يتيح لك بدء تشغيل الروبوت أو تغيير سلوكه بنقرة واحدة.

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

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

الإجراءات — التفاعل مع مؤشر LED الذي يعمل باللمس.

pressed — يسجل وظيفة ليتم استدعاؤها عند الضغط على مؤشر LED اللمسي.
released — يسجل وظيفة ليتم استدعاؤها عند تحرير مؤشر LED اللمسي.
on — تشغيل مؤشر LED الذي يعمل باللمس.
off — إيقاف تشغيل مؤشر LED الذي يعمل باللمس.
toggle — تشغيل أو إيقاف تشغيل مؤشر LED الذي يعمل باللمس.

المُعدِّلات — تغيير الألوان والسطوع والإعدادات الخاصة بمؤشر LED الذي يعمل باللمس.

set_color — يحدد لون مؤشر LED الخاص باللمس.
set_fade — يحدد مدى سرعة تلاشي الألوان في بعضها البعض.
set_brightness — يضبط سطوع مؤشر LED اللمسي.
set_blink — تشغيل وإيقاف مؤشر اللمس LED بشكل متناوب إلى أجل غير مسمى.

المُستقبِلات — تُعيد البيانات من مؤشر LED اللمسي.

pressing — إرجاع ما إذا كان يتم الضغط على مؤشر LED اللمسي.
installed — إرجاع ما إذا كان مؤشر LED اللمسي متصلاً بالدماغ.

المنشئات — قم بتهيئة وتكوين مؤشر LED اللمسي يدويًا.

Touchled — إنشاء مؤشر LED يعمل باللمس.

الإجراءات #

pressed #

pressed registers a function to be called when the Touch LED is pressed.

Usage:
touchled_1.pressed(callback, arg)

حدود	وصف
`callback`	A function that is previously defined to execute when the Touch LED is being pressed.
`arg`	Optional. A tuple containing arguments to pass to the callback function. See Functions with Parameters for more information.

# Turn blue while the Touch LED is pressed
def light_blue():
    touchled_1.set_color(Color.BLUE)

touchled_1.pressed(light_blue)

released #

released يسجل وظيفة ليتم استدعاؤها عند تحرير مؤشر LED اللمسي.

Usage:
touchled_1.released(callback, arg)

حدود	وصف
`callback`	A function that is previously defined to execute when the Touch LED is released.
`arg`	Optional. A tuple containing arguments to pass to the callback function. See Functions with Parameters for more information.

# Turn red when the Touch LED is released
def light_red():
    touchled_1.set_color(Color.RED)

touchled_1.released(light_red)

on #

يؤدي الضغط على on إلى تشغيل مؤشر LED الذي يعمل باللمس عن طريق ضبط سطوعه على 100%.

Usage:
touchled_1.on(value)

حدود	وصف
`value`	Optional. Sets the LED’s color to: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (default) `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` You can also specify a custom color.

حدود

وصف

value

Optional. Sets the LED’s color to:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE (default)
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET
Color.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

You can also specify a custom color.

# Turn green when the robot is moving
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

off #

يؤدي إيقاف تشغيل off إيقاف تشغيل مؤشر LED الذي يعمل باللمس عن طريق ضبط سطوعه على 0%.

Usage:
touchled_1.off()

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

# Turn off Touch LED when movement is over
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

toggle #

يُشغّل الزر toggle مؤشر LED اللمسي أو يُطفئه. إذا كان المؤشر مُضاءً، يُخفّض الزر toggle سطوعه إلى 0%، مما يؤدي إلى إطفائه. أما إذا كان المؤشر مُطفأً، فيُشغّله الزر toggle سطوعه إلى 100%.

Usage:
touchled_1.toggle()

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

# Turn the Touch LED off and on
touchled_1.set_color(Color.RED)
while True:
    touchled_1.toggle()
    wait(0.5,SECONDS)

المتحولون #

set_color #

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

Usage:
touchled_1.set_color(color)

حدود	وصف
`color`	Optional. Sets the LED’s color to: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (default) `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET` `Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` If unspecified, `set_color` will turn the Touch LED on with the previously set color. You can also specify a custom color.

حدود

وصف

color

Optional. Sets the LED’s color to:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE (default)
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET
Color.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

If unspecified, set_color will turn the Touch LED on with the previously set color.
You can also specify a custom color.

# Change colors between blue and green
while True:
    touchled_1.set_color(Color.BLUE)
    wait(0.5, SECONDS)
    touchled_1.set_color(Color.GREEN)
    wait(0.5, SECONDS)

set_fade #

set_fade يغير كيفية انتقال مؤشر LED اللمسي إلى ألوان جديدة.

Usage:
touchled_1.set_fade(type)

حدود	وصف
`type`	سرعة تلاشي الألوان من لون إلى آخر: `FadeType.FAST` — انتقال الألوان سريع. `FadeType.OFF` — انتقال الألوان فوري. `FadeType.SLOW` — انتقال الألوان بطيء.

حدود

وصف

type

سرعة تلاشي الألوان من لون إلى آخر:

FadeType.FAST — انتقال الألوان سريع.
FadeType.OFF — انتقال الألوان فوري.
FadeType.SLOW — انتقال الألوان بطيء.

# No fade to red, then slow fade to purple
touchled_1.set_fade(FadeType.OFF)
touchled_1.set_color(Color.RED)
wait(2, SECONDS)
touchled_1.set_fade(FadeType.SLOW)
touchled_1.set_color(Color.PURPLE)

set_brightness #

set_brightness يحدد سطوع مؤشر LED اللمسي.

Usage:
touchled_1.set_brightness(brightness)

حدود	وصف
`brightness`	يمكن ضبط سطوع مؤشر LED الذي يعمل باللمس كرقم صحيح من 0% إلى 100%.

# Show green at different brightness levels
touchled_1.set_color(Color.GREEN)
wait(1, SECONDS)
touchled_1.set_brightness(10)
wait(1, SECONDS)
touchled_1.set_brightness(100)

set_blink #

set_blink يومض مؤشر اللمس بشكل متكرر بنمط تشغيل وإيقاف.

ملاحظة: لن يؤدي استدعاء off إلى إيقاف خاصية الوميض. لإيقاف خاصية الوميض، اضبط سطوع مؤشر LED على 0 باستخدام set_brightness.

Usage:
set_blink(color, ontime, offtime)

حدود	وصف
`color`	يُضبط لون مؤشر LED اللمسي على: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` `Color.YELLOW` `Color.ORANGE` `Color.PURPLE` `Color.RED_VIOLET` `Color.VIOLET`36 أزرق`Color.BLUE_VIOLET` `Color.BLUE_GREEN` `Color.YELLOW_GREEN` `Color.YELLOW_ORANGE` `Color.RED_ORANGE` يمكنك أيضًا تحديد لون مخصص.
`ontime`	مدة بقاء مؤشر LED مضاءً خلال كل ومضة، بالثواني. القيمة الافتراضية هي 0.25 ثانية.
`offtime`	مدة بقاء مؤشر LED مطفأً خلال كل ومضة، بالثواني. القيمة الافتراضية هي 0.25 ثانية.

حدود

وصف

color

يُضبط لون مؤشر LED اللمسي على:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE
Color.YELLOW
Color.ORANGE
Color.PURPLE
Color.RED_VIOLET
Color.VIOLET36
أزرقColor.BLUE_VIOLET
Color.BLUE_GREEN
Color.YELLOW_GREEN
Color.YELLOW_ORANGE
Color.RED_ORANGE

يمكنك أيضًا تحديد لون مخصص.

ontime

مدة بقاء مؤشر LED مضاءً خلال كل ومضة، بالثواني. القيمة الافتراضية هي 0.25 ثانية.

offtime

مدة بقاء مؤشر LED مطفأً خلال كل ومضة، بالثواني. القيمة الافتراضية هي 0.25 ثانية.

# Blink green for 2 seconds then stop
touchled_1.set_blink(Color.GREEN, 0.5, 0.5)
wait(2, SECONDS)
touchled_1.set_brightness(0)

المحصلون #

pressing #

الضغط على pressing يُرجع عددًا صحيحًا يشير إلى ما إذا كان يتم الضغط على مؤشر LED اللمسي حاليًا.

1 — يتم الضغط على زر TouchLED.
0 — لم يتم الضغط على زر TouchLED.

Usage:
touchled_1.pressing()

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

# Turn TouchLED green when touched
while True:
    if touchled_1.pressing():
        touchled_1.set_color(Color.GREEN)
    else:
        touchled_1.set_color(Color.RED)
    wait(50, MSEC)

installed #

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

True — يتم توصيل مؤشر LED الذي يعمل باللمس بالدماغ.
False — مؤشر LED اللمسي غير متصل بالدماغ.

Usage:
touchled_1.installed()

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

المُنشئون #

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

Touchled #

Touchled يُنشئ مؤشر LED يعمل باللمس.

Usage:
touchled_1 = Touchled(smartport)

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

# Create a Touchled in Port 1
touchled_1 = Touchled(Ports.PORT1)