Python específico para robots#

Todos los comandos VR estándar de VEXcode están disponibles para su uso en el patio de juegos VIQRC Virtual Skills - Slapshot.

Movimiento #

motor.spin()#

The motor.spin(direction) command is used to spin a motor indefinitely.

Este es un comando sin espera y permite que cualquier comando posterior se ejecute sin demora.

To use this command, replace motor with the desired motor or motor group, for example: intake_motor.spin(direction).

Objetos	Descripción
`intake_motor`	Gira la entrada de Instantánea para recoger discos del campo.
`arm_motor`	Sube o baja el brazo de Snapshot.

Parámetros	Descripción
dirección	The direction for the motor to move in: `FORWARD` or `REVERSE`.

Devoluciones: Ninguna.

def main():
    # Spin the intake motor forward.
    intake_motor_group.spin(FORWARD)
    # Wait half a second.
    wait(0.5, SECONDS)
    # Stop spinning the intake motor group.
    intake_motor_group.stop()

motor.spin_for()#

The motor.spin_for(direction, distance, units, wait) command is used to spin a motor for a given amount of degrees or turns.

This is can be a non-waiting or waiting command depending on if the wait parameter is used.

To use this command, replace motor with the desired motor or motor group, for example: intake_motor_group.spin_for(direction, distance, units, wait).

Objetos	Descripción
`intake_motor`	Gira la entrada de Instantánea para recoger discos del campo.
`arm_motor`	Sube o baja el brazo de Snapshot.

Parámetros	Descripción
dirección	The direction for the motor to move in: `FORWARD` or `REVERSE`.
distancia	La distancia que debe recorrer el motor, expresada en un número entero.
unidades	The units that the motor will use: `DEGREES` or `TURNS`.
esperar	Optional. The wait parameter determines whether the command will block subsequent commands (`wait=True`) or allow immediate execution (`wait=False`). If unspecified, the default for the `wait` parameter is `wait=True`.

Devoluciones: Ninguna.

def main():
    # Spin the intake motor forward for 1 turn.
    intake_motor.spin_for(FORWARD, 1, TURNS)

motor.spin_to_position()#

The motor.spin_to(angle, units, wait) command is used to spin a motor to a given position.

This is can be a non-waiting or waiting command depending on if the wait parameter is used.

To use this command, replace motor with the desired motor or motor group, for example: intake_motor_group.spin_for(angle, units, wait).

Objetos	Descripción
`intake_motor`	Gira la entrada de Instantánea para recoger discos del campo.
`arm_motor`	Sube o baja el brazo de Snapshot.

Parámetros	Descripción
ángulo	El ángulo específico o número de vueltas que dará el motor.
unidades	The units that the motor will use: `DEGREES` or `TURNS`.
esperar	Optional. The wait parameter determines whether the command will block subsequent commands (`wait=True`) or allow immediate execution (`wait=False`). If unspecified, the default for the `wait` parameter is `wait=True`.

Devoluciones: Ninguna.

def main():
    # Spin the intake motor to 55 degrees.
    intake_motor.spin_to_position(55, DEGREES)

motor.stop()#

The motor.stop() command is used to stop a motor.

Este es un comando sin espera y permite que cualquier comando posterior se ejecute sin demora.

To use this command, replace motor with the desired motor or motor group, for example: intake_motor_group.stop().

Objetos	Descripción
`intake_motor`	Gira la entrada de Instantánea para recoger discos del campo.
`arm_motor`	Sube o baja el brazo de Snapshot.

Devoluciones: Ninguna.

def main():
    # Spin the intake motor forward.
    intake_motor.spin(FORWARD)
    # Wait one second.
    wait(1, SECONDS)
    # Stop spinning the intake motor group.
    intake_motor.stop()

motor.set_position()#

The motor.set_position(position, units) command is used to set a motor’s encoder position to the given position value.

Este es un comando sin espera y permite que cualquier comando posterior se ejecute sin demora.

To use this command, replace motor with the desired motor or motor group, for example: intake_motor_group.set_position(position, units).

Objetos	Descripción
`intake_motor`	Gira la entrada de Instantánea para recoger discos del campo.
`arm_motor`	Sube o baja el brazo de Snapshot.

Parámetros	Descripción
posición	El entero específico en el que se configurará el codificador del motor IQ.
unidades	The units for the motor to use: `DEGREES` or `TURNS`.

Devoluciones: Ninguna.

def main():
    # Set the current motor position to 90 degrees.
    intake_motor.set_position(90, DEGREES)
    # Spin the intake motor back to 0 degrees.
    intake_motor.spin_to_position(0, DEGREES)

motor.set_velocity()#

The motor.set_velocity(velocity, units) command is used to set the speed of a motor.

Este es un comando sin espera y permite que cualquier comando posterior se ejecute sin demora.

To use this command, replace motor with the desired motor or motor group, for example: intake_motor_group.set_velocity(velocity, units).

Objetos	Descripción
`intake_motor`	Gira la entrada de Instantánea para recoger discos del campo.
`arm_motor`	Sube o baja el brazo de Snapshot.

Parámetros	Descripción
velocidad	La velocidad a la que girará el motor IQ, que varía entre -100 y 100.
unidades	The unit for the Motor’s velocity, `PERCENT`.

Devoluciones: Ninguna.

def main():
    # Set the intake motor velocity to 75 percent.
    intake_motor.set_velocity(75, PERCENT)
    # Spin the intake motor to 180 degrees.
    intake_motor.spin_to_position(180, DEGREES)

motor.set_timeout()#

The motor.set_timeout(value, units) command is used to set a time limit for a motor’s movement commands.

Esto evita que los comandos de movimiento que no llegan a su posición prevista impidan la ejecución de los comandos posteriores.

Este es un comando sin espera y permite que cualquier comando posterior se ejecute sin demora.

To use this command, replace motor with the desired motor or motor group, for example: intake_motor_group.set_timeout(value, units).

Objetos	Descripción
`intake_motor`	Gira la entrada de Instantánea para recoger discos del campo.
`arm_motor`	Sube o baja el brazo de Snapshot.

Parámetros	Descripción
valor	La cantidad de tiempo que el motor esperará antes de detenerse.
unidades	The unit for the Motor’s timer, `SECONDS`.

Devoluciones: Ninguna.

def main():
    # Set the intake motor's timeout to 2 seconds.
    intake_motor.set_timeout(2, SECONDS)
    # Spin the intake motor to 270 degrees.
    intake_motor.spin_to_position(270, DEGREES)

Eventos #

intake_bumper.pressed()#

intake_bumper.pressed(callback) is the same command as bumper.pressed(callback).

The command only uses Byte’s specific bumper sensor intake_bumper to replace bumper in the standard command.

For information on how to use the bumper.pressed(callback) command, go to its API documentation here.

intake_bumper.released()#

intake_bumper.released(callback) is the same command as bumper.released(callback).

The command only uses Byte’s specific bumper sensor intake_bumper to replace bumper in the standard command.

For information on how to use the bumper.released(callback) command, go to its API documentation here.

front_optical.object_detected()#

front_optical.object_detected(callback) is the same command as eye.object_detected(callback).

The command only uses Byte’s Optical Sensor front_optical to replace eye in the standard command.

For information on how to use the eye.object_detected(callback) command, go to its API documentation here.

front_optical.object_lost()#

front_optical.object_lost(callback) is the same command as eye.object_lost(callback).

The command only uses Byte’s Optical Sensor front_optical to replace eye in the standard command.

For information on how to use the eye.object_lost(callback) command, go to its API documentation here.

Detección #

motor.is_done()#

The motor.is_done() command is used to return a True or False value if the selected motor has completed its movement.

To use this command, replace motor with the desired motor or motor group, for example: intake_motor_group.is_done().

Objetos	Descripción
`intake_motor`	Gira la entrada de Instantánea para recoger discos del campo.
`arm_motor`	Sube o baja el brazo de Snapshot.

Devuelve: Esto devuelve un valor booleano.

def main():
    # Move the Arm so it doesn't block the Front Distance Sensor.
    arm_motor.spin_to_position(1000, DEGREES)
    # Wait until the arm_motor_group has finished moving.
    if arm_motor.is_done():
        # Print the distance from the Front Distance Sensor to the closest
        # object in front of it.
        brain.screen.print(front_distance.object_distance(MM))

motor.is_spinning()#

The motor.is_spinning() command is used to return a True or False value if the selected motor is moving.

To use this command, replace motor with the desired motor or motor group, for example: intake_motor_group.is_spinning().

Objetos	Descripción
`intake_motor`	Gira la entrada de Instantánea para recoger discos del campo.
`arm_motor`	Sube o baja el brazo de Snapshot.

Devuelve: Esto devuelve un valor booleano.

# Example coming soon.

motor.position()#

The motor.position(units) command is used to return the current rotational position of the selected motor.

To use this command, replace motor with the desired motor or motor group, for example: intake_motor_group.position(units).

Objetos	Descripción
`intake_motor`	Gira la entrada de Instantánea para recoger discos del campo.
`arm_motor`	Sube o baja el brazo de Snapshot.

Parámetros	Descripción
unidades	The unit of the returned value, `DEGREES` or `TURNS`.

Devuelve: Esto devuelve un valor numérico.

def main():
    # Print the current position of the intake_motor_group in degrees.
    brain.screen.print(intake_motor_group.position(DEGREES))

motor.velocity()#

The motor.velocity(units) command is used to return the current velocity of the selected motor.

To use this command, replace motor with the desired motor or motor group, for example: intake_motor_group.velocity(units).

Objetos	Descripción
`intake_motor`	Gira la entrada de Instantánea para recoger discos del campo.
`arm_motor`	Sube o baja el brazo de Snapshot.

Parámetros	Descripción
unidades	The unit of the motor’s velocity, `PERCENT`.

Devuelve: Esto devuelve un valor numérico.

def main():
    # Print the current velocity of the arm_motor_group.
    brain.screen.print(arm_motor_group.velocity(PERCENT))

intake_bumper.pressing()#

intake_bumper.pressing() is the same command as bumper.pressing().

The command only uses Byte’s specialized Bumper Sensor intake_bumper to replace bumper in the standard command.

For information on how to use the bumper.pressing() command, go to its API documentation here.

front_optical.is_near_object()#

The front_optical.near_object() command is used to report a Boolean value if the Optical Sensor is close enough to an object to detect a color.

Este es un comando sin espera y permite que cualquier comando posterior se ejecute sin demora.

Devuelve: Esto informa un valor booleano.

def main():
    # Print if the Front Optical Sensor is detecting a color.
    brain.print(front_optical.near_object())

front_optical.color()#

The front_optical.color()) command is used to return the color detected by a VEX IQ Optical Sensor.

Este es un comando sin espera y permite que cualquier comando posterior se ejecute sin demora.

Los siguientes colores se pueden utilizar como comparación con el color detectado por un sensor óptico IQ:

Color.ROJO
Color.VERDE
Color.AZUL
Color.AMARILLO
Color.NARANJA
Color. PÚRPURA
Color.CIAN

Devuelve: Esto devuelve un valor booleano.

def main():
    # Print the color of the object that the Front Optical Sensor sees.
    brain.print(front_optical.color())

front_optical.brightness()#

The front_optical.brightness() command is used to report the amount of light detected by a VEX IQ Optical Sensor within a range of 0 to 100 percent.

Este es un comando sin espera y permite que cualquier comando posterior se ejecute sin demora.

Devuelve: Esto devuelve un valor numérico.

def main():
    # Print the brightness of the object in front of Byte.
    brain.print(front_optical.brightness())

The front_optical.brightness() command is used to report the hue of the object detected by a VEX IQ Optical Sensor within a range of 0 to 359. This number represents the location of the detected color on a color wheel.

Este es un comando sin espera y permite que cualquier comando posterior se ejecute sin demora.

Devuelve: Esto devuelve un valor numérico.

def main():
    # Print the hue of the object in front of Byte.
    brain.screen.print("Hue: ", optical.hue())