LED αφής#

Εισαγωγή #

Η λυχνία LED αφής VEX IQ είναι ταυτόχρονα φως και κουμπί. Μπορεί να ανάβει σε διαφορετικά χρώματα για να δώσει ανατροφοδότηση, όπως να σηματοδοτήσει ότι το ρομπότ είναι έτοιμο, να δείξει ποια λειτουργία έχει επιλεγεί ή να αντιστοιχίσει ένα χρώμα που ανιχνεύεται από έναν άλλο αισθητήρα και μπορεί να ανιχνεύσει πότε το αγγίζετε, επιτρέποντάς σας να ξεκινήσετε ή να αλλάξετε τη συμπεριφορά ενός ρομπότ με ένα άγγιγμα.

Κατασκευαστής κλάσης #

touchled( 
  int32_t index );

Καταστροφέας κλάσης #

Destroys the touchled object and releases associated resources.

virtual ~touchled();

Παράμετροι #

Παράμετρος	Τύπος	Περιγραφή
`index`	`int32_t`	The Smart Port that the Touch LED is connected to, written as `PORTx`, where `x` is the port number (for example, `PORT1`).

Παράδειγμα #

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

Συναρτήσεις Μελών #

The touchled class includes the following member functions:

pressing – Returns whether the Touch LED is being pressed.
setColor – Sets the color of the Touch LED.
setFade – Sets how fast colors will fade to one another.
setBrightness – Sets the brightness of the Touch LED.
pressed – Registers a function to be called when the Touch LED is pressed.
released – Registers a function to be called when the Touch LED is released.
on – Turns the Touch LED on.
off – Turns the Touch LED off.
setBlink – Alternate the Touch LED on and off indefinitely.
installed – Returns whether the Touch LED is connected to the Brain.

Before calling any touchled member functions, a touchled instance must be created, as shown below:

/* 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

Returns an bool indicating whether the Touch LED is being pressed.

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

setColor #

Ρυθμίζει τη λυχνία LED του αισθητήρα αφής LED σε ένα συγκεκριμένο χρώμα.

Available Functions

1 — Sets the Touch LED to a color using vex::color.
void setColor( 
  vex::color  color );

2 — Sets LED colors using a 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 #

Ορίζει τη ρύθμιση fade του αισθητήρα αφής LED. Ο αισθητήρας αφής LED θα αλλάξει σε νέα χρώματα χρησιμοποιώντας τον τύπο fade.

Available Functions

void setFade(
  fadeType  speed );

Parameters

Παράμετρος	Τύπος	Περιγραφή
`speed`	`fadeType`	The speed the fade will be set to: `fast` `off` — no fade `slow`

Παράμετρος

Τύπος

Περιγραφή

speed

fadeType

The speed the fade will be set to:

fast
off — no fade
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

Define the callback function (outside of int main())

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

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

Define the callback function (outside of int main())

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

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 χρησιμοποιώντας την απόχρωση.
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 — Sets the blink color using a 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 — Sets the blink color using a 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`	A hex color value (e.g., `0xFF0000` for red).
`color`	`vex::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.