LED αφής#

Εισαγωγή#

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

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

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 του αισθητήρα αφής LED σε ένα συγκεκριμένο χρώμα.

Available Functions

1 — Ορίζει το LED αφής σε ένα χρώμα χρησιμοποιώντας vex::color.

void setColor( 
  vex::color  color );

2 — Sets LED colors using a colorType.

void setColor( 
  colorType   color );

Parameters

Παράμετρος

Τύπος

Περιγραφή

color

colorType

Ένα έγκυρο χρώμα:

  • 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

Η ταχύτητα στην οποία θα ρυθμιστεί η σταδιακή μείωση της έντασης του ήχου:

  • 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 χρησιμοποιώντας την απόχρωση.

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

Ένα έγκυρο χρώμα:

  • 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

Αυτή η συνάρτηση δεν επιστρέφει τιμή.

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.