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.

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

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

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

• borrar fila en pantalla — Borra una fila de texto específica.

• 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 la coordenada en pantalla — 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 en pantalla — Cambia el tipo y tamaño de fuente para la visualización del texto.

• establecer precisión de impresión en pantalla — Ajusta la cantidad de decimales para los números impresos.

• establecer ancho del lápiz en pantalla — Ajusta el grosor de las líneas dibujadas.

• establecer color de lápiz/fuente en pantalla — Cambia el color del texto y los dibujos.

• establecer color de relleno de texto en pantalla – Establece el color de resaltado que se utiliza cuando se imprime el texto.

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

Dibujar - Crear gráficos y elementos visuales.

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

• dibujar píxel en pantalla — Dibuja un solo píxel en una coordenada específica.

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

• dibujar rectángulo en la pantalla — Dibuja un rectángulo con las dimensiones especificadas.

• dibujar círculo en la pantalla — Dibuja un círculo con un radio dado.

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 en pantalla

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

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 ▶

Colocar el cursor en la fila o columna de la pantalla.

Al usar el bloque Colocar cursor en fila y columna en pantalla, el cursor se sitúa 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 con el bloque Colocar fuente en pantalla. Con la fuente monoespaciada mediana predeterminada, se pueden mostrar con claridad hasta 18 filas y 53 columnas. El texto que se coloque fuera de este rango puede recortarse 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 de la pantalla.

El bloque establecer cursor en la siguiente fila de la pantalla mueve el cursor a la columna 1 de la siguiente fila en 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 ▶

Borrar fila en la pantalla

El bloque borrar fila en pantalla 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 la coordenada que aparece en pantalla.

El bloque imprimir en la coordenada de la pantalla muestra texto en la pantalla del controlador en una posición específica (x, y) en píxeles, utilizando la fuente font configurada actualmente. x determina la distancia desde el borde izquierdo donde comienza el texto, y y determina la posición de la parte inferior de las letras. Este método no tiene en cuenta 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 en pantalla

El bloque Establecer fuente en pantalla define la fuente y el tamaño que se utilizarán para mostrar el texto en la pantalla del controlador. Esta fuente se aplicará a todo el texto que se imprima 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: monoespaciada 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	proporcionalmente pequeño	medio proporcional
proporcionalmente grande	proporcional extra grande	supergrande proporcional

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 ▶

Ajustar la precisión de impresión en pantalla

El bloque establecer precisión de impresión en pantalla define el formato de precisión utilizado para mostrar los números en la pantalla del controlador. Esta precisión de impresión se aplicará a todos los números que se impriman 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 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 ▶

Ajustar el ancho del lápiz en la pantalla

El bloque establecer ancho del lápiz en pantalla establece el ancho del lápiz que se utiliza 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

Configurar el color del lápiz/fuente en la pantalla

El bloque establecer color de lápiz/fuente en pantalla establece el color del lápiz que se usa para dibujar líneas, formas y texto en la pantalla del controlador. El color predeterminado es 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 en la pantalla

El bloque establecer color de relleno de texto en pantalla establece el color de resaltado que se utiliza al imprimir el 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 color de relleno de dibujo en la pantalla

El bloque establecer color de relleno de dibujo en pantalla define el color que se utiliza para rellenar las formas cuando se dibujan. 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 en pantalla

El bloque mostrar archivo de imagen en pantalla 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 en la pantalla

El bloque dibujar píxel en pantalla dibuja un píxel en la coordenada de pantalla (x, y) especificada en el color de lápiz actual (#set-pen-font-color-on-screen).

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 en la pantalla

El bloque dibujar línea en pantalla 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] (#set-pen-width-on-screen) y el [color del lápiz] (#set-pen-font-color-on-screen ) 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 un rectángulo en la pantalla

El bloque dibujar rectángulo en pantalla dibuja un rectángulo usando el [ancho del lápiz] (#set-pen-width-on-screen), el [color del lápiz] (#set-pen-font-color-on-screen) y el [color de relleno] (#set-draw-fill-color-on-screen ) 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 en la pantalla

El bloque dibujar círculo en la pantalla dibuja un círculo utilizando el [ancho del lápiz] (#set-pen-width-on-screen), el [color del lápiz] (#set-pen-font-color-on-screen) y el [color de relleno] (#set-draw-fill-color-on-screen ) 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] ▶

Al pulsar la pantalla, se muestra el primer mensaje. El código espera a que se suelte la pantalla y solo continúa después de volver a pulsarla para mostrar el segundo mensaje.

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] ▶