Pantalla#
Introducción#
Los métodos de pantalla controlan cómo el robot de codificación VEX AIM muestra texto, números y gráficos en su pantalla, y cómo responde a las pulsaciones en la misma.
A continuación se muestra una lista de todos los métodos:
Táctil: detecta y responde a las pulsaciones de la pantalla.
pressing– Devuelve si la pantalla está siendo presionada actualmente.x_position– Devuelve la coordenada x de la última pulsación de pantalla.y_position– Devuelve la coordenada y de la última pulsación de pantalla.
Impresión del cursor: muestra el texto utilizando un sistema de filas y columnas.
print– Imprime texto, números o valores de variables en la posición actual del cursor.set_cursor– Mueve el cursor a una fila y columna específicas.next_row– Mueve el cursor a la columna 1 de la siguiente fila.clear_row– Borra una fila de texto.get_row– Devuelve la fila actual del cursor.get_column– Devuelve la columna del cursor actual.
Impresión XY: muestra el texto en una coordenada de pantalla específica.
print_at– Imprime texto, números o valores de variables en una coordenada x e y específica.set_origin– Establece el origen utilizado para la impresión y el dibujo basados en coordenadas.
Mutadores: limpia la pantalla o actualiza la configuración visual.
clear_screen– Borra la pantalla de todos los dibujos y texto.set_font– Establece la fuente para el texto impreso.set_pen_width– Establece el grosor de las líneas dibujadas y los contornos de las formas.set_pen_color– Establece el color del texto, los píxeles, las líneas y los contornos de las formas.set_fill_color– Establece el color de relleno para las formas dibujadas y los fondos de texto impresos.
Dibujar – Agregar gráficos e imágenes a la pantalla.
draw_pixel– Dibuja un píxel en una posición x e y específica.draw_line– Dibuja una línea entre dos puntos.draw_rectangle– Dibuja un rectángulo.draw_circle– Dibuja un círculo.show_file– Muestra una imagen cargada.set_clip_region– Restringe dónde pueden aparecer los dibujos y el texto.
Funciones de devolución de llamada: ejecutan funciones cuando se presiona o se suelta la pantalla.
Tocar#
pressing#
Al pulsar pressing se devuelve un valor booleano que indica si se está pulsando la pantalla del robot en ese momento.
True– Se está presionando la pantalla.False– No se está pulsando la pantalla.
Usage:
robot.screen.pressing()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Turn LEDs white only while the screen is pressed.
while True:
if robot.screen.pressing():
robot.led.on(ALL_LEDS, WHITE)
else:
robot.led.off(ALL_LEDS)
wait(50, MSEC)
# Display different messages after the screen is pressed
while not robot.screen.pressing():
wait(5, MSEC)
robot.screen.print("First message!")
robot.screen.next_row()
# Lift finger to press the screen again
while robot.screen.pressing():
wait(5, MSEC)
while not robot.screen.pressing():
wait(5, MSEC)
robot.screen.print("Second message!")
robot.screen.next_row()
x_position#
x_position devuelve la coordenada x de la última pulsación de pantalla como un número entero de 0 (izquierda) a 240 (derecha).
Usage:robot.screen.x_position()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Display the x-coordinate of where
# the screen is pressed
while True:
if robot.screen.pressing():
robot.screen.clear_screen()
robot.screen.print(robot.screen.x_position())
wait (50, MSEC)
y_position#
y_position devuelve la coordenada y de la última pulsación de pantalla como un número entero de 0 (arriba) a 240 (abajo).
Usage:robot.screen.y_position()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Display the y-coordinate of where
# the screen is pressed
while True:
if robot.screen.pressing():
robot.screen.clear_screen()
robot.screen.print(robot.screen.y_position())
wait (50, MSEC)
Cursor Imprimir#
print#
print imprime texto, números o valores de variables en la pantalla del robot en la posición del cursor y fuente actuales.
Usage:robot.screen.print(text)
Parámetros |
Descripción |
|---|---|
|
El texto, número o valor de variable que se mostrará en la pantalla. |
# Display a message at the starting cursor position
robot.screen.print("Hello, Robot!")

set_cursor#
set_cursor mueve el cursor de texto a una fila y columna específicas en la pantalla del robot. La siguiente llamada print comenzará a imprimir en esa ubicación. El número de filas y columnas que caben depende de la fuente seleccionada. Con la fuente monoespaciada mediana predeterminada, la pantalla puede mostrar claramente hasta 8 filas y 13 columnas. El texto colocado fuera de este rango puede quedar cortado o ser más difícil de leer.
Las fuentes monoespaciadas tienen caracteres del mismo ancho, lo que garantiza una colocación uniforme del texto. En cambio, las fuentes proporcionales varían en el ancho de los caracteres, por lo que algunas letras ocupan más espacio que otras. Sin embargo, independientemente del tipo de fuente utilizado, set_cursor posiciona el cursor en función del tamaño de fila y columna, no del estilo de fuente. El tamaño de la fuente se puede ajustar mediante set_font.
Usage:robot.screen.set_cursor(row, column)
Parámetros |
Descripción |
|---|---|
|
La fila a la que mover el cursor. |
|
La columna a la que se debe mover el cursor. |
# Display text starting at Row 3 Column 2
robot.screen.set_cursor(3, 2)
robot.screen.print("Row 3, Column 2")

next_row#
next_row mueve el cursor a la columna 1 en la siguiente fila de la pantalla del robot.
Usage:robot.screen.next_row()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Display two lines of text
robot.screen.print("Line 1")
robot.screen.next_row()
robot.screen.print("Line 2")

clear_row#
clear_row borra una sola fila de texto en la pantalla del robot.
Usage:robot.screen.clear_row(row, color)
Parámetro |
Descripción |
|---|---|
|
Opcional. La fila que se va a borrar como un número entero. Por defecto, se utiliza la fila actual del cursor. |
|
Opcional. El color que se aplicará a la fila borrada. Las opciones incluyen:
|
# Display text on two rows
robot.screen.print("This text stays")
robot.screen.next_row()
robot.screen.print("This text disappears")
# Wait 3 seconds before clearing only the second row
wait(3, SECONDS)
robot.screen.clear_row()
# Turn the 5th row green
robot.screen.clear_row(5, GREEN)

get_row#
get_row devuelve la fila actual donde se imprimirá el texto como un número entero.
Usage:robot.screen.get_row()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Set cursor to (3,2) and print row number
robot.screen.set_cursor(3, 2)
robot.screen.print(robot.screen.get_row())

get_column#
get_column devuelve la columna actual donde se imprimirá el texto como un número entero.
Usage:robot.screen.get_column()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Set cursor to (3,2) and print column number
robot.screen.set_cursor(3, 2)
robot.screen.print(robot.screen.get_column())

Impresión XY#
print_at#
print_at imprime texto, números o valores de variables en la pantalla del robot en una coordenada x e y específica en píxeles, utilizando la fuente y el origen actualmente configurados. x establece la distancia desde el lado izquierdo donde comienza el texto, y y establece dónde se ubica la parte inferior de las letras. Este método ignora la posición actual del cursor.

Nota: El círculo rojo muestra las coordenadas que serán visibles en la pantalla circular del robot AIM. Las coordenadas que quedan fuera del círculo rojo se encuentran dentro del rango de 0 a 240, pero no aparecerán en la pantalla.
Usage:
robot.screen.print_at(text, x, y)
Parámetro |
Descripción |
|---|---|
|
El texto, número o valor de variable que se imprimirá en la pantalla. |
|
La posición horizontal del texto, como un entero de 0 a 240 píxeles. 0 es izquierda; 240 es derecha. |
|
La posición vertical del texto, como un entero de 0 a 240 píxeles. 0 es la parte superior; 240 es la parte inferior. |
# Display a message in the middle of the screen
robot.screen.print_at("Hello, Robot!", x=40, y=120)

set_origin#
set_origin establece el origen utilizado para dibujar e imprimir en coordenadas en la pantalla del robot. Por defecto, el origen es la esquina superior izquierda de la pantalla.
Usage:
robot.screen.set_origin(x, y)
Parámetro |
Descripción |
|---|---|
|
La nueva coordenada x que se establecerá como origen, expresada como un número entero de 0 a 240. |
|
La nueva coordenada y que se establecerá como origen, expresada como un número entero de 0 a 240. |
# Set the origin to the center of the screen
robot.screen.set_origin(120, 120)
# Draw a rectangle at the new origin
robot.screen.draw_rectangle(0, 0, 80, 40)

Mutadores#
clear_screen#
clear_screen borra todos los dibujos y texto de la pantalla del robot. Por defecto, también restablece la posición del cursor a la fila 1, columna 1.
Usage:
robot.screen.clear_screen(color)
Parámetro |
Descripción |
|---|---|
|
Opcional. Establece el color de la pantalla. Las opciones incluyen:
|
# Draw a circle, and clear it after 2 seconds
robot.screen.draw_circle(120, 120, 60)
wait(2, SECONDS)
robot.screen.clear_screen()
# Set the background color of the screen to red
robot.screen.clear_screen(RED)

set_font#
set_font establece la fuente utilizada para mostrar texto en la pantalla del robot. Esta fuente se aplicará a todo el texto impreso con print o print_at. La fuente predeterminada al inicio de un proyecto es MONO24.
Usage:
robot.screen.set_font(fontname)
Parámetro |
Descripción |
|---|---|
|
Sets the font to one of the following:
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
# Display text using a larger font
robot.screen.set_font(MONO40)
robot.screen.print("VEX")

set_pen_width#
set_pen_width establece el grosor de las líneas dibujadas y los contornos de las formas.
Usage:
robot.screen.set_pen_width(width)
Parámetro |
Descripción |
|---|---|
|
El ancho del lápiz, en píxeles, va de 0 a 32. |
# Draw a rectangle with a pen width of 10
robot.screen.set_pen_width(10)
robot.screen.draw_rectangle(50, 50, 130, 60)

set_pen_color#
set_pen_color establece el color del texto, los píxeles, las líneas y los contornos de las formas.
Usage:
robot.screen.set_pen_color(color)
Parámetro |
Descripción |
|---|---|
|
Opcional. El color del bolígrafo y la fuente a utilizar. Las opciones incluyen:
|
# Draw a rectangle with a red pen
robot.screen.set_pen_color(RED)
robot.screen.draw_rectangle(50, 50, 130, 60)

set_fill_color#
set_fill_color establece el color de relleno utilizado cuando se dibujan formas y cuando el texto impreso utiliza un fondo.
Usage:robot.screen.set_fill_color(color)
Parámetro |
Descripción |
|---|---|
|
Opcional. El color de relleno a utilizar. Las opciones incluyen:
|
# Draw two orange rectangles
robot.screen.set_fill_color(ORANGE)
robot.screen.draw_rectangle(50, 50, 100, 60)
robot.screen.draw_rectangle(50, 130, 100, 60)

# Display text with a purple background
robot.screen.set_fill_color(PURPLE)
robot.screen.print("Highlight")

Dibujar#
draw_pixel#
draw_pixel draws one pixel at the selected x and y coordinate using the current pen color.
Usage:
robot.screen.draw_pixel(x, y)
Parámetro |
Descripción |
|---|---|
|
La coordenada x donde se dibujará el píxel, expresada como un número entero de 0 a 240. |
|
La coordenada y donde se dibujará el píxel, expresada como un número entero de 0 a 240. |
# Draw a pixel at the center of the screen
robot.screen.draw_pixel(120, 120)
![]()
draw_line#
draw_line dibuja una línea desde la primera coordenada de la pantalla (x1, y1) hasta la segunda coordenada de la pantalla (x2, y2) usando el ancho del lápiz y el color del lápiz actuales.
Las coordenadas x e y utilizan el origen predeterminado de (0, 0) a menos que se haya establecido un origen diferente utilizando set_origin.
Usage:
robot.screen.draw_line(x1, y1, x2, y2)
Parámetro |
Descripción |
|---|---|
|
La coordenada x inicial de la línea, expresada como un número entero entre 0 y 240. |
|
La coordenada y inicial de la línea, expresada como un número entero entre 0 y 240. |
|
La coordenada x final de la línea, expresada como un número entero entre 0 y 240. |
|
La coordenada y final de la línea, expresada como un número entero entre 0 y 240. |
# Draw a line from the top left to bottom right of the screen
robot.screen.draw_line(0, 0, 240, 240)

draw_rectangle#
draw_rectangle dibuja un rectángulo con su esquina superior izquierda en la coordenada (x, y) seleccionada y un tamaño determinado por el ancho y alto dados, todos medidos en píxeles. El contorno del rectángulo se dibuja usando el ancho del lápiz y el color del lápiz actuales. El interior se rellena con el color de relleno actual, a menos que se use el parámetro opcional color.
Las coordenadas x e y utilizan el origen predeterminado de (0, 0) a menos que se haya establecido un origen diferente utilizando set_origin.
Usage:robot.screen.draw_rectangle(x, y, width, height, color)
Parámetro |
Descripción |
|---|---|
|
La coordenada x de la esquina superior izquierda del rectángulo, expresada como un número entero de 0 a 240. |
|
La coordenada y de la esquina superior izquierda del rectángulo, expresada como un número entero de 0 a 240. |
|
El ancho del rectángulo, expresado como un número entero de 0 a 240. |
|
La altura del rectángulo, expresada como un número entero de 0 a 240. |
|
Opcional. El color de relleno del rectángulo. Las opciones incluyen:
|
# Draw a red rectangle on the screen
robot.screen.draw_rectangle(50, 50, 130, 60, RED)

draw_circle#
draw_circle dibuja un círculo con su centro en la coordenada (x, y) seleccionada y un tamaño determinado por el radio dado, todo medido en píxeles. El contorno del círculo se dibuja usando el ancho del lápiz y el color del lápiz actuales. El interior se rellena con el color de relleno actual, a menos que se use el parámetro opcional color.
Las coordenadas x e y utilizan el origen predeterminado de (0, 0) a menos que se haya establecido un origen diferente utilizando set_origin.
Usage:robot.screen.draw_circle(x, y, radius, color)
Parámetro |
Descripción |
|---|---|
|
La coordenada x del centro del círculo, expresada como un número entero de 0 a 240. |
|
La coordenada y del centro del círculo, expresada como un número entero de 0 a 240. |
|
El radio del círculo, expresado como un número entero de 0 a 240 píxeles. |
|
Opcional. El color de relleno del círculo. Las opciones incluyen:
|
# Draw a green circle on the screen
robot.screen.draw_circle(120, 120, 40, GREEN)

show_file#
show_file muestra una imagen personalizada cargada en la pantalla del robot, con su posición establecida usando los parámetros x, y, y center basados en el punto de referencia de la imagen.
Usage:
robot.screen.show_file(file, x, y, center)
Parámetro |
Descripción |
|---|---|
|
La imagen personalizada a utilizar, desde |
|
El desplazamiento horizontal de la imagen, expresado como un entero en píxeles. Los valores positivos lo desplazan hacia la derecha; los negativos, hacia la izquierda. |
|
El desplazamiento vertical de la imagen, expresado como un entero en píxeles. Los valores positivos lo desplazan hacia abajo; los negativos, hacia arriba. |
|
Optional. If |
# Display uploaded Image 1 in the top left corner
robot.screen.show_file(IMAGE1, 0, 0)
# Show the same image on both sides of the screen
# Image size is 120 x 120
robot.screen.show_file(IMAGE1, 65, 0, center=True)
robot.screen.show_file(IMAGE1, -65, 0, center=True)
set_clip_region#
set_clip_region define un área rectangular en la pantalla donde se confinarán todos los dibujos y el texto. Cualquier contenido fuera de esta región no se mostrará.
Usage:
robot.screen.set_clip_region(x, y, width, height)
Parámetro |
Descripción |
|---|---|
|
La coordenada x de la esquina superior izquierda de la región de recorte, dada como un decimal ( |
|
La coordenada y de la esquina superior izquierda de la región de recorte, dada como un decimal ( |
|
El ancho de la región de recorte en píxeles, dado como un decimal ( |
|
La altura de la región de recorte en píxeles, dada como un decimal ( |
# Restrict text and drawings to a specific region
robot.screen.set_clip_region(0, 0, 120, 120)
robot.screen.draw_rectangle(60, 60, 100, 100, RED)
robot.screen.print_at("Cut off!", x=60, y=60)

Devoluciones de llamada#
pressed#
pressed registra un método que se llamará cuando se pulse la pantalla del robot.
Usage:robot.screen.pressed(callback, arg)
Parámetros |
Descripción |
|---|---|
|
Una función que se define previamente para ejecutarse cuando se presiona la pantalla del controlador. |
|
Opcional. Una tupla que contiene los argumentos que se pasarán a la función de devolución de llamada. Consulte Uso de funciones con parámetros para obtener más información. |
# Set the LEDs to green when the screen is pressed.
def screen_touched():
robot.led.on(ALL_LEDS, GREEN)
robot.screen.pressed(screen_touched)
released#
released registra un método que se llamará cuando se suelte la pantalla del robot.
Usage:robot.screen.released(callback, arg)
Parámetros |
Descripción |
|---|---|
|
Una función que se define previamente para ejecutarse cuando se presiona la pantalla del controlador. |
|
Opcional. Una tupla que contiene los argumentos que se pasarán a la función de devolución de llamada. Consulte Uso de funciones con parámetros para obtener más información. |
# Set the LEDs to blue when the screen is released.
def screen_released():
robot.led.on(ALL_LEDS, BLUE)
robot.screen.released(screen_released)










