Atstumo jutiklis#

Įvadas#

sonar klasė naudojama su VEX IQ atstumo jutikliu (1-osios kartos). distance klasė naudojama su VEX IQ atstumo jutikliu (2-osios kartos).

Abu atstumo jutikliai gali aptikti, ar priešais jutiklį yra objektas, ir pateikti informaciją apie atstumą iki objekto. „VEX IQ“ atstumo jutiklis (antrosios kartos) taip pat gali pateikti aptikto objekto santykinį greitį ir įvertinti, ar objektas yra mažas, vidutinis ar didelis.

Klasės konstruktoriai#

1 — Šis konstruktorius sukuria VEX IQ atstumo jutiklį (1-osios kartos).

sonar(
    int32_t index);

2 — Šis konstruktorius sukuria VEX IQ atstumo jutiklį (2-os kartos).

distance(
    int32_t index);

Klasės destruktorius#

Sunaikina distance objektą ir išlaisvina susijusius išteklius.

1 — Sunaikina VEX IQ atstumo jutiklį (1-osios kartos).

~sonar();

2 — Sunaikina VEX IQ atstumo jutiklį (2-os kartos).

~distance();

Parametrai#

Parametras

Tipas

Aprašymas

index

int32_t

Išmanusis prievadas, prie kurio prijungtas atstumo jutiklis, užrašomas kaip PORTx, kur x yra prievado numeris (pavyzdžiui, PORT1).

Pavyzdžiai#

1 — Sukurkite VEX IQ atstumo jutiklio (1-osios kartos) egzempliorių 1 prievade.

sonar Distance1 = sonar(PORT1);

2 — Sukurkite VEX IQ atstumo jutiklio (2-osios kartos) egzempliorių 1 prievade.

distance Distance1 = distance(PORT1);

Narių funkcijos#

sonar klasė apima šias narines funkcijas:

  • foundObject — Grąžina, ar atstumo jutiklis šiuo metu aptinka objektą.

  • distance — Grąžina atstumą tarp atstumo jutiklio ir artimiausio aptikto objekto.

distance klasė apima šias narines funkcijas:

  • objectDistance — Grąžina atstumą tarp atstumo jutiklio ir artimiausio aptikto objekto.

  • objectVelocity – Grąžina, kaip greitai aptiktas objektas juda link atstumo jutiklio arba nuo jo.

  • objectSize — Grąžina apytikslį aptikto objekto dydį.

  • isObjectDetected — Grąžina, ar atstumo jutiklis šiuo metu aptinka objektą.

  • changed — Registruoja grįžtamojo ryšio funkciją, kuri paleidžiama, kai pasikeičia aptikta atstumo reikšmė.

  • installed – Grąžina, ar atstumo jutiklis yra įdiegtas ir prijungtas.

Prieš iškviečiant bet kokias distance arba sonar nario funkcijas, reikia sukurti distance arba sonar egzempliorių, kaip parodyta žemiau:

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

Grąžina, ar atstumo jutiklis šiuo metu aptinka objektą.

Available Functions 
bool foundObject();
Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Grąžina loginę reikšmę, nurodančią, ar atstumo jutiklis aptinka objektą:

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

Grąžina atstumą tarp atstumo jutiklio ir artimiausio aptikto objekto.

Available Functions 
double distance( distanceUnits units );
Parameters

Parametras

Tipas

Aprašymas

units

distanceUnits

Atstumo vienetas:

  • mm — milimetrai (nuo 24 mm iki 1000 mm)
  • cm — centimetrai (nuo 2,4 cm iki 100 cm)
  • inches — coliai (nuo 1 colio iki 40 colių)
Return Values

Grąžina double skaičių, nurodantį atstumą tarp atstumo jutiklio ir artimiausio aptikto objekto nurodytais vienetais.

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

objectDistance#

Grąžina atstumą tarp atstumo jutiklio ir artimiausio aptikto objekto.

Available Functions 
double objectDistance( distanceUnits units );
Parameters

Parametras

Tipas

Aprašymas

units

distanceUnits

Atstumo vienetas:

  • mm — milimetrai (nuo 20 mm iki 2000 mm)
  • cm — centimetrai (nuo 2 cm iki 200 cm)
  • inches — coliai (nuo 0,78 colio iki 78 colių)
Return Values

Grąžina double skaičių, nurodantį atstumą tarp atstumo jutiklio ir artimiausio aptikto objekto nurodytais vienetais.

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

objectVelocity#

Grąžina aptikto objekto santykinį greitį.

Greitis rodo, kaip greitai objektas juda link atstumo jutiklio arba nuo jo. Reikšmė, artima 0, reiškia, kad objektas jutiklio atžvilgiu juda nedaug.

Available Functions 
double objectVelocity();
Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Grąžina skaičių double reiškiantį aptikto objekto santykinį greitį m/s (metrais per sekundę).

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

objectSize#

Grąžina atstumo jutiklio aptikto objekto numatomą dydį.

Atstumo jutiklis įvertina objekto dydį pagal tai, kiek jutiklio matymo lauko užima aptiktas objektas.

Available Functions 
sizeType objectSize();
Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Grąžina sizeType reikšmę, nurodančią apytikslį aptikto objekto dydį:

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

Grąžina, ar atstumo jutiklis šiuo metu aptinka objektą.

Available Functions 
bool isObjectDetected();
Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Grąžina loginę reikšmę, nurodančią, ar atstumo jutiklis aptinka objektą:

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

Registruoja grįžtamojo ryšio funkciją, kuri paleidžiama, kai pasikeičia aptikta atstumo reikšmė.

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

Parametras

Tipas

Aprašymas

callback

void (*)(void)

Rodyklė į funkciją, kuri bus iškviečiama, kai pasikeis aptikta atstumo reikšmė. Funkcija negali priimti parametrų ir grąžinti void.
Return Values

Ši funkcija negrąžina reikšmės.

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

installed#

Grąžina, ar atstumo jutiklis yra sumontuotas ir prijungtas.

Available Functions 
bool installed();
Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Grąžina loginę reikšmę, nurodančią, ar atstumo jutiklis yra įdiegtas ir prijungtas:

  • 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