Pantalla#

Introducción#

The Screen blocks control the VEX AIR Drone Controller’s screen, allowing your controller to show text, numbers, graphics, and images, and respond to touch input.

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.

Below is a list of available blocks:

Cursor Print - Display text and manage the print cursor.

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

Settings - Change the appearance of text, graphics, and screen display.

Dibujar - Crear gráficos y elementos visuales.

Toque: detecta interacciones en la pantalla.

Cursor Imprimir#

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

The set cursor to row column on screen stack block moves the cursor to a specific row and column on the controller screen. The next print on screen block will start printing at that location.

The number of characters that can fit on the screen depends on the selected font. With the default monospaced medium font, up to 18 rows and 53 columns can be displayed clearly. Text placed beyond this range may be cut off or become difficult to read.

Establecer bloque de pila de cursor#
Coloque el cursor en la fila [1] columna [1] en la pantalla

Parámetros

Descripción

fila

The row to move the cursor to.

columna

The column to move the cursor to.

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 ▶

Captura de pantalla de la pantalla del controlador del dron VEX AIR, con texto blanco cerca del centro que dice Fila 7, Columna 25 en esa posición de la pantalla.

Colocar el cursor en la siguiente fila de la pantalla.#

The set cursor to next row on screen stack block moves the cursor to column 1 on the next row on the controller screen.

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 ▶

Captura de pantalla de la pantalla del controlador del dron VEX AIR, con texto blanco en la esquina superior izquierda que dice Línea 1 en la línea superior y Línea 2 justo debajo.

Borrar fila en la pantalla#

The clear row on screen stack block clears a row of text on the controller screen.

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#

The screen cursor column reporter block reports the column number where text will be printed as an integer.

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 ▶

Captura de pantalla de la pantalla del controlador del dron VEX AIR, con texto blanco cerca del centro que dice 25, en la fila 7, columna 25.

fila del cursor de la pantalla#

The screen cursor row reporter block reports the row number where text will be printed as an integer.

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 ▶

Captura de pantalla de la pantalla del controlador del dron VEX AIR, con texto blanco cerca del centro que dice 7, en la fila 7, columna 25.

Impresión XY#

establecer el origen de la pantalla#

The set screen origin stack block sets the origin (0, 0) used for drawing and coordinate-based printing on the controller screen. By default, the origin is the top-left corner of the screen. This block can reset the origin to an alternate (x, y) screen coordinate location.

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

Captura de pantalla de la pantalla del controlador del dron VEX AIR, con un rectángulo blanco dibujado de manera que la esquina superior izquierda sea el centro de la pantalla.

Ajustes#

pantalla clara#

The clear screen stack block clears all drawings, text, and images from the controller screen.

clear screen stack block#
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#

The wait for screen to render stack block switches screen drawing to render-later behavior. Once this block runs, following screen blocks will not appear on the controller screen until the next wait for screen to render block runs.

Note: Use this block before drawing a group of text, shapes, or images, then use it again to render the full update at once.

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

Captura de pantalla de la pantalla del controlador del dron VEX AIR, con texto blanco que dice ¡Pantalla renderizada! en la esquina superior izquierda, y un círculo blanco dibujado en el centro de la pantalla.

llenar la pantalla#

The fill screen stack block clears all drawings, text, and images from the controller screen, then changes the background to a specified color.

El bloque de pantalla de relleno#
llenar la 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

Ejemplo

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

Captura de pantalla de la pantalla del controlador del dron VEX AIR, con toda el área imprimible de la pantalla rellena de verde brillante.

establecer fuente en pantalla#

The set font on screen stack block sets the font and size used for displaying text on the controller screen. This font will apply to all text printed after this block runs.

establecer bloque de pila de fuentes#
Establezca la fuente en [monoespaciado v] [medio v] en la pantalla

Parámetros

Descripción

tipo

The font type: monospaced or proportional.

tamaño

The font size (shown below):

  • super small
  • extra small
  • small
  • medium
  • large
  • extra large
  • super large

Captura de pantalla de la pantalla del controlador del dron VEX AIR con una variedad de letras y números impresos en blanco en la esquina superior izquierda en fuente Mono 12. Las letras AZ están en una línea y ocupan aproximadamente un tercio del ancho de la pantalla. En la esquina inferior izquierda, se lee 91 caracteres de ancho y 30 filas.
monospaced super small

La misma imagen que la anterior, ahora con la fuente Mono 15. Las letras AZ están en una línea y ocupan casi la mitad del ancho de la pantalla. En la esquina inferior izquierda, se lee 71 caracteres de ancho y 23 filas.
monospaced extra small

La misma imagen que la anterior, ahora con la fuente Mono 20. Las letras AZ están en una línea y ocupan la mitad del ancho de la pantalla. En la esquina inferior izquierda, se lee 53 caracteres de ancho y 18 filas.
monospaced small

La misma imagen que la anterior, ahora con la fuente Mono 24. Las letras AZ están en una línea y ocupan un poco más de la mitad del ancho de la pantalla. En la esquina inferior izquierda, se lee 45 caracteres de ancho y 15 filas.
monospaced medium

La misma imagen que la anterior, ahora con la fuente Mono 30. Las letras AZ están en una línea y ocupan aproximadamente tres cuartas partes del ancho de la pantalla. En la esquina inferior izquierda, se lee 35 caracteres de ancho y 12 filas.
monospaced large

La misma imagen que la anterior, ahora con la fuente Mono 40. Las letras AZ están en una línea, abarcando todo el ancho de la pantalla. En la esquina inferior izquierda, se lee 26 caracteres de ancho y 9 filas.
monospaced extra large

La misma imagen que la anterior, ahora con la fuente Mono 60. Las letras AQ están en una línea, abarcando todo el ancho de la pantalla. En la esquina inferior izquierda, se lee 17 caracteres de ancho y 6 filas.
monospaced super large

La misma imagen que la anterior, ahora con la fuente Prop 20. Las letras AZ están en una línea y ocupan un poco más de la mitad del ancho de la pantalla. En la esquina inferior izquierda, se lee 49 caracteres de ancho y 18 filas.
proporcionalmente pequeño

La misma imagen que la anterior, ahora con la fuente Prop 24. Las letras AZ están en una línea y ocupan aproximadamente dos tercios del ancho de la pantalla. En la esquina inferior izquierda, se lee 42 caracteres de ancho y 15 filas.
medio proporcional

La misma imagen que la anterior, ahora con la fuente Prop 30. Las letras AZ están en una línea y ocupan tres cuartas partes del ancho de la pantalla. En la esquina inferior izquierda, se lee 33 caracteres de ancho y 12 filas.
proporcionalmente grande

La misma imagen que la anterior, ahora con la fuente Prop 40. Las letras AY están en una línea, abarcando todo el ancho de la pantalla. En la esquina inferior izquierda, se lee 24 caracteres de ancho y 9 filas.
proporcional extra grande

La misma imagen que la anterior, ahora con la fuente Prop 60. Las letras AQ están en una línea, abarcando todo el ancho de la pantalla. En la esquina inferior izquierda, se lee 17 caracteres de ancho y 6 filas.
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 ▶

La misma imagen que las anteriores, ahora con texto blanco en la esquina superior izquierda que dice VEX es fuente Mono 40.

Ajustar la precisión de impresión en pantalla#

The set print precision on screen stack block sets how many decimal places are shown when numbers are printed on the controller screen. This print precision will apply to all numbers printed after this block runs.

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

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

Captura de pantalla de la pantalla del controlador del dron VEX AIR con texto blanco en la esquina superior izquierda que dice 0.33.

Ajustar el ancho del lápiz en la pantalla#

The set pen width on screen stack block sets the thickness of drawn lines and shape outlines.

set pen width stack block#
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

Captura de pantalla de la pantalla del controlador del dron VEX AIR con un rectángulo blanco con un borde grueso impreso en el centro.

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

The set pen / font color on screen stack block sets the color of text, pixels, lines, and shape outlines. The default color is white.

set pen / font color stack block#
Establezca el color del lápiz/fuente en [rojo v] en la pantalla

Ejemplo

Parámetros

Descripción

color

The pen and font color to use:

  • 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 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

Captura de pantalla de la pantalla del controlador del dron VEX AIR con un delgado rectángulo naranja con las palabras VEXcode AIR impresas en blanco en el centro.

establecer el color de relleno del texto en la pantalla#

The set text fill color on screen stack block sets the fill color behind printed text. The default text fill color is transparent.

set text fill color stack block#
Establezca el color de relleno del texto en [rojo v] en la pantalla

Parámetros

Descripción

color

The text fill color to use:

  • 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 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#

The set draw fill color on screen stack block sets the fill color used when shapes are drawn. The default fill color is black.

set draw fill color stack block#
Establezca el color de relleno del dibujo en [rojo v] en la pantalla

Parámetros

Descripción

color

The shape fill color to use:

  • 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 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

Captura de pantalla de la pantalla del controlador del dron VEX AIR con un rectángulo naranja sólido con un borde blanco delgado y texto blanco que dice VEXcode AIR impreso en el centro.

Dibujar#

Mostrar archivo de imagen en pantalla#

The show image file on screen stack block draws a custom user-uploaded image on the controller screen at the set origin.

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#

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#
Dibuja el píxel [0] [0] en la pantalla

Parámetros

Descripción

incógnita

The x-coordinate to draw the pixel from 0 to 640.

y

The y-coordinate to draw the pixel from 0 to 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

Captura de pantalla de la pantalla del controlador del dron VEX AIR con 5 píxeles espaciados uniformemente impresos en una línea diagonal a través del centro de la pantalla.

dibujar una línea en la pantalla#

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

bloque de pila de línea de dibujo#
dibuja la línea [0] [0] [10] [10] en la pantalla

Parámetros

Descripción

x1

The x-coordinate in pixels of the start of the line from 0 to 640.

año1

The y-coordinate in pixels of the start of the line from 0 to 480.

x2

The x-coordinate in pixels of the end of the line from 0 to 640.

y2

The y-coordinate in pixels of the end of the line from 0 to 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

Captura de pantalla de la pantalla del controlador del dron VEX AIR con una línea blanca dibujada desde la esquina superior izquierda hasta la esquina inferior derecha, y una línea de color turquesa dibujada desde la esquina inferior izquierda hasta la esquina superior derecha, que se cruzan en el centro.

Dibujar un rectángulo en la pantalla#

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

draw rectangle stack block#
dibuja el rectángulo [0] [0] [10] [10] en la pantalla

Ejemplo

Parámetros

Descripción

incógnita

The x-coordinate in pixels of the top-left corner of the rectangle from 0 to 640.

y

The y-coordinate in pixels of the top-left corner of the rectangle from 0 to 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 del dibujo en [verde v] en la pantalla
dibuja el rectángulo [200] [180] [200] [100] en la pantalla

Captura de pantalla de la pantalla del controlador del dron VEX AIR con un rectángulo verde sólido con un borde blanco delgado impreso en el centro, y un rectángulo blanco delgado impreso alrededor de los bordes exteriores de la pantalla.

dibujar un círculo en la pantalla#

The draw circle on screen stack block draws a circle using the current pen width, pen color, and fill color.

Dibujar bloque de pila circular#
dibuja el círculo [0] [0] [10] en la pantalla

Parámetros

Descripción

incógnita

The x-coordinate in pixels of the center of the circle from 0 to 640.

y

The y-coordinate in pixels of the center of the circle from 0 to 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 del dibujo en [verde v] en la pantalla
dibuja el círculo [320] [240] [200] en la pantalla

Captura de pantalla de la pantalla del controlador del dron VEX AIR con un gran círculo verde sólido con un borde blanco delgado dibujado en el centro de la pantalla.

Tocar#

screen pressed#

The screen pressed Boolean block reports whether the controller’s screen is currently being pressed.

  • 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

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#

The screen position reporter block reports the x- or y-coordinate in pixels where the screen was last pressed. The return value for x is between 0 (left) and 640 (right). The return value for y is between 0 (top) and 480 (bottom).

A VEX AIR Drone Controller with the printable area of the screen dimensions labeled and outlined in a red box. The coordinates begin with (0,0) in the upper left corner, and proceed clockwise with (0, 640), (480, 640), and (480,0) to the lower left corner. The center coordinates of the screen are labeled (240, 320).

bloque de reportero de posición de pantalla#
(posición de pantalla [incógnita v])

Parámetros

Descripción

coordinar

The coordinate of the last screen press in pixels: x reports the horizontal position, and y reports the vertical position.

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#

The when screen event hat block runs when the controller screen is pressed or released.

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 run: pressed runs when the screen is pressed, and released runs when the screen is released.

Ejemplo

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