Ekrāns

Ievads

Klase screen ir atvasināta no bāzes klases brain. Tā kontrolē, kā V5 Brain skārienekrānā rāda tekstu, skaitļus un grafiku un kā tas reaģē uz skārienvadi.

Pēc noklusējuma fonts drukāšanai uz Brain ir vienas atstarpes mazs, kam ir 12 rindas un 48 kolonnas.

Zīmēšanai smadzeņu izšķirtspēja ir 480 x 240 pikseļi.

Piekļuve

screen klasei var piekļūt, izmantojot:

Brain.Screen

Piezīmes

• screen objektu nodrošina smadzenes. Tas netiek tieši konstruēts.

• Projekti izmanto vienu globālu Brain objektu, tāpēc ekrāna funkcijas tiek izsauktas, izmantojot Brain.Screen.

Piemērs

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

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

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

Dalībnieku funkcijas

screen klasē ir iekļautas šādas dalībfunkcijas:

• print — Izdrukā formatētu tekstu, skaitļus vai Būla vērtības Brain ekrānā.

• setCursor — Pārvieto teksta kursoru uz norādīto rindu un kolonnu.

• newLine — Notīra atlikušo pašreizējās rindas daļu un pārvieto kursoru uz nākamo rindu.

• clearLine — Notīra atlikušo pašreizējās rindas daļu vai notīra norādīto rindu.

• row rinda — Atgriež rindu, kurā tiks drukāts teksts.

• column — Atgriež kolonnu, kurā tiks drukāts teksts.

• getStringHeight — Atgriež virknes augstumu pikseļos, izmantojot pašreizējo fontu.

• getStringWidth — Atgriež virknes platumu pikseļos, izmantojot pašreizējo fontu.

• printAt — Izdrukā formatētu tekstu x un y pikseļu atrašanās vietā.

• clearScreen — Notīra visus zīmējumus un tekstu no Brain ekrāna.

• setFont — Iestata fontu, kas tiek izmantots drukāšanai uz ekrāna.

• setPenWidth — Iestata zīmēto līniju un formu kontūru biezumu.

• setPenColor — Iestata teksta, pikseļu, līniju un formu kontūru krāsu.

• setFillColor — Iestata aizpildījuma krāsu zīmētām formām un drukāta teksta foniem.

• setOrigin — Iestata ekrāna koordinātu sākumpunktu.

• setClipRegion — Ierobežo ekrāna izvadi taisnstūrveida apgabalā.

• drawPixel — Uzzīmē vienu pikseli koordinātā.

• drawLine — Novelk līniju starp diviem punktiem.

• drawRectangle — Uzzīmē taisnstūri x un y koordinātēs ar norādīto izmēru.

• drawCircle — Uzzīmē apli x un y koordinātēs ar norādītu rādiusu.

• drawImageFromFile — Uzzīmē attēlu no SD kartes faila ekrānā.

• render — Iespējo dubulto buferizāciju vai renderē aizmugurējo buferi ekrānā.

• pressing — Atgriež, vai ekrāns pašlaik tiek nospiests.

• xPosition — Atgriež pēdējās ekrāna nospiešanas x koordinātu.

• yPosition — Atgriež pēdējās ekrāna nospiešanas y koordinātu.

• pressed — Reģistrē atzvanīšanas funkciju, kas tiks palaista, nospiežot ekrānu.

• released — Reģistrē atzvanīšanas funkciju, kas tiek palaista, kad ekrāns tiek atlaists pēc nospiešanas.

Pirms jebkuru screen dalībfunkciju izsaukšanas ir jāizveido brain instance, kā parādīts zemāk:

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

print

V5 Brain ekrānā parāda tekstu, skaitļus vai Būla vērtības.

Available Functions

1 — Izdrukā formatētu tekstu, izmantojot virkņu literāļus vai tikai lasāmas C stila virknes.

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

2 — Izdrukā formatētu tekstu, izmantojot modificējamus rakstzīmju masīvus.

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

Parameters

Parametrs	Tips	Apraksts
format	const char*	Formāta virkne, kas norādīta kā virknes literālis vai tikai lasāma C stila virkne (piemēram, “Score: %d”).
format	char*	Formāta virkne, kas norādīta kā modificējams rakstzīmju masīvs.
…		Viena vai vairākas papildu vērtības, kas tiek ievietotas formāta virknē, atdalītas ar komatiem.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Izvade sākas no pašreizējās kursora pozīcijas ekrānā.

• Drukātajam tekstam tiek izmantots pašreizējais ekrāna fonts

• Drukātajam tekstam tiek izmantota pašreizējā pildspalvas krāsa .

• Teksts, kas tiek drukāts ar print vienmēr tiek drukāts ar fonu, un fona krāsu nosaka aizpildījuma krāsa.

• Izmantojot formāta virkni, nodoto vērtību skaitam un tipiem ir jāatbilst virknes formāta specifikatoriem.

Examples

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

setCursor

Pārvieto kursoru uz noteiktu rindu un kolonnu V5 Brain ekrānā. Nākamais print izsaukums sāks drukāšanu šajā vietā.

Available Functions

void setCursor(
  int32_t row, 
  int32_t col );

Parameters

Parametrs	Tips	Apraksts
row	int32_t	Rinda, uz kuru jāpārvieto kursors.
col	int32_t	Kolonna, uz kuru jāpārvieto kursors.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Ietekmē, kur sākas turpmākā teksta izvade, izmantojot print.

• Rindas un kolonnas ir balstītas uz pašreiz iestatīto ekrāna fontu.

• Noklusējuma fonts (mono20) izmanto 12 rindas un 48 kolonnas.

• Izsaucot setCursor , tiek ietekmēta tikai nākamā teksta izvades pozīcija.

Examples

// Display text starting at Row 3 Column 12
Brain.Screen.setCursor(3, 12);
Brain.Screen.print("Row 3, Column 12");

newLine

Pārvieto kursoru uz nākamās rindas sākumu Brain ekrānā.

Available Functions

void newLine();

Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Ja kursors atrodas teikuma vidū, newLine notīrīs pārējo rindu aiz kursora, pirms pāriet uz nākamo rindu.

• Pēc newLineizsaukšanas kursors tiek novietots nākamās rindas pirmajā kolonnā.

• Kursora pozīcija un rindu numerācija tiek iestatīta, izmantojot setCursor.

Examples

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

clearLine

Notīra tekstu no rindas V5 Brain ekrānā.

Available Functions

1 — Notīra atlikušo pašreizējās rindas daļu no kursora pozīcijas.

void clearLine();

2 — Notīra norādīto rindu, izmantojot pašlaik konfigurēto aizpildījuma krāsu.

void clearLine(
    int number );

3 — Notīra norādīto rindu, izmantojot iepriekš definētu vai pielāgotas krāsas objektu.

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

4 — Notīra norādīto rindu, izmantojot heksadecimālu krāsas vērtību.

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

5 — Notīra norādīto rindu, izmantojot nokrāsas vērtību.

void clearLine(
    int number,
    int hue );

Parameters

Parametrs	Tips	Apraksts
number	int	Notīrāmā rindas numurs. Rindu numerācija sākas ar 1.
color	const color&	Notīra rindu, izmantojot color objektu. Iepriekš definētās krāsas ietver: black white red green blue yellow orange purple cyan transparent Šeit var izmantot arī pielāgotas krāsas objektu.
color	const char*	Notīra rindu, izmantojot heksadecimālu krāsas vērtību (piemēram, “#000000”).
hue	int	Notīra rindu, izmantojot vesela skaitļa nokrāsas vērtību diapazonā 0līdz359, kas attēlo grādus ap krāsu apli.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Rindas notīrīšana nemaina pašreizējo kursora pozīciju.

• Kursora pozīcija un rindu numerācija tiek iestatīta, izmantojot 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);

row

Atgriež rindu, kurā teksts tiks drukāts V5 Brain ekrānā.

Available Functions

int32_t row();

Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež int32_t , kas apzīmē rindu, kurā tiks drukāts teksts.

Rindu numerācija sākas ar 1.

Notes

• Kursora pozīcija ir balstīta uz pašreizējo ekrāna fontu .

• Atgrieztā vērtība norāda, kur parādīsies nākamā izdrukātā izvade.

• Rindas vērtība mainās, kad tiek drukāts teksts vai kad tiek izsaukta setCursor.

Examples

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

column

Atgriež kolonnu, kurā teksts tiks drukāts V5 Brain ekrānā.

Available Functions

int32_t column();

Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež int32_t , kas apzīmē kolonnu, kurā tiks drukāts teksts.

Kolonnu numerācija sākas ar 1.

Notes

• Kursora pozīcija ir balstīta uz pašreizējo ekrāna fontu .

• Atgrieztā vērtība norāda, kur parādīsies nākamā izdrukātā izvade.

• Kolonnas vērtība mainās, kad tiek drukāts teksts vai kad tiek izsaukta setCursor.

Examples

// Display the cursor's current column
Brain.Screen.setCursor(5, 15);
Brain.Screen.print(Brain.Screen.column());

getStringHeight

Atgriež virknes augstumu pikseļos, kad tā tiek atveidota V5 Brain ekrānā.

Available Functions

int32_t getStringHeight( 
    const char* cstr );

Parameters

Parametrs	Tips	Apraksts
cstr	const char*	Mērāmais teksts, kas norādīts kā C stila virkne (piemēram, “Hello”).

Return Values

Atgriež int32_t kas apzīmē virknes augstumu pikseļos, kad tā tiek atveidota Brain ekrānā.

Notes

• Atgrieztais augstums ir atkarīgs no pašlaik atlasītā ekrāna fonta

• Šī funkcija mēra virkni, to nezīmējot ekrānā.

• Atgrieztais augstums atspoguļo, kā virkne izskatītos izdrukāta.

getStringWidth

Atgriež virknes platumu pikseļos, kad tā tiek atveidota V5 Brain ekrānā.

Available Functions

int32_t getStringWidth( 
    const char* cstr );

Parameters

Parametrs	Tips	Apraksts
cstr	const char*	Mērāmais teksts, kas norādīts kā C stila virkne (piemēram, “Hello”).

Return Values

Atgriež int32_t kas attēlo virknes platumu pikseļos, kad tā tiek atveidota Brain ekrānā.

Notes

• Atgrieztais platums ir atkarīgs no pašlaik atlasītā ekrāna

• Šī funkcija mēra virkni, to nezīmējot ekrānā.

• Atgrieztais platums atspoguļo, kā virkne izskatītos, kad tā tiktu izdrukāta.

printAt

Izdrukā tekstu, skaitļus vai Būla vērtības noteiktā koordinātā V5 Brain ekrānā.

Available Functions

1 — Izdrukā formatētu izvadi norādītajā pikseļa vietā.

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

2 — Izdrukā formatētu izvadi norādītajā pikseļa vietā un iestata, vai teksta fons ir necaurspīdīgs vai caurspīdīgs.

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

Parameters

Parametrs	Tips	Apraksts
x	int32_t	X-pozīcija, kurā jādrukā, atsaucoties uz ekrāna sākumpunktu.
y	int32_t	Y pozīcija, kurā jādrukā, atsaucoties uz ekrāna sākumpunktu.
bOpaque	bool	Nosaka, vai drukātais teksts tiek zīmēts necaurspīdīgi vai caurspīdīgi: true — Drukātā teksta fons tiek aizpildīts, izmantojot pašreizējo aizpildījuma krāsu. false — Teksts tiek zīmēts caurspīdīgi, un fons netiek aizpildīts.
format	const char*	Formāta virkne, kas kontrolē ekrānā drukājamo informāciju (piemēram, “Score: %d”).
…		Viena vai vairākas papildu vērtības, kas tiek ievietotas formāta virknē, atdalītas ar komatiem.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• x un y koordinātas ir relatīvas attiecībā pret pašreizējo ekrāna sākumpunktu, ko var mainīt, izmantojot setOrigin.

• Drukātajam tekstam tiek izmantots pašreizējais ekrāna fonts

• Drukātajam tekstam tiek izmantota pašreizējā pildspalvas krāsa .

• Izmantojot formāta virkni, nodoto vērtību skaitam un tipiem ir jāatbilst virknes formāta specifikatoriem.

Examples

// Print "Center" at the center of the screen
Brain.Screen.printAt(220, 120, "Center");

clearScreen

Izdzēš visus zīmējumus un tekstu no Brain ekrāna un atiestata kursora pozīciju uz 1. rindas 1. kolonnu.

Available Functions

1 — Padara ekrānu melnu.

void clearScreen();

2 — Notīra ekrānu, izmantojot iepriekš definētu vai pielāgotas krāsas objektu.

void clearScreen(
    const color& color );

3 — Notīra ekrānu, izmantojot heksadecimālu krāsas vērtību.

void clearScreen(
    const char* color );

4 — Notīra ekrānu, izmantojot nokrāsas vērtību.

void clearScreen(
    int hue );

Parameters

Parametrs	Tips	Apraksts
color	const color&	Notīra ekrānu, izmantojot color objektu. Iepriekš definētās krāsas ietver: black white red green blue yellow orange purple cyan transparent Šeit var izmantot arī pielāgotas krāsas objektu.
color	const char*	Notīra ekrānu, izmantojot heksadecimālu krāsas vērtību, kas attēlota kā virkne (piemēram, “#000000”).
hue	int	Notīra ekrānu, izmantojot vesela skaitļa nokrāsas vērtību diapazonā 0līdz359, kas attēlo grādus ap krāsu apli.

Return Values

Šī funkcija neatgriež vērtību.

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(blue);

setFont

Iestata fontu, kas tiek izmantots tekstam, kas tiek rādīts V5 Brain ekrānā.

Tas kontrolē fontu, kas tiek lietots turpmākajai teksta izvadei, izmantojot ekrāna teksta funkcijas, piemēram, print.

Available Functions

void setFont(
  fontType font );

Parameters

Parametrs	Tips	Apraksts
font	fontType	Iestata fontu uz vienu no šiem: mono12 mono15 mono20 mono30 mono40 mono60 prop20 prop30 prop30 prop40 prop60prop60 fontType::cjk16 — Var drukāt ķīniešu, japāņu un korejiešu rakstzīmes. Vienkāršotā ķīniešu valoda — Var redzēt līdz 28. kolonnai. Tradicionālā ķīniešu valoda — Var redzēt līdz 28. kolonnai. Japāņu valoda (kandži) — Var redzēt līdz 28. kolonnai. Korejiešu valoda (hangul) — Var redzēt līdz 30. kolonnai. Šīs opcijas ir parādītas tālāk.

mono12	mono15	mono20
mono30	mono40	mono60
prop20	prop30	prop40
prop60	fontType::cjk16

Return Values

Šī funkcija neatgriež vērtību.

Examples

// Print larger text
Brain.Screen.setFont(mono40);
Brain.Screen.print("VEX");

---

// Print in Chinese
Brain.Screen.setFont(fontType::cjk16);
Brain.Screen.print("VEX机器人");

setPenWidth

Nosaka zīmēto līniju un formu kontūru biezumu.

Available Functions

void setPenWidth(
  uint32_t width );

Parameters

Parametrs	Tips	Apraksts
width	uint32_t	Pildspalvas platums pikseļos no 0 līdz 32.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Pildspalvas platums attiecas uz zīmēšanas funkcijām, piemēram, drawLine, drawRectangle un drawCircle.

Examples

// Draw a rectangle with a pen width of 10
Brain.Screen.setPenWidth(10);
Brain.Screen.drawRectangle(50, 50, 130, 60);

setPenColor

Iestata teksta, pikseļu, līniju un formu kontūru krāsu.

Available Functions

1 — Iestata pildspalvas krāsu, izmantojot iepriekš definētu vai pielāgotas krāsas objektu.

void setPenColor(
    const color& color );

2 — Iestata pildspalvas krāsu, izmantojot heksadecimālu krāsas vērtību.

void setPenColor(
    const char* color );

3 — Iestata pildspalvas krāsu, izmantojot nokrāsas vērtību.

void setPenColor(
    int hue );

Parameters

Parametrs	Tips	Apraksts
color	const color&	Iestata pildspalvas krāsu, izmantojot color objektu. Iepriekš definētās krāsas ietver: black white red green blue yellow orange purple cyan transparent
color	const char*	Iestata pildspalvas krāsu, izmantojot heksadecimālu krāsas vērtību, kas attēlota kā virkne (piemēram, “#FF0000”).
hue	int	Iestata pildspalvas krāsu, izmantojot vesela skaitļa nokrāsas vērtību diapazonā 0līdz359, kas attēlo grādus ap krāsu apli (piemēram, 0 ir sarkana, 120 ir zaļa un 240 ir zila).

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Noklusējuma pildspalvas krāsa projekta sākumā ir 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

// Draw a rectangle with orange borders
Brain.Screen.setPenColor(orange);
Brain.Screen.drawRectangle(50, 50, 130, 60);

setFillColor

Iestata aizpildījuma krāsu, kas tiek izmantota, zīmējot formas.

Available Functions

1 — Iestata aizpildījuma krāsu, izmantojot iepriekš definētu vai pielāgotas krāsas objektu.

void setFillColor(
    const color& color );

2 — Iestata aizpildījuma krāsu, izmantojot heksadecimālu krāsas vērtību.

void setFillColor(
    const char* color );

3 — Iestata aizpildījuma krāsu, izmantojot nokrāsas vērtību.

void setFillColor(
    int hue );

Parameters

Parametrs	Tips	Apraksts
color	const color&	Iestata aizpildījuma krāsu, izmantojot color objektu. Iepriekš definētās krāsas ietver: black white red green blue yellow orange purple cyan transparent
color	const char*	Iestata aizpildījuma krāsu, izmantojot heksadecimālu krāsas vērtību, kas attēlota kā virkne (piemēram, “#00FF00”).
hue	int	Iestata aizpildījuma krāsu, izmantojot vesela skaitļa nokrāsas vērtību diapazonā 0līdz359, kas attēlo grādus ap krāsu apli (piemēram, 0 ir sarkana, 120 ir zaļa un 240 ir zila).

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Noklusējuma aizpildījuma krāsa projekta sākumā ir black.

• Aizpildījuma krāsa tiek izmantota formu iekšpusē (piemēram, ar drawCircle vai drawRectangle).

• Aizpildījuma krāsa tiek izmantota kā fona krāsa drukātam tekstam (piemēram, ar print un printAt).

  • Ja drukātam tekstam tiek izmantota vērtība transparent , fons būs melns 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 rectangle filled with purple
  Brain.Screen.setFillColor(purple);
  Brain.Screen.drawRectangle(50, 100, 130, 60);

setOrigin

Iestata sākuma punktu, kas tiek izmantots zīmēšanai un uz koordinātām balstītai drukāšanai Brain ekrānā.

Available Functions

void setOrigin(
  int32_t x,
  int32_t y );

Parameters

Parametrs	Tips	Apraksts
x	int32_t	Sākotnes x pozīcija attiecībā pret Brain ekrāna augšējo kreiso stūri no 0 līdz 479.
y	int32_t	Sākotnes y pozīcija attiecībā pret smadzeņu ekrāna augšējo kreiso stūri no 0 līdz 239.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Noklusējuma sākumpunkts ir ekrāna augšējais kreisais stūris koordinātēs (0, 0).

• Izcelsmes punkts attiecas uz koordinātu funkcijām, piemēram, drawLine, drawRectangle, drawCircle un printAt.

• Izcelsmes punkts paliek spēkā, līdz tas tiek mainīts vēlreiz vai projekts tiek atiestatīts.

setClipRegion

Nosaka taisnstūrveida apgabalu ekrānā, kurā tiks ievietoti visi zīmējumi un teksts. Jebkāds saturs ārpus šī apgabala netiks parādīts.

Available Functions

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

Parameters

Parametrs	Tips	Apraksts
x	int	Klipa apgabala augšējā kreisā stūra x koordināta, kas norādīta kā vesels skaitlis no 0 līdz 479.
y	int	Saspraudes apgabala augšējā kreisā stūra y koordināta, kas norādīta kā vesels skaitlis no 0 līdz 239.
width	int	Klipa apgabala platums pikseļos, kas norādīts kā vesels skaitlis no 0 līdz 479.
height	int	Klipa apgabala augstums pikseļos, kas norādīts kā vesels skaitlis no 0 līdz 239.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Zīmēšanas funkcijas joprojām tiek izpildītas pat tad, ja tās atrodas ārpus klipa apgabala, bet redzama ir tikai apgabala iekšpusē esošā daļa.

• x un y koordinātas ir relatīvas attiecībā pret pašreizējo ekrāna sākumpunktu, ko var mainīt, izmantojot setOrigin.

• Klipa reģions attiecas tikai uz pašreizējo pavedienu.

• Jauna klipa apgabala iestatīšana aizstāj jebkuru iepriekš iestatītu klipa apgabalu pašreizējai pavedienam.

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!");

drawPixel

Uzzīmē vienu pikseli V5 Brain ekrānā atlasītajā x un y pikseļu atrašanās vietā.

Available Functions

void drawPixel(
  int x,
  int y );

Parameters

Parametrs	Tips	Apraksts
x	int	X koordināta, kur tiks zīmēts pikselis, norādīta kā vesels skaitlis no 0 līdz 479.
y	int	Y koordināta, kur tiks zīmēts pikselis, norādīta kā vesels skaitlis no 0 līdz 239.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Pikseļi tiek zīmēti, izmantojot pašreizējo pildspalvas krāsu, kas iestatīta ar setPenColor.

• x un y koordinātas ir relatīvas attiecībā pret pašreizējo ekrāna sākumpunktu, ko var iestatīt, izmantojot setOrigin.

• Ja norādītā pikseļa atrašanās vieta atrodas ārpus ekrāna robežām, pikselis netiek zīmēts.

Examples

// Draw the pixels marking the corners of a square
Brain.Screen.drawPixel(250, 100);
Brain.Screen.drawPixel(275, 100);
Brain.Screen.drawPixel(250, 125);
Brain.Screen.drawPixel(275, 125);

drawLine

V5 Brain ekrānā zīmē taisnu līniju, kas savieno divus punktus.

Available Functions

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

Parameters

Parametrs	Tips	Apraksts
x1	int	Līnijas sākuma x koordināta, kas norādīta kā vesels skaitlis no 0 līdz 479.
y1	int	Līnijas sākuma y koordināta, kas norādīta kā vesels skaitlis no 0 līdz 239.
x2	int	Līnijas beigu x koordināta, kas norādīta kā vesels skaitlis no 0 līdz 479.
y2	int	Līnijas beigu y koordināta, kas norādīta kā vesels skaitlis no 0 līdz 239.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Līnijas tiek zīmētas, izmantojot pašreizējo pildspalvas krāsu, kas iestatīta ar setPenColor.

• Līnijas platumu nosaka pašreizējais pildspalvas platums, kas iestatīts ar setPenWidth.

• x un y koordinātas ir relatīvas attiecībā pret pašreizējo ekrāna sākumpunktu, ko var iestatīt, izmantojot setOrigin.

• Ja kāda līnijas daļa atrodas ārpus ekrāna robežām, tiek zīmēta tikai redzamā daļa.

Examples

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

drawRectangle

Uzzīmē taisnstūri V5 Brain ekrānā norādītajā pozīcijā un izmērā.

Available Functions

1 — Zīmē un aizpilda taisnstūri, izmantojot pašlaik konfigurēto aizpildījuma krāsu.

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

2 — Zīmē un aizpilda taisnstūri, izmantojot iepriekš definētu vai pielāgotu krāsu objektu.

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

3 — Zīmē un aizpilda taisnstūri, izmantojot heksadecimālu krāsas vērtību.

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

4 — Zīmē un aizpilda taisnstūri, izmantojot nokrāsas vērtību.

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

Parameters

Parametrs	Tips	Apraksts
x	int	Taisnstūra augšējā kreisā stūra x koordināta, kas norādīta kā vesels skaitlis no 0 līdz 479.
y	int	Taisnstūra augšējā kreisā stūra y koordināta, kas norādīta kā vesels skaitlis no 0 līdz 239.
width	int	Taisnstūra platums, kas norādīts kā vesels skaitlis no 0 līdz 479.
height	int	Taisnstūra augstums, kas norādīts kā vesels skaitlis no 0 līdz 239.
color	const color&	Aizpilda taisnstūri, izmantojot color objektu. Iepriekš definētās krāsas ietver: black white red green blue yellow orange purple cyan transparent Var izmantot arī pielāgotas krāsas objektu.
color	const char*	Aizpilda taisnstūri, izmantojot heksadecimālu krāsas vērtību (piemēram, “#FF0000”).
hue	int	Aizpilda taisnstūri, izmantojot nokrāsas vērtību diapazonā 0līdz359.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Taisnstūra kontūra tiek zīmēta, izmantojot pašreizējo pildspalvas krāsu, kas iestatīta ar setPenColor.

• Kontūras biezumu nosaka pašreizējais pildspalvas platums, kas iestatīts ar setPenWidth.

• Ja nav norādīts parametrs color , taisnstūra iekšpuse tiek aizpildīta, izmantojot pašreizējo aizpildījuma krāsu, kas iestatīta ar setFillColor.

• x un y koordinātas ir relatīvas attiecībā pret pašreizējo ekrāna sākumpunktu, ko var mainīt, izmantojot setOrigin.

• Ja kāda taisnstūra daļa atrodas ārpus ekrāna robežām, tiek zīmēta tikai redzamā daļa.

• 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 rectangle on the screen
Brain.Screen.drawRectangle(50, 50, 130, 60);

drawCircle

V5 Brain ekrānā norādītajā pozīcijā un rādiusā uzzīmē apli.

Available Functions

1 — Zīmē un aizpilda apli, izmantojot pašlaik konfigurēto aizpildījuma krāsu.

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

2 — Zīmē un aizpilda apli, izmantojot iepriekš definētu vai pielāgotu krāsu objektu.

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

3 — Zīmē un aizpilda apli, izmantojot heksadecimālu krāsas vērtību.

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

4 — Zīmē un aizpilda apli, izmantojot nokrāsas vērtību.

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

Parameters

Parametrs	Tips	Apraksts
x	int	Apļa centra x koordināta, kas norādīta kā vesels skaitlis no 0 līdz 479.
y	int	Apļa centra y koordināta, kas norādīta kā vesels skaitlis no 0 līdz 239.
radius	int	Apļa rādiuss, kas norādīts kā vesels skaitlis no 0 līdz 239 pikseļiem.
color	const color&	Aizpilda apli, izmantojot color objektu. Iepriekš definētās krāsas ietver: black white red green blue yellow orange purple cyan transparent Var izmantot arī pielāgotas krāsas objektu.
color	const char*	Aizpilda apli, izmantojot heksadecimālu krāsas vērtību (piemēram, “#FF0000”).
hue	int	Aizpilda apli, izmantojot nokrāsas vērtību diapazonā 0līdz359.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Apļa kontūra tiek zīmēta, izmantojot pašreizējo pildspalvas krāsu, kas iestatīta ar setPenColor.

• Kontūras biezumu nosaka pašreizējais pildspalvas platums, kas iestatīts ar setPenWidth.

• Ja nav norādīts parametrs color , apļa iekšpuse tiek aizpildīta, izmantojot pašreizējo aizpildījuma krāsu, kas iestatīta ar setFillColor.

• x un y koordinātas ir relatīvas attiecībā pret pašreizējo ekrāna sākumpunktu, ko var mainīt, izmantojot 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 circle on the screen
Brain.Screen.drawCircle(240, 120, 40);

drawImageFromFile

Uzzīmē attēlu V5 Brain ekrānā, izmantojot attēla failu, kas saglabāts SD kartē.

Available Functions

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

Parameters

Parametrs	Tips	Apraksts
name	const char*	Attēla faila nosaukums SD kartē. Failam ir jābūt ar paplašinājumu .bmp vai .png.
x	int	X koordināta pikseļos no 0 līdz 479, kurā tiks zīmēta attēla kreisā mala.
y	int	Y koordināta pikseļos no 0 līdz 239, pie kuras tiks zīmēta attēla augšējā mala.

Return Values

Atgriež Būla vērtību, kas norāda, vai attēls tika veiksmīgi uzzīmēts:

• true — Attēls tika veiksmīgi ielādēts un uzzīmēts ekrānā.
• false — Attēlu nevarēja uzzīmēt (piemēram, ja fails neeksistē vai ir nederīgs).

Notes

• Atbalstītie attēlu formāti ir .bmp un .png.

• Attēla faila lielums nedrīkst pārsniegt 512 KB

  • Lai samazinātu faila lielumu, ieteicams izmantot 8 bitu RLE kodējumu.

• Maksimāli atbalstītie attēla izmēri ir Brain ekrāna izmērs (aptuveni 479 x 239 pikseļi).

• x un y koordinātas ir relatīvas attiecībā pret pašreizējo ekrāna sākumpunktu, ko var mainīt, izmantojot setOrigin.

Examples

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

render

Iespējo dubultu buferizāciju Brain ekrānam. Pēc izsaukšanas visas zīmēšanas funkcijas (piemēram, teksts, formas vai attēli) vairs neparādīsies nekavējoties pārējā projektā. Tā vietā atjauninājumi tiks parādīti tikai tad, kad atkal tiks izmantota render Tas nodrošina vienmērīgākus un kontrolētākus ekrāna atjauninājumus, bet nozīmē, ka nekas nebūs redzams, kamēr netiks izmantota render.

Available Functions

1 — Iespējo dubulto buferizāciju vai atveido aizmugurējo buferi ekrānā.

bool render();

2 — Renderē aizmugurējo buferi ekrānā ar vertikālās sinhronizācijas darbības kontroli un papildu plānotāja izpildi.

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

Parameters

Parametrs	Tips	Apraksts
bVsyncWait	bool	​ true — Pirms renderēšanas nogaidīt ekrāna vertikālo atsvaidzinājumu, lai samazinātu vizuālo plīsumu. false — Pirms renderēšanas negaidīt ekrāna vertikālo atsvaidzinājumu.
bRunScheduler	bool	Neobligāti. true (noklusējums) — Ļaut fona uzdevumiem darboties, gaidot renderēšanu. false — Neļaut fona uzdevumiem darboties, gaidot renderēšanu.

Return Values

Atgriež Būla vērtību, kas norāda, vai buferī saglabātie zīmējumi tika veiksmīgi atveidoti ekrānā:

• true — Zīmējumi tika veiksmīgi atveidoti ekrānā.
• false — Zīmējumus nevarēja atveidot ekrānā.
Notes

• Izsaucot render , pārējā projekta daļā būs jāizmanto render.

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();

pressing

Ziņo, vai pašlaik tiek nospiests V5 Brain ekrāns.

Available Functions

bool pressing();

Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež Būla vērtību, kas norāda pašreizējo ekrāna nospiešanas stāvokli:true — Ekrāns pašlaik tiek nospiests. vai false — Ekrāns netiek nospiests.

Examples

// Change the screen's color after it's pressed
while (Brain.Screen.pressing() == false) {
  wait(5, msec);
}

Brain.Screen.setFillColor(green);
Brain.Screen.drawRectangle(0, 0, 479, 239);

---

// Display different messages after the screen is pressed
while (!Brain.Screen.pressing()) {
  wait(5, msec);
}
Brain.Screen.print("First message!");
Brain.Screen.newLine();

// Lift finger to press the screen again
while (Brain.Screen.pressing()) {
  wait(5, msec);
}
while (Brain.Screen.pressing() == false) {
  wait(5, msec);
}
Brain.Screen.print("Second message!");
Brain.Screen.newLine();

xPosition

Atgriež pēdējās nospiešanas x koordinātu V5 Brain ekrānā.

Available Functions

int32_t xPosition();

Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež int32_t kas apzīmē pēdējā ekrāna nospiešanas x koordinātu pikseļos no 0 līdz 479.

Examples

// Display a circle where the screen is pressed
while (Brain.Screen.pressing() == false) {
  wait(5, msec);
}

Brain.Screen.drawCircle(Brain.Screen.xPosition(), Brain.Screen.yPosition(), 20, white);

yPosition

Atgriež pēdējās nospiešanas y koordinātu V5 Brain ekrānā.

Available Functions

int32_t yPosition();

Parameters

Šī funkcija nepieņem nekādus parametrus.

Return Values

Atgriež int32_t kas attēlo pēdējā ekrāna nospiešanas y koordinātu pikseļos no 0 līdz 239.

Examples

// Display a circle where the screen is pressed
while (Brain.Screen.pressing() == false) {
  wait(5, msec);
}

Brain.Screen.drawCircle(Brain.Screen.xPosition(), Brain.Screen.yPosition(), 20, white);

pressed

Reģistrē funkciju, kas tiks izsaukta, nospiežot V5 Brain ekrānu.

Available Functions

1 — Izsauc funkciju, kad tiek nospiests ekrāns.

void pressed(
    void (*callback)(void)
);

2 — Izsauc funkciju, kad tiek nospiests ekrāns, un nodod lietotāja definētu argumentu atzvanīšanas funkcijai.

void pressed(
    void (*callback)(void*),
    void* arg );

Parameters

Parametrs	Tips	Apraksts
callback	void (*)(void)	Funkcija, kas tiek izsaukta, nospiežot ekrāna pogu.
callback	void ()(void)	Funkcija, kas tiek izsaukta, nospiežot ekrānu, un saņem lietotāja definētu argumentu.
arg	void*	Lietotāja definēta vērtība, kas tiek nodota atzvanīšanas funkcijai, kad tiek nospiests ekrāns.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Atzvanīšanas funkcija tiek izpildīta katru reizi, kad tiek nospiests Brain ekrāns.

• Vienlaikus var reģistrēt tikai vienu atzvanīšanas funkciju; atkārtota pressed nospiešana aizstāj iepriekšējo atzvanīšanas funkciju.

• Atzvanīšanas funkcijai ir jāatgriež void.

Examples

Definējiet atzvanīšanas funkciju (ārpus int main())

// Tracks how many times the screen is pressed.
void onScreenPressed(void* arg) {
  int* count = (int*)arg;
  (*count)++;

  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Pressed %d times", *count);
}

Reģistrējiet atzvanīšanas funkciju int main() iekšpusē

int main() {
  int pressCount = 0;

  // Register the callback and pass a value to update.
  Brain.Screen.pressed(onScreenPressed, &pressCount);

  while (true) {
    wait(20, msec);
  }
}

released

Reģistrē funkciju, kas tiks izsaukta, kad pēc nospiešanas tiek atlaists V5 Brain ekrāns.

Available Functions

1 — Izsauc funkciju, kad ekrāns tiek atlaists pēc nospiešanas.

void released(
    void (*callback)(void)
);

2 — Izsauc funkciju, kad ekrāns tiek atlaists pēc nospiešanas, un nodod lietotāja definētu argumentu atzvanīšanas funkcijai.

void released(
    void (*callback)(void*),
    void* arg );

Parameters

Parametrs	Tips	Apraksts
callback	void (*)(void)	Funkcija, kas tiek izsaukta, kad ekrāns tiek atlaists pēc nospiešanas.
callback	void ()(void)	Funkcija, kas tiek izsaukta, kad ekrāns tiek atlaists pēc nospiešanas, un saņem lietotāja definētu argumentu.
arg	void*	Lietotāja definēta vērtība, kas tiek nodota atzvanīšanas funkcijai, kad ekrāns tiek atlaists pēc nospiešanas.

Return Values

Šī funkcija neatgriež vērtību.

Notes

• Atzvanīšanas funkcija tiek izpildīta katru reizi, kad pēc nospiešanas tiek atbrīvots Brain ekrāns.

• Vienlaikus var reģistrēt tikai vienu atzvanīšanas funkciju; atkārtota released atlaišana aizstāj iepriekšējo atzvanīšanas funkciju.

• Atzvanīšanas funkcijai ir jāatgriež void.

Examples

Definējiet atzvanīšanas funkciju (ārpus int main())

// Tracks how many times the screen is released.
void onScreenReleased(void* arg) {
  int* count = (int*)arg;
  (*count)++;

  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Released %d times", *count);
}

Reģistrējiet atzvanīšanas funkciju int main() iekšpusē

int main() {
  int releaseCount = 0;

  // Register the callback and pass a value to update.
  Brain.Screen.released(onScreenReleased, &releaseCount);

  while (true) {
    wait(20, msec);
  }
}