Pantalla

Introducción

Los bloques de pantalla controlan la pantalla del controlador de drones VEX AIR, lo que permite que su controlador muestre texto, números, gráficos e imágenes, y responda a la entrada táctil.

Nota: Si el dron VEX AIR 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 bloques disponibles:

Impresión del cursor: muestra el texto y administra el cursor de impresión.

• print on screen — Imprime texto, números o valores variables en la pantalla del controlador.

• set cursor to row column on screen — Mueve el cursor a una fila y columna específicas.

• set cursor to next row on screen — Mueve el cursor a la columna 1 de la siguiente fila.

• borrar fila en pantalla — Borra una fila de texto especificada.

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

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

XY Print - Imprimir texto en coordenadas basadas en píxeles.

• imprimir en coordenadas en pantalla: imprime texto, números o valores de variables en una coordenada x e y específica.

• set screen origin — Cambia el origen (0, 0) utilizado para la impresión y el dibujo basados en coordenadas.

Configuración: cambia la apariencia del texto, los gráficos y la pantalla.

• Clear Screen: borra todo el texto, los dibujos y las imágenes de la pantalla.

• espere a que la pantalla se renderice — Cambia el dibujo de la pantalla a un comportamiento de renderización posterior.

• pantalla DE relleno: borra todo el texto, los dibujos y las imágenes de la pantalla y, a continuación, establece el color de fondo de la pantalla.

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

• set print precision on screen — Establece cuántos decimales mostrar al imprimir números.

• set pen width on screen — Establece el grosor de las líneas dibujadas y los contornos de forma.

• establecer el color del lápiz / fuente en la pantalla: establece el color del texto, los píxeles, las líneas y los contornos de la forma.

• set text fill color on screen – Establece el color de relleno detrás del texto impreso.

• set draw fill color on screen — Establece el color de relleno para las formas dibujadas.

Dibujar: crea gráficos y elementos visuales.

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

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

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

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

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

Táctil: detecta las interacciones de la pantalla.

• pantalla presionada — Informa si la pantalla se está presionando actualmente.

• posición DE pantalla — Informa la coordenada x o y de la última prensa de pantalla.

• when screen event: se ejecuta cuando se presiona o suelta la pantalla.

Impresión del cursor

imprimir en pantalla

El bloque imprimir en pantalla apilar imprime texto, números o valores variables en la pantalla del controlador en la posición del cursor y fuente actuales.

imprimir bloque de pila

imprimir [VEXcode] en pantalla ▶

Parámetros	Descripción
value	El texto, número o valor de la variable a imprimir en la pantalla.
y establecer el cursor en la siguiente fila	Seleccione la flecha (▶) para expandir el bloque para decir y coloque el cursor en la siguiente fila, de modo que el cursor se mueva a la columna 1 de la siguiente fila después de imprimir.

Ejemplo

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

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

ajustar el cursor a la columna de fila en la pantalla

El bloque set cursor to row column on screen stack mueve el cursor a una fila y columna específica en la pantalla del controlador. El siguiente bloque imprimir en pantalla comenzará a imprimirse en esa ubicación.

El número de caracteres que pueden caber en la pantalla depende de la fuente seleccionada. Con la fuente media monoespaciada predeterminada, se pueden mostrar claramente hasta 18 filas y 53 columnas. El texto colocado más allá de este rango puede cortarse o ser difícil de leer.

Establecer bloque de pila de cursor

mover cursor a fila [1] columna [1] en pantalla

Parámetros	Descripción
fila	La fila a la que mover el cursor.
columna	La columna a la que mover el cursor.

Ejemplos

Cuando se inicia, mueve el cursor a la fila 7, columna 25 en la pantalla e imprime ‘Fila 7, Columna 25’.

cuando inicie
[Display text starting at Row 7 Column 25.]
mover cursor a fila [7] columna [25] en pantalla
imprimir [Row 7, Column 25] en pantalla ▶

colocar el cursor en la siguiente fila de la pantalla

El bloque set cursor to next row on screen stack mueve el cursor a la columna 1 en la siguiente fila en la pantalla del controlador.

ajustar el cursor al siguiente bloque de pila de filas

mover cursor a la siguiente fila en 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 inicie
[Display two lines of text.]
imprimir [Line 1] en pantalla ▶
mover cursor a la siguiente fila en pantalla
imprimir [Line 2] en pantalla ▶

borrar fila en pantalla

El bloque de pila borrar fila en pantalla borra una fila de texto en la pantalla del controlador.

Borrar bloque de pila de filas

limpiar fila [1] en pantalla

Parámetros	Descripción
fila	El número de fila a borrar.

Ejemplo

Cuando se inicia, imprime el texto en dos filas. La primera fila permanece, mientras que la segunda fila desaparece después de 3 segundos.

cuando inicie
[Clear only the second row of text.]
imprimir [This text stays] en pantalla ▶
mover cursor a la siguiente fila en pantalla
imprimir [This text disappears] en pantalla ▶
esperar [3] segundos
limpiar fila [2] en pantalla

columna de cursor de pantalla

El bloque de informe Columna del cursor de pantalla informa el número de columna donde se imprimirá el texto como un número entero.

bloque de reportero de columna de cursor de pantalla

(columna del cursor de pantalla)

Parámetros	Descripción
	Este bloque no tiene parámetros.

Ejemplo

Cuando se inicia, mueve el cursor a la fila 7, columna 25 en la pantalla e imprime el número de columna del cursor actual.

cuando inicie
[Display the cursor's current column.]
mover cursor a fila [7] columna [25] en pantalla
imprimir (columna del cursor de pantalla) en pantalla ▶

fila del cursor de la pantalla

El bloque de informe fila del cursor de pantalla informa el número de fila donde se imprimirá el texto como un número entero.

bloque de reportero de fila de 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 7, columna 25 en la pantalla e imprime el número de fila del cursor actual.

cuando inicie
[Display the cursor's current row.]
mover cursor a fila [7] columna [25] en pantalla
imprimir (fila del cursor de pantalla) en pantalla ▶

Impresión XY

imprimir en coordenadas en pantalla

El bloque imprimir en coordenadas en pantalla apilar imprime texto, números o valores variables en la pantalla del controlador en una posición específica (x, y) en píxeles, utilizando la fuente y el origen actuales. x establece a qué distancia del lado izquierdo comienza el texto, y * * y * * establece dónde se encuentra la parte inferior de las letras. Este bloque 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
value	El texto, número o valor de la variable a imprimir en la pantalla.
x	La coordenada x en píxeles (0 a 640, donde 0 es la izquierda y 640 es la derecha).
y	La coordenada y en píxeles (0 a 480, donde 0 es arriba y 480 es abajo).

Ejemplo

Cuando se inicia, muestra el mensaje “¡Hola, dron!” en el centro de la pantalla.

cuando inicie
[Display a message starting in the middle of the screen.]
imprimir [Hello, drone!] en x:[320] y:[240] en pantalla

configurar el origen de la pantalla

El bloque de pila set screen origin establece el origen (0, 0) utilizado para el dibujo y la impresión basada en coordenadas en la pantalla del controlador. De forma predeterminada, el origen es la esquina superior izquierda de la pantalla. Este bloque puede restablecer el origen a una ubicación de coordenadas de pantalla alternativa (x, y).

establecer bloque de pila de origen de pantalla

establecer origen de pantalla x: [0] y: [0]

Parámetros	Descripción
x	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), un ancho de 80 píxeles y un alto de 40 píxeles.

cuando inicie
[Set the origin to the center of the screen.]
establecer origen de pantalla x: [320] y: [240]
[Draw a rectangle at the new origin.]
dibujar rectángulo [0] [0] [80] [40] en pantalla

Ajustes

borrar pantalla

El bloque de pila * * Clear Screen * * borra todos los dibujos, texto e imágenes de la pantalla del controlador.

borrar bloque de pila de pantalla

limpiar pantalla

Parámetros	Descripción
	Este bloque no tiene parámetros.

Ejemplo

Cuando se inicia, dibuja un círculo con centro (120,120) y radio de 40 píxeles. Después de 2 segundos, la pantalla se borra.

cuando inicie
[Draw a circle, and clear it after 2 seconds.]
dibujar círculo [320] [240] [80] en pantalla
esperar [2] segundos
limpiar pantalla

esperar a que la pantalla se renderice

El bloque de pila esperar a que se renderice la pantalla cambia el comportamiento de renderizado posterior del dibujo de la pantalla. Una vez que se ejecuta este bloque, los siguientes bloques de pantalla no aparecerán en la pantalla del controlador hasta que se ejecute el siguiente bloque esperar a que se renderice la pantalla.

Nota: Usa este bloque antes de dibujar un grupo de texto, formas o imágenes, luego úsalo de nuevo para representar la actualización completa a la vez.

esperar a que la pantalla se renderice

Parámetros	Descripción
	Este bloque no tiene parámetros.

Ejemplo

Cuando se inicia, dibuja un círculo con centro (120,120) y radio de 40 píxeles. Después de 2 segundos, la pantalla se borra.

cuando inicie
[Display text and images when button 7 is pressed.]
esperar a que la pantalla se renderice
imprimir [Screen rendered!] en pantalla ▶
dibujar círculo [320] [240] [80] en pantalla
esperar hasta <¿botón [7 v] del control presionado?>
esperar a que la pantalla se renderice

pantalla de llenado

El bloque de pila * * pantalla de relleno * * borra todos los dibujos, texto e imágenes de la pantalla del controlador y, a continuación, cambia el fondo a un color especificado.

El bloque de pantalla de llenado

llenar pantalla con [rojo v]

Parámetros	Descripción
color	El color para cambiar el fondo a: rojo verde azul * negro blanco amarillo naranja morado cian

Ejemplo

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

establecer fuente en pantalla

El bloque de pila set font on screen establece 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 después de que se ejecute este bloque.

establecer bloque de pila de fuentes

establecer fuente a [monoespaciada v] [mediano v] en pantalla

Parámetros	Descripción
tipo	El tipo de letra: monoespaciado o proporcional.
tamaño	El tamaño de la fuente (que se muestra a continuación): superpequeño * * extra pequeño * * pequeño * 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 ‘monoespaciado extra grande’ e imprime ‘VEX’ en la pantalla.

cuando inicie
[Display text using a larger font.]
establecer fuente a [monoespaciada v] [extra grande v] en pantalla
imprimir [VEX] en pantalla ▶

configurar la precisión de impresión en pantalla

El bloque establecer precisión de impresión en pantalla define la cantidad de decimales que se muestran al imprimir números en la pantalla del controlador. Esta precisión de impresión se aplicará a todos los números que se impriman después de que se ejecute este bloque.

establecer bloque de pila de precisión de impresión

establecer precisión de impresión a [0.1 v] en 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 inicie
[Print 1/3 as 0.33.]
establecer precisión de impresión a [0.01 v] en pantalla
imprimir ([1] [math_division v] [3]) en pantalla ▶

establecer el ancho del lápiz en la pantalla

El bloque de apilamiento establecer el ancho del lápiz en la pantalla establece el grosor de las líneas dibujadas y los contornos de la forma.

establecer bloque de pila de ancho de lápiz

establecer ancho de lápiz a [10] en 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), el ancho en 130 píxeles y la altura en 60 píxeles.

cuando inicie
[Draw a rectangle with a pen width of 10.]
establecer ancho de lápiz a [10] en pantalla
dibujar rectángulo [200] [200] [200] [80] en pantalla

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

El bloque de pila establecer el color del lápiz / fuente en la pantalla establece el color del texto, los píxeles, las líneas y los contornos de la forma. El color predeterminado es el blanco.

establecer bloque de pila de color de lápiz / fuente

establecer color de lápiz / fuente a [rojo v] en pantalla

Ejemplo

Parámetros	Descripción
color	El color del bolígrafo y la fuente a utilizar: rojo verde azul negro blanco amarillo naranja 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), un ancho de 130 píxeles y un alto de 60 píxeles.

cuando inicie
[Draw a rectangle with an orange outline.]
establecer color de lápiz / fuente a [naranja v] en pantalla
dibujar rectángulo [200] [150] [240] [150] en pantalla
establecer color de lápiz / fuente a [blanco v] en pantalla
imprimir [VEXcode AIR] en x:[250] y:[220] en pantalla

establecer color de relleno de texto en pantalla

El bloque de pila establecer color de relleno de texto en pantalla establece el color de relleno detrás del texto impreso. El color de relleno de texto predeterminado es transparente.

establecer bloque de pila de color de relleno de texto

establecer color de relleno de texto a [rojo v] en pantalla

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

Ejemplos

Cuando se inicia, establece el color de relleno en naranja y dibuja dos rectángulos. El primero está en (50, 50), y el segundo está en (50, 130), ambos con un ancho de 100 píxeles y una altura de 60 píxeles.

cuando inicie :: hat events
[Display two colors behind text.]
establecer color de relleno de texto a [rojo v] en pantalla
imprimir ["Red"] en pantalla ▶
mover cursor a la siguiente fila en pantalla
establecer color de relleno de texto a [azul v] en pantalla
imprimir ["Blue"] en pantalla ▶

establecer color de relleno de dibujo en pantalla

El bloque de pila establecer color de relleno de dibujo en pantalla establece el color de relleno utilizado cuando se dibujan formas. El color de relleno predeterminado es negro.

establecer bloque de pila de color de relleno de dibujo

establecer color de relleno de dibujo a [rojo v] en pantalla

Parámetros	Descripción
color	Color de relleno de la forma a utilizar: rojo verde azul negro blanco amarillo naranja morado cian transparente

Ejemplos

Cuando se inicia, establece el color de relleno en naranja y dibuja dos rectángulos. El primero está en (50, 50), y el segundo está en (50, 130), ambos con un ancho de 100 píxeles y una altura de 60 píxeles.

cuando inicie
[Draw an orange-filled rectangle with text on top.]
establecer color de relleno de dibujo a [naranja v] en pantalla
dibujar rectángulo [200] [150] [240] [150] en pantalla
imprimir [VEXcode AIR] en x:[250] y:[220] en pantalla

Sorteo

mostrar archivo de imagen en pantalla

El bloque de pila 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 cargada por el usuario a utilizar. Las opciones cambiarán si se editan los nombres de las imágenes en el Panel de control.

Ejemplo

todo

cuando inicie
[Display custom image on screen.]
mostrar archivo de imagen [IMAGE1 v]

dibujar píxel en pantalla

The draw pixel on screen stack block draws one pixel at the selected x and y coordinate using the current pen color.

dibujar bloque de pila de píxeles

dibujar píxel [0] [0] en pantalla

Parámetros	Descripción
x	La coordenada x para dibujar el píxel de 0 a 640.
y	La coordenada y para dibujar el píxel de 0 a 480.

Ejemplo

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

cuando inicie
[Draw five pixels in a diagonal.]
dibujar píxel [360] [200] en pantalla
dibujar píxel [340] [220] en pantalla
dibujar píxel [320] [240] en pantalla
dibujar píxel [300] [260] en pantalla
dibujar píxel [280] [280] en pantalla

dibujar línea en pantalla

El bloque de pila dibujar línea en la pantalla dibuja una línea desde la primera coordenada de la pantalla (x1, y1) hasta la segunda coordenada de la pantalla (x2, y2) utilizando el ancho del bolígrafo y el color del bolígrafo actuales.

bloque de pila de líneas 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 de 0 a 640.
y1	La coordenada y en píxeles del inicio de la línea de 0 a 480.
x2	La coordenada x en píxeles del final de la línea de 0 a 640.
y2	La coordenada y en píxeles del final de la línea de 0 a 480.

Ejemplo

Cuando se inicia, dibuja una línea diagonal desde la esquina superior izquierda (0,0) hasta la esquina inferior derecha (240,240) de la pantalla.

cuando inicie
[Make an X across the screen.]
dibujar línea [0] [0] [640] [480] en pantalla
establecer color de lápiz / fuente a [cian v] en pantalla
dibujar línea [0] [480] [640] [0] en pantalla

dibujar rectángulo en pantalla

El bloque de pila dibujar rectángulo en pantalla dibuja un rectángulo usando el ancho del lápiz, el color del lápiz y el color de relleno actuales.

dibujar bloque de pila rectangular

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

Ejemplo

Parámetros	Descripción
x	La coordenada x en píxeles de la esquina superior izquierda del rectángulo de 0 a 640.
y	La coordenada y en píxeles de la esquina superior izquierda del rectángulo 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), un ancho de 130 píxeles y una altura de 60 píxeles.

cuando inicie
[Draw two rectangles on the screen.]
dibujar rectángulo [0] [0] [620] [460] en pantalla
establecer color de relleno de dibujo a [verde v] en pantalla
dibujar rectángulo [200] [180] [200] [100] en pantalla

dibujar círculo en pantalla

El bloque de pila dibujar círculo en la pantalla dibuja un círculo usando el ancho del lápiz, el color del lápiz y el color de relleno actuales.

bloque de pila de círculo de dibujo

dibujar círculo [0] [0] [10] en pantalla

Parámetros	Descripción
x	La coordenada x en píxeles del centro del círculo de 0 a 640.
y	La coordenada y en píxeles del centro del círculo de 0 a 480.
radio	El radio del círculo en píxeles.

Ejemplo

Cuando se inicia, dibuja un círculo en la pantalla con el centro en (120,120) y un radio de 40 píxeles.

cuando inicie
[Draw one green circle on the screen.]
establecer color de relleno de dibujo a [verde v] en pantalla
dibujar círculo [320] [240] [200] en pantalla

Toque

pantalla presionada

El bloque booleano * * pantalla presionada * * informa si la pantalla del controlador se está presionando actualmente.

• Verdadero - La pantalla se está presionando actualmente

• Falso - No se está presionando la pantalla

bloque booleano presionado en pantalla

<¿pantalla presionada?>

Parámetros	Descripción
	Este bloque no tiene parámetros.

Ejemplo

cuando inicie
[Play a sound when the screen is pressed.]
por siempre
si <¿pantalla presionada?> entonces
reproducir nota [bajo v] [C v] [note_eight v] ▶

Cuando se presiona la pantalla, se muestra el primer mensaje. Luego, el código espera hasta que se libere la pantalla y solo continúa después de que se vuelva a presionar la pantalla para mostrar el segundo mensaje.

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

posición de la pantalla

El bloque de indicador * * posición de la pantalla * * informa la coordenada x o y en píxeles donde se presionó la pantalla por última vez. 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 indicador de posición de pantalla

(posición [x v] de pantalla)

Parámetros	Descripción
coordina	La coordenada de la última pantalla presiona en píxeles: x informa la posición horizontal e y informa la posición vertical.

Ejemplo

Cuando se inicia, verifica continuamente si hay prensas de pantalla. Si se pulsa, borra la pantalla e imprime las coordenadas x e y de la posición táctil.

cuando inicie
[Play high or low note based on where screen is pressed.]
por siempre
si <¿pantalla presionada?> entonces
si <(posición [x v] de pantalla) [math_greater_than v] [320]> entonces
reproducir nota [alto v] [C v] [note_eight v] ▶
si no
reproducir nota [bajo v] [C v] [note_eight v] ▶

cuando el evento de pantalla

El bloque when screen event Hat se ejecuta cuando se presiona o suelta la pantalla del controlador.

Cuando se bloquea el sombrero del evento de pantalla

cuando pantalla [presionado v]

Parámetros	Descripción
acción	Determina cuándo se ejecutará la pila de bloques adjunta: presionado se ejecuta cuando se presiona la pantalla y liberado se ejecuta cuando se libera la pantalla.

Ejemplo

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