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.

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.

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

print at – Displays text at a specified x and y coordinate.
set screen origin – Changes the origin (0, 0) used for drawing and printing.

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

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.

Dibujar - Crear gráficos y elementos visuales.

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.

Toque: detecta interacciones en la pantalla.

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 #

The print block displays text on the robot’s screen at the current cursor position and font.

bloque de pila de impresión#

imprimir [Código VEX] en 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 and 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 empieza :: hat events
[Mostrar un mensaje en la posición inicial del cursor.]
imprimir [Hola, robot!] en pantalla ▶

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

establecer el cursor en la fila columna #

When using the set cursor to row column block, the cursor is placed at a specific row and column on the screen. How many rows and columns can comfortably fit depends on the selected font. With the default monospaced medium font, up to 8 rows and 13 columns can be displayed clearly. Text placed beyond this range may be cut off or become difficult to read.

Monospaced fonts have characters that are all the same width, making text placement consistent. In contrast, proportional fonts vary in character width, so some letters take up more space than others. However, regardless of which type is used, the set cursor to row column block positions the cursor based on row and column size, not font style. The font size can be adjusted using the set font block.

Establecer bloque de pila de cursor#

establecer cursor a [1]  columna de fila [1] en 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 empieza :: hat events
[Mostrar texto a partir de la Fila 3 Columna 2.]
establecer cursor a (3) columna de fila (2) en pantalla
imprimir [Fila 3, Columna 2] en pantalla ▶

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

cuando empieza :: hat events
[Mostrar las cantidades de carga en una lista organizada.]
establecer fuente en [proporcional v] [grande v] la pantalla
imprimir [Balones deportivos] en pantalla ◀ establecer cursor a siguente fila
imprimir [Barriles de naranja] en pantalla ◀ establecer cursor a siguente fila
imprimir [Barriles azules] en pantalla ▶
establecer cursor a [1] columna de fila [11] en pantalla
imprimir [2] en pantalla ▶
establecer cursor a [2] columna de fila [11] en pantalla
imprimir [3] en pantalla ▶
establecer cursor a [3] columna de fila [11] en pantalla
imprimir [3] en 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 empieza :: hat events
[Mostrar el ID del AprilTag detectado.]
establecer fuente en [proporcional v] [extra grande v] la pantalla
por siempre
borrar pantalla
imprimir [AprilTag] en pantalla ▶
obtener [abrilEtiquetas v] datos de AI Vision
si <¿Existe el objeto AI Vision?> entonces
establecer cursor a [3] columna de fila [4] en pantalla
imprimir (Objeto AI Vision [ID de etiqueta v]) en 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 pan...

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 empieza :: hat events
[Mostrar dos líneas de texto.]
imprimir [Línea 1] en pantalla ▶
colocar el cursor en la siguiente fila de la pan...
imprimir [Línea 2] en 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#

borrar fila [1] en 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 empieza :: hat events
[Mostrar texto en dos filas.]
imprimir [Este texto permanece] en pantalla ▶
colocar el cursor en la siguiente fila de la pan...
imprimir [Este texto desaparece] en pantalla ▶
esperar [1] segundos
borrar fila [2] en 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 de cursor de 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 empieza :: hat events
[Mostrar la columna actual del cursor.]
establecer cursor a [3] columna de fila [2] en pantalla
imprimir (columna de cursor de pantalla) en 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 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 empieza :: hat events
[Mostrar la fila actual del cursor.]
establecer cursor a [3] columna de fila [2] en pantalla
imprimir (fila del cursor de pantalla) en 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 #

The print at block displays text on the robot’s screen at a specified x and y-coordinate (in pixels) with the currently set font.

imprimir en bloque de pila#

imprimir [VEXcode] en [80] x: 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 empieza :: hat events
[Mostrar un mensaje en el medio de la pantalla.]
imprimir [Hola, robot!] en [40] x: 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#

configurar origen de pantalla [0] x: 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 empieza :: hat events
[Establezca el origen en el centro de la pantalla..]
configurar origen de pantalla [120] x: y: [120]
[Dibuje un rectángulo en el nuevo origen.]
dibujar rectángulo [0] [0] [80] [40] en pantalla

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

Ajustes #

pantalla clara #

The clear screen block clears all drawings and text from the robot’s screen and resets the cursor position to row 1, column 1.

borrar bloqueo de pantalla#

borrar pantalla

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 empieza :: hat events
[Dibuja un círculo y bórralo después de 2 segundos.]
dibujar círculo [120] [120] [40] en pantalla
esperar [2] segundos
borrar pantalla

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#

rellenar pantalla con [rojo v]

Parámetros	Descripción
color	The color to change the background to: red green blue black white yellow orange purple cyan

Parámetros

Descripción

color

The color to change the background to:

red
green
blue
black
white
yellow
orange
purple
cyan

Ejemplo

cuando empieza :: hat events
[Decir "Hola" luego la pantalla se vuelve amarilla.]
imprimir [Hola] en pantalla ▶
esperar [2] segundos
rellenar 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#

establecer fuente en [monoespaciado v] [superpequeño v] la pantalla

Parámetros	Descripción
tipo	The font type: monospaced proportional
tamaño	The font size (shown below): super small extra small small medium large extra large super large

Parámetros

Descripción

tipo

The font type:

monospaced
proportional

tamaño

The font size (shown below):

super small
extra small
small
medium
large
extra large
super large

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 empieza :: hat events
[Mostrar texto usando una fuente más grande]
establecer fuente en [monoespaciado v] [extra pequeño v] la pantalla
imprimir [VEX] en 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#

establecer la precisión de impresión [0.1 v] en la pantalla

Parámetros	Descripción
precisión	Sets the print precision to: 1 0.1 0.01 0.001 All Digits

Parámetros

Descripción

precisión

Sets the print precision to:

1
0.1
0.01
0.001
All Digits

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 empieza :: hat events
[Imprimir 1/3 como 0,33.]
establecer la precisión de impresión [0.01 v] en la pantalla
imprimir ([1] [math_division v] [3]) en 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#

establecer el ancho del lápiz [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 empieza :: hat events
[Dibuje un rectángulo con un ancho de lápiz de 10.]
establecer el ancho del lápiz [10] en la pantalla
dibujar rectángulo [50] [50] [130] [60] en 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#

establecer el color del lápiz / fuente [rojo v] en la pantalla

Ejemplo

Parámetros	Descripción
color	Sets the pen color to: red green blue black white yellow orange purple cyan transparent

Parámetros

Descripción

color

Sets the pen color to:

red
green
blue
black
white
yellow
orange
purple
cyan
transparent

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 empieza :: hat events
[Dibuja un rectángulo con un bolígrafo rojo.]
establecer el color del lápiz / fuente [rojo v] en la pantalla
dibujar rectángulo [50] [50] [130] [60] en 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#

establecer el color de relleno [rojo v] en la pantalla

Parámetros	Descripción
color	Sets the fill color to: red green blue black white yellow orange purple cyan transparent

Parámetros

Descripción

color

Sets the fill color to:

red
green
blue
black
white
yellow
orange
purple
cyan
transparent

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 empieza :: hat events
[Dibuja dos rectángulos naranjas.]
establecer el color de relleno [anaranjado v] en la pantalla
dibujar rectángulo [50] [50] [100] [60] en pantalla
dibujar rectángulo [50] [130] [100] [60] en 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 empieza :: hat events
[Mostrar texto con fondo morado.]
establecer el color de relleno [morado v] en la pantalla
imprimir [Destacar] en 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 empieza :: hat events
[Dibujar imagen cargada 1.]
mostrar archivo de imagen [1 v]

dibujar píxeles #

The draw pixel block draws a pixel at the specified (x, y) screen coordinate in the current pen color.

dibujar bloque de pila de píxeles#

dibujar píxel [0] [0] en 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 empieza :: hat events
[Dibuja un píxel en el centro de la pantalla.]
dibujar píxel [120] [120] en pantalla

dibujar una línea #

The draw line block draws a line from the first specified screen coordinate (x1, y1) to the second specified screen coordinate (x2, y2) using the current pen width and pen color.

bloque de pila de línea de dibujo#

dibujar línea [0] [0] [10] [10] en 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 empieza :: hat events
[Dibuje una línea desde la parte superior izquierda hasta la parte inferior derecha de la pantalla.]
dibujar línea [0] [0] [240] [240] en 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 #

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

dibujar bloque de rectángulo#

dibujar rectángulo [0] [0] [10] [10] en pantalla

Ejemplo

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.

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 empieza :: hat events
[Dibuja un rectángulo en la pantalla.]
dibujar rectángulo [50] [50] [130] [60] en 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#

dibujar círculo [0] [0] [10] en 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 empieza :: hat events
[Dibuja un rectángulo en la pantalla.]
dibujar círculo [120] [120] [40] en 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 empieza :: hat events
[Enciende los LED en blanco solo cuando se presiona la pantalla.]
por siempre
si <pantalla presionada?> entonces
establecer el color del [lightall v] LED EN [blanco v]
si no
establecer el color del [lightall v] LED 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#

([x v] posición de la pantalla)

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 empieza :: hat events
[Muestra la coordenada x e y de donde se presiona la pantalla.]
por siempre
si <pantalla presionada?> entonces
borrar pantalla
imprimir ([x v] posición de la pantalla) en pantalla ▶
colocar el cursor en la siguiente fila de la pan...
imprimir ([y v] posición de la pantalla) en 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]
[Configurar los LED en verde cuando se presiona la pantalla.]
establecer el color del [lightall v] LED EN [verde v]