Pantalla

imprimir()

El método print(valor, formato, ...) imprime texto en la pantalla utilizando la posición actual del cursor.

Parámetros	Descripción
valor	El texto a imprimir.
formato	Un especificador de formato que se utilizará al imprimir el valor de las variables.
…	Una lista variable de parámetros que se imprimirán con el especificador de formato.

Devoluciones: Ninguna.

// Print the number 1 on the Brain's screen at current
// cursor position.
Brain.Screen.print(1);

imprimirEn()

El método printAt(text, x, y, format, precision, ...) imprime texto en coordenadas x e y específicas en la pantalla.

Parámetros	Descripción
valor	El texto a imprimir.
incógnita	La posición x para imprimir como argumento de palabra clave (x=), referenciada al origen de la pantalla.
y	La posición y para imprimir como argumento de palabra clave (y=), referenciada al origen de la pantalla.
formato	Un especificador de formato que se utilizará al imprimir el valor de las variables.
…	Una lista variable de parámetros que se imprimirán con el especificador de formato.

Devoluciones: Ninguna.

// Print the number 1 on the Brain's screen at
// position (100, 40).
Brain.Screen.printAt(1, x=100, y=40);

establecerCursor()

El método setCursor(x, y) establece la posición del cursor. El espaciado entre filas y columnas considera la fuente seleccionada. El tamaño de celda base es de 10 x 20 píxeles para la fuente MONO20. La esquina superior izquierda de la pantalla es la posición (x=1, y=1).

Parámetros	Descripción
incógnita	La posición x del cursor.
y	La posición y del cursor.

Devoluciones: Ninguna.

establecerOrigen()

El método setOrigin(x, y) establece el origen utilizado para dibujar gráficos en la pantalla del Brain. Las funciones de dibujo consideran la esquina superior izquierda de la pantalla del Brain como origen. Esta función puede mover el origen a una posición alternativa, como el centro de la pantalla del Brain.

Parámetros	Descripción
incógnita	La posición x del origen relativa a la esquina superior izquierda.
y	La posición y del origen con respecto a la esquina superior izquierda.

Devoluciones: Ninguna.

establecerFuente()

El método setFont(fontname) establece el tipo de fuente utilizado para imprimir texto en la pantalla del Brain.

Parámetros	Descripción
nombre de fuente	Un fontType válido.

Devoluciones: Ninguna.

// Set the font type to mono40.
Brain.Screen.setFont(fontType::mono40);

establecerAnchoDePluma()

El método setPenWidth(width) establece el ancho del lápiz utilizado para dibujar líneas, rectángulos y círculos.

Parámetros	Descripción
ancho	El ancho del bolígrafo.

Devoluciones: Ninguna.

// Set the pen width to 5 pixels.
Brain.Screen.setPenWidth(5);

establecerColorDePluma()

El color del lápiz se puede configurar de dos maneras:

El método setPenColor(color) establece el color del lápiz con el color especificado.

Parámetros	Descripción
color	Un objeto colorType definido previamente o un valor hexadecimal.

Devoluciones: Ninguna.

// Set pen color red using a Hex value.
Brain.Screen.setPenColor(0xFF0000);

// Set pen color blue using a predefined color.
Brain.Screen.setPenColor(blue);

// Set pen color green using a web string.
Brain.Screen.setPenColor("#00FF00");

El método setPenColor(hue) establece el color del lápiz con el tono especificado.

Parámetros	Descripción
matiz	Un número entero que representa el tono del color, de 1 a 359.

Devoluciones: Ninguna.

establecerColorDeRelleno()

El color de relleno se puede configurar de dos maneras:

El método setFillColor(color) establece el color de relleno con el color especificado.

Parámetros	Descripción
color	Un objeto colorType definido previamente o un valor hexadecimal.

Devoluciones: Ninguna.

// Set pen color red using a hex value.
Brain.Screen.setFillColor(0xFF0000);

// Set pen color blue using a predefined color.
Brain.Screen.setFillColor(blue);

// Set pen color green using a web string.
Brain.Screen.setFillColor("#00FF00");

El método setFillColor(hue) establece el color de relleno con el tono especificado.

Parámetros	Descripción
matiz	Un número entero que representa el tono del color, de 1 a 359.

Devoluciones: Ninguna.

columna()

El método column() devuelve la columna actual donde se imprimirá el texto.

Devuelve: La posición actual de la columna.

fila()

El método row() devuelve la fila actual donde se imprimirá el texto.

Devuelve: La posición de la fila actual.

obtenerAnchoDeCadena()

El método getStringWidth(string) obtiene el ancho de una cadena en píxeles, como si estuviera en la pantalla del cerebro. El ancho de una cadena cambia según su longitud y el tamaño de la fuente.

Parámetros	Descripción
cadena	La cuerda a medir.

Devuelve: El ancho de la cadena como un entero.

obtenerAlturaDeCadena()

El método getStringHeight(string) obtiene la altura de una cadena en píxeles, como si estuviera en la pantalla del cerebro. La altura de una cadena cambia según su longitud y el tamaño de la fuente.

Parámetros	Descripción
cadena	La cuerda a medir.

Devuelve: La altura de la cadena como un entero.

Borrar pantalla()

La pantalla del cerebro se puede limpiar de tres maneras:

El método clearScreen() limpia la pantalla del Cerebro al color predeterminado (negro).

Devoluciones: Ninguna.

// Print VEXcode on the Brain's screen.
Brain.Screen.print("VEXcode");

// Clear screen to black.
Brain.Screen.clearScreen();

El método clearScreen(color) borra toda la pantalla del cerebro a un color específico.

Parámetros	Descripción
color	Un objeto colorType definido previamente o un valor hexadecimal.

Devoluciones: Ninguna.

// Print VEXcode on the Brain's screen.
Brain.Screen.print("VEXcode");

// Clear screen to blue using a predefined color.
Brain.Screen.clearScreen(blue);

El método clearScreen(hue) borra toda la pantalla del cerebro a un tono específico.

Parámetros	Descripción
matiz	Un número entero que representa el tono del color, de 1 a 359.

Devoluciones: Ninguna.

clearLine()

Las líneas se pueden borrar en la pantalla del Cerebro de cuatro maneras:

El método clearLine() borra la fila donde se encuentra actualmente el cursor.

Devoluciones: Ninguna.

El método clearLine(number) borra una fila especificada.

Parámetros	Descripción
número	La fila a despejar.

Devoluciones: Ninguna.

El método clearLine(number, color) borra una fila especificada y establece la fila en un color especificado.

Parámetros	Descripción
número	La fila a despejar.
color	Un objeto color definido previamente o un valor hexadecimal.

Devoluciones: Ninguna.

El método clearLine(number, hue) borra una fila especificada y establece la fila en un tono especificado.

Parámetros	Descripción
número	La fila a despejar.
matiz	Un número entero que representa el tono del color, de 1 a 359.

Devoluciones: Ninguna.

nuevaLínea()

El método newLine() mueve el cursor a la siguiente fila.

Devoluciones: Ninguna.

dibujarPixel()

El método drawPixel(x, y) dibuja un píxel utilizando el color del lápiz actual.

Parámetros	Descripción
incógnita	La posición x para dibujar el píxel referenciado al origen de la pantalla.
y	La posición y para dibujar el píxel referenciado al origen de la pantalla.

Devoluciones: Ninguna.

// Draw a red pixel on the Brain's screen.
Brain.Screen.setPenColor(red);
Brain.Screen.drawPixel(10, 10);

dibujarLínea()

El método drawLine(x1, y1, x2, y2) dibuja una línea utilizando el color del lápiz actual.

Parámetros	Descripción
x1	La posición x del inicio de la línea referenciada al origen de la pantalla.
año1	La posición y del inicio de la línea referenciada al origen de la pantalla.
x2	La posición x del final de la línea referenciada al origen de la pantalla.
Año 2	La posición y del final de la línea referenciada al origen de la pantalla.

Devoluciones: Ninguna.

// Draw a red line on the Brain's screen.
Brain.Screen.setPenColor(red);
Brain.Screen.drawLine(10, 10, 20, 20);

dibujarRectángulo()

Se puede dibujar un rectángulo en la pantalla del Cerebro de tres maneras:

El método drawRectangle(x, y, width, height) dibuja un rectángulo en la pantalla usando el lápiz actual y los colores de relleno.

Parámetros	Descripción
incógnita	La posición x de la esquina superior izquierda del rectángulo referenciada al origen de la pantalla.
y	La posición y de la esquina superior izquierda del rectángulo referenciada al origen de la pantalla.
ancho	El ancho del rectángulo.
altura	La altura del rectángulo.

Devoluciones: Ninguna.

// Draw a green rectangle on the screen that is
// filled using blue.
Brain.Screen.setPenColor(green);
Brain.Screen.setFillColor(blue);
Brain.Screen.drawRectangle(10, 10, 20, 20);

El método drawRectangle(x, y, width, height, color) dibuja un rectángulo en la pantalla usando el lápiz actual y rellena el círculo con el color especificado.

Parámetros	Descripción
incógnita	La posición x de la esquina superior izquierda del rectángulo referenciada al origen de la pantalla.
y	La posición y de la esquina superior izquierda del rectángulo referenciada al origen de la pantalla.
ancho	El ancho del rectángulo.
altura	La altura del rectángulo.
color	Un objeto color definido previamente o un valor hexadecimal.

Devoluciones: Ninguna.

El método drawRectangle(x, y, width, height, hue) dibuja un rectángulo en la pantalla usando el lápiz actual y rellena el círculo con el tono especificado.

Parámetros	Descripción
incógnita	La posición x de la esquina superior izquierda del rectángulo referenciada al origen de la pantalla.
y	La posición y de la esquina superior izquierda del rectángulo referenciada al origen de la pantalla.
ancho	El ancho del rectángulo.
altura	La altura del rectángulo.
matiz	Un número entero que representa el tono del color, de 1 a 359.

Devoluciones: Ninguna.

dibujarCírculo()

Se puede dibujar un círculo en la pantalla del Cerebro de tres maneras:

El método drawCircle(x, y, radio) dibuja un círculo utilizando los colores de lápiz y relleno actuales.

Parámetros	Descripción
incógnita	La posición x del centro del círculo referenciado al origen de la pantalla.
y	La posición y del centro del círculo referenciada al origen de la pantalla.
radio	El radio del círculo en píxeles.

Devoluciones: Ninguna.

// Draw a green circle on the Brain's screen that is
// filled using blue.
Brain.Screen.setPenColor(green);
Brain.Screen.setFillColor(blue);
Brain.Screen.drawCircle(50, 50, 10);

El método drawCircle(x, y, radio, color) dibuja un círculo usando el color actual del lápiz y rellena el círculo con el color especificado.

Parámetros	Descripción
incógnita	La posición x del centro del círculo referenciado al origen de la pantalla.
y	La posición y del centro del círculo referenciada al origen de la pantalla.
radio	El radio del círculo en píxeles.
color	Un objeto color definido previamente o un valor hexadecimal.

Devoluciones: Ninguna.

El método drawCircle(x, y, radio, hue) dibuja un círculo usando el color actual del lápiz y rellena el círculo con el tono especificado.

Parámetros	Descripción
incógnita	La posición x del centro del círculo referenciado al origen de la pantalla.
y	La posición y del centro del círculo referenciada al origen de la pantalla.
radio	El radio del círculo en píxeles.
matiz	Un número entero que representa el tono del color, de 1 a 359.

Devoluciones: Ninguna.

dibujarImagenDesdeBuffer()

El método drawImageFromBuffer(buffer, x, y, width, height) dibuja una imagen en la pantalla utilizando el contenido del búfer de memoria.

Parámetros	Descripción
buffer	Un puntero a un búfer que contiene datos de imagen sin procesar de 32 bits por píxel.
incógnita	La coordenada x en la que se dibujará el borde izquierdo de la imagen.
y	La coordenada y en la que se dibujará el borde superior de la imagen.
ancho	El ancho de la imagen.
altura	La altura de la imagen.

Devuelve: Un valor booleano que indica si la imagen se dibujó correctamente en la pantalla.

dibujarImagenDesdeArchivo()

El método drawImageFromFile(filename, x, y) extrae una imagen de la tarjeta SD. El nombre de archivo que se introduce al llamar al método debe estar ubicado en la tarjeta SD.

Parámetros	Descripción
Nombre del archivo	El nombre del archivo de la imagen.
incógnita	La coordenada x de la esquina superior izquierda de la imagen en la pantalla.
y	La coordenada y de la esquina superior izquierda de la imagen en la pantalla.

Devoluciones: Ninguna.

// Draw the vex.bmp image on the Brain's screen at
// coordinate 0, 0.
Brain.Screen.drawImageFromFile('vex.bmp', 0, 0);

prestar()

La pantalla se puede almacenar en búfer de dos maneras:

El método render() cambia al doble buffering o renderiza el buffer posterior en la pantalla del Brain.

Devuelve: verdadero si el búfer se representó correctamente en la pantalla.

El método render(bSyncWait, bRunScheduler) cambia al almacenamiento en búfer doble o muestra el búfer posterior en la pantalla del Brain, con opciones para esperar la señal Vsync antes de continuar y ejecutar el programador durante el proceso.

Parámetros	Descripción
bSyncEspera	true para hacer que el cerebro espere la señal Vsync antes de permitir que se ejecuten los comandos subsiguientes.
bRunScheduler	true ejecutará tareas en segundo plano mientras espera a que se renderice la pantalla del cerebro. Por defecto, este parámetro es true.

Devuelve: verdadero si el búfer se representó correctamente en la pantalla.

establecerRegiónDeClip()

El método setClipRegion(x, y, width, height) establece la región de recorte para dibujar el rectángulo proporcionado.

Parámetros	Descripción
incógnita	La posición x de la esquina superior izquierda del rectángulo, referenciada al origen de la pantalla.
y	La posición y de la esquina superior izquierda del rectángulo, referenciada al origen de la pantalla.
ancho	El ancho del rectángulo.
altura	La altura del rectángulo.

Devoluciones: Ninguna.