Távolságérzékelő#

Bevezetés#

A sonar osztály a VEX IQ távolságérzékelővel (1. generáció) használatos. A distance osztály a VEX IQ távolságérzékelővel (2. generáció) használatos.

Mindkét távolságérzékelő képes érzékelni, hogy van-e tárgy az érzékelő előtt, és visszaadni a tárgy távolságát is. A VEX IQ távolságérzékelő (2. generáció) a detektált tárgy relatív sebességét is vissza tudja adni, és meg tudja becsülni, hogy a tárgy kicsi, közepes vagy nagy.

Osztálykonstruktorok#

1 — Ez a konstruktor egy VEX IQ távolságérzékelőt (1. generáció) hoz létre.

sonar(
    int32_t index);

2 — Ez a konstruktor egy VEX IQ távolságérzékelőt (2. generáció) hoz létre.

distance(
    int32_t index);

Osztálydestruktor#

Megsemmisíti a distance objektumot és felszabadítja a hozzá tartozó erőforrásokat.

1 — Megsemmisít egy VEX IQ távolságérzékelőt (1. generáció).

~sonar();

2 — Megsemmisít egy VEX IQ távolságérzékelőt (2. generáció).

~distance();

Paraméterek#

Paraméter

Típus

Leírás

index

int32_t

Az az intelligens port, amelyhez a távolságérzékelő csatlakozik, PORTxformátumban írva, ahol x a port száma (például PORT1).

Példák#

1 — Hozz létre egy VEX IQ távolságérzékelő (1. generációs) példányt az 1-es porton.

sonar Distance1 = sonar(PORT1);

2 — Hozz létre egy VEX IQ távolságérzékelő (2. generációs) példányt az 1-es porton.

distance Distance1 = distance(PORT1);

Tagfüggvények#

A sonar osztály a következő tagfüggvényeket tartalmazza:

  • foundObject — Visszaadja, hogy a távolságérzékelő jelenleg érzékel-e objektumot.

  • distance — Visszaadja a távolságérzékelő és a legközelebbi érzékelt tárgy közötti távolságot.

A distance osztály a következő tagfüggvényeket tartalmazza:

  • objectDistance — Visszaadja a távolságérzékelő és a legközelebbi érzékelt tárgy közötti távolságot.

  • objectVelocity — Visszaadja, hogy a detektált objektum milyen gyorsan mozog a távolságérzékelő felé vagy attól távolodva.

  • objectSize — Visszaadja az észlelt objektum becsült méretét.

  • isObjectDetected — Visszaadja, hogy a távolságérzékelő jelenleg érzékel-e objektumot.

  • changed — Visszahívó függvényt regisztrál, amely akkor fut le, amikor a detektált távolságérték megváltozik.

  • installed — Visszaadja, hogy a távolságérzékelő telepítve és csatlakoztatva van-e.

Mielőtt bármilyen distance vagy sonar tagfüggvényt meghívnánk, létre kell hozni egy distance vagy sonar példányt, az alábbiak szerint:

/* 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#

Visszaadja, hogy a távolságérzékelő jelenleg érzékel-e objektumot.

Available Functions 
bool foundObject();
Parameters

Ez a függvény nem fogad el paramétereket.

Return Values

Egy logikai értéket ad vissza, amely azt jelzi, hogy a távolságérzékelő érzékel-e objektumot:

  • 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#

Visszaadja a távolságérzékelő és a legközelebbi érzékelt tárgy közötti távolságot.

Available Functions 
double distance( distanceUnits units );
Parameters

Paraméter

Típus

Leírás

units

distanceUnits

A távolság mértékegysége:

  • mm — milliméter (24 mm-től 1000 mm-ig)
  • cm — centiméter (2,4 cm-től 100 cm-ig)
  • inches — hüvelyk (1 hüvelyktől 40 hüvelykig)
Return Values

double értéket ad vissza, amely a távolságérzékelő és a legközelebbi érzékelt objektum közötti távolságot jelöli a megadott mértékegységben.

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

objectDistance#

Visszaadja a távolságérzékelő és a legközelebbi érzékelt tárgy közötti távolságot.

Available Functions 
double objectDistance( distanceUnits units );
Parameters

Paraméter

Típus

Leírás

units

distanceUnits

A távolság mértékegysége:

  • mm — milliméter (20 mm-től 2000 mm-ig)
  • cm — centiméter (2 cm-től 200 cm-ig)
  • inches — hüvelyk (0,78 hüvelyktől 78 hüvelykig)
Return Values

double értéket ad vissza, amely a távolságérzékelő és a legközelebbi érzékelt objektum közötti távolságot jelöli a megadott mértékegységben.

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

objectVelocity#

Visszaadja az érzékelt objektum relatív sebességét.

A sebesség megmutatja, hogy a tárgy milyen gyorsan mozog a távolságérzékelő felé vagy attól távolodva. A 0-hoz közeli érték azt jelenti, hogy a tárgy nem mozog sokat az érzékelőhöz képest.

Available Functions 
double objectVelocity();
Parameters

Ez a függvény nem fogad el paramétereket.

Return Values

Egy double értéket ad vissza, amely a detektált objektum relatív sebességét jelenti m/s-ban (méter per másodperc).

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

objectSize#

Visszaadja a távolságérzékelő által érzékelt objektum becsült méretét.

A távolságérzékelő a tárgy méretét az alapján becsüli meg, hogy az érzékelő látóterének mekkora részét foglalja el az érzékelt tárgy.

Available Functions 
sizeType objectSize();
Parameters

Ez a függvény nem fogad el paramétereket.

Return Values

sizeType értéket ad vissza, amely az észlelt objektum becsült méretét jelzi:

  • 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#

Visszaadja, hogy a távolságérzékelő jelenleg érzékel-e objektumot.

Available Functions 
bool isObjectDetected();
Parameters

Ez a függvény nem fogad el paramétereket.

Return Values

Egy logikai értéket ad vissza, amely azt jelzi, hogy a távolságérzékelő érzékel-e objektumot:

  • 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#

Visszahívó függvényt regisztrál, amely akkor fut le, amikor a detektált távolságérték megváltozik.

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

Paraméter

Típus

Leírás

callback

void (*)(void)

Egy mutató egy függvényre, amely akkor hívódik meg, amikor a detektált távolságérték megváltozik. A függvény nem vehet fel paramétereket, és void értéket adhat vissza.
Return Values

Ez a függvény nem ad vissza értéket.

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

installed#

Visszaadja, hogy a távolságérzékelő telepítve és csatlakoztatva van-e.

Available Functions 
bool installed();
Parameters

Ez a függvény nem fogad el paramétereket.

Return Values

Egy logikai értéket ad vissza, amely jelzi, hogy a távolságérzékelő telepítve és csatlakoztatva van-e:

  • 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