Cnaipe#

Réamhrá#

Díorthaítear an rang cnaipe button ón rang bonn brain agus soláthraíonn sé rochtain ar chnaipí an IQ (1ú glúin) Brain, rud a ligeann do do róbat brúnna ar chnaipí na hinchinne a mhonatóiriú.

Rochtain#

Soláthraíonn an rang brain dhá réad cnaipe déag. Is sampla den rang button gach réad agus is féidir rochtain a fháil air trí shampla inchinne.

Réad

Úsáid Shamplach

Cur síos

buttonCheck

Brain.buttonCheck.pressing()

Cnaipe seiceála

buttonLeft

Brain.buttonLeft.pressing()

Cnaipe clé

buttonRight

Brain.buttonRight.pressing()

Cnaipe ar dheis

Nótaí#

  • Soláthraíonn an inchinn an réad cnaipe button Ní thógtar go díreach é.

Feidhmeanna na mBall#

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

  • pressed — Cláraíonn sé feidhm le glaoch uirthi nuair a bhrúitear an cnaipe sonraithe.

  • released — Cláraíonn sé feidhm le glaoch uirthi nuair a scaoiltear an cnaipe sonraithe.

  • pressing — Tugann sé seo ar ais an bhfuil an cnaipe sonraithe á bhrú.

Sula nglaotar ar aon fheidhmeanna cnaipe button ball, ní mór sampla brain a chruthú, mar a thaispeántar thíos:

// Create a brain instance
brain();

pressed#

Cláraíonn sé feidhm athghlaoite a ritheann nuair a bhrúnn tú cnaipe inchinne ar leith.

Available Functions
void pressed( 
  void (* callback)(void) ) const;

Parameters

Paraiméadar

Cineál

Cur síos

callback

void (*)(void)

Feidhm a ghlaoitear nuair a bhrúitear an cnaipe sonraithe.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Examples

Is féidir an fheidhm seo a ghlaoch ar aon réad cnaipe inchinne, mar shampla:

  • Brain.buttonCheck
  • Brain.buttonLeft
  • Brain.buttonRight

Sainmhínigh an fheidhm athghlaoite (lasmuigh de int main())

// Drive forward when check is pressed
void driveForward() {
    Drivetrain.driveFor(forward, 100, mm);
}

Cláraigh an glao ar ais taobh istigh de int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Call driveForward when the check button is pressed
  Brain.buttonCheck.pressed(driveForward);
}

released#

Cláraíonn sé feidhm athghlaoite a ritheann nuair a scaoiltear cnaipe inchinne ar leith.

Available Functions
void released( 
  void (* callback)(void) ) const;

Parameters

Paraiméadar

Cineál

Cur síos

callback

void (*)(void)

Feidhm a ghlaoitear nuair a scaoiltear an cnaipe sonraithe.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Examples

Is féidir an fheidhm seo a ghlaoch ar aon réad cnaipe inchinne, mar shampla:

  • Brain.buttonCheck
  • Brain.buttonLeft
  • Brain.buttonRight

Sainmhínigh an fheidhm athghlaoite (lasmuigh de int main())

// Drive backward when the left button is released
void backUp() {
    Drivetrain.driveFor(reverse, 100, mm);
}

Cláraigh an glao ar ais taobh istigh de int main()

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Call backUp when the left button is released
  Brain.buttonLeft.released(backUp);
}

pressing#

Tugann sé seo ar ais an bhfuil cnaipe inchinne ar leith á bhrú faoi láthair.

Available Functions
bool pressing() const;

Parameters

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

Return Values

Tugann sé seo luach Boolean ar ais a léiríonn an bhfuil an cnaipe sonraithe á bhrú:

  • true — Tá an cnaipe á bhrú.

  • false — Níl an cnaipe á bhrú.

Examples

Is féidir an fheidhm seo a ghlaoch ar aon réad cnaipe inchinne, mar shampla:

  • Brain.buttonCheck
  • Brain.buttonLeft
  • Brain.buttonRight
// Turn right while right is pressed
while (true) {
    if (Brain.buttonRight.pressing()) {
        Drivetrain.turn(right);
    } else {
        Drivetrain.stop();
    }
    wait(5, msec);
}