Pantalla

Introducción

La pantalla del controlador de drones VEX AIR proporciona bloques para mostrar texto, administrar el cursor, dibujar formas y manejar interacciones táctiles.

Nota: Si el VEX AIR Drone está emparejado con un controlador, se mostrará un temporizador en la parte superior de la pantalla de impresión que indica el tiempo transcurrido del proyecto actual. Cualquier texto o dibujo aparecerá detrás del temporizador.

A continuación se muestra una lista de todos los bloques disponibles, agrupados por funcionalidad:

Cursor Print: administra la visualización de texto mediante un sistema de cursor de filas y columnas.

• print — Muestra texto en la pantalla en la posición actual del cursor.

• establecer cursor en fila o columna — Mueve el cursor a una fila y columna específicas.

• establecer cursor en la siguiente fila — Mueve el cursor a la columna 1 de la siguiente fila.

• borrar fila — Borra una fila de texto especificada.

• columna del cursor de pantalla — Devuelve el número de columna donde se imprimirá el texto.

• fila del cursor de pantalla — Devuelve el número de fila donde se imprimirá el texto.

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

• imprimir en — Muestra texto en una coordenada x e y especificada.

• Establecer origen de pantalla — Cambia el origen (0, 0) utilizado para dibujar e imprimir.

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

• borrar pantalla — Borra todo el texto y los dibujos de la pantalla.

• esperar a que se renderice la pantalla — Evita que se muestre cualquier impresión o dibujo hasta que se vuelva a utilizar el bloque.

• llenar pantalla — Borra todo el texto y los dibujos de la pantalla, luego establece el color de fondo de la pantalla.

• establecer fuente — Cambia el tipo y tamaño de fuente para la visualización del texto.

• set print precision on screen — Adjusts the amount of decimal places for printed numbers.

• establecer ancho de pluma — Ajusta el grosor de las líneas dibujadas.

• establecer color de pluma/fuente — Cambia el color del texto y los dibujos.

• establecer color de relleno de texto – Establece el color de resaltado utilizado cuando se imprime texto.

• establecer color de relleno de dibujo — Establece el color de relleno para las formas.

Dibujar - Crear gráficos y elementos visuales.

• mostrar archivo de imagen — Muestra una imagen cargada por el usuario en la pantalla.

• dibujar píxel — Dibuja un solo píxel en una coordenada especificada.

• dibujar línea — Dibuja una línea entre dos puntos.

• dibujar rectángulo — Dibuja un rectángulo con dimensiones especificadas.

• dibujar círculo — Dibuja un círculo con un radio determinado.

Toque: detecta interacciones en la pantalla.

• ¿Pantalla presionada? — Devuelve si la pantalla está siendo presionada actualmente.

• posición de pantalla — Recupera las coordenadas x e y donde se tocó la pantalla por última vez.

• cuando ocurre un evento de pantalla — Se activa cuando se presiona o se suelta la pantalla.

Cursor Imprimir

imprimir

El bloque imprimir muestra texto en la pantalla del controlador 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

Al iniciarse, muestra el mensaje “¡Hola, dron!” en la posición inicial del cursor en la pantalla.

cuando empezó
[Display a message at the starting cursor position.]
imprimir [Time to fly!] en la pantalla ▶

establecer el cursor en la fila o 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. La cantidad de caracteres que caben en la pantalla depende de la fuente seleccionada. El tamaño de la fuente se puede cambiar usando el bloque establecer fuente. Con la fuente monoespaciada mediana predeterminada, se pueden mostrar con claridad hasta 18 filas y 53 columnas. El texto que se encuentre fuera de este rango puede quedar cortado o resultar difícil de leer.

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 7, columna 25 de la pantalla e imprime ‘Fila 7, columna 25’.

cuando empezó
[Display text starting at Row 7 Column 25.]
Coloque el cursor en la fila [7] columna [25] en la pantalla
imprimir [Row 7, Column 25] en la pantalla ▶

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

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

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ó
[Clear only the second row of text.]
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

La columna del cursor de pantalla devuelve la posición actual de la columna del cursor.

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 7, columna 25 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 [7] columna [25] 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 la posición de fila actual del cursor.

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 7, columna 25 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 [7] columna [25] en la pantalla
imprimir (fila del cursor de la pantalla) en la pantalla ▶

Impresión XY

imprimir en

El bloque imprimir en muestra el texto en la pantalla del controlador en una posición (x, y) específica en píxeles, utilizando la fuente establecida actualmente. x establece a qué distancia del lado izquierdo comienza el texto, e y establece dónde se ubican las letras inferiores. Este método ignora la posición actual del cursor.

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 640, donde 0 es izquierda y 640 es derecha).
y	La coordenada y en píxeles (de 0 a 480, donde 0 es superior y 480 es inferior).

Ejemplo

Al iniciarse, muestra el mensaje “¡Hola, dron!” en el centro de la pantalla.

cuando empezó
[Display a message starting in the middle of the screen.]
imprimir [Hello, drone!] en x:[320] y:[240] 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 controlador. 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 de pantalla (x, y).

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 (320, 240) 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: [320] y: [240]
[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 la pantalla del controlador de todos los dibujos, textos e imágenes.

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 [320] [240] [80] en la pantalla
esperar [2] segundos
pantalla clara

esperar a que se renderice la pantalla

El bloque esperar a que se renderice la pantalla evita que se muestren los siguientes bloques de pantalla y luego muestra toda su salida a la vez cuando se usa nuevamente.

Nota: El uso de este bloque cambia el proyecto de modo que todos los bloques de pantalla subsiguientes permanecerán ocultos hasta que se utilice nuevamente el bloque esperar a que se renderice la pantalla.

esperar a que se renderice la 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 empezó
[Display text and images when button 7 is pressed.]
esperar a que se renderice la pantalla
imprimir [Screen rendered!] en la pantalla ▶
dibuja el círculo [320] [240] [80] en la pantalla
esperar hasta <¿Botón del controlador [7 v] presionado?>
esperar a que se renderice la pantalla

llenar la pantalla

El bloque llenar pantalla borra todos los dibujos y textos de la pantalla del controlador 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 anaranjado morado cian

Ejemplo

cuando empezó
[Say "Hello" then turn screen green.]
imprimir [Hello] en la pantalla ▶
esperar [2] segundos
llenar la pantalla con [verde v]

establecer fuente

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

establecer bloque de pila de fuentes

Establezca la fuente en [monoespaciado v] [medio 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): superpequeño extra pequeño chico mediano grande extra grande super grande

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

Ejemplo

Cuando se inicia, establece la fuente en ‘monoespaciada 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 controller’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 Digitos

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 pluma establece el ancho de pluma utilizado para dibujar líneas y formas.

Establecer bloque de ancho de pluma

Establezca el ancho del lápiz en [10] en la pantalla

Parámetros	Descripción
ancho	El ancho del lápiz en píxeles.

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 [200] [200] [200] [80] en la pantalla

Establecer color de pluma/fuente

El bloque establecer color de lápiz/fuente define el color del lápiz para dibujar líneas, formas y texto en la pantalla del controlador. El color predeterminado es el blanco.

establecer el color de fuente del bolígrafo

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

Ejemplo

Parámetros	Descripción
color	Establece el color del lápiz a: rojo verde azul negro blanco amarillo anaranjado morado cian transparente

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 an orange outline.]
Establezca el color del lápiz/fuente en [naranja v] en la pantalla
dibuja el rectángulo [200] [150] [240] [150] en la pantalla
Establezca el color del lápiz/fuente en [blanco v] en la pantalla
print [VEXcode AIR] at x: [250] y: [220] on screen

establecer el color de relleno del texto

El bloque establecer color de relleno de texto define el color de resaltado que se utiliza al imprimir texto. El color de resaltado predeterminado es transparente.

Establecer bloque de pila de color de relleno

Establezca el color de relleno del texto en [rojo v] en la pantalla

Parámetros	Descripción
color	Establece el color de resaltado del texto en: rojo verde azul negro blanco amarillo anaranjado morado 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
[Display two colors behind text.]
Establezca el color de relleno del texto en [rojo v] en la pantalla
imprimir ["Red"] en la pantalla ▶
Colocar el cursor en la siguiente fila de la pantalla
Establezca el color de relleno del texto en [azul v] en la pantalla
imprimir ["Blue"] en la pantalla ▶

establecer el color de relleno del dibujo

El bloque establecer color de relleno de dibujo define el color que se usará para rellenar las formas al dibujarlas. El color de relleno predeterminado es el negro.

Establecer bloque de pila de color de relleno

Establezca el color de relleno del dibujo en [rojo v] en la pantalla

Parámetros	Descripción
color	Establece el color de relleno de la forma en: rojo verde azul negro blanco amarillo anaranjado morado 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 an orange-filled rectangle with text on top.]
Establezca el color de relleno del dibujo en [naranja v] en la pantalla
dibuja el rectángulo [200] [150] [240] [150] en la pantalla
print [VEXcode AIR] at x: [250] y: [220] on screen

Dibujar

mostrar archivo de imagen

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

mostrar bloque de pila de imágenes de usuario

mostrar archivo de imagen [IMAGE1 v]

Parámetros	Descripción
número de imagen	La imagen subida por el usuario que se usará. Las opciones cambiarán si se editan los nombres de las imágenes en el Panel de control.

Ejemplo

hacer

cuando empezó
[Display custom image on screen.]
mostrar archivo de imagen [IMAGE1 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, que va de 0 a 640.
y	La coordenada y para dibujar el píxel, que va de 0 a 480.

Ejemplo

Cuando se inicia, dibuja un píxel en el centro de la pantalla en las coordenadas (120, 120).

cuando empezó
[Draw five pixels in a diagonal.]
Dibuja el píxel [360] [200] en la pantalla
Dibuja el píxel [340] [220] en la pantalla
Dibuja el píxel [320] [240] en la pantalla
Dibuja el píxel [300] [260] en la pantalla
Dibuja el píxel [280] [280] 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, que va de 0 a 640.
año1	La coordenada y en píxeles del inicio de la línea, que va de 0 a 480.
x2	La coordenada x en píxeles del final de la línea, que va de 0 a 640.
y2	La coordenada y en píxeles del final de la línea, que va de 0 a 480.

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ó
[Make an X across the screen.]
dibuja la línea [0] [0] [640] [480] en la pantalla
Establezca el color del lápiz/fuente en [cyan v] en la pantalla
dibuja la línea [0] [480] [640] [0] 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 el color de relleno actuales.

dibujar bloque rectangular

dibuja el rectángulo [0] [0] [10] [10] en la pantalla

Ejemplo

Parámetros	Descripción
incógnita	La coordenada x en píxeles de la esquina superior izquierda del rectángulo, con un rango de 0 a 640.
y	La coordenada y en píxeles de la esquina superior izquierda del rectángulo, que va de 0 a 480.
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 empezó
[Draw two rectangles on the screen.]
dibuja el rectángulo [0] [0] [620] [460] en la pantalla
Establezca el color de relleno en [verde v] en la pantalla
dibuja el rectángulo [200] [180] [200] [100] en la pantalla

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 el color 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, que va de 0 a 640.
y	La coordenada y en píxeles del centro del círculo, que va de 0 a 480.
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 one green circle on the screen.]
Establezca el color de relleno en [verde v] en la pantalla
dibuja el círculo [320] [240] [200] en la pantalla

Tocar

¿pantalla presionada?

El bloque ¿Pantalla presionada? informa si la pantalla del controlador 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

cuando empezó
[Play a sound when the screen is pressed.]
para siempre
si <¿pantalla presionada?> entonces
tocar nota [bajo v] [C v] [note_eight v] ▶

When the screen is pressed, the first message is shown. The code then waits until the screen is released, and only continues after the screen is pressed again to show the second message.

cuando empezó
[Display different messages after the screen is pressed.]
esperar hasta <¿pantalla presionada?>
imprimir [First message!] en la pantalla ▶
Colocar el cursor en la siguiente fila de la pantalla
[Lift finger to press the screen again.]
esperar hasta <no <¿pantalla presionada?>>
esperar hasta <¿pantalla presionada?>
imprimir [Second message!] en la pantalla ▶

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 640 (derecha). El valor de retorno para y está entre 0 (arriba) y 480 (abajo).

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, comprueba 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ó
[Play high or low note based on where screen is pressed.]
para siempre
si <¿pantalla presionada?> entonces
si <(posición de pantalla [incógnita v]) [math_greater_than v] [320]> entonces
tocar nota [alto v] [C v] [note_eight v] ▶
demás
tocar nota [bajo v] [C v] [note_eight v] ▶

cuando el evento de pantalla

El bloque cuando hay evento de pantalla se llama cuando se presiona o se suelta la pantalla del controlador.

Cuando el evento de pantalla se bloquea

cuando la pantalla [presionado v]

Parámetros	Descripción
acción	Determina cuándo se ejecutará la pila de bloques adjunta: presionado liberado

Ejemplo

cuando la pantalla [presionado v]
[Play a sound when the screen is pressed.]
reproducir sonido [éxito v] ▶