Rialaitheoir#

Réamhrá #

Tá ceithre chnaipe agus luamhán stiúrtha ar Rialaitheoir Bata Amháin VEX AIM. Is féidir an luamhán stiúrtha a bhogadh feadh dhá ais agus is féidir é a bhrú cosúil le cnaipe freisin.

Is féidir modhanna rialtóra a úsáid chun brúigh cnaipe a sheiceáil, gluaiseacht luamhán stiúrtha a léamh, stádas nasc agus ceallraí a sheiceáil, nó feidhmeanna a rith nuair a tharlaíonn imeachtaí rialtóra.

Seo thíos liosta de na modhanna uile:

Getters — Léigh stádas an chnaipe, an luamháin stiúrtha, an nasc, agus na ceallraí.

.pressing — Tugann sé seo ar ais an bhfuil cnaipe sonraithe á bhrú.
.position — Tugann sé seo suíomh an luamháin stiúrtha ar ais feadh ais shonraithe.
is_connected — Tugann sé seo ar ais an bhfuil an rialtóir ceangailte.
get_battery_level — Tugann sé seo leibhéal ceallraí an rialtóra ar ais.

Glaonna ar ais — Feidhmeanna a rith nuair a athraíonn ionchur an rialtóra.

.pressed — Ritheann feidhm nuair a bhrúitear cnaipe sonraithe.
.released — Ritheann feidhm nuair a scaoiltear cnaipe sonraithe.
.changed — Ritheann feidhm nuair a athraíonn suíomh an luamháin stiúrtha feadh ais shonraithe.

Faighteoirí #

.pressing #

.pressing , tugann sé sin ar ais an bhfuil cnaipe ar leith ar an rialtóir á bhrú faoi láthair. Ní mór an modh seo a ghlaoch ar réad cnaipe ar leith, amhail controller.button_up.

True — Tá an cnaipe sonraithe á bhrú.
False — Níl an cnaipe sonraithe á bhrú.

Úsáid:
Is féidir ceann amháin de chúig réad cnaipe atá ar fáil a úsáid leis an modh seo:

Cnaipe	Ordú
`button_up`	`controller.button_up.pressing()` — An cnaipe Suas
`button_down`	`controller.button_down.pressing()` — An cnaipe Síos
`button_left`	`controller.button_left.pressing()` — An cnaipe Clé
`button_right`	`controller.button_right.pressing()` — An cnaipe Ar Dheis
`button_stick`	`controller.button_stick.pressing()` — An cnaipe Luamhán stiúrtha

Rialaitheoir Aon-Mhaide VEX AIM le luamhán stiúrtha ar chlé agus ceithre chnaipe ar dheis. Tá an luamhán stiúrtha agus na ceithre chnaipe aibhsithe.

Paraiméadair	Cur síos
	Níl aon pharaiméadair ag an modh seo.

# Move forward while the Up button is being pressed
while True:
    if controller.button_up.pressing():
        robot.move_at(0)
    else:
        robot.stop_all_movement()

    wait(20, MSEC)

.position #

.position tugann sé suíomh ais luamhán stiúrtha ar ais mar uimhir ó -100 go 100.

Caithfear an modh seo a ghlaoch ar réad ais ar leith, amhail controller.axis1.

Úsáid:
Is féidir ceann amháin de dhá réad ais atá ar fáil a úsáid leis an modh seo:

Ais	Ordú
`axis1`	`controller.axis1.position()` — An ais ingearach
`axis2`	`controller.axis2.position()` — An ais chothrománach

Rialaitheoir VEX AIM le luamhán stiúrtha ar chlé agus ceithre chnaipe ar dheis. Tá ais 1 agus ais 2 don luamhán stiúrtha aibhsithe.

Paraiméadair	Cur síos
	Níl aon pharaiméadair ag an modh seo.

# Move forward when the joystick is moved up
while True:
    if controller.axis1.position() > 0:
        robot.move_at(0)
    else:
        robot.stop_all_movement()

    wait(20, MSEC)

is_connected #

is_connected ar ais an bhfuil an rialtóir ceangailte.

True — Tá an rialtóir ceangailte.
False — Níl an rialtóir ceangailte.

Usage:
controller.is_connected()

Paraiméadair	Cur síos
	Níl aon pharaiméadair ag an modh seo.

# Stop the robot if the controller disconnects
robot.move_at(0)

while True:
    if not controller.is_connected():
        robot.stop_all_movement()

    wait(100, MSEC)

get_battery_level #

get_battery_level leibhéal ceallraí an rialtóra ar ais mar uimhir ó 0 go 100.

Usage:
controller.get_battery_level()

Paraiméadair	Cur síos
	Níl aon pharaiméadair ag an modh seo.

# Display the controller's battery level
robot.screen.print(controller.get_battery_level())

Glaonna ar ais #

.pressed #

.pressed ritheann feidhm nuair a bhrúitear an cnaipe sonraithe. Nuair a úsáidtear é, rithfidh an fheidhm go huathoibríoch gach uair a bhrúitear an cnaipe sin.

Úsáid:
Is féidir ceann amháin de chúig réad cnaipe atá ar fáil a úsáid leis an modh seo:

Cnaipe	Ordú
`button_up`	`controller.button_up.pressed(callback, arg)` — An cnaipe Suas
`button_down`	`controller.button_down.pressed(callback, arg)` — An cnaipe Síos
`button_left`	`controller.button_left.pressed(callback, arg)` — An cnaipe Clé
`button_right`	`controller.button_right.pressed(callback, arg)` — An cnaipe Ar Dheis
`button_stick`	`controller.button_stick.pressed(callback, arg)` — An cnaipe Luamhán stiúrtha

Paraiméadar	Cur síos
`callback`	Feidhm shainithe atá sainithe roimhe seo le rith gach uair a bhrúitear an cnaipe sonraithe.
`arg`	Roghnach. Tupla ina bhfuil argóintí le cur chuig an bhfeidhm athghlaoite. Féach Úsáid Imeachtaí le Paraiméadair le haghaidh tuilleadh eolais.

# Kick hard when the Up button is pressed
def kick_object():
    robot.kicker.kick(HARD)

controller.button_up.pressed(kick_object)

.released #

.released ritheann feidhm nuair a scaoiltear an cnaipe sonraithe. Nuair a úsáidtear é, rithfidh an fheidhm go huathoibríoch gach uair a scaoiltear an cnaipe sin.

Úsáid:
Is féidir ceann amháin de chúig réad cnaipe atá ar fáil a úsáid leis an modh seo:

Cnaipe	Ordú
`button_up`	`controller.button_up.released(callback, arg)` — An cnaipe Suas
`button_down`	`controller.button_down.released(callback, arg)` — An cnaipe Síos
`button_left`	`controller.button_left.released(callback, arg)` — An cnaipe Clé
`button_right`	`controller.button_right.released(callback, arg)` — An cnaipe Ar Dheis
`button_stick`	`controller.button_stick.released(callback, arg)` — An cnaipe Luamhán Stiúrtha

Paraiméadar	Cur síos
`callback`	Feidhm [Feidhm] atá sainithe roimhe seo le rith gach uair a scaoiltear an cnaipe sonraithe.
`arg`	Roghnach. Tupla ina bhfuil argóintí le cur chuig an bhfeidhm athghlaoite. Féach Úsáid Imeachtaí le Paraiméadair le haghaidh tuilleadh eolais.

# Clear the screen after the Up button is released
def clear_screen():
    robot.screen.clear_screen()

controller.button_up.released(clear_screen)

robot.screen.print("Press Up, then")
robot.screen.next_row()
robot.screen.print("Release Up!")

.changed #

.changed ritheann feidhm nuair a athraíonn suíomh an luamháin stiúrtha feadh an ais shonraithe. Nuair a úsáidtear í, rithfidh an fheidhm go huathoibríoch gach uair a athraíonn suíomh an luamháin stiúrtha feadh an ais sin.

Úsáid:
Is féidir ceann amháin de dhá réad ais atá ar fáil a úsáid leis an modh seo:

Ais	Ordú
`axis1`	`controller.axis1.changed(callback, arg)` — An ais ingearach
`axis2`	`controller.axis2.changed(callback, arg)` — An ais chothrománach

Paraiméadar	Cur síos
`callback`	Feidhm shainithe a rithfear gach uair a athraíonn suíomh an luamháin stiúrtha feadh an ais shonraithe.
`arg`	Roghnach. Tupla ina bhfuil argóintí le cur chuig an bhfeidhm athghlaoite. Féach Úsáid Imeachtaí le Paraiméadair le haghaidh tuilleadh eolais.

# Show an emoji when the joystick moves up or down
def move_joystick():
    robot.screen.show_emoji(CONFUSED)

controller.axis1.changed(move_joystick)