Braiteoir Fad#

Réamhrá#

Úsáidtear rang sonar sonar leis an Braiteoir Fad VEX IQ (1ú glúin). Úsáidtear rang sonar distance leis an Braiteoir Fad VEX IQ (2ú glúin).

Is féidir leis an dá Braiteoir Fad a bhrath an bhfuil réad os comhair an braiteora agus a thabhairt ar ais cé chomh fada is atá an réad sin ar shiúl. Is féidir leis an Braiteoir Fad VEX IQ (2ú glúin) luas coibhneasta an réada braite a thabhairt ar ais freisin agus meastachán a dhéanamh ar cibé an bhfuil an réad beag, meánach nó mór.

Tógálaithe Ranga#

1 — Cruthaíonn an tógálaí seo Braiteoir Fad VEX IQ (1ú glúin).

sonar(
    int32_t index);

2 — Cruthaíonn an tógálaí seo Braiteoir Fad VEX IQ (2ú glúin).

distance(
    int32_t index);

Scriostóir Ranga#

Scriosann sé an réad atá distance agus scaoileann sé acmhainní gaolmhara.

1 — Scriosann sé Braiteoir Fad VEX IQ (1ú glúin).

~sonar();

2 — Scriosann sé Braiteoir Fad VEX IQ (2ú glúin).

~distance();

Paraiméadair#

Paraiméadar

Cineál

Cur síos

index

int32_t

An Port Cliste a bhfuil an Braiteoir Faid ceangailte leis, scríofa mar PORTx, áit a seasann x don uimhir phoirt (mar shampla, PORT1).

Samplaí#

1 — Cruthaigh sampla Braiteoir Fad VEX IQ (1ú glúin) i bPort 1.

sonar Distance1 = sonar(PORT1);

2 — Cruthaigh sampla de Braiteoir Fad VEX IQ (2ú glúin) i bPort 1.

distance Distance1 = distance(PORT1);

Feidhmeanna na mBall#

Áirítear leis an rang sonar na feidhmeanna ball seo a leanas:

  • foundObject — Tugann sé seo ar ais an bhfuil réad á bhrath ag an Braiteoir Fad faoi láthair.

  • distance — Tugann sé seo an t-achar idir an Braiteoir Achair agus an réad braite is gaire ar ais.

Áirítear leis an rang achar distance na feidhmeanna ball seo a leanas:

  • objectDistance — Tugann sé seo an fad idir an Braiteoir Fad agus an réad braite is gaire ar ais.

  • objectVelocity — Tugann sé seo ar ais cé chomh tapa agus atá an réad braite ag bogadh i dtreo nó ar shiúl ón Braiteoir Fad.

  • objectSize — Tugann sé seo méid measta an réada braite ar ais.

  • isObjectDetected — Tugann sé seo ar ais an bhfuil réad á bhrath ag an Braiteoir Fad faoi láthair.

  • changed — Cláraíonn sé feidhm athghlaoite a ritheann nuair a athraíonn luach an achair a braitheadh.

  • installed — Tugann sé seo ar ais an bhfuil an Braiteoir Fad suiteáilte agus ceangailte.

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#

Tugann sé seo ar ais an bhfuil réad á bhrath ag an Braiteoir Fad faoi láthair.

Available Functions 
bool foundObject();
Parameters

Ní ghlacann an fheidhm seo aon pharaiméadair.

Return Values

Tugann sé seo luach Booleach ar ais a léiríonn an bhfuil réad á bhrath ag an Braiteoir Fad:

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

Tugann sé seo an fad idir an Braiteoir Fad agus an réad braite is gaire ar ais.

Available Functions 
double distance( distanceUnits units );
Parameters

Paraiméadar

Cineál

Cur síos

units

distanceUnits

An t-aonad achair:

  • mm — milliméadair (24 mm go 1000 mm)
  • cm — ceintiméadair (2.4 cm go 100 cm)
  • inches — orlach (1 orlach go 40 orlach)
Return Values

Tugann sé double ar ais a léiríonn an t-achar idir an Braiteoir Faid agus an réad braite is gaire sna haonaid shonraithe.

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

objectDistance#

Tugann sé seo an fad idir an Braiteoir Fad agus an réad braite is gaire ar ais.

Available Functions 
double objectDistance( distanceUnits units );
Parameters

Paraiméadar

Cineál

Cur síos

units

distanceUnits

An t-aonad achair:

  • mm — milliméadair (20 mm go 2000 mm)
  • cm — ceintiméadair (2 cm go 200 cm)
  • inches — orlach (0.78 orlach go 78 orlach)
Return Values

Tugann sé double ar ais a léiríonn an t-achar idir an Braiteoir Faid agus an réad braite is gaire sna haonaid shonraithe.

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

objectVelocity#

Tugann sé seo luas coibhneasta an réada braite ar ais.

Léiríonn luas cé chomh tapa agus atá an réad ag bogadh i dtreo nó ar shiúl ón Braiteoir Fad. Ciallaíonn luach gar do 0 nach bhfuil an réad ag bogadh mórán i gcoibhneas leis an braiteoir.

Available Functions 
double objectVelocity();
Parameters

Ní ghlacann an fheidhm seo aon pharaiméadair.

Return Values

Tugann sé double ar ais a léiríonn luas coibhneasta an réada braite i m/s (méadair in aghaidh an tsoicind).

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

objectSize#

Tugann sé seo méid measta an réada a bhraith an Braiteoir Fad ar ais.

Meastar ag an Braiteoir Fad méid an réada bunaithe ar an méid de radharc an braiteora atá tógtha suas ag an réad braite.

Available Functions 
sizeType objectSize();
Parameters

Ní ghlacann an fheidhm seo aon pharaiméadair.

Return Values

Tugann sé seo sizeType ar ais a léiríonn méid measta an réada braite:

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

Tugann sé seo ar ais an bhfuil réad á bhrath ag an Braiteoir Fad faoi láthair.

Available Functions 
bool isObjectDetected();
Parameters

Ní ghlacann an fheidhm seo aon pharaiméadair.

Return Values

Tugann sé seo luach Booleach ar ais a léiríonn an bhfuil réad á bhrath ag an Braiteoir Fad:

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

Cláraíonn sé feidhm athghlaoite a ritheann nuair a athraíonn luach an achair braite.

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

Paraiméadar

Cineál

Cur síos

callback

void (*)(void)

Pointeoir chuig feidhm a ghlaofar nuair a athraíonn luach an achair braite. Ní mór don fheidhm aon pharaiméadair a ghlacadh agus void a thabhairt ar ais.
Return Values

Ní thugann an fheidhm seo luach ar ais.

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

installed#

Tugann sé seo ar ais cibé an bhfuil an Braiteoir Fad suiteáilte agus ceangailte.

Available Functions 
bool installed();
Parameters

Ní ghlacann an fheidhm seo aon pharaiméadair.

Return Values

Tugann sé seo luach Booleach ar ais a léiríonn an bhfuil an Braiteoir Fad suiteáilte agus ceangailte:

  • 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