Pantalla#

Introducción #

The VEX AIM Coding Robot’s screen provides blocks for displaying text, managing the cursor, drawing shapes, and handling touch interactions.

Below is a list of all blocks:

Cursor Print — Manage text display using a row-and-column cursor system.

print — Displays text on the screen at the current cursor position.
set cursor to row column — Moves the cursor to a specific row and column.
set cursor to next row — Moves the cursor to column 1 of the next row.
clear row — Clears a specified row of text.
screen cursor column — Returns the column number where text will be printed.
screen cursor row — Returns the row number where text will be printed.

XY Print — Print text at pixel-based coordinates.

print at — Displays text at a specified x and y coordinate.
set screen origin — Changes the origin used for drawing and printing.

Settings — Customize text formatting and screen display.

clear screen — Erases all text and drawings from the screen.
fill screen — Erases all text and drawings from the screen, then sets the screen’s background color.
set font — Changes the font type and size for text display.
set print precision — Adjusts the amount of decimal places for printed numbers.
set pen width — Adjusts the thickness of drawn lines.
set pen / font color — Changes the color for text and drawings.
set fill color — Defines the fill color for shapes.

Draw — Create graphics and visual elements.

show image file — Displays a user-uploaded image on the screen.
draw pixel — Draws a single pixel at a specified coordinate.
draw line — Draws a line between two points.
draw rectangle — Draws a rectangle with specified dimensions.
draw circle — Draws a circle with a given radius.

Touch — Detect screen interactions.

screen pressed? — Returns whether the screen is currently being pressed.
screen position — Returns the x and y coordinates where the screen was last touched.
when screen event — Triggers when the screen is pressed or released.

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	Expand the block to read and set cursor to next row to make the cursor move to the next row after this block.

Ejemplo

Cuando se inicia, muestra el mensaje “¡Hola, robot!” en la posición inicial del cursor en la pantalla.#

cuando empezó
[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ó
[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ó
[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ó
[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ó
[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ó
[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ó
[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ó
[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 #

imprimir en #

El bloque imprimir en muestra texto en la pantalla del robot en una coordenada x e y especificada (en píxeles) con la fuente configurada actualmente.

imprimir en bloque de pila#

imprimir [VEXcode] en x:[80] y:[120] en pantalla

Parámetros	Descripción
valor	El texto, número o valor de variable que se mostrará en la pantalla.
incógnita	La coordenada x en píxeles (de 0 a 240, donde 0 es izquierda y 240 es derecha).
y	La coordenada y en píxeles (de 0 a 240, donde 0 es superior y 240 es inferior).

Ejemplo

Cuando se inicia, muestra el mensaje “¡Hola, robot!” en la posición inicial del cursor en la pantalla.#

cuando empezó
[Display a message in the middle of the screen.]
imprimir [Hello, Robot!] en x:[40] y:[120] en pantalla

Muestra el método robot.screen.print_at con "¡Hola, Robot!" en el medio de la pantalla que es (40, 120)

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ó
[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ó
[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

Parámetros

Descripción

color

El color al que cambiar el fondo:

rojo
verde
azul
negro
blanco
amarillo
naranja
morado
cian

Ejemplo

cuando empezó
[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

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

Monoespaciado super pequeña	Monoespaciado extra pequeña	Monoespaciado pequeña
medio monoespaciado	monoespaciado grande	monoespaciado extra grande
monoespaciado supergrande	proporcional pequeño	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ó
[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

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ó
[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ó
[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

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ó
[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

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ó
[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ó
[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ó
[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ó
[Draw a pixel at the center of the screen.]
Dibuja el píxel [120] [120] en la pantalla

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ó
[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ó
[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 #

The draw circle block draws a circle using the current pen width, pen color, and fill colors.

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ó
[Draw a circle 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:

True — Screen is currently being pressed
False — Screen is not being pressed

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ó
[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	The coordinate of the last screen press in pixels: x — The horizontal position y — The vertical position

Parámetros

Descripción

coordinar

The coordinate of the last screen press in pixels:

x — The horizontal position
y — The vertical position

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ó
[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]

Parámetros	Descripción
acción	Determines when the attached stack of blocks will execute: pressed released

Parámetros

Descripción

acción

Determines when the attached stack of blocks will execute:

pressed
released

Ejemplo

Cuando se presiona la pantalla, todos los LED se vuelven verdes.#

cuando la pantalla [presionado v]
[Set the LEDs to green when the screen is pressed.]
Establezca el color del LED [lightall v] en [verde v]