Αισθητήρας απόστασης#

Εισαγωγή#

The sonar class is used with the VEX IQ Distance Sensor (1st gen). The distance class is used with the VEX IQ Distance Sensor (2nd gen).

Και οι δύο αισθητήρες απόστασης μπορούν να ανιχνεύσουν εάν ένα αντικείμενο βρίσκεται μπροστά από τον αισθητήρα και να επιστρέψουν την απόσταση που βρίσκεται αυτό το αντικείμενο. Ο αισθητήρας απόστασης VEX IQ (2ης γενιάς) μπορεί επίσης να επιστρέψει τη σχετική ταχύτητα του ανιχνευμένου αντικειμένου και να εκτιμήσει εάν το αντικείμενο είναι μικρό, μεσαίο ή μεγάλο.

Κατασκευαστές κλάσεων#

1 — Αυτός ο κατασκευαστής δημιουργεί έναν αισθητήρα απόστασης VEX IQ (1ης γενιάς).

sonar(
    int32_t index);

2 — Αυτός ο κατασκευαστής δημιουργεί έναν αισθητήρα απόστασης VEX IQ (2ης γενιάς).

distance(
    int32_t index);

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

Destroys the distance object and releases associated resources.

1 — Καταστρέφει έναν αισθητήρα απόστασης VEX IQ (1ης γενιάς).

~sonar();

2 — Καταστρέφει έναν αισθητήρα απόστασης VEX IQ (2ης γενιάς).

~distance();

Παράμετροι#

Παράμετρος

Τύπος

Περιγραφή

index

int32_t

The Smart Port that the Distance Sensor is connected to, written as PORTx, where x is the port number (for example, PORT1).

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

1 — Δημιουργήστε μια παρουσία του αισθητήρα απόστασης VEX IQ (1ης γενιάς) στη θύρα 1.

sonar Distance1 = sonar(PORT1);

2 — Δημιουργήστε μια παρουσία του VEX IQ Distance Sensor (2ης γενιάς) στη Θύρα 1.

distance Distance1 = distance(PORT1);

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

The sonar class includes the following member functions:

  • foundObject — Returns whether the Distance Sensor currently detects an object.

  • distance — Returns the distance between the Distance Sensor and the nearest detected object.

The distance class includes the following member functions:

  • objectDistance — Returns the distance between the Distance Sensor and the nearest detected object.

  • objectVelocity — Returns how quickly the detected object is moving toward or away from the Distance Sensor.

  • objectSize — Returns the estimated size of the detected object.

  • isObjectDetected — Returns whether the Distance Sensor currently detects an object.

  • changed — Registers a callback function that runs when the detected distance value changes.

  • installed — Returns whether the Distance Sensor is installed and connected.

Before calling any distance or sonar member functions, a distance or sonar instance must be created, as shown below:

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

// Create a VEX IQ Distance Sensor (2nd gen) instance in Port 1
distance Distance1 = distance(PORT1);

foundObject#

Επιστρέφει εάν ο αισθητήρας απόστασης ανιχνεύει αυτήν τη στιγμή ένα αντικείμενο.

Available Functions 
bool foundObject();
Parameters

Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.

Return Values

Επιστρέφει μια λογική τιμή που υποδεικνύει εάν ο αισθητήρας απόστασης ανιχνεύει ένα αντικείμενο:

  • true — The Distance Sensor detects an object.
  • false — The Distance Sensor does not detect an object.
Notes - This is a VEX IQ Distance Sensor (1st gen) function.

distance#

Επιστρέφει την απόσταση μεταξύ του αισθητήρα απόστασης και του πλησιέστερου αντικειμένου που ανιχνεύθηκε.

Available Functions 
double distance( distanceUnits units );
Parameters

Παράμετρος

Τύπος

Περιγραφή

units

distanceUnits

The distance unit:

  • mm — millimeters (24 mm to 1000 mm)
  • cm — centimeters (2.4 cm to 100 cm)
  • inches — inches (1 inch to 40 inches)
Return Values

Returns a double representing the distance between the Distance Sensor and the nearest detected object in the specified units.

Notes - This is a VEX IQ Distance Sensor (1st gen) function.

objectDistance#

Επιστρέφει την απόσταση μεταξύ του αισθητήρα απόστασης και του πλησιέστερου αντικειμένου που ανιχνεύθηκε.

Available Functions 
double objectDistance( distanceUnits units );
Parameters

Παράμετρος

Τύπος

Περιγραφή

units

distanceUnits

The distance unit:

  • mm — millimeters (20 mm to 2000 mm)
  • cm — centimeters (2 cm to 200 cm)
  • inches — inches (0.78 inches to 78 inches)
Return Values

Returns a double representing the distance between the Distance Sensor and the nearest detected object in the specified units.

Notes - This is a VEX IQ Distance Sensor (2nd gen) function.

objectVelocity#

Επιστρέφει τη σχετική ταχύτητα του ανιχνευμένου αντικειμένου.

Η ταχύτητα δείχνει πόσο γρήγορα κινείται το αντικείμενο προς ή μακριά από τον αισθητήρα απόστασης. Μια τιμή κοντά στο 0 σημαίνει ότι το αντικείμενο δεν κινείται πολύ σε σχέση με τον αισθητήρα.

Available Functions 
double objectVelocity();
Parameters

Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.

Return Values

Returns a double representing the relative velocity of the detected object in m/s (meters per second).

Notes - This is a VEX IQ Distance Sensor (2nd gen) function.

objectSize#

Επιστρέφει το εκτιμώμενο μέγεθος του αντικειμένου που ανιχνεύεται από τον αισθητήρα απόστασης.

Ο αισθητήρας απόστασης εκτιμά το μέγεθος του αντικειμένου με βάση το πόσο μεγάλο μέρος της ορατότητας του αισθητήρα καταλαμβάνεται από το ανιχνευόμενο αντικείμενο.

Available Functions 
sizeType objectSize();
Parameters

Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.

Return Values

Returns a sizeType indicating the estimated size of the detected object:

  • none — No object is detected.
  • small — A small object is detected.
  • medium — A medium object is detected.
  • large — A large object is detected.
Notes - This is a VEX IQ Distance Sensor (2nd gen) function.

isObjectDetected#

Επιστρέφει εάν ο αισθητήρας απόστασης ανιχνεύει αυτήν τη στιγμή ένα αντικείμενο.

Available Functions 
bool isObjectDetected();
Parameters

Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.

Return Values

Επιστρέφει μια λογική τιμή που υποδεικνύει εάν ο αισθητήρας απόστασης ανιχνεύει ένα αντικείμενο:

  • true — The Distance Sensor detects an object.
  • false — The Distance Sensor does not detect an object.
Notes - This is a VEX IQ Distance Sensor (2nd gen) function.

changed#

Καταγράφει μια συνάρτηση επανάκλησης που εκτελείται όταν αλλάζει η τιμή της ανιχνευμένης απόστασης.

Available Functions 
void changed( void (* callback)(void) );
Parameters

Παράμετρος

Τύπος

Περιγραφή

callback

void (*)(void)

A pointer to a function that will be called when the detected distance value changes. The function must take no parameters and return void.
Return Values

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

Notes - This is a VEX IQ Distance Sensor (1st gen) or (2nd gen) function.

installed#

Επιστρέφει εάν ο αισθητήρας απόστασης είναι εγκατεστημένος και συνδεδεμένος.

Available Functions 
bool installed();
Parameters

Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.

Return Values

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

  • true — The Distance Sensor is installed and connected.
  • false — The Distance Sensor is not installed or not connected.
Notes - This is a VEX IQ Distance Sensor (1st gen) or (2nd gen) function.
On this page