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 on screen — 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 ▶

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 ▶

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 ▶

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

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 ▶

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 ▶

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 ▶

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

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

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

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

monospaced super small	monospaced extra small	monospaced small
monospaced medium	monospaced large	monospaced extra large
monospaced super large	proportional small	proportional large
proportional extra large	proportional super large

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 ▶

set print precision on screen

The set print precision on screen block sets the precision formatting used for displaying numbers on the robot’s screen. This print precision will apply to all subsequently printed numbers.

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

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

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

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

---

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 ▶

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

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

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

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

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

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

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]