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.

Funciones de devolución de llamada: ejecutan funciones cuando se presiona o se suelta la pantalla.

  • pressed – Registra una función que se llamará cuando se presione la pantalla.

  • released – Registra una función que se llamará cuando se suelte 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

text

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!")

Captura de pantalla de la pantalla del robot, con "¡Hola, robot!" impreso en blanco en la parte superior.

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

row

La fila a la que mover el cursor.

column

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")

Captura de pantalla de la pantalla del robot, con "Fila 3, Columna 2" impreso en blanco justo encima del centro de la pantalla, comenzando en la fila 3, columna 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")

Captura de pantalla de la pantalla del robot con texto blanco. La pantalla muestra la Línea 1 en la línea superior, alineada a la izquierda, y la Línea 2 justo debajo.

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

row

Opcional. La fila que se va a borrar como un número entero. Por defecto, se utiliza la fila actual del cursor.

color

Opcional. El color que se aplicará a la fila borrada. Las opciones incluyen:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
También puede especificar un color personalizado.

# 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)

Captura de pantalla de la pantalla del robot con una barra verde que cruza el centro de la pantalla de izquierda a derecha.

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())

Captura de pantalla de SA de la pantalla del robot, con un 3 blanco impreso cerca del centro del cuadrante superior izquierdo, en la fila 3, columna 2.

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())

Captura de pantalla de la pantalla del robot, con un 2 blanco impreso cerca del centro del cuadrante superior izquierdo, en la fila 3, columna 2.

Impresión XY#

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

x

La nueva coordenada x que se establecerá como origen, expresada como un número entero de 0 a 240.

y

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)

Captura de pantalla de la pantalla del robot con un rectángulo blanco dibujado en el cuadrante inferior izquierdo. La esquina superior izquierda del rectángulo es el centro de la pantalla.

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

color

Opcional. Establece el color de la pantalla. Las opciones incluyen:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
También puede especificar un color personalizado.

# 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)

Captura de pantalla de la pantalla del robot, mostrando toda la pantalla en rojo brillante.

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

fontname

Sets the font to one of the following:

  • MONO12
  • MONO15
  • MONO20
  • MONO24
  • MONO30
  • MONO40
  • MONO60
  • PROP20
  • PROP30
  • PROP40
  • PROP60
These options are shown below.

Captura de pantalla de la pantalla del robot que muestra una muestra de números y letras impresos en fuente Mono 12. El alfabeto ocupa 1 fila de texto. En la parte inferior se leen 26 caracteres de ancho y 15 filas.
MONO12

La misma imagen que la anterior con la fuente Mono 15. Las letras AT abarcan 1 fila de texto. En la parte inferior se leen 20 caracteres de ancho y 12 filas.
MONO15

La misma imagen que la anterior, con la fuente Mono 20. Las letras AP abarcan 1 fila de texto. En la parte inferior se leen 16 caracteres de ancho y 9 filas.
MONO20

La misma imagen que la anterior, con la fuente Mono 24. Las letras AM abarcan 1 fila de texto. En la parte inferior se leen 13 caracteres de ancho y 8 filas.
MONO24

Misma imagen que la anterior, con fuente Mono 30. Las letras AK abarcan 1 fila de texto. En la parte inferior se leen 11 caracteres de ancho y 6 filas.
MONO30

Misma imagen que la anterior, con fuente Mono 40. Las letras AH abarcan 1 fila de texto. La parte inferior muestra 8 caracteres de ancho y 5 filas.
MONO40

Misma imagen que la anterior, con números impresos en fuente Mono 60. Los números del 1 al 6 ocupan 1 fila de texto. En la parte inferior se lee 3 filas.
MONO60

Misma imagen que la anterior, con la fuente Prop 20. Las letras A abarcan 1 fila de texto. En la parte inferior se leen 20 caracteres de ancho y 9 filas.
PROP20

Misma imagen que la anterior, con la fuente Prop 30. Las letras AM abarcan 1 fila de texto. La parte inferior muestra 15 caracteres de ancho y 6 filas.
PROP30

Misma imagen que la anterior, con la fuente Prop 40. Las letras AJ abarcan 1 fila de texto. En la parte inferior se leen 11 caracteres de ancho y 5 filas.
PROP40

Misma imagen que la anterior, con números impresos en la fuente de la Propuesta 60. Los números del 1 al 7 abarcan 1 fila de texto. En la parte inferior se lee 7 por 3.
PROP60

# Display text using a larger font
robot.screen.set_font(MONO40)
robot.screen.print("VEX")

Una captura de pantalla de la pantalla del robot muestra VEX en fuente Mono 40 en la esquina superior izquierda.

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

width

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)

Captura de pantalla de la pantalla del robot con un grueso rectángulo blanco dibujado en la mitad superior.

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

color

Opcional. El color del bolígrafo y la fuente a utilizar. Las opciones incluyen:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
También puede especificar un color personalizado.

# Draw a rectangle with a red pen
robot.screen.set_pen_color(RED)
robot.screen.draw_rectangle(50, 50, 130, 60)

Captura de pantalla de la pantalla del robot con un rectángulo rojo de borde fino dibujado en la mitad superior.

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

color

Opcional. El color de relleno a utilizar. Las opciones incluyen:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
También puede especificar un color personalizado.

# 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)

Captura de pantalla de la pantalla del robot con dos rectángulos naranjas paralelos con finos contornos blancos situados en el centro izquierdo de la pantalla.

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

Una captura de pantalla de la pantalla del robot muestra la palabra "Resaltar" en texto blanco con un resaltado morado a su alrededor, comenzando en la esquina superior izquierda.

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

x

La coordenada x donde se dibujará el píxel, expresada como un número entero de 0 a 240.

y

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)

Captura de pantalla de la pantalla del robot con un solo píxel blanco en el centro.

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

x1

La coordenada x inicial de la línea, expresada como un número entero entre 0 y 240.

y1

La coordenada y inicial de la línea, expresada como un número entero entre 0 y 240.

x2

La coordenada x final de la línea, expresada como un número entero entre 0 y 240.

y2

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)

Captura de pantalla de la pantalla del robot con una fina línea diagonal blanca dibujada desde la esquina superior izquierda hasta la esquina inferior derecha.

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

x

La coordenada x de la esquina superior izquierda del rectángulo, expresada como un número entero de 0 a 240.

y

La coordenada y de la esquina superior izquierda del rectángulo, expresada como un número entero de 0 a 240.

width

El ancho del rectángulo, expresado como un número entero de 0 a 240.

height

La altura del rectángulo, expresada como un número entero de 0 a 240.

color

Opcional. El color de relleno del rectángulo. Las opciones incluyen:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
También puede especificar un color personalizado.

# Draw a red rectangle on the screen
robot.screen.draw_rectangle(50, 50, 130, 60, RED)

Captura de pantalla de la pantalla del robot con un rectángulo rojo brillante con un borde blanco delgado centrado en la mitad superior de la pantalla.

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

x

La coordenada x del centro del círculo, expresada como un número entero de 0 a 240.

y

La coordenada y del centro del círculo, expresada como un número entero de 0 a 240.

radius

El radio del círculo, expresado como un número entero de 0 a 240 píxeles.

color

Opcional. El color de relleno del círculo. Las opciones incluyen:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
También puede especificar un color personalizado.

# Draw a green circle on the screen
robot.screen.draw_circle(120, 120, 40, GREEN)

Captura de pantalla de la pantalla del robot con un círculo verde brillante con un borde blanco fino en el centro.

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

file

La imagen personalizada a utilizar, desde IMAGE1 hasta IMAGE10El número de imagen coincide con el número que se muestra en el panel de control de AIM.

x

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.

y

El desplazamiento vertical de la imagen, expresado como un entero en píxeles. Los valores positivos lo desplazan hacia abajo; los negativos, hacia arriba.

center

Optional. If center=True, the image is placed using its center at coordinate (120, 120). By default (center=False), the top-left corner of the image is used and positioned relative to the current origin.

# 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

x

La coordenada x de la esquina superior izquierda de la región de recorte, dada como un decimal (float) de 0 a 240.

y

La coordenada y de la esquina superior izquierda de la región de recorte, dada como un decimal (float) de 0 a 240.

width

El ancho de la región de recorte en píxeles, dado como un decimal (float) de 0 a 240.

height

La altura de la región de recorte en píxeles, dada como un decimal (float) de 0 a 240.

# 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)

Captura de pantalla de la pantalla del robot que muestra el texto y la imagen que se ajustan a la región de recorte. En el cuadrante superior izquierdo, el texto blanco dice "Cortar o", con un cuadrado rojo justo debajo.

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

callback

Una función que se define previamente para ejecutarse cuando se presiona la pantalla del controlador.

arg

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

callback

Una función que se define previamente para ejecutarse cuando se presiona la pantalla del controlador.

arg

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)