LED αφής#
Εισαγωγή#
Η λυχνία LED αφής VEX IQ είναι ταυτόχρονα φως και κουμπί. Μπορεί να ανάβει σε διαφορετικά χρώματα για να δώσει ανατροφοδότηση, όπως να σηματοδοτήσει ότι το ρομπότ είναι έτοιμο, να δείξει ποια λειτουργία έχει επιλεγεί ή να αντιστοιχίσει ένα χρώμα που ανιχνεύεται από έναν άλλο αισθητήρα και μπορεί να ανιχνεύσει πότε το αγγίζετε, επιτρέποντάς σας να ξεκινήσετε ή να αλλάξετε τη συμπεριφορά ενός ρομπότ με ένα άγγιγμα.
Κατασκευαστής κλάσης#
touchled(
int32_t index );
Καταστροφέας κλάσης#
Καταστρέφει το αντικείμενο touchled και απελευθερώνει τους σχετικούς πόρους.
virtual ~touchled();
Παράμετροι#
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
Η Έξυπνη Θύρα στην οποία είναι συνδεδεμένη η λυχνία LED αφής, γράφεται ως |
Παράδειγμα#
// Create a touchled instance in Port 1
touchled TouchLED1 = touchled(PORT1);
Συναρτήσεις Μελών#
Η κλάση touchled περιλαμβάνει τις ακόλουθες συναρτήσεις-μέλη:
πατώντας– Επιστρέφει εάν πατιέται η λυχνία LED αφής.setColor– Ορίζει το χρώμα της λυχνίας LED αφής.setFade– Ορίζει την ταχύτητα με την οποία τα χρώματα θα ξεθωριάζουν το ένα στο άλλο.setBrightness– Ορίζει τη φωτεινότητα της λυχνίας LED αφής.πατημένο– Καταγράφει μια λειτουργία που θα κληθεί όταν πατηθεί η λυχνία LED αφής.released– Καταγράφει μια συνάρτηση που θα κληθεί όταν απελευθερωθεί η λυχνία LED αφής.σε– Ανάβει την λυχνία LED αφής.off– Απενεργοποιεί την λυχνία LED αφής.setBlink– Εναλλαγή ενεργοποίησης και απενεργοποίησης της λυχνίας LED αφής επ’ αόριστον.εγκατεστημένο– Επιστρέφει εάν η λυχνία 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 );
2 — Ορίζει τα χρώματα των LED χρησιμοποιώντας έναν τύπο χρώματος με τιμή
.void setColor( colorType color );
Parameters
Παράμετρος
Τύπος
Περιγραφή
color
colorType
Ένα έγκυρο χρώμα:
μπλε μπλε_πράσινο μπλε_βιολετί πράσινο πορτοκαλί μωβ κόκκινο κόκκινο_πορτοκαλί κόκκινο_βιολετί βιολετί λευκό κίτρινο κίτρινο_πράσινο κίτρινο_πορτοκαλί colorType::none μαύρο διαφανές
color
vex::color
Ένα έγκυρο προσαρμοσμένο χρώμα.
Return Values
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
setFade#
Ορίζει τη ρύθμιση fade του αισθητήρα αφής LED. Ο αισθητήρας αφής LED θα αλλάξει σε νέα χρώματα χρησιμοποιώντας τον τύπο fade.
Available Functions
void setFade(
fadeType speed );
Parameters
Παράμετρος
Τύπος
Περιγραφή
speed
fadeType
Η ταχύτητα στην οποία θα ρυθμιστεί η σταδιακή μείωση της έντασης του ήχου:
γρήγορηαπενεργοποιημένη — χωρίς σταδιακή μείωση της έντασης του ήχουαργή
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
Ένα έγκυρο χρώμα:
μπλεμπλε_πράσινο μπλε_βιολετί πράσινο πορτοκαλί μωβ κόκκινο κόκκινο_πορτοκαλί κόκκινο_βιολετί βιολετί λευκό κίτρινο κίτρινο_πράσινο κίτρινο_πορτοκαλί colorType::none μαύρο διαφανές
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.
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 — Ορίζει το χρώμα αναλαμπής χρησιμοποιώντας έναν τύπο χρώματοςμε τιμή.void setBlink( colorType color, double onTime = 0.25, double offTime = 0.25 );
Parameters
Παράμετρος
Τύπος
Περιγραφή
color
colorType
Ένα έγκυρο χρώμα:
μπλε μπλε_πράσινο μπλε_βιολετί πράσινο πορτοκαλί μωβ κόκκινο κόκκινο_πορτοκαλί κόκκινο_βιολετί βιολετί λευκό κίτρινο κίτρινο_πράσινο κίτρινο_πορτοκαλί colorType::none μαύρο διαφανές
onTime
double
Προαιρετικά. Η διάρκεια σε δευτερόλεπτα που θα είναι αναμμένη η λυχνία LED ανά κύκλο αναλαμπής, με προεπιλογή 0,25 δευτερόλεπτα.
offTime
double
Προαιρετικά. Η διάρκεια σε δευτερόλεπτα που θα είναι σβηστή η λυχνία LED ανά κύκλο αναλαμπής, με προεπιλογή 0,25 δευτερόλεπτα.
hue
uint32_t
Μια δεκαεξαδική τιμή χρώματος (π.χ., 0xFF0000 για κόκκινο).
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.