Attāluma sensors#

Ievads#

sonar klase tiek izmantota ar VEX IQ attāluma sensoru (1. paaudze). distance klase tiek izmantota ar VEX IQ attāluma sensoru (2. paaudze).

Abi attāluma sensori var noteikt, vai sensora priekšā atrodas objekts, un atgriezt informāciju par to, cik tālu šis objekts atrodas. VEX IQ attāluma sensors (2. paaudze) var arī atgriezt noteiktā objekta relatīvo ātrumu un novērtēt, vai objekts ir mazs, vidējs vai liels.

Klases konstruktori#

1 — Šis konstruktors izveido VEX IQ attāluma sensoru (1. paaudze).

sonar(
    int32_t index);

2 — Šis konstruktors izveido VEX IQ attāluma sensoru (2. paaudze).

distance(
    int32_t index);

Klases iznīcinātājs#

Iznīcina distance objektu un atbrīvo saistītos resursus.

1 — Iznīcina VEX IQ attāluma sensoru (1. paaudze).

~sonar();

2 — Iznīcina VEX IQ attāluma sensoru (2. paaudze).

~distance();

Parametri#

Parametrs

Tips

Apraksts

index

int32_t

Viedports, kuram ir pievienots attāluma sensors, kas pierakstīts kā PORTx, kur x ir porta numurs (piemēram, PORT1).

Piemēri#

1 — Izveidojiet VEX IQ attāluma sensora (1. paaudzes) instanci 1. portā.

sonar Distance1 = sonar(PORT1);

2 — Izveidojiet VEX IQ attāluma sensora (2. paaudzes) instanci 1. portā.

distance Distance1 = distance(PORT1);

Dalībnieku funkcijas#

sonar klasē ir iekļautas šādas dalībfunkcijas:

  • foundObject — Atgriež, vai attāluma sensors pašlaik nosaka objektu.

  • distance — Atgriež attālumu starp attāluma sensoru un tuvāko noteikto objektu.

distance klase ietver šādas dalībfunkcijas:

  • objectDistance — Atgriež attālumu starp attāluma sensoru un tuvāko noteikto objektu.

  • objectVelocity — Atgriež, cik ātri noteiktais objekts pārvietojas attāluma sensora virzienā vai prom no tā.

  • objectSize — Atgriež noteiktā objekta aptuveno izmēru.

  • isObjectDetected — Atgriež, vai attāluma sensors pašlaik nosaka objektu.

  • changed — Reģistrē atzvanīšanas funkciju, kas darbojas, kad mainās noteiktā attāluma vērtība.

  • installed — Atgriež, vai attāluma sensors ir instalēts un pievienots.

Pirms jebkuru distance vai sonar dalībfunkciju izsaukšanas ir jāizveido distance vai sonar instance, kā parādīts zemāk:

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

Atgriež, vai attāluma sensors pašlaik nosaka objektu.

Available Functions 
bool foundObject();
Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež Būla vērtību, kas norāda, vai attāluma sensors nosaka objektu:

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

Atgriež attālumu starp attāluma sensoru un tuvāko noteikto objektu.

Available Functions 
double distance( distanceUnits units );
Parameters

Parametrs

Tips

Apraksts

units

distanceUnits

Attāluma mērvienība:

  • mm — milimetri (no 24 mm līdz 1000 mm)
  • cm — centimetri (no 2,4 cm līdz 100 cm)
  • inches — collas (no 1 collas līdz 40 collām)
Return Values

Atgriež skaitli double kas apzīmē attālumu starp attāluma sensoru un tuvāko noteikto objektu norādītajās vienībās.

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

objectDistance#

Atgriež attālumu starp attāluma sensoru un tuvāko noteikto objektu.

Available Functions 
double objectDistance( distanceUnits units );
Parameters

Parametrs

Tips

Apraksts

units

distanceUnits

Attāluma mērvienība:

  • mm — milimetri (no 20 mm līdz 2000 mm)
  • cm — centimetri (no 2 cm līdz 200 cm)
  • inches — collas (no 0,78 collām līdz 78 collām)
Return Values

Atgriež skaitli double kas apzīmē attālumu starp attāluma sensoru un tuvāko noteikto objektu norādītajās vienībās.

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

objectVelocity#

Atgriež noteiktā objekta relatīvo ātrumu.

Ātrums parāda, cik ātri objekts virzās attāluma sensora virzienā vai prom no tā. Vērtība, kas ir tuvu 0, nozīmē, ka objekts nekustas daudz attiecībā pret sensoru.

Available Functions 
double objectVelocity();
Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež skaitli double kas apzīmē noteiktā objekta relatīvo ātrumu m/s (metri sekundē).

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

objectSize#

Atgriež attāluma sensora noteiktā objekta aptuveno izmēru.

Attāluma sensors novērtē objekta izmēru, pamatojoties uz to, cik lielu daļu no sensora skata aizņem noteiktais objekts.

Available Functions 
sizeType objectSize();
Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež sizeType kas norāda noteiktā objekta aptuveno izmēru:

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

Atgriež, vai attāluma sensors pašlaik nosaka objektu.

Available Functions 
bool isObjectDetected();
Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež Būla vērtību, kas norāda, vai attāluma sensors nosaka objektu:

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

Reģistrē atzvanīšanas funkciju, kas darbojas, kad mainās noteiktā attāluma vērtība.

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

Parametrs

Tips

Apraksts

callback

void (*)(void)

Rādītājs uz funkciju, kas tiks izsaukta, mainoties noteiktajai attāluma vērtībai. Funkcija nedrīkst pieņemt parametrus un atgriezt void.
Return Values

Šī funkcija neatgriež vērtību.

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

installed#

Atgriež, vai attāluma sensors ir uzstādīts un pievienots.

Available Functions 
bool installed();
Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež Būla vērtību, kas norāda, vai attāluma sensors ir uzstādīts un pievienots:

  • 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