Aimseoir Raoin

Réamhrá

Úsáidtear an rang sonar sonar leis an Aimseoir Raoin Ultrafhuaime, a thomhaiseann an t-achar go dtí an réad is gaire ag baint úsáide as tonnta fuaime. Oibríonn sé trí bíog ultrafhuaime a sheoladh amach agus tomhas a dhéanamh ar an am a thógann sé ar an bhfuaim preabadh ar ais.

Tógálaí Ranga

sonar(
  triport::port &port);

Scriostóir Ranga

Scriosann sé an réad sonar agus scaoileann sé acmhainní gaolmhara.

virtual ~sonar();

Paraiméadair

Paraiméadar	Cineál	Cur síos
port	triport::port &	An chéad Phort 3-Sreang de ghrúpa dhá-phort riachtanach a úsáideann an Aimseoir Raoin. Áitíonn an Aimseoir Raoin dhá phort cóngaracha (A–B, C–D, E–F, nó G–H) ar an Brain nó ar Leathnaitheoir 3-Sreang. Sonraigh an chéad phort sa phéire (A, C, E, nó G), scríofa mar Brain.ThreeWirePort.X nó ExpanderName.X áit a seasann X don litir calafoirt (mar shampla, Brain.ThreeWirePort.A nó Expander1.C).

Samplaí

// Create a sonar instance in Ports A and B
sonar RangeFinderA = sonar(Brain.ThreeWirePort.A);

Feidhmeanna na mBall

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

• foundObject — Tugann sé seo ar ais an mbraitheann an Aimseoir Raoin réad.

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

Sula nglaoitear ar aon fheidhmeanna sonar ball, ní mór sampla sonar a chruthú, mar a thaispeántar thíos:

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

// Create a sonar instance in Ports A and B
sonar RangeFinderA = sonar(Brain.ThreeWirePort.A);

foundObject

Tugann sé seo ar ais an mbraitheann an Aimseoir Raoin réad laistigh dá réimse radhairc.

Available Functions

bool foundObject();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Tugann sé bool ar ais a léiríonn an mbraitheann an Aimseoir Raoin réad:

• true — Tá an Aimseoir Raoin ag brath réad.

• false — Níl an Aimseoir Raoin ag braith réad.

Examples

// Check if an object is detected.
if (RangeFinderA.foundObject()){
    // Print to screen on the brain that an object was found.
    Brain.Screen.print("object found");
}

distance

Tugann sé an fad tomhaiste chuig an réad is gaire a bhraith an braiteoir ar ais.

Available Functions

double distance(
  distanceUnits units );

Parameters

Paraiméadar	Cineál	Cur síos
units	distanceUnits	An t-aonad a léiríonn an fad: inches nó mm — milliméadar.

Return Values

Tugann sé double a léiríonn an fad sna haonaid shonraithe.

Examples

// Get the Range Finder distance in millimeters.
double value = RangeFinderA.distance(mm);

// Print the current distance detected by the Range Finder to the
// Brain's screen.
Brain.Screen.print(value);