Pantalla#
Introducción#
Los métodos de pantalla controlan cómo el cerebro V5 muestra texto, números y gráficos en su pantalla táctil, y cómo responde a la entrada táctil.
De forma predeterminada, la fuente para imprimir en el cerebro es pequeña monoespaciada que tiene 12 filas y 48 columnas.
Para el dibujo, la resolución del cerebro es de 480 x 240 píxeles.
A continuación se muestra una lista de todos los métodos:
Impresión del cursor: coloque e imprima el texto.
print— Imprime texto, números o valores de variables en la posición actual del cursor.set_cursor— Mueve el cursor a una fila y columna específicas.next_row— Mueve el cursor a la columna 1 de la siguiente fila.clear_row— Borra una fila de texto.row— Devuelve la fila donde se imprimirá el texto.column— Devuelve la columna donde se imprimirá el texto.print_at— Imprime texto, números o valores de variables en una coordenada x e y específica.get_string_width— Devuelve el ancho de una cadena en píxeles utilizando la fuente actual.get_string_height— Devuelve la altura de una cadena en píxeles utilizando la fuente actual.clear_line— Borra una línea de texto.new_line— Mueve el cursor a una nueva línea.
Mutadores: cambia la configuración de la pantalla, los colores y el comportamiento del dibujo.
clear_screen— Borra la pantalla de todos los dibujos y texto.set_font— Establece la fuente para el texto impreso.set_pen_width— Establece el grosor de las líneas dibujadas y los contornos de forma.set_pen_color— Establece el color del texto, los píxeles, las líneas y los contornos de forma.set_fill_color— Establece el color de relleno para formas dibujadas y fondos de texto impreso.set_origin— Establece el origen utilizado para la impresión y el dibujo basados en coordenadas.
Dibujar: agrega gráficos a la pantalla.
draw_pixel— Dibuja un píxel en una coordenada.draw_line— Dibuja una línea entre dos puntos.draw_rectangle— Dibuja un rectángulo.draw_circle— Dibuja un círculo.render— Actualiza la pantalla del cerebro con texto y dibujos solo cuando se llama.set_clip_region— Restringe dónde pueden aparecer los dibujos y el texto.
Getters — Compruebe el estado táctil y la posición táctil.
pressing— Devuelve si se está presionando la pantalla.x_position— Devuelve la coordenada x de la última prensa de pantalla.y_position— Devuelve la coordenada y de la última prensa de pantalla.
Devoluciones de llamada: responda a eventos táctiles en la pantalla.
pressed— Registra una función que se llamará cuando se presione la pantalla.released— Registra una función que se llamará cuando se libere la pantalla.
Para obtener información sobre cómo construir un Cerebro para acceder a los métodos de la pantalla screen , consulte Cerebro.
Impresión del cursor#
print#
print imprime texto, números o valores de variables en la pantalla Cerebro en la posición actual del cursor y la fuente.
Uso:
brain.screen.print(text, sep, precision)
Parámetros |
Descripción |
|---|---|
|
El texto, el número o el valor de la variable a imprimir. |
|
Opcional. Una cadena para insertar entre valores. Esto debe escribirse como un argumento de palabra clave (sep=). El valor predeterminado es |
|
Opcional. El número de decimales que se mostrarán al imprimir números simples. Esto debe escribirse como un argumento de palabra clave ( |
# Print on the Brain's screen
brain.screen.print("Hello, Robot!")
set_cursor#
set_cursor mueve el cursor a una fila y columna específicas en la pantalla Cerebro. La próxima llamada print comenzará a imprimirse en esa ubicación. La cantidad de filas y columnas que pueden caber cómodamente depende de la fuente seleccionada. Con la fuente media monoespaciada predeterminada, se pueden mostrar claramente hasta 8 filas y 13 columnas. El texto colocado más allá de este rango puede cortarse o ser difícil de leer.
Las fuentes monoespaciadas tienen caracteres que tienen el mismo ancho, lo que hace que la ubicación del texto sea consistente. Por el contrario, las fuentes proporcionales varían en el ancho de los caracteres, por lo que algunas letras ocupan más espacio que otras. Sin embargo, independientemente del tipo que se utilice, set_cursor posiciona el cursor en función del tamaño de fila y columna, no del estilo de fuente. El tamaño de la fuente se puede ajustar utilizando el set_font.
Uso:
brain.screen.set_cursor(row, column)
Parámetros |
Descripción |
|---|---|
|
La fila a la que mover el cursor. |
|
La columna a la que mover el cursor. |
# Display text starting at Row 3 Column 12
brain.screen.set_cursor(3, 12)
brain.screen.print("Row 3, Column 12")
next_row#
next_row mueve el cursor a la siguiente fila.
Uso:
brain.screen.next_row()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Print two lines of text on the Brain's screen
brain.screen.print("Line 1")
brain.screen.next_row()
brain.screen.print("Line 2")
clear_row#
clear_row borra una sola fila de texto en la pantalla Cerebro.
Uso:
brain.screen.clear_row(row, color)
Parámetros |
Descripción |
|---|---|
|
Opcional. La fila a borrar. El valor predeterminado es la fila del cursor actual. |
|
Opcional. Un color válido, un valor hexadecimal o una cadena web. |
# Only keep the text on row 1
brain.screen.print("This text stays")
brain.screen.next_row
brain.screen.print("This text disappears")
wait(3, SECONDS)
brain.screen.clear_row()
row#
la row devuelve la fila donde el texto se imprimirá como un número entero.
Uso:
brain.screen.row()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Display the cursor's current row
brain.screen.set_cursor(3, 2)
brain.screen.print(brain.screen.row())
column#
column devuelve la columna donde el texto se imprimirá como un número entero.
Uso:
brain.screen.column()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Display the cursor's current column
brain.screen.set_cursor(3, 15)
brain.screen.print(brain.screen.column())
print_at#
print_at imprime texto, números o valores de variables en la pantalla Cerebro en coordenadas x e y específicas con la fuente y origen actuales.
Uso:
brain.screen.print_at(text, x, y, sep, precision, opaque)
Parámetros |
Descripción |
|---|---|
|
El texto, el número o el valor de la variable a imprimir. |
|
La coordenada x a imprimir en como un argumento de palabra clave ( |
|
La coordenada y a imprimir en como argumento de palabra clave ( |
|
Opcional. Una cadena para insertar entre valores. Esto debe escribirse como un argumento de palabra clave (sep=). El valor predeterminado es |
|
Opcional. El número de decimales que se mostrarán al imprimir números simples. Esto debe escribirse como un argumento de palabra clave ( |
|
Opcional. Un valor booleano que indica si el texto debe borrar los píxeles de fondo. El valor predeterminado es |
# Display text at the center of the screen
brain.screen.print_at("Center", x=220, y=120)
get_string_width#
get_string_width devuelve el ancho de una cadena en píxeles como un número entero, utilizando la font actual.
Usage:
brain.screen.get_string_width(string)
Parámetros |
Descripción |
|---|---|
|
La cadena a medir. |
get_string_height#
get_string_height devuelve la altura de una cadena en píxeles como un número entero, utilizando la font actual.
Usage:
brain.screen.get_string_height(string)
Parámetros |
Descripción |
|---|---|
|
La cadena a medir. |
clear_line#
clear_line borra la fila de texto actual.
Usage:
brain.screen.clear_line()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
new_line#
new_line mueve el cursor a la columna 1 en la siguiente fila en la pantalla Cerebro.
Uso:
brain.screen.new_line()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
Mutadores#
clear_screen#
clear_screen borra todos los dibujos y el texto de la pantalla Cerebro.
Uso:
brain.screen.clear_screen(color)
Parámetros |
Descripción |
|---|---|
|
Opcional. Una opción de color válida:
|
# Print VEXcode on the screen
brain.screen.print("VEXcode")
wait(2, SECONDS)
# Clear screen to black
brain.screen.clear_screen()
# Print VEXcode on the screen
brain.screen.print("VEXcode")
# Clear screen to blue using predefined color
brain.screen.clear_screen(Color.BLUE)
set_font#
set_font establece la fuente utilizada para mostrar el texto en la pantalla Cerebro. Esta fuente se aplicará a todo el texto impreso después de que se ejecute este método.
Uso:
brain.screen.set_font(font)
Parámetros |
Descripción |
|---|---|
|
Una opción de fuente válida a continuación. |
|
|
|
|---|---|---|
|
|
|
|
|
|
|
# Set the font type to MONO40
brain.screen.set_font(FontType.MONO40)
brain.screen.print("VEX")
set_pen_width#
set_pen_width establece el grosor de las líneas dibujadas y los contornos de forma.
Uso:
brain.screen.set_pen_width(value)
Parámetros |
Descripción |
|---|---|
|
El ancho del lápiz, en píxeles, de 0 a 32. |
# Draw a rectangle with a pen width of 10
brain.screen.set_pen_width(10)
brain.screen.draw_rectangle(50, 50, 130, 60)
set_pen_color#
set_pen_color establece el color del texto, los píxeles, las líneas y los contornos de forma.
Uso:
brain.screen.set_pen_color(color)
Parámetros |
Descripción |
|---|---|
|
El lápiz y el color de fuente a usar. Las opciones incluyen:
|
# Draw a rectangle with orange borders
brain.screen.set_pen_color(Color.ORANGE)
brain.screen.draw_rectangle(50, 50, 130, 60)
set_fill_color#
set_fill_color establece el color de relleno utilizado cuando se dibujan formas.
Uso:
brain.screen.set_fill_color(color)
Parámetros |
Descripción |
|---|---|
|
El color de relleno a usar. Las opciones incluyen:
|
# Draw a purple rectangle
brain.screen.set_fill_color(Color.PURPLE)
brain.screen.draw_rectangle(50, 130, 100, 60)
set_origin#
set_origin establece el origen utilizado para el dibujo y la impresión basada en coordenadas en la pantalla Brain. De forma predeterminada, el origen es la esquina superior izquierda de la pantalla.
Uso:
brain.screen.set_origin(x, y)
Parámetros |
Descripción |
|---|---|
|
La coordenada x a establecer como origen, de 0 a 479. |
|
La coordenada y para establecer como origen, de 0 a 239. |
Sorteo#
draw_pixel#
draw_pixel dibuja un píxel en las coordenadas x e y seleccionadas utilizando el color actual del bolígrafo.
Uso:
brain.screen.draw_pixel(x, y)
Parámetros |
Descripción |
|---|---|
|
La coordenada x para dibujar el píxel, de 0 a 479, referenciado al origen de la pantalla. |
|
La coordenada y para dibujar el píxel, de 0 a 239, referenciado al origen de la pantalla. |
# Draw the pixels marking the corners of a square
brain.screen.draw_pixel(250, 100)
brain.screen.draw_pixel(275, 100)
brain.screen.draw_pixel(250, 125)
brain.screen.draw_pixel(275, 125)
draw_line#
draw_line dibuja una línea desde la primera coordenada de la pantalla hasta la segunda coordenada de la pantalla utilizando el ancho actual del lápiz y el color del lápiz.
Uso:
brain.screen.draw_line(start_x, start_y, end_x, end_y)
Parámetros |
Descripción |
|---|---|
|
La coordenada x en píxeles del inicio de la línea, de 0 a 479, referenciada al origen de la pantalla. |
|
La coordenada y en píxeles del inicio de la línea, de 0 a 239, referenciada al origen de la pantalla. |
|
La coordenada x en píxeles del final de la línea, de 0 a 479, referenciada al origen de la pantalla. |
|
La coordenada y en píxeles del final de la línea, de 0 a 239, referenciada al origen de la pantalla. |
# Draw a line from the top left to bottom right of the screen
brain.screen.draw_line(0, 0, 479, 239)
draw_rectangle#
draw_rectangle dibuja un rectángulo utilizando el ancho del lápiz actual, el color del lápiz y el color de relleno, a menos que se utilice el parámetro de color opcional.
Uso:
brain.screen.draw_rectangle(x, y, width, height, color)
Parámetros |
Descripción |
|---|---|
|
La coordenada x en píxeles de la esquina superior izquierda del rectángulo de 0 a 479. |
|
La coordenada y en píxeles de la esquina superior izquierda del rectángulo de 0 a 239. |
|
El ancho del rectángulo. |
|
La altura del rectángulo. |
|
Opcional. Una opción de color válida:
|
# Draw a rectangle on the screen
brain.screen.draw_rectangle(50, 50, 130, 60)
draw_circle#
draw_circle dibuja un círculo utilizando el ancho actual del bolígrafo, el color del bolígrafo y el color de relleno, a menos que se utilice el parámetro de color opcional.
Uso:
brain.screen.draw_circle(x, y, radius, color)
Parámetros |
Descripción |
|---|---|
|
La coordenada x en píxeles del centro del círculo, de 0 a 479, referenciada al origen de la pantalla. |
|
La coordenada y en píxeles del centro del círculo, de 0 a 239, referenciada al origen de la pantalla. |
|
El radio del círculo, en píxeles. |
|
Opcional. El color de relleno a usar. Las opciones incluyen:
|
# Draw a circle on the screen
brain.screen.draw_circle(120, 120, 40)
render#
La opción render habilita el doble búfer para la pantalla del cerebro. Una vez activada, los comandos de dibujo (como texto, formas o imágenes) no aparecerán inmediatamente durante el resto del proyecto. En su lugar, las actualizaciones solo se mostrarán cuando se vuelva a usar render Esto permite actualizaciones de pantalla más fluidas y controladas, pero implica que no se verá nada hasta que se use render.
Uso:
brain.screen.render()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Render text after moving
brain.screen.render()
brain.screen.print("Render later...")
drivetrain.drive_for(FORWARD, 100, MM)
drivetrain.turn_for(RIGHT, 90, DEGREES)
brain.screen.render()
set_clip_region#
set_clip_region define un área rectangular en la pantalla donde se confinarán todos los dibujos y el texto. No se mostrará ningún contenido fuera de esta región.
Uso:
brain.screen.set_clip_region(x, y, width, height)
Parámetros |
Descripción |
|---|---|
|
La posición x de la esquina superior izquierda del rectángulo, referenciada al origen de la pantalla. |
|
La posición y de la esquina superior izquierda del rectángulo, referenciada al origen de la pantalla. |
|
El ancho del rectángulo. |
|
La altura del rectángulo. |
# Restrict text and drawings to a specific region
brain.screen.set_clip_region(0, 0, 120, 120)
brain.screen.draw_rectangle(60, 60, 100, 100, Color.RED)
brain.screen.print_at("Cut off!", x=60, y=60)
Toque#
pressing#
pressing devuelve un booleano que indica si la pantalla Brain se está pulsando actualmente.
True: se está presionando la pantalla.False- No se está presionando la pantalla.
Uso:
brain.screen.pressing()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Change the screen's color after it's pressed
while not brain.screen.pressing():
wait(5, MSEC)
brain.screen.set_fill_color(Color.GREEN)
brain.screen.draw_rectangle(0, 0, 479, 239)
# Display different messages after the screen is pressed
while not brain.screen.pressing():
wait(5, MSEC)
brain.screen.print("First message!")
brain.screen.next_row()
# Lift finger to press the screen again
while brain.screen.pressing():
wait(5, MSEC)
while not brain.screen.pressing():
wait(5, MSEC)
brain.screen.print("Second message!")
brain.screen.next_row()
x_position#
x_position devuelve la coordenada x de la última pantalla presionada como un número entero de 0 (izquierda) a 479 (derecha).
Uso:
brain.screen.x_position()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Display a circle where the screen is pressed
while not brain.screen.pressing():
wait(5, MSEC)
brain.screen.set_fill_color(Color.WHITE)
brain.screen.draw_circle(brain.screen.x_position(), brain.screen.y_position(), 20)
y_position#
y_position devuelve la coordenada y de la última prensa de pantalla como un número entero de 0 (arriba) a 239 (abajo).
Uso:
brain.screen.y_position()
Parámetros |
Descripción |
|---|---|
Este método no tiene parámetros. |
# Display a circle where the screen is pressed
while not brain.screen.pressing():
wait(5, MSEC)
brain.screen.set_fill_color(Color.WHITE)
brain.screen.draw_circle(brain.screen.x_position(), brain.screen.y_position(), 20)
Devoluciones de llamada#
pressed#
pressed registra una función que se llamará cuando se presione la pantalla del cerebro.
Uso:
brain.screen.pressed(callback, arg)
Parámetros |
Descripción |
|---|---|
|
Una función previamente definida que se ejecuta cuando se presiona la pantalla Cerebro. |
|
Opcional. Una tupla que contiene argumentos para pasar a la función de devolución de llamada. Consulte Uso de funciones con parámetros para obtener más información. |
def my_function():
brain.screen.print("Screen pressed")
# Call my_function whenever the Brain screen is pressed
brain.screen.pressed(my_function)
released#
released registra una función que se llamará cuando se libere la pantalla (toque removed).
Uso:
brain.screen.released(callback, arg)
Parámetros |
Descripción |
|---|---|
|
Una función previamente definida que se ejecuta cuando se libera la pantalla Brain. |
|
Opcional. Una tupla que contiene argumentos para pasar a la función de devolución de llamada. Consulte Uso de funciones con parámetros para obtener más información. |
def my_function():
brain.screen.print("Screen released")
# Call my_function whenever the Brain screen is released
brain.screen.released(my_function)