Pantalla

Introducción

The screen class is derived from the brain base class. It controls how the IQ (2nd gen) Brain shows text, numbers, and graphics on its built-in screen.

Por defecto, la fuente para imprimir en el Cerebro es monoespaciada pequeña.

Para dibujar, la resolución del Brain es de 160 x 108 píxeles.

Acceso

The screen class can be accessed by:

Brain.Screen

Notas

• The screen object is provided by the Brain. It is not constructed directly.

• Projects use a single global Brain object, so screen functions are called using Brain.Screen.

Ejemplo

/* This constructor is required when using VS Code.
A Brain is generated automatically at the start of
VEXcode projects. */

// Create the Brain
brain Brain = brain();

// Print text to the Brain screen
Brain.Screen.print("Hello!");

Funciones de los miembros

The screen class includes the following member functions:

• print — Prints formatted text, numbers, or Boolean values to the Brain screen.

• setCursor — Moves the text cursor to a specified row and column.

• newLine — Clears the remainder of the current line and moves the cursor to the next line.

• clearLine — Clears the remainder of the current line or clears a specified line.

• row — Returns the row where text will be printed.

• column — Returns the column where text will be printed.

• getStringHeight — Returns the height of a string in pixels using the current font.

• getStringWidth — Returns the width of a string in pixels using the current font.

• printAt — Prints formatted text at an x, y pixel location (optionally opaque).

• clearScreen — Clears the entire screen (optionally to a specified color).

• setFont — Sets the font used for printing on the screen.

• setPenWidth — Sets the thickness of drawn lines and shape outlines.

• setPenColor — Sets the color of text, pixels, lines, and shape outlines.

• setFillColor — Sets the fill color for drawn shapes and printed text backgrounds.

• setOrigin — Sets the origin used for screen coordinates.

• setClipRegion — Restricts screen output to a rectangular region.

• drawPixel — Draws one pixel at a coordinate.

• drawLine — Draws a line between two points.

• drawRectangle — Draws a rectangle at an x, y location with a specified size.

• drawCircle — Draws a circle at an x, y location with a specified radius.

• drawImageFromFile — Draws an image from an SD card file onto the screen.

• render — Enables double buffering or renders the back buffer to the screen.

• pressing — Returns whether the screen is currently being pressed.

• xPosition — Returns the x-coordinate of the most recent screen press.

• yPosition — Returns the y-coordinate of the most recent screen press.

• pressed — Registers a callback function to run when the screen is pressed.

• released — Registers a callback function to run when the screen is released after being pressed.

Before calling any screen member functions, a brain instance must be created, as shown below:

// Create the Brain
brain Brain = brain();

imprimir

Muestra texto, números o valores booleanos en la pantalla cerebral del IQ (2.ª generación).

Available Functions

1 — Imprime texto formateado usando literales de cadena o cadenas de estilo C de solo lectura.

void print(
    const char* format,
    ... );

2 — Imprime texto formateado utilizando matrices de caracteres modificables.

void print(
    char* format,
    ... );

Parameters

Parámetro	Tipo	Descripción
format	const char*	A format string provided as a string literal or read-only C-style string (for example, “Score: %d”).
format	char*	Una cadena de formato proporcionada como una matriz de caracteres modificable.
…		Uno o más valores adicionales que se insertan en la cadena de formato, separados por comas.

Return Values

Esta función no devuelve ningún valor.

Notes

• La salida comienza en la posición actual del cursor posición en la pantalla.

• El texto impreso utiliza la fuente de pantalla actual .

• El texto impreso utiliza el color de pluma actual .

• Text printed with print is always printed with a background, and the background color is determined by the current fill color.

• Al utilizar una cadena de formato, el número y los tipos de valores pasados ​​deben coincidir con los especificadores de formato en la cadena.

Examples

// Display a message at the starting cursor
Brain.Screen.print("Hello, Robot!");

establecer cursor

Moves the cursor to a specific row and column on the IQ (2nd gen) Brain screen. The next print call will start printing at that location.

Available Functions

void setCursor(
  int32_t row, 
  int32_t col );

Parameters

Parámetro	Tipo	Descripción
row	int32_t	La fila a la que mover el cursor.
col	int32_t	La columna a la que se debe mover el cursor.

Return Values

Esta función no devuelve ningún valor.

Notes

• Affects where subsequent text output begins when using print.

• Las filas y columnas se basan en la fuente de pantalla configurada actualmente.

• The default font (mono20) uses 5 rows and 16 columns.

• Calling setCursor affects the position of subsequent text output only.

Examples

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Repeatedly print the Brain timer at top-left
  while (true) {
    Brain.Screen.print("%d", Brain.Timer.time(seconds));
    Brain.Screen.newLine();
    wait(1, seconds);
    Brain.Screen.clearScreen();
    Brain.Screen.setCursor(1, 1);
  }
}

nueva línea

Mueve el cursor al principio de la siguiente fila en la pantalla del cerebro.

Available Functions

void newLine();

Parameters

Esta función no acepta ningún parámetro.

Return Values

Esta función no devuelve ningún valor.

Notes

• If the cursor is in the middle of a sentence, newLine will clear the rest of the row after the cursor before moving to the next row.

• After calling newLine, the cursor is positioned at the first column of the next line.

• The cursor position and row numbering are set using setCursor.

Examples

// Display two lines of text
Brain.Screen.print("Line 1");
Brain.Screen.newLine();
Brain.Screen.print("Line 2");

Línea clara

Borra el texto de una fila en la pantalla cerebral IQ (2.ª generación).

Available Functions

1 — Borra el resto de la línea actual desde la posición del cursor.

void clearLine();

2 — Borra la fila especificada usando el color de relleno configurado actualmente.

void clearLine(
    int number );

3 — Borra la fila especificada usando un objeto de color predefinido o…/Logic/Custom_color.md.

void clearLine(
    int          number,
    const color& color );

4 — Borra la fila especificada utilizando un valor de color hexadecimal.

void clearLine(
    int         number,
    const char* color );

5 — Borra la fila especificada usando un valor de tono.

void clearLine(
    int number,
    int hue );

Parameters

Parámetro	Tipo	Descripción
number	int	The row number to clear. Row numbering starts at 1.
color	const color&	Clears the row using a color object. Predefined colors include: black white red green blue yellow orange purple cyan transparent This can also use a custom color object.
color	const char*	Clears the row using a hexadecimal color value (for example, “#000000”).
hue	int	Clears the row using an integer hue value in the range 0–359, representing degrees around a color wheel.

Return Values

Esta función no devuelve ningún valor.

Notes

• Borrar una línea no cambia la posición actual del cursor.

• The cursor position and row numbering are set using setCursor.

• The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

Examples

// Display text on two rows
Brain.Screen.print("This text stays");
Brain.Screen.newLine();
Brain.Screen.print("This disappears");

// Wait 3 seconds before clearing row 2
wait(3, seconds);
Brain.Screen.clearLine(2);

fila

Devuelve la fila donde se imprimirá el texto en la pantalla del IQ (2.ª generación).

Available Functions

int32_t row();

Parameters

Esta función no acepta ningún parámetro.

Return Values

Returns an int32_t representing the row where text will be printed.

La numeración de las filas comienza en el 1.

Notes

• La posición del cursor se basa en la fuente de pantalla actual .

• El valor devuelto indica dónde aparecerá la siguiente impresión.

• The row value changes when text is printed or when setCursor is called.

Examples

// Display the cursor's current row
Brain.Screen.setCursor(3, 12);
Brain.Screen.print("row: ", Brain.Screen.row());

columna

Devuelve la columna donde se imprimirá el texto en la pantalla del IQ (2.ª generación).

Available Functions

int32_t column();

Parameters

Esta función no acepta ningún parámetro.

Return Values

Returns an int32_t representing the column where text will be printed.

La numeración de las columnas comienza en 1.

Notes

• La posición del cursor se basa en la fuente de pantalla actual .

• El valor devuelto indica dónde aparecerá la siguiente impresión.

• The column value changes when text is printed or when setCursor is called.

Examples

// Display the cursor's current column
Brain.Screen.print("column: ", Brain.Screen.column());

obtenerCadenaAltura

Devuelve la altura, en píxeles, de una cadena cuando se muestra en la pantalla del procesador IQ (2.ª generación).

Available Functions

int32_t getStringHeight( 
    const char* cstr );

Parameters

Parámetro	Tipo	Descripción
cstr	const char*	The text to be measured, provided as a C-style string (for example, “Hello”).

Return Values

Returns an int32_t representing the height of the string in pixels when rendered on the Brain screen.

Notes

• La altura devuelta depende de la fuente de pantalla seleccionada actualmente .

• Esta función mide la cadena sin dibujarla en la pantalla.

• La altura devuelta refleja cómo se vería la cadena al imprimirse.

obtenerAnchoDeCadena

Devuelve el ancho, en píxeles, de una cadena cuando se muestra en la pantalla del procesador IQ (2.ª generación).

Available Functions

int32_t getStringWidth( 
    const char* cstr );

Parameters

Parámetro	Tipo	Descripción
cstr	const char*	The text to be measured, provided as a C-style string (for example, “Hello”).

Return Values

Returns an int32_t representing the width of the string in pixels when rendered on the Brain screen.

Notes

• El ancho devuelto depende de la fuente de pantalla seleccionada actualmente .

• Esta función mide la cadena sin dibujarla en la pantalla.

• El ancho devuelto refleja cómo se vería la cadena al imprimirse.

imprimirEn

Imprime texto, números o valores booleanos en una coordenada específica de la pantalla cerebral IQ (2.ª generación).

Available Functions

1 — Imprime la salida formateada en la ubicación de píxeles especificada.

void printAt(
    int32_t    x,
    int32_t    y,
    const char* format,
    ... );

2 — Imprime la salida formateada en la ubicación de píxeles especificada y establece si el fondo del texto es opaco o transparente.

void printAt(
    int32_t    x,
    int32_t    y,
    bool       bOpaque,
    const char* format,
    ... );

Parameters

Parámetro	Tipo	Descripción
x	int32_t	La posición x en la que se imprimirá, con respecto al origen de la pantalla.
y	int32_t	La posición Y en la que se imprimirá, con respecto al origen de la pantalla.
bOpaque	bool	Controls whether the printed text is drawn opaquely or transparently: true — The background of the printed text is filled using the current fill color. false — The text is drawn transparently and the background is not filled.
format	const char*	A format string that controls what is printed on the screen (for example, “Score: %d”).
…		Uno o más valores adicionales que se insertan en la cadena de formato, separados por comas.

Return Values

Esta función no devuelve ningún valor.

Notes

• The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.

• El texto impreso utiliza la fuente de pantalla actual .

• El texto impreso utiliza el color de pluma actual .

• Al utilizar una cadena de formato, el número y los tipos de valores pasados ​​deben coincidir con los especificadores de formato en la cadena.

Examples

// Print the number 1 at pixel (100, 40)
Brain.Screen.printAt(100, 40, 1);

pantalla clara

Borra todos los dibujos y textos de la pantalla del Cerebro.

Available Functions

1 — Borra la pantalla y la deja en negro.

void clearScreen();

2 — Borra la pantalla usando un objeto de color predefinido o color personalizado.

void clearScreen(
    const color& color );

3 — Borra la pantalla usando un valor de color hexadecimal.

void clearScreen(
    const char* color );

4 — Borra la pantalla usando un valor de tono.

void clearScreen(
    int hue );

Parameters

Parámetro	Tipo	Descripción
color	const color&	Clears the screen using a color object. Predefined colors include: black white red green blue yellow orange purple cyan transparent This can also use a custom color object.
color	const char	Clears the screen using a hexadecimal color value represented as a string (for example, “#000000”).
hue	int	Clears the screen using an integer hue value in the range 0–359, representing degrees around a color wheel.

Return Values

Esta función no devuelve ningún valor.

Notes

• The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

Examples

// Clear screen after 2 seconds
Brain.Screen.print("VEXcode");
wait(2, seconds);
Brain.Screen.clearScreen();

---

// Clear screen to blue after 2 seconds
Brain.Screen.print("VEXcode");
wait(2, seconds);
Brain.Screen.clearScreen(red);

establecerFuente

Establece la fuente utilizada para el texto que se muestra en la pantalla del cerebro IQ (2.ª generación).

This controls the font applied to subsequent text output when using screen text functions such as print.

Available Functions

void setFont(
  fontType font );

Parameters

Parámetro	Tipo	Descripción
font	fontType	Sets the font to one of the following: mono12 mono15 mono20 mono30 mono40 mono60 prop20 prop30 prop40 prop60 These options are shown below.

mono12	mono15	mono20
mono30	mono40	mono60
prop20	prop30	prop40
prop60

Return Values

Esta función no devuelve ningún valor.

Examples

// Display two different fonts on
// two separate lines
Brain.Screen.setFont(mono20);
Brain.Screen.print("Mono Medium");
Brain.Screen.newLine();
Brain.Screen.setFont(prop20);
Brain.Screen.print("Prop Medium");

establecerAnchoDelPluma

Establece el grosor de las líneas dibujadas y los contornos de las formas.

Available Functions

void setPenWidth(
  uint32_t width );

Parameters

Parámetro	Tipo	Descripción
width	uint32_t	El ancho del lápiz, en píxeles, va de 0 a 32.

Return Values

Esta función no devuelve ningún valor.

Notes

• The pen width applies to drawing functions such as drawLine, drawRectangle, and drawCircle.

Examples

// Draw a circle with a pen width of 5
Brain.Screen.drawCircle(40, 70, 20);
Brain.Screen.setPenWidth(5);
Brain.Screen.drawCircle(100, 70, 20);

color del bolígrafo

Establece el color del texto, los píxeles, las líneas y los contornos de las formas.

Available Functions

1 — Establece el color del lápiz usando un objeto predefinido o color personalizado.

void setPenColor(
    const color& color );

2 — Establece el color del lápiz usando un valor de color hexadecimal.

void setPenColor(
    const char* color );

3 — Establece el color del lápiz usando un valor de tono.

void setPenColor(
    int hue );

Parameters

Parámetro	Tipo	Descripción
color	const color&	Sets the pen color using a color object. Predefined colors include: black white red green blue yellow orange purple cyan transparent
color	const char*	Sets the pen color using a hexadecimal color value represented as a string (for example, “#FF0000”).
hue	int	Sets the pen color using an integer hue value in the range 0–359, representing degrees around a color wheel (for example, 0 is red, 120 is green, and 240 is blue).

Return Values

Esta función no devuelve ningún valor.

Notes

• The default pen color at the start of a project is white.

• The pen color is used for outlines of shapes (such as with drawCircle or drawRectangle), text and numeric output (with print and printAt), and individual pixels drawn with drawPixel.

• The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

Examples

Brain.Screen.drawRectangle(100, 50, 10, 20);
Brain.Screen.setPenColor(blue);
Brain.Screen.drawRectangle(50, 50, 10, 20);

establecerColorDeRelleno

Establece el color de relleno que se utiliza al dibujar las formas.

Available Functions

1 — Establece el color de relleno usando un objeto predefinido o color personalizado.

void setFillColor(
    const color& color );

2 — Establece el color de relleno utilizando un valor de color hexadecimal.

void setFillColor(
    const char* color );

3 — Establece el color de relleno usando un valor de tono.

void setFillColor(
    int hue );

Parameters

Parámetro	Tipo	Descripción
color	const color&	Sets the fill color using a color object. Predefined colors include: black white red green blue yellow orange purple cyan transparent
color	const char	Sets the fill color using a hexadecimal color value represented as a string (for example, “#00FF00”).
hue	int	Sets the fill color using an integer hue value in the range 0–359, representing degrees around a color wheel (for example, 0 is red, 120 is green, and 240 is blue).

Return Values

Esta función no devuelve ningún valor.

Notes

• The default fill color at the start of a project is black.

• The fill color is used for interior of shapes (such as with drawCircle or drawRectangle).

• The fill color is used as the background color for printed text (such as with print and printAt).

  • If transparent is used with printed text, the background will be black.

• The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

Examples

// Draw a circle filled with yellow
Brain.Screen.setFillColor(yellow);
Brain.Screen.drawCircle(50, 50, 20);

establecerOrigen

Establece el origen utilizado para el dibujo y la impresión basada en coordenadas en la pantalla del sistema Brain.

Available Functions

void setOrigin(
  int32_t x,
  int32_t y );

Parameters

Parámetro	Tipo	Descripción
x	int32_t	La posición x del origen en relación con la esquina superior izquierda de la pantalla del Cerebro, de 0 a 159.
y	int32_t	La posición en el eje y del origen con respecto a la esquina superior izquierda de la pantalla del cerebro, de 0 a 107.

Return Values

Esta función no devuelve ningún valor.

Notes

• El origen predeterminado es la esquina superior izquierda de la pantalla en la coordenada (0, 0).

• The origin applies to coordinate functions such as drawLine, drawRectangle, drawCircle, and printAt.

• El origen permanece vigente hasta que se modifique de nuevo o se reinicie el proyecto.

establecerRegiónDeRecorte

Define un área rectangular en la pantalla donde se mostrarán todos los dibujos y el texto. Cualquier contenido fuera de esta región no se mostrará.

Available Functions

void setClipRegion(
  int x,
  int y,
  int width,
  int height );

Parameters

Parámetro	Tipo	Descripción
x	int	La coordenada x de la esquina superior izquierda de la región de recorte, dada como un número entero entre 0 y 159.
y	int	La coordenada y de la esquina superior izquierda de la región de recorte, dada como un número entero de 0 a 107.
width	int	El ancho de la región de recorte en píxeles, expresado como un número entero entre 0 y 159.
height	int	La altura de la región de recorte en píxeles, expresada como un número entero entre 0 y 107.

Return Values

Esta función no devuelve ningún valor.

Notes

• Las funciones de dibujo se siguen ejecutando aunque queden fuera de la región de recorte, pero solo se ve la parte que está dentro de dicha región.

• The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.

• La región de recorte se aplica únicamente al hilo actual.

• Al establecer una nueva región de recorte, se reemplaza cualquier región de recorte establecida previamente para el hilo actual.

Examples

// Restrict text and drawings to a specific region
Brain.Screen.setClipRegion(0, 0, 120, 120);
Brain.Screen.drawRectangle(60, 60, 100, 100, red);
Brain.Screen.printAt(60, 60, "Cut off!");

dibujarPíxel

Dibuja un píxel en la pantalla del cerebro IQ (2.ª generación) en la ubicación de píxeles x e y seleccionada.

Available Functions

void drawPixel(
  int x,
  int y );

Parameters

Parámetro	Tipo	Descripción
x	int	La coordenada x donde se dibujará el píxel, dada como un número entero del 0 al 159.
y	int	La coordenada y donde se dibujará el píxel, dada como un número entero del 0 al 107.

Return Values

Esta función no devuelve ningún valor.

Notes

• Pixels are drawn using the current pen color set with setPenColor.

• The x and y coordinates are relative to the current screen origin, which can be set using setOrigin.

• Si la ubicación del píxel especificada está fuera de los límites de la pantalla, el píxel no se dibuja.

Examples

// Draw one pixel at the center 
// of the screen
Brain.Screen.drawPixel(80, 50);

dibujarLínea

Dibuja una línea recta que conecta dos puntos en la pantalla cerebral de IQ (2.ª generación).

Available Functions

void drawLine(
  int x1,
  int y1,
  int x2,
  int y2 );

Parameters

Parámetro	Tipo	Descripción
x1	int	La coordenada x inicial de la línea, dada como un número entero entre 0 y 159.
y1	int	La coordenada y inicial de la línea, dada como un número entero entre 0 y 107.
x2	int	La coordenada x final de la línea, dada como un número entero entre 0 y 159.
y2	int	La coordenada y final de la línea, dada como un número entero entre 0 y 107.

Return Values

Esta función no devuelve ningún valor.

Notes

• Lines are drawn using the current pen color set with setPenColor.

• The width of the line is determined by the current pen width set with setPenWidth.

• The x and y coordinates are relative to the current screen origin, which can be set using setOrigin.

• Si alguna parte de la línea queda fuera de los límites de la pantalla, solo se dibuja la parte visible.

Examples

// Draw a line from the top left to 
// bottom right of the screen
Brain.Screen.drawLine(0, 0, 159, 107);

dibujarRectángulo

Dibuja un rectángulo en la pantalla del IQ (2.ª generación) Brain en la posición y el tamaño especificados.

Available Functions

1 — Dibuja y rellena un rectángulo usando el color de relleno configurado actualmente.

void drawRectangle(
    int x,
    int y,
    int width,
    int height );

2 — Dibuja y rellena un rectángulo usando un objeto de color predefinido o color personalizado.

void drawRectangle(
    int           x,
    int           y,
    int           width,
    int           height,
    const color&  color );

3 — Dibuja y rellena un rectángulo utilizando un valor de color hexadecimal.

void drawRectangle(
    int           x,
    int           y,
    int           width,
    int           height,
    const char*   color );

4 — Dibuja y rellena un rectángulo usando un valor de tono.

void drawRectangle(
    int x,
    int y,
    int width,
    int height,
    int hue );

Parameters

Parámetro	Tipo	Descripción
x	int	La coordenada x de la esquina superior izquierda del rectángulo, dada como un número entero entre 0 y 159.
y	int	La coordenada y de la esquina superior izquierda del rectángulo, dada como un número entero entre 0 y 107.
width	int	El ancho del rectángulo, dado como un número entero de 0 a 159.
height	int	La altura del rectángulo, dada como un número entero de 0 a 107.
color	const color&	Fills the rectangle using a color object. Predefined colors include: black white red green blue yellow orange purple cyan transparent This can also use a custom color object.
color	const char*	Fills the rectangle using a hexadecimal color value (for example, “#FF0000”).
hue	int	Fills the rectangle using a hue value in the range 0–359.

Return Values

Esta función no devuelve ningún valor.

Notes

• The rectangle outline is drawn using the current pen color set with setPenColor.

• The outline thickness is determined by the current pen width set with setPenWidth.

• When no color parameter is provided, the rectangle interior is filled using the current fill color set with setFillColor.

• The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.

• Si alguna parte del rectángulo queda fuera de los límites de la pantalla, solo se dibujará la parte visible.

• The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

Examples

// Draw a red rectangle on the screen
Brain.Screen.drawRectangle(25, 25, 100, 50, red);

dibujarCírculo

Dibuja un círculo en la pantalla del sensor IQ (2.ª generación) en la posición y el radio especificados.

Available Functions

1 — Dibuja y rellena un círculo usando el color de relleno configurado actualmente.

void drawCircle(
    int x,
    int y,
    int radius );

2 — Dibuja y rellena un círculo usando un objeto de color predefinido o color personalizado.

void drawCircle(
    int           x,
    int           y,
    int           radius,
    const color&  color );

3 — Dibuja y rellena un círculo utilizando un valor de color hexadecimal.

void drawCircle(
    int           x,
    int           y,
    int           radius,
    const char*   color );

4 — Dibuja y rellena un círculo usando un valor de tono.

void drawCircle(
    int x,
    int y,
    int radius,
    int hue );

Parameters

Parámetro	Tipo	Descripción
x	int	La coordenada x del centro del círculo, dada como un número entero entre 0 y 159.
y	int	La coordenada y del centro del círculo, dada como un número entero entre 0 y 107.
radius	int	El radio del círculo, expresado como un número entero entre 0 y 107 píxeles.
color	const color&	Fills the circle using a color object. Predefined colors include: black white red green blue yellow orange purple cyan transparent This can also use a custom color object.
color	const char*	Fills the circle using a hexadecimal color value (for example, “#FF0000”).
hue	int	Fills the circle using a hue value in the range 0–359.

Return Values

Esta función no devuelve ningún valor.

Notes

• The circle outline is drawn using the current pen color set with setPenColor.

• The outline thickness is determined by the current pen width set with setPenWidth.

• When no color parameter is provided, the circle interior is filled using the current fill color set with setFillColor.

• The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.

• The hue parameter value is based on a circular color wheel, as shown below, where values represent degrees around the wheel (for example, red near 0°, green near 120°, and blue near 240°).

Examples

// Draw a green circle on the screen
Brain.Screen.drawCircle(80, 50, 20, green);

dibujarImagenDesdeArchivo

Dibuja una imagen en la pantalla del cerebro IQ (2.ª generación) utilizando un archivo de imagen almacenado en la tarjeta SD.

Available Functions

bool drawImageFromFile(
  const char* name,
  int x,
  int y );

Parameters

Parámetro	Tipo	Descripción
name	const char*	The filename of the image on the SD card. The file must have a .bmp or .png extension.
x	int	La coordenada x, en píxeles de 0 a 159, en la que se dibujará el borde izquierdo de la imagen.
y	int	La coordenada y, en píxeles de 0 a 107, en la que se dibujará el borde superior de la imagen.

Return Values

Returns a Boolean indicating whether the image was successfully drawn:

• true — The image was successfully loaded and drawn on the screen.
• false — The image could not be drawn (for example, if the file does not exist or is invalid).

Notes

• Supported image formats are .bmp and .png.

• The image file size must not exceed 512 KB.

  • Se recomienda la codificación RLE de 8 bits para minimizar el tamaño del archivo.

• Las dimensiones máximas de imagen admitidas son las del tamaño de la pantalla del dispositivo (160 x 108 píxeles).

• The x and y coordinates are relative to the current screen origin, which can be changed using setOrigin.

Examples

// Draw a bmp file on the Brain's screen at coordinate 0, 0
Brain.Screen.drawImageFromFile("test_image.bmp", 0, 0);

prestar

Enables double buffering for the Brain’s screen. Once called, any drawing functions (like text, shapes, or images) will no longer appear immediately for the rest of the project. Instead, updates will only be shown when render is used again. This allows for smoother and more controlled screen updates, but means nothing will be visible until render is used.

Available Functions

1 — Habilita el doble búfer o renderiza el búfer de respaldo en la pantalla.

bool render();

2 — Renderiza el búfer de fondo en la pantalla con control sobre el comportamiento de sincronización vertical y ejecución del programador opcional.

bool render(
    bool bVsyncWait,
    bool bRunScheduler = true );

Parameters

Parámetro	Tipo	Descripción
bVsyncWait	bool	true — Wait for the screen’s vertical refresh before rendering to reduce visual tearing. false — Do not wait for the screen’s vertical refresh before rendering.
bRunScheduler	bool	Optional. true (default) — Allow background tasks to run while waiting to render. false — Do not allow background tasks to run while waiting to render.

Return Values

Returns a Boolean indicating whether the saved drawings in the buffer were successfully rendered to the screen:

• true — The drawings were successfully rendered on the screen.
• false — The drawings could not be rendered on the screen.
Notes

• Calling render will require render to be used for the rest of the project.

Examples

Brain.Screen.render();

// Draw text to the back buffer
Brain.Screen.print("Render later...");

// Wait for a screen press to render drawings
while (!Brain.Screen.pressing()) {
  wait(20, msec);
}
Brain.Screen.render();