टच एलईडी#

परिचय#

VEX IQ टच एलईडी एक लाइट और बटन दोनों का काम करती है। यह अलग-अलग रंगों में चमक सकती है, जिससे रोबोट के तैयार होने का संकेत, चयनित मोड का प्रदर्शन या किसी अन्य सेंसर द्वारा पता लगाए गए रंग से मेल खाने जैसी प्रतिक्रिया मिलती है। यह स्पर्श किए जाने का भी पता लगा सकती है, जिससे आप एक टैप से रोबोट के व्यवहार को शुरू या बदल सकते हैं।

क्लास कंस्ट्रक्टर#

touchled( 
  int32_t index );

क्लास डिस्ट्रक्टर#

touchled वस्तु को नष्ट करता है और उससे संबंधित संसाधनों को मुक्त करता है।

virtual ~touchled();

पैरामीटर#

पैरामीटर

प्रकार

विवरण

index

int32_t

स्मार्ट पोर्ट जिससे टच एलईडी जुड़ा हुआ है, उसे PORTxके रूप में लिखा जाता है, जहां x पोर्ट संख्या है (उदाहरण के लिए, PORT1)।

उदाहरण#

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

सदस्य कार्य#

touchled क्लास में निम्नलिखित सदस्य फ़ंक्शन शामिल हैं:

  • pressing – यह बताता है कि टच एलईडी दबाई जा रही है या नहीं।

  • setColor – टच एलईडी का रंग सेट करता है।

  • setFade – यह सेट करता है कि रंग एक दूसरे में कितनी तेजी से फीके पड़ेंगे।

  • setBrightness – टच एलईडी की चमक सेट करता है।

  • pressed – टच एलईडी दबाए जाने पर कॉल किए जाने वाले फ़ंक्शन को रजिस्टर करता है।

  • released – टच एलईडी रिलीज़ होने पर कॉल किए जाने वाले फ़ंक्शन को रजिस्टर करता है।

  • on – टच एलईडी चालू करता है.

  • off – टच एलईडी बंद कर देता है।

  • setBlink – टच एलईडी को अनिश्चित काल तक चालू और बंद करें।

  • installed – यह बताता है कि टच एलईडी ब्रेन से कनेक्टेड है या नहीं।

किसी भी 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#

यदि टचएलईडी वर्तमान में दबा हुआ है तो यह जानकारी वापस लौटाता है।

Available Functions
bool pressing();

Parameters

यह फ़ंक्शन कोई पैरामीटर स्वीकार नहीं करता है।

Return Values

यह मान bool लौटाता है जो दर्शाता है कि टच एलईडी दबाई जा रही है या नहीं।

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

setColor#

टच एलईडी सेंसर की एलईडी को एक विशिष्ट रंग पर सेट करता है।

Available Functions

1 — vex::color का उपयोग करके टच एलईडी को एक रंग पर सेट करता है।

void setColor( 
  vex::color  color );

2 — 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

एक वैध कस्टम रंग।

Return Values

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

setFade#

टच एलईडी सेंसर की फ़ेड सेटिंग सेट करता है। फ़ेड प्रकार का उपयोग करके टच एलईडी सेंसर नए रंगों में परिवर्तित हो जाएगा।

Available Functions
void setFade(
  fadeType  speed );

Parameters

पैरामीटर

प्रकार

विवरण

speed

fadeType

फ़ेड की गति इस प्रकार सेट की जाएगी:

  • fast
  • off — कोई फ़ेड नहीं
  • slow

Return Values

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

setBrightness#

टच एलईडी की चमक को सेट करता है।

Available Functions
void setBrightness(
  uint32_t  value );

Parameters

पैरामीटर

प्रकार

विवरण

value

uint32_t

टच एलईडी की चमक को प्रतिशत के रूप में सेट किया जा सकता है।

Return Values

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

pressed#

टच एलईडी दबाए जाने पर कॉल किए जाने वाले फ़ंक्शन को पंजीकृत करता है।

Available Functions
void pressed( void (* callback)(void) );

Parameters

पैरामीटर

प्रकार

विवरण

callback

void (*)(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#

टच एलईडी को छोड़ने पर कॉल किए जाने वाले फ़ंक्शन को पंजीकृत करता है।

Available Functions
void released( void (* callback)(void) );

Parameters

पैरामीटर

प्रकार

विवरण

callback

void (*)(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#

यह टचएलईडी सेंसर के एलईडी को रंगों और निर्धारित चमक का उपयोग करके चालू करता है।

Available Functions

1 — vex::color का उपयोग करके LED को एक रंग पर सेट करता है।

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

2 — ह्यू का उपयोग करके एलईडी का रंग सेट करता है।

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

3 — आरजीबी मानों द्वारा एलईडी रंग सेट करता है।

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

यह विकल्प वैकल्पिक है। एलईडी की चमक को प्रतिशत में सेट करें, डिफ़ॉल्ट मान 100 है।

hue

uint32_t

एलईडी का रंग। इसे हेक्सकोड मान (0x000000) के रूप में भी दर्शाया जा सकता है।

red

uint8_t

एलईडी के लाल रंग के मान को दर्शाने वाला एक पूर्णांक।

green

uint8_t

एलईडी के हरे रंग के मान को दर्शाने वाला एक पूर्णांक।

blue

uint8_t

एलईडी के नीले रंग के मान को दर्शाने वाला एक पूर्णांक।

Return Values

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

off#

टच एलईडी को बंद कर देता है।

Available Functions
void off( void );

Parameters

यह फ़ंक्शन कोई पैरामीटर नहीं लेता है।

Return Values

इस कार्य पर कीमत के लिहाज से कुछ भी रिटर्न नहीं मिलता है।

installed#

यह बताता है कि टच एलईडी कनेक्टेड है या नहीं।

Available Functions
bool installed();

Parameters

यह फ़ंक्शन कोई पैरामीटर नहीं लेता है।

Return Values

यह एक बूलियन मान लौटाता है जो दर्शाता है कि टच एलईडी कनेक्टेड है या नहीं:

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