Pantalla#

Introducción#

La pantalla del robot de codificación VEX AIM ofrece bloques para mostrar texto, controlar el cursor, dibujar formas y gestionar interacciones táctiles. A continuación, se muestra una lista de todos los bloques disponibles, agrupados por funcionalidad:

Impresión del cursor: administre la visualización del texto mediante un sistema de cursor de filas y columnas.

Impresión XY: imprime texto en coordenadas basadas en píxeles.

Configuración: personaliza el formato del texto y la visualización de la pantalla.

Dibujar - Crear gráficos y elementos visuales.

Toque: detecta interacciones en la pantalla.

Cursor Imprimir#

imprimir#

El bloque imprimir muestra texto en la pantalla del robot en la posición del cursor y fuente actuales.

bloque de pila de impresión#
imprimir [VEXcode] en la pantalla ▶

Parámetros

Descripción

valor

El texto, número o valor de variable que se mostrará en la pantalla.

flecha expansiva

Expande el bloque para leer y establece el cursor en la siguiente fila y haz que el cursor se mueva a la siguiente fila después de este bloque.

Ejemplo

Cuando se inicia, muestra el mensaje “¡Hola, robot!” en la posición inicial del cursor en la pantalla.#
cuando empezó :: hat events
[Display a message at the starting cursor position.]
imprimir [Hello, Robot!] en la pantalla ▶

Muestra el método robot.screen.print con la palabra "¡Hola Robot!"

establecer el cursor en la fila columna#

Al usar el bloque establecer cursor en fila y columna, el cursor se coloca en una fila y columna específicas de la pantalla. El número de filas y columnas que se pueden colocar cómodamente depende de la fuente seleccionada. Con la fuente monoespaciada mediana predeterminada, se pueden mostrar con claridad hasta 8 filas y 13 columnas. El texto que se encuentre fuera de este rango puede quedar cortado o resultar 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 utilizado, el bloque establecer cursor en fila y columna posiciona el cursor según el tamaño de fila y columna, no el estilo de fuente. El tamaño de fuente se puede ajustar mediante el bloque establecer fuente.

Establecer bloque de pila de cursor#
Coloque el cursor en la fila [1] columna [1] en la pantalla

Parámetros

Descripción

fila

La fila del cursor.

columna

La columna del cursor.

Ejemplos

Al iniciarse, mueve el cursor a la fila 3, columna 2 en la pantalla e imprime ‘Fila 3, columna 2’.#
cuando empezó :: hat events
[Display text starting at Row 3 Column 2.]
Coloque el cursor en la fila (3) columna (2) en la pantalla
imprimir [Row 3, Column 2] en la pantalla ▶

Muestra el método robot.screen.print_at con la Fila 3, Columna 2 impresa en la fila 3 columna 2

cuando empezó :: hat events
[Display cargo amounts in an organized list.]
Establezca la fuente en [proporcional v] [grande v] en la pantalla
imprimir [Sports Balls] en la pantalla ◀ y coloque el cursor en la siguiente fila
imprimir [Orange Barrels] en la pantalla ◀ y coloque el cursor en la siguiente fila
imprimir [Blue Barrels] en la pantalla ▶
Coloque el cursor en la fila [1] columna [11] en la pantalla
imprimir [2] en la pantalla ▶
Coloque el cursor en la fila [2] columna [11] en la pantalla
imprimir [3] en la pantalla ▶
Coloque el cursor en la fila [3] columna [11] en la pantalla
imprimir [3] en la pantalla ▶

Un fondo circular azul oscuro muestra tres líneas de texto blanco que enumeran las pelotas deportivas 2, los barriles naranjas 3 y los barriles azules 3. Los números están alineados a la derecha de cada etiqueta.

cuando empezó :: hat events
[Display the ID of the detected AprilTag.]
Establezca la fuente en [proporcional v] [extra grande v] en la pantalla
para siempre
pantalla clara
imprimir [AprilTag] en la pantalla ▶
obtener [all AprilTags v] datos de AI Vision
si <¿Existe el objeto AI Vision?> entonces
Coloque el cursor en la fila [3] columna [4] en la pantalla
imprimir (Objeto de visión de IA [ID de etiqueta v]) en la pantalla ▶
fin
esperar [0.1] segundos

Un fondo circular azul oscuro muestra un texto blanco centrado en la imagen, que dice AprilTag en la primera línea y 4 en la segunda línea.

colocar el cursor en la siguiente fila#

El bloque establecer cursor en la siguiente fila mueve el cursor a la columna 1 en la siguiente fila de la pantalla del robot.

establece el cursor en el siguiente bloque de pila de fila#
Colocar el cursor en la siguiente fila de la pantalla

Parámetros

Descripción

Este bloque no tiene parámetros.

Ejemplo

Cuando se inicia, imprime ‘Línea 1’ en la pantalla, mueve el cursor a la siguiente fila y luego imprime ‘Línea 2’.#
cuando empezó :: hat events
[Display two lines of text.]
imprimir [Line 1] en la pantalla ▶
Colocar el cursor en la siguiente fila de la pantalla
imprimir [Line 2] en la pantalla ▶

Muestra el método robot.screen.next_row con la Línea 1 y la Línea 2 impresas en la pantalla del robot en la línea 1 y la línea 2 respectivamente.

fila despejada#

El bloque borrar fila borra una fila de texto en la pantalla del robot.

Borrar bloque de pila de filas#
Limpiar la fila [1] de la pantalla

Parámetros

Descripción

fila

El número de fila a borrar.

Ejemplo

Al iniciarse, imprime texto en dos filas. La primera fila permanece, mientras que la segunda desaparece después de 3 segundos.#
cuando empezó :: hat events
[Display text on two rows.]
imprimir [This text stays] en la pantalla ▶
Colocar el cursor en la siguiente fila de la pantalla
imprimir [This text disappears] en la pantalla ▶
esperar [3] segundos
Limpiar la fila [2] de la pantalla

columna del cursor de la pantalla#

El bloque columna del cursor de pantalla devuelve el número de columna donde se imprimirá el texto como un entero.

bloque de reportero de columna de cursor de pantalla#
(columna del cursor de la pantalla)

Parámetros

Descripción

Este bloque no tiene parámetros.

Ejemplo

Cuando se inicia, mueve el cursor a la fila 3, columna 2 de la pantalla e imprime el número de columna del cursor actual.#
cuando empezó :: hat events
[Display the cursor's current column.]
Coloque el cursor en la fila [3] columna [2] en la pantalla
imprimir (columna del cursor de la pantalla) en la pantalla ▶

Muestra el método robot.screen.print_at mostrando la columna número 2 cuando establece cursor en 3,2

fila del cursor de la pantalla#

El bloque fila del cursor de pantalla devuelve el número de fila donde se imprimirá el texto como un entero.

bloque de reportero de filas del cursor de pantalla#
(fila del cursor de la pantalla)

Parámetros

Descripción

Este bloque no tiene parámetros.

Ejemplo

Cuando se inicia, mueve el cursor a la fila 6, columna 2 de la pantalla e imprime el número de fila actual del cursor.#
cuando empezó :: hat events
[Display the cursor's current row.]
Coloque el cursor en la fila [3] columna [2] en la pantalla
imprimir (fila del cursor de la pantalla) en la pantalla ▶

Muestra el método robot.screen.print_at mostrando la fila número 3 cuando establece cursor en 3,2

Impresión XY#

establecer el origen de la pantalla#

El bloque establecer origen de pantalla establece el origen (0,0) utilizado para dibujar o imprimir en la pantalla del robot. Por defecto, los bloques de dibujo o impresión consideran la esquina superior izquierda de la pantalla como origen. Este bloque puede restablecer el origen a una ubicación alternativa de coordenadas (x, y) en la pantalla.

Establecer bloque de pila de origen de pantalla#
establecer origen de pantalla x: [0] y: [0]

Parámetros

Descripción

incógnita

La coordenada x en píxeles para establecer el nuevo origen.

y

La coordenada y en píxeles para establecer el nuevo origen.

Ejemplo

Cuando se inicia, establece el origen de la pantalla en (120, 120) y dibuja un rectángulo en el nuevo origen con la esquina superior izquierda en (0,0), ancho de 80 píxeles y alto de 40 píxeles.#
cuando empezó :: hat events
[Set the origin to the center of the screen.]
establecer origen de pantalla x: [120] y: [120]
[Draw a rectangle at the new origin.]
dibuja el rectángulo [0] [0] [80] [40] en la pantalla

La pantalla del robot muestra un rectángulo blanco con la esquina superior izquierda en el centro.

Ajustes#

pantalla clara#

El bloque borrar pantalla borra todos los dibujos y textos de la pantalla del robot y restablece la posición del cursor en la fila 1, columna 1.

borrar bloqueo de pantalla#
pantalla clara

Parámetros

Descripción

Este bloque no tiene parámetros.

Ejemplo

Al iniciarse, dibuja un círculo con centro (120,120) y radio de 40 píxeles. Después de 2 segundos, la pantalla se borra.#
cuando empezó :: hat events
[Draw a circle, and clear it after 2 seconds.]
dibuja el círculo [120] [120] [40] en la pantalla
esperar [2] segundos
pantalla clara

llenar la pantalla#

El bloque llenar pantalla borra todos los dibujos y textos de la pantalla del robot y luego cambia el fondo a un color específico.

El bloque de pantalla de relleno#
llenar la pantalla con [rojo v]

Parámetros

Descripción

color

El color al que cambiar el fondo:

  • rojo
  • verde
  • azul
  • negro
  • blanco
  • amarillo
  • naranja
  • morado
  • cian

Ejemplo

cuando empezó :: hat events
[Say "Hello" then turn screen yellow.]
imprimir [Hello] en la pantalla ▶
esperar [2] segundos
llenar la pantalla con [amarillo v]

establecer fuente#

El bloque establecer fuente define la fuente y el tamaño que se usarán para mostrar el texto en la pantalla del robot. Esta fuente se aplicará a todo el texto impreso posteriormente.

establecer bloque de pila de fuentes#
Establezca la fuente en [monoespaciado v] [superpequeño v] en la pantalla

Parámetros

Descripción

tipo

Tipo de fuente:

  • monoespaciado
  • proporcional

tamaño

El tamaño de fuente (que se muestra a continuación):

  • súper pequeño
  • extra pequeño
  • pequeño
  • mediano
  • grande
  • extra grande
  • súper grande

El robot serigrafió números y letras con la fuente MONO 12. Muestra de la A a la Z. En la parte inferior de la pantalla, tiene 26 caracteres de ancho y 15 filas..
Monoespaciado super pequeña

El robot serigrafió números y letras con la fuente MONO 15. Muestra de la A a la T. En la parte inferior de la pantalla, tiene 20 caracteres de ancho y 12 filas..
Monoespaciado extra pequeña

El robot serigrafió números y letras con la fuente MONO 20. Muestra de la A a la P. En la parte inferior de la pantalla, tiene 16 de ancho y 9 filas..
Monoespaciado pequeña

El robot serigrafió números y letras con la fuente MONO 24. Muestra de la A a la M. En la parte inferior de la pantalla, tiene 13 de ancho y 8 filas..
medio monoespaciado

El robot serigrafió números y letras con la fuente MONO 30. Muestra de la A a la K. En la parte inferior de la pantalla, tiene 11 caracteres de ancho y 6 filas..
monoespaciado grande

El robot serigrafió números y letras con la fuente MONO 40. Muestra de la A a la K. En la parte inferior de la pantalla, tiene 8 caracteres de ancho y 5 filas..
monoespaciado extra grande

El robot serigrafió números y letras con la fuente MONO 60. Muestra del 1 al 6. En la parte inferior de la pantalla, tiene 3 filas.
monoespaciado supergrande

El robot imprimió números y letras en pantalla con la fuente PROP 20. Muestra AS. En la parte inferior de la pantalla, tiene 8 de ancho y 9 filas.
proporcional pequeño

El robot imprimió números y letras en la pantalla con la fuente PROP 30. Muestra AM. En la parte inferior de la pantalla, mide 15 de ancho y 6 filas.
proporcional grande

El robot serigrafió números y letras con la fuente PROP 40. Muestra AM. En la parte inferior de la pantalla, mide 15 de ancho y 6 filas. (/_static/img/fonts/prop40.png)
extra grande proporcional

El robot serigrafió números y letras con la fuente PROP 60. Muestra del 1 al 7. En la parte inferior de la pantalla, tiene un 7 de ancho y 3 filas. (/_static/img/fonts/prop60.png)
proporcional supergrande

Ejemplo

Cuando se inicia, establece la fuente en ‘monoespaciado extra grande’ e imprime ‘VEX’ en la pantalla.#
cuando empezó :: hat events
[Display text using a larger font]
Establezca la fuente en [monoespaciado v] [extra grande v] en la pantalla
imprimir [VEX] en la pantalla ▶

La pantalla del robot muestra la palabra VEX en fuente Mono 40 en la esquina superior izquierda.

establecer la precisión de impresión#

El bloque establecer precisión de impresión define el formato de precisión utilizado para mostrar los números en la pantalla del robot. Esta precisión de impresión se aplicará a todos los números impresos posteriormente.

Establecer bloque de pila de precisión de impresión#
Establezca la precisión de impresión en [0.1 v] en la pantalla

Parámetros

Descripción

precisión

Establece la precisión de impresión en:

  • 1
  • 0,1
  • 0,01
  • 0,001
  • Todos los dígitos

Ejemplo

Cuando se inicia, establece la precisión de impresión en dos decimales e imprime 1/3 como 0,33 en la pantalla.#
cuando empezó :: hat events
[Print 1/3 as 0.33.]
Establezca la precisión de impresión en [0.01 v] en la pantalla
imprimir ([1] [math_division v] [3]) en la pantalla ▶

La pantalla del robot muestra un rectángulo blanco con un borde ancho dibujado centrado en la parte superior.

establecer el ancho del lápiz#

El bloque establecer ancho de lápiz establece el ancho de lápiz utilizado para dibujar líneas y formas.

Bloque de ancho de pluma establecido#
Establezca el ancho del lápiz en [10] en la pantalla

Parámetros

Descripción

ancho

El ancho del lápiz en píxeles en un rango de 0 a 32.

Ejemplo

Cuando se inicia, establece el ancho del lápiz en 10 píxeles y dibuja un rectángulo con la esquina superior izquierda en (50,50), ancho de 130 píxeles y alto de 60 píxeles.#
cuando empezó :: hat events
[Draw a rectangle with a pen width of 10.]
Establezca el ancho del lápiz en [10] en la pantalla
dibuja el rectángulo [50] [50] [130] [60] en la pantalla

La pantalla del robot muestra un rectángulo rojo con un borde delgado dibujado centrado en la parte superior.

Establecer color de pluma/fuente#

El bloque establecer color de lápiz/fuente establece el color del lápiz utilizado para dibujar líneas, formas y texto en la pantalla del robot.

establecer el color de fuente del bolígrafo#
Establezca el color del lápiz/fuente en [rojo v] en la pantalla

Parámetros

Descripción

color

Establece el color del lápiz a:

  • rojo
  • verde
  • azul
  • negro
  • blanco
  • amarillo
  • naranja
  • morado
  • cian
  • transparente

Ejemplo

Cuando se inicia, establece el color del lápiz en rojo y dibuja un rectángulo con la esquina superior izquierda en (50, 50), ancho 130 píxeles y alto 60 píxeles.#
cuando empezó :: hat events
[Draw a rectangle with a red pen.]
Establezca el color del lápiz/fuente en [rojo v] en la pantalla
dibuja el rectángulo [50] [50] [130] [60] en la pantalla

La pantalla del robot muestra un rectángulo rojo con un borde delgado dibujado centrado en la parte superior.

establecer color de relleno#

El bloque establecer color de relleno establece el color de relleno utilizado cuando se dibujan formas.

Establecer bloque de pila de color de relleno#
Establezca el color de relleno en [rojo v] en la pantalla

Parámetros

Descripción

color

Establece el color de relleno a:

  • rojo
  • verde
  • azul
  • negro
  • blanco
  • amarillo
  • naranja
  • púrpura
  • cian
  • transparente

Ejemplos

Al iniciarse, establece el color de relleno en naranja y dibuja dos rectángulos. El primero está en (50, 50) y el segundo en (50, 130), ambos con 100 píxeles de ancho y 60 de alto.#
cuando empezó :: hat events
[Draw two orange rectangles.]
Establezca el color de relleno en [naranja v] en la pantalla
dibuja el rectángulo [50] [50] [100] [60] en la pantalla
dibuja el rectángulo [50] [130] [100] [60] en la pantalla

La pantalla del robot muestra dos rectángulos naranjas paralelos con bordes blancos delgados dibujados en la pantalla, ligeramente descentrados hacia la izquierda.


Cuando se inicia, establece el color de relleno de fondo en violeta e imprime “Resaltar” en la pantalla.#
cuando empezó :: hat events
[Display text with a purple background.]
Establezca el color de relleno en [púrpura v] en la pantalla
imprimir [Highlight] en la pantalla ▶

La pantalla del robot muestra la palabra Resaltar en texto blanco con resaltado morado alrededor, impreso comenzando en la esquina superior izquierda.

Dibujar#

mostrar archivo de imagen#

El bloque mostrar archivo de imagen dibuja una imagen personalizada cargada por el usuario en la pantalla del robot.

mostrar bloque de pila de imágenes de usuario#
mostrar archivo de imagen [1 v]

Parámetros

Descripción

número de ranura de imagen

La imagen personalizada a utilizar, número del 1 al 10. El número de la imagen se alinea con el número que se muestra en el panel de control de AIM.

Ejemplo

hacer#
cuando empezó :: hat events
[Draw uploaded Image 1.]
mostrar archivo de imagen [1 v]

dibujar píxeles#

El bloque dibujar píxel dibuja un píxel en la coordenada de pantalla especificada (x, y) en el color de lápiz actual.

dibujar bloque de pila de píxeles#
Dibuja el píxel [0] [0] en la pantalla

Parámetros

Descripción

incógnita

La coordenada x para dibujar el píxel.

y

La coordenada y para dibujar el píxel.

Ejemplo

Cuando se inicia, dibuja un píxel en el centro de la pantalla en las coordenadas (120, 120).#
cuando empezó :: hat events
[Draw a pixel at the center of the screen.]
Dibuja el píxel [120] [120] en la pantalla

La pantalla del robot muestra un solo píxel impreso en blanco en el centro.

dibujar una línea#

El bloque dibujar línea dibuja una línea desde la primera coordenada de pantalla especificada (x1, y1) hasta la segunda coordenada de pantalla especificada (x2, y2) utilizando el ancho del lápiz y el color del lápiz actuales.

bloque de pila de línea de dibujo#
dibuja la línea [0] [0] [10] [10] en la pantalla

Parámetros

Descripción

x1

La coordenada x en píxeles del inicio de la línea.

año1

La coordenada y en píxeles del inicio de la línea.

x2

La coordenada x en píxeles del final de la línea.

Año 2

La coordenada y en píxeles del final de la línea.

Ejemplo

Al iniciarse, dibuja una línea diagonal desde la esquina superior izquierda (0,0) hasta la esquina inferior derecha (240,240) de la pantalla.#
cuando empezó :: hat events
[Draw a line from the top left to bottom right of the screen.]
dibuja la línea [0] [0] [240] [240] en la pantalla

La pantalla del robot muestra una delgada línea diagonal en el centro, desde la esquina superior izquierda hasta la esquina inferior derecha.

dibujar rectángulo#

El bloque dibujar rectángulo dibuja un rectángulo utilizando el ancho del lápiz, el color del lápiz y los colores de relleno actuales.

dibujar bloque de rectángulo#
dibuja el rectángulo [0] [0] [10] [10] en la pantalla

Parámetros

Descripción

incógnita

La coordenada x en píxeles de la esquina superior izquierda del rectángulo.

y

La coordenada y en píxeles de la esquina superior izquierda del rectángulo.

ancho

El ancho del rectángulo en píxeles.

altura

La altura del rectángulo en píxeles.

Ejemplo

Cuando se inicia, dibuja un rectángulo en la pantalla con la esquina superior izquierda en (50,50), ancho de 130 píxeles y alto de 60 píxeles.#
cuando empezó :: hat events
[Draw a rectangle on the screen.]
dibuja el rectángulo [50] [50] [130] [60] en la pantalla

La pantalla del robot muestra un rectángulo rojo con un fino borde blanco dibujado en la parte superior.

dibujar un círculo#

El bloque dibujar círculo dibuja un círculo utilizando el ancho del lápiz, el color del lápiz y los colores de relleno actuales.

Dibujar bloque de pila circular#
dibuja el círculo [0] [0] [10] en la pantalla

Parámetros

Descripción

incógnita

La coordenada x en píxeles del centro del círculo.

y

La coordenada y en píxeles del centro del círculo.

radio

El radio del círculo en píxeles.

Ejemplo

Al iniciarse, dibuja un círculo en la pantalla con el centro en (120,120) y un radio de 40 píxeles.#
cuando empezó :: hat events
[Draw a rectangle on the screen.]
dibuja el círculo [120] [120] [40] en la pantalla

La pantalla del robot muestra un círculo verde con un fino borde blanco dibujado en el centro.

Tocar#

¿pantalla presionada?#

El bloque ¿Pantalla presionada? indica si la pantalla del robot está presionada o no. Este bloque devuelve un valor booleano:

  • Verdadero: la pantalla está siendo presionada actualmente

  • Falso: no se presiona la pantalla

bloque booleano presionado en pantalla#
<¿pantalla presionada?>

Parámetros

Descripción

Este bloque no tiene parámetros.

Ejemplo

Al iniciarse, comprueba continuamente si la pantalla está presionada. Si se presiona, todos los LED se vuelven blancos; de lo contrario, permanecen apagados.#
cuando empezó :: hat events
[Turn LEDs white only when the screen is pressed.]
para siempre
si <¿pantalla presionada?> entonces
Establezca el color del LED [lightall v] en [blanco v]
demás
Establezca el color del LED [lightall v] en [apagado v]
fin
fin

posición de la pantalla#

El bloque posición de pantalla devuelve un entero que muestra las coordenadas x e y (en píxeles) donde se presionó la pantalla. El valor de retorno para x está entre 0 (izquierda) y 240 (derecha). El valor de retorno para y está entre 0 (arriba) y 240 (abajo).

Vista cenital de un robot AIM apagado que muestra un cuadrado blanco superpuesto con las esquinas etiquetadas con las coordenadas (0,0), (240,0), (0,240) y (240,240/_static/img/screen/aim-screen-resolution.png. Un círculo rojo está centrado dentro del cuadrado y una cruz discontinua blanca interseca en el centro de la imagen, marcada con las coordenadas 120,120.

bloque de reportero de posición de pantalla#
(posición de pantalla [incógnita v])

Parámetros

Descripción

coordinar

La coordenada de la última pulsación de pantalla en píxeles:

  • x - La posición horizontal
  • y - La posición vertical

Ejemplo

Al iniciarse, verifica continuamente si se pulsa la pantalla. Si se pulsa, borra la pantalla e imprime las coordenadas x e y de la posición táctil.#
cuando empezó :: hat events
[Display the x and y coordinate of where the screen is pressed.]
para siempre
si <¿pantalla presionada?> entonces
pantalla clara
imprimir (posición de pantalla [incógnita v]) en la pantalla ▶
Colocar el cursor en la siguiente fila de la pantalla
imprimir (posición de pantalla [y v]) en la pantalla ▶
fin
fin

cuando el evento de pantalla#

El bloque cuando hay evento de pantalla debe llamarse cuando la pantalla del robot esté presionada o ya no esté presionada.

Cuando el evento de pantalla se bloquea#
cuando la pantalla [presionado v] :: hat events

Parámetros

Descripción

acción

Determina cuándo se ejecutará la pila de bloques adjunta:

  • presionado
  • liberado

Ejemplo

Cuando se presiona la pantalla, todos los LED se vuelven verdes.#
cuando la pantalla [presionado v] :: hat events
[Set the LEDs to green when the screen is pressed.]
Establezca el color del LED [lightall v] en [verde v]