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

مقدمة

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

مُنشئ الفئة

touchled( 
  int32_t index );

مُدمِّر الفئة

يقوم بتدمير الكائن الذي تم لمسه touchled الموارد المرتبطة به.

virtual ~touchled();

حدود

المعلمة	يكتب	وصف
index	int32_t	المنفذ الذكي الذي يتصل به مؤشر LED الذي يعمل باللمس، مكتوبًا على النحو التالي: PORTx، حيث x هو رقم المنفذ (على سبيل المثال، PORT1).

مثال

// Create a touchled instance in Port 1
touchled TouchLED1 = touchled(PORT1);

الدوال الأعضاء

تتضمن الفئة touchled الدوال الأعضاء التالية:

• pressing – إرجاع ما إذا كان يتم الضغط على مؤشر LED اللمسي.

• setColor – يحدد لون مؤشر LED اللمسي.

• setFade – يحدد مدى سرعة تلاشي الألوان إلى بعضها البعض.

• setBrightness – يضبط سطوع مؤشر LED اللمسي.

• pressed – يسجل وظيفة ليتم استدعاؤها عند الضغط على مؤشر LED اللمسي.

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

• on – تشغيل مؤشر LED الذي يعمل باللمس.

• off – يقوم بإيقاف تشغيل مؤشر LED الذي يعمل باللمس.

• setBlink – تشغيل وإيقاف مؤشر اللمس LED بشكل متبادل إلى أجل غير مسمى.

• installed – إرجاع ما إذا كان مؤشر LED اللمسي متصلاً بالدماغ.

قبل استدعاء أي من الدوال الأعضاء touchled ، يجب إنشاء مثيل touchled ، كما هو موضح أدناه:

/* This constructor is required when using VS Code.
Touch LED configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create a Touch LED instance in Port 1
touchled TouchLED1 = touchled(PORT1);

pressing

يتم إرجاع القيمة إذا كان يتم الضغط على زر TouchLED حاليًا.

Available Functions

bool pressing();

Parameters

لا تقبل هذه الدالة أي معلمات.

Return Values

يُرجع قيمة منطقية bool تشير إلى ما إذا كان يتم الضغط على مؤشر LED اللمسي.

• true — The Touch LED is being pressed.
• false — The Touch LED is not being pressed.

setColor

يضبط مؤشر LED الخاص بمستشعر اللمس على لون محدد.

Available Functions

1 — يضبط لون مؤشر LED اللمسي باستخدام vex::color.

void setColor( 
  vex::color  color );

2 — يحدد ألوان LED باستخدام نوع اللون colorType.

void setColor( 
  colorType   color );

Parameters

المعلمة	يكتب	وصف
color	colorType	A valid color: blue blue_green blue_violet green orange purple red red_orange red_violet violet white yellow yellow_green yellow_orange colorType::none black transparent
color	vex::color	A valid custom color.

Return Values

هذه الدالة لا تُرجع قيمة.

setFade

يُحدد هذا الخيار إعداد التلاشي لمستشعر LED اللمسي. سيتغير لون مستشعر LED اللمسي إلى ألوان جديدة باستخدام نوع التلاشي.

Available Functions

void setFade(
  fadeType  speed );

Parameters

المعلمة	يكتب	وصف
speed	fadeType	سيتم ضبط سرعة التلاشي على: fast off — بدون تلاشي slow

Return Values

هذه الدالة لا تُرجع قيمة.

setBrightness

يضبط سطوع مؤشر LED الذي يعمل باللمس.

Available Functions

void setBrightness(
  uint32_t  value );

Parameters

المعلمة	يكتب	وصف
value	uint32_t	يمكن ضبط سطوع مؤشر LED اللمسي كنسبة مئوية.

Return Values

هذه الدالة لا تُرجع قيمة.

pressed

يسجل وظيفة ليتم استدعاؤها عند الضغط على مؤشر LED اللمسي.

Available Functions

void pressed( void (* callback)(void) );

Parameters

المعلمة	يكتب	وصف
callback	void (*)(void)	مؤشر إلى دالة سيتم استدعاؤها عند الضغط على مؤشر LED اللمسي. يجب ألا تأخذ الدالة أي معلمات وأن تُرجع قيمة فارغة (void).

Return Values

هذه الدالة لا تُرجع قيمة.

Examples

عرّف دالة الاستدعاء (خارج نطاق int main())

// Display a message when LED is pressed
void LEDPressed() {
  Brain.Screen.print("LED pressed");
}

قم بتسجيل دالة الاستدعاء داخل الدالة الرئيسية int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run LEDPressed when the value of the Touch LED is pressed.
  TouchLED1.pressed(LEDPressed);
}

released

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

Available Functions

void released( void (* callback)(void) );

Parameters

المعلمة	يكتب	وصف
callback	void (*)(void)	مؤشر إلى دالة سيتم استدعاؤها عند تحرير مؤشر LED اللمسي. يجب ألا تأخذ الدالة أي معلمات وأن تُرجع قيمة فارغة (void).

Return Values

هذه الدالة لا تُرجع قيمة.

Examples

عرّف دالة الاستدعاء (خارج نطاق int main())

// Display a message when LED is released
void LEDReleased() {
  Brain.Screen.print("LED released");
}

قم بتسجيل دالة الاستدعاء داخل الدالة الرئيسية int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Run LEDReleased when the value of the Touch LED is released.
  TouchLED1.released(LEDReleased);
}

on

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

Available Functions

1 — يقوم بتعيين لون LED باستخدام vex::color.

void on( 
  vex::color    color, 
  uint32_t      brightness = 100 );

2 — يحدد لون LED باستخدام hue.

void on( 
  uint32_t hue, 
  uint32_t brightness = 100);

3 — يحدد لون LED بواسطة قيم RGB.

void on( 
  uint8_t   red, 
  uint8_t   green, 
  uint8_t   blue, 
  uint32_t  brightness = 100);

Parameters

المعلمة	يكتب	وصف
color	vex::color	A valid color: blue blue_green blue_violet green orange purple red red_orange red_violet violet white yellow yellow_green yellow_orange colorType::none black transparent
brightness	uint32_t	اختياري. مستوى السطوع الذي يتم ضبط مؤشر LED عليه كنسبة مئوية، والقيمة الافتراضية هي 100.
hue	uint32_t	لون مصباح LED. ويمكن تمثيل ذلك أيضًا بقيمة رمز سداسي عشري (0x000000).
red	uint8_t	عدد صحيح يمثل قيمة اللون الأحمر لمؤشر LED.
green	uint8_t	عدد صحيح يمثل قيمة اللون الأخضر لمؤشر LED.
blue	uint8_t	عدد صحيح يمثل قيمة اللون الأزرق لمؤشر LED.

Return Values

هذه الدالة لا تُرجع قيمة.

off

يقوم بإيقاف تشغيل مؤشر LED الذي يعمل باللمس.

Available Functions

void off( void );

Parameters

لا تأخذ هذه الدالة أي معلمات.

Return Values

هذه الدالة لا تُرجع قيمة.

setBlink

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

Available Functions

1 — يحدد لون الوميض باستخدام vex::color vex::color.

void setBlink( 
  vex::color    color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

2 — يحدد لون الوميض باستخدام قيمة لون سداسية عشرية.

void setBlink( 
  uint32_t      hue, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

3 — يحدد لون الوميض باستخدام نوع اللون colorType.

void setBlink( 
  colorType     color, 
  double        onTime = 0.25,
  double        offTime = 0.25 );

Parameters

المعلمة	يكتب	وصف
color	colorType	A valid color: blue blue_green blue_violet green orange purple red red_orange red_violet violet white yellow yellow_green yellow_orange colorType::none black transparent
onTime	double	اختياري. مدة إضاءة مؤشر LED بالثواني لكل دورة وميض، والقيمة الافتراضية هي 0.25 ثانية.
offTime	double	اختياري. مدة انطفاء مؤشر LED بالثواني لكل دورة وميض، والقيمة الافتراضية هي 0.25 ثانية.
hue	uint32_t	قيمة لون سداسية عشرية (على سبيل المثال، 0xFF0000 للون الأحمر).
color	vex::color	A valid custom color.

Return Values

هذه الدالة لا تُرجع قيمة.

Notes - Calling [off](#off) will not stop the blinking behavior. To stop the blinking behavior, set the LED brightness to 0 with [setBrightness](#setbrightness).

installed

يُظهر ما إذا كان مؤشر LED اللمسي متصلاً أم لا.

Available Functions

bool installed();

Parameters

لا تأخذ هذه الدالة أي معلمات.

Return Values

يُرجع قيمة منطقية تشير إلى ما إذا كان مؤشر LED اللمسي متصلاً أم لا:

• true — The sensor is connected and responding.
• false — The sensor is not connected or not detected.