Αισθητήρας φωτός

Εισαγωγή

Η κλάση light χρησιμοποιείται με τον Αισθητήρα Φωτός, ο οποίος μετρά τη φωτεινότητα του φωτός που ανακλάται από ή λάμπει πάνω σε ένα αντικείμενο. Εξάγει μια αναλογική τιμή που αντιπροσωπεύει την ποσότητα φωτός που ανιχνεύεται.

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

light(
  triport::port &port );

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

Καταστρέφει το αντικείμενο light και απελευθερώνει τους σχετικούς πόρους.

virtual ~light();

Παράμετροι

Παράμετρος	Τύπος	Περιγραφή
port	triport::port &	Η θύρα 3 καλωδίων στην οποία είναι συνδεδεμένος ο αισθητήρας φωτός, γραμμένη ως Brain.ThreeWirePort.X ή ExpanderName.X, όπου X είναι το γράμμα της θύρας (για παράδειγμα, Brain.ThreeWirePort.A ή Expander1.A).

Παραδείγματα

// Create a light instance in Port A
light LightA = light(Brain.ThreeWirePort.A);

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

Η κλάση light περιλαμβάνει τις ακόλουθες συναρτήσεις-μέλη:

• brightness — Επιστρέφει την ποσότητα φωτός που ανιχνεύεται από τον αισθητήρα φωτός.

Πριν από την κλήση οποιασδήποτε συνάρτησης μέλους light , πρέπει να δημιουργηθεί μια παρουσία light , όπως φαίνεται παρακάτω:

/* This constructor is required when using VS Code.
Light Sensor configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create a light instance in Port A
light LightA = light(Brain.ThreeWirePort.A);

brightness

Επιστρέφει την ποσότητα φωτός που ανιχνεύεται από τον αισθητήρα φωτός. Αυτό μπορεί να χρησιμοποιηθεί για να ελέγξει εάν ένα αντικείμενο είναι αρκετά φωτεινό ώστε να αναφέρει με ακρίβεια άλλα οπτικά δεδομένα.

Available Functions

int32_t brightness(
  percentUnits units = percentUnits::pct );

Parameters

Παράμετρος	Τύπος	Περιγραφή
units	percentUnits	Η μονάδα που αντιπροσωπεύει τη φωτεινότητα: percent / pct (προεπιλογή) — τοις εκατό

Return Values

Επιστρέφει μια τιμή int32_t που αντιπροσωπεύει τη φωτεινότητα που μετριέται από τον αισθητήρα φωτός ως ποσοστό στην περιοχή 0 - 100%.

Examples

// Get Light Sensor brightness in range of 0% - 100%.
int32_t value = LightA.brightness();

// Print the brightness of the Light Sensor to the
// Brain's screen.
Brain.Screen.print(value);