LED αφής#
Εισαγωγή#
Η λυχνία LED αφής VEX IQ είναι ταυτόχρονα φως και κουμπί. Μπορεί να ανάβει σε διαφορετικά χρώματα για να δώσει ανατροφοδότηση, όπως να σηματοδοτήσει ότι το ρομπότ είναι έτοιμο, να δείξει ποια λειτουργία έχει επιλεγεί ή να αντιστοιχίσει ένα χρώμα που ανιχνεύεται από έναν άλλο αισθητήρα και μπορεί να ανιχνεύσει πότε το αγγίζετε, επιτρέποντάς σας να ξεκινήσετε ή να αλλάξετε τη συμπεριφορά ενός ρομπότ με ένα άγγιγμα.
Κατασκευαστής κλάσης#
touchled(
int32_t index );
Καταστροφέας κλάσης#
Καταστρέφει το αντικείμενο touchled και απελευθερώνει τους σχετικούς πόρους.
virtual ~touchled();
Παράμετροι#
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
Η Έξυπνη Θύρα στην οποία είναι συνδεδεμένη η λυχνία LED αφής, γράφεται ως |
Παράδειγμα#
// 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 Functionsbool pressing();
Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.
Return ValuesΕπιστρέφει μια τιμή bool που υποδεικνύει εάν είναι πατημένο το LED αφής.
-
true— The Touch LED is being pressed. -
false— The Touch LED is not being pressed.
setColor#
Ρυθμίζει τη λυχνία LED του αισθητήρα αφής LED σε ένα συγκεκριμένο χρώμα.
Available Functions1 — Ορίζει το LED αφής σε ένα χρώμα χρησιμοποιώντας
vex::color.void setColor( vex::color color );
Parameters2 — Sets LED colors using a
colorType.void setColor( colorType color );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
Ένα έγκυρο χρώμα:
|
|
|
Ένα έγκυρο προσαρμοσμένο χρώμα. |
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
setFade#
Ορίζει τη ρύθμιση fade του αισθητήρα αφής LED. Ο αισθητήρας αφής LED θα αλλάξει σε νέα χρώματα χρησιμοποιώντας τον τύπο fade.
Available Functionsvoid setFade(
fadeType speed );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
Η ταχύτητα στην οποία θα ρυθμιστεί η σταδιακή μείωση της έντασης του ήχου:
|
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
setBrightness#
Ρυθμίζει τη φωτεινότητα της λυχνίας LED αφής.
Available Functionsvoid setBrightness(
uint32_t value );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
Η φωτεινότητα της λυχνίας LED αφής θα οριστεί ως ποσοστό. |
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
pressed#
Καταγράφει μια λειτουργία που θα κληθεί όταν πατηθεί η λυχνία LED αφής.
Available Functionsvoid pressed( void (* callback)(void) );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
Ένας δείκτης προς μια συνάρτηση που θα κληθεί όταν πατηθεί η λυχνία LED αφής. Η συνάρτηση δεν πρέπει να δέχεται παραμέτρους και να επιστρέφει void. |
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
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 Functionsvoid released( void (* callback)(void) );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
Ένας δείκτης προς μια συνάρτηση που θα κληθεί όταν απελευθερωθεί η λυχνία LED αφής. Η συνάρτηση δεν πρέπει να δέχεται παραμέτρους και να επιστρέφει void. |
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
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 Functions1 — Ορίζει το LED σε ένα χρώμα χρησιμοποιώντας την εντολή vex::color.
void on( vex::color color, uint32_t brightness = 100 );
2 — Ορίζει το χρώμα της LED χρησιμοποιώντας την απόχρωση.
void on( uint32_t hue, uint32_t brightness = 100);
Parameters3 — Ορίζει το χρώμα της λυχνίας LED με βάση τις τιμές RGB.
void on( uint8_t red, uint8_t green, uint8_t blue, uint32_t brightness = 100);
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
Ένα έγκυρο χρώμα:
|
|
|
Προαιρετικό. Η φωτεινότητα στην οποία θα οριστεί η λυχνία LED σε ποσοστό, με προεπιλεγμένη τιμή 100. |
|
|
Η απόχρωση της λυχνίας LED. Αυτή μπορεί επίσης να αναπαρασταθεί ως τιμή δεκαεξαδικού κώδικα (0x000000). |
|
|
Ένας ακέραιος αριθμός που αντιπροσωπεύει την κόκκινη τιμή του LED. |
|
|
Ένας ακέραιος αριθμός που αντιπροσωπεύει την πράσινη τιμή του LED. |
|
|
Ένας ακέραιος αριθμός που αντιπροσωπεύει την μπλε τιμή του LED. |
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
off#
Απενεργοποιεί τη λυχνία LED αφής.
Available Functionsvoid off( void );
Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.
Return ValuesΑυτή η συνάρτηση δεν επιστρέφει τιμή.
setBlink#
Αναβοσβήνει επανειλημμένα η λυχνία LED αφής με μοτίβο ενεργοποίησης και απενεργοποίησης.
Available Functions1 — Ορίζει το χρώμα αναλαμπής χρησιμοποιώντας την τιμή
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 );
Parameters3 — Sets the blink color using a
colorType.void setBlink( colorType color, double onTime = 0.25, double offTime = 0.25 );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
Ένα έγκυρο χρώμα:
|
|
|
Προαιρετικά. Η διάρκεια σε δευτερόλεπτα που θα είναι αναμμένη η λυχνία LED ανά κύκλο αναλαμπής, με προεπιλογή 0,25 δευτερόλεπτα. |
|
|
Προαιρετικά. Η διάρκεια σε δευτερόλεπτα που θα είναι σβηστή η λυχνία LED ανά κύκλο αναλαμπής, με προεπιλογή 0,25 δευτερόλεπτα. |
|
|
Η απόχρωση της λυχνίας LED. Αυτή μπορεί επίσης να αναπαρασταθεί με μια τιμή δεκαεξαδικού κώδικα. |
|
|
Ένα έγκυρο προσαρμοσμένο χρώμα. |
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
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 Functionsbool installed();
Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.
Return ValuesΕπιστρέφει μια λογική τιμή που υποδεικνύει εάν η LED αφής είναι συνδεδεμένη:
-
true— The sensor is connected and responding. -
false— The sensor is not connected or not detected.