Ekranas

Įvadas

screen klasė yra kilusi iš brain bazinės klasės. Ji kontroliuoja, kaip EXP Brain ekrane rodo tekstą, skaičius ir grafiką.

„EXP Brain“ ekrane yra nustatytas eilučių ir stulpelių skaičius, naudojamas spausdinant tekstą.

Pagal numatytuosius nustatymus, spausdinimui į „Brain“ naudojamas šriftas yra mono20 , kuris turi 7 eilutes ir 20 stulpelių.

Piešimui smegenų skiriamoji geba yra 159 x 107 pikselių.

Prieiga

screen klasę galima pasiekti:

Brain.Screen

Pastabos

• screen objektą pateikia smegenys. Jis nėra tiesiogiai konstruojamas.

• Projektuose naudojamas vienas globalus Brain objektas, todėl „screen“ funkcijos iškviečiamos naudojant Brain.Screen.

Pavyzdys

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

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

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

Narių funkcijos

screen klasėje yra šios narinės funkcijos:

• print – Spausdina suformatuotą tekstą, skaičius arba logines reikšmes į „Brain“ ekraną.

• setCursor — Perkelia teksto žymeklį į nurodytą eilutę ir stulpelį.

• newLine — Išvalo likusią dabartinės eilutės dalį ir perkelia žymeklį į kitą eilutę.

• clearLine — Išvalo likusią dabartinės eilutės dalį arba nurodytą eilutę.

• row — Grąžina eilutę, kurioje bus spausdinamas tekstas.

• column — Grąžina stulpelį, kuriame bus spausdinamas tekstas.

• getStringHeight — Grąžina eilutės aukštį pikseliais, naudojant dabartinį šriftą.

• getStringWidth — Grąžina eilutės plotį pikseliais, naudojant dabartinį šriftą.

• printAt – Spausdina suformatuotą tekstą x ir y pikselių vietoje (pasirinktinai nepermatomas).

• clearScreen — Išvalo visą ekraną (pasirinktinai iki nurodytos spalvos).

• setFont — Nustato šriftą, naudojamą spausdinimui ekrane.

• setPenWidth — Nustato nubrėžtų linijų ir formos kontūrų storį.

• setPenColor – Nustato teksto, pikselių, linijų ir figūrų kontūrų spalvą.

• setFillColor — Nustato nupieštų formų ir spausdinto teksto fonų užpildymo spalvą.

• setOrigin — Nustato ekrano koordinatėms naudojamą pradžios tašką.

• setClipRegion — Apriboja ekrano išvestį iki stačiakampio formos srities.

• drawPixel — Nubraižo vieną pikselį koordinatėje.

• drawLine — Nubrėžia liniją tarp dviejų taškų.

• drawRectangle — Nubraižo stačiakampį x ir y koordinatėse su nurodytu dydžiu.

• drawCircle — Nubrėžia apskritimą x ir y koordinatėse nurodytu spinduliu.

• drawImageFromFile — Nupiešia vaizdą iš SD kortelės failo ekrane.

• render – Įjungia dvigubą buferizavimą arba atvaizduoja galinį buferį ekrane.

Prieš iškviečiant bet kokias screen nario funkcijas, reikia sukurti brain egzempliorių, kaip parodyta žemiau:

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

print

Rodo tekstą, skaičius arba logines reikšmes EXP Brain ekrane.

Available Functions

1 — Spausdina suformatuotą tekstą naudodamas eilučių literalus arba tik skaitomas C stiliaus eilutes.

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

2 — Spausdina suformatuotą tekstą naudojant modifikuojamus simbolių masyvus.

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

Parameters

Parametras	Tipas	Aprašymas
format	const char*	Formato eilutė, pateikta kaip eilutės literalas arba tik skaitymui skirta C stiliaus eilutė (pavyzdžiui, “Score: %d”).
format	char*	Formato eilutė, pateikta kaip modifikuojamas simbolių masyvas.
…		Viena ar kelios papildomos reikšmės, įterptos į formatavimo eilutę, atskirtos kableliais.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Išvestis prasideda nuo dabartinės žymeklio pozicijos ekrane.

• Spausdinamam tekstui naudojamas dabartinis ekrano šriftas

• Spausdinamam tekstui naudojama dabartinė rašiklio spalva .

• Su print atspausdintas tekstas visada spausdinamas su fonu, o fono spalva nustatoma pagal dabartinę užpildymo spalvą

• Naudojant formatavimo eilutę, perduodamų reikšmių skaičius ir tipai turi sutapti su eilutėje esančiais formato specifikacijomis.

Examples

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

setCursor

Perkelia žymeklį į konkrečią eilutę ir stulpelį EXP Brain ekrane. Kitas print iškvietimas pradės spausdinti toje vietoje.

Available Functions

void setCursor(
  int32_t row, 
  int32_t col );

Parameters

Parametras	Tipas	Aprašymas
row	int32_t	Eilutė, į kurią reikia perkelti žymeklį.
col	int32_t	Stulpelis, į kurį reikia perkelti žymeklį.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Įtakoja, kur prasideda tolesnė teksto išvestis, kai naudojama print.

• Eilutės ir stulpeliai yra pagrįsti šiuo metu nustatytu ekrano šriftu.

• Numatytasis šriftas (mono20) naudoja 12 eilučių ir 48 stulpelius.

• Funkcijos setCursor iškvietimas paveikia tik vėlesnės teksto išvesties poziciją.

Examples

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

newLine

Perkelia žymeklį į kitos eilutės pradžią smegenų ekrane.

Available Functions

void newLine();

Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Jei žymeklis yra sakinio viduryje, newLine išvalys likusią eilutės dalį po žymeklio prieš pereinant į kitą eilutę.

• Iškvietus funkciją newLine, žymeklis perkeliamas į kitos eilutės pirmą stulpelį.

• Žymeklio pozicija ir eilučių numeracija nustatomi naudojant setCursor.

Examples

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

clearLine

Išvalo tekstą iš eilutės EXP Brain ekrane.

Available Functions

1 — Išvalo likusią dabartinės eilutės dalį nuo žymeklio pozicijos.

void clearLine();

2 — Išvalo nurodytą eilutę naudodama šiuo metu sukonfigūruotą užpildymo spalvą.

void clearLine(
    int number );

3 — Išvalo nurodytą eilutę naudodamas iš anksto nustatytą arba pasirinktinės spalvos objektą.

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

4 — Išvalo nurodytą eilutę naudodama šešioliktainę spalvos reikšmę.

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

5 — Išvalo nurodytą eilutę naudodama atspalvio reikšmę.

void clearLine(
    int number,
    int hue );

Parameters

Parametras	Tipas	Aprašymas
number	int	Eilutės, kurią reikia išvalyti, numeris. Eilučių numeravimas prasideda nuo 1.
color	const color&	Išvalo eilutę naudodama color objektą. Iš anksto apibrėžtos spalvos: black white red green blue yellow orange purple cyan transparent Taip pat galima naudoti pasirinktinės spalvos objektą.
color	const char*	Išvalo eilutę naudodama šešioliktainę spalvos reikšmę (pavyzdžiui, “#000000”).
hue	int	Išvalo eilutę naudodama sveikojo skaičiaus atspalvio reikšmę diapazone 0iki359, kuri žymi laipsnius aplink spalvų ratą.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Išvalius eilutę, dabartinė žymeklio padėtis nepasikeičia.

• Žymeklio pozicija ir eilučių numeracija nustatomi naudojant setCursor.

• hue parametro reikšmė pagrįsta apskritu spalvų ratu, kaip parodyta žemiau, kur reikšmės nurodo laipsnius aplink ratą (pavyzdžiui, raudona prie 0°, žalia prie 120° ir mėlyna prie 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

Grąžina eilutę, kurioje tekstas bus atspausdintas EXP Brain ekrane.

Available Functions

int32_t row();

Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Grąžina int32_t , žymintį eilutę, kurioje bus spausdinamas tekstas.

Eilučių numeracija prasideda nuo 1.

Notes

• Žymeklio padėtis nustatoma pagal dabartinį ekrano šriftą .

• Grąžinta reikšmė nurodo, kur bus rodoma kita atspausdinta išvestis.

• Eilutės reikšmė pasikeičia, kai spausdinamas tekstas arba kai iškviečiama setCursor.

Examples

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

column

Grąžina stulpelį, kuriame tekstas bus spausdinamas EXP Brain ekrane.

Available Functions

int32_t column();

Parameters

Ši funkcija nepriima jokių parametrų.

Return Values

Grąžina int32_t , nurodantį stulpelį, kuriame bus spausdinamas tekstas.

Stulpelių numeracija prasideda nuo 1.

Notes

• Žymeklio padėtis nustatoma pagal dabartinį ekrano šriftą .

• Grąžinta reikšmė nurodo, kur bus rodoma kita atspausdinta išvestis.

• Stulpelio reikšmė keičiasi, kai spausdinamas tekstas arba kai iškviečiama setCursor.

Examples

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

getStringHeight

Grąžina eilutės aukštį pikseliais, kai ji pateikiama EXP Brain ekrane.

Available Functions

int32_t getStringHeight( 
    const char* cstr );

Parameters

Parametras	Tipas	Aprašymas
cstr	const char*	Matuojamas tekstas, pateikiamas kaip C stiliaus eilutė (pavyzdžiui, “Hello”).

Return Values

Grąžina int32_t , nurodantį eilutės aukštį pikseliais, kai ji vaizduojama „Brain“ ekrane.

Notes

• Grąžintas aukštis priklauso nuo šiuo metu pasirinkto ekrano šrifto

• Ši funkcija matuoja eilutę jos nepiešdama ekrane.

• Grąžintas aukštis parodo, kaip eilutė atrodytų atspausdinta.

getStringWidth

Grąžina eilutės plotį pikseliais, kai ji pateikiama EXP Brain ekrane.

Available Functions

int32_t getStringWidth( 
    const char* cstr );

Parameters

Parametras	Tipas	Aprašymas
cstr	const char*	Matuojamas tekstas, pateikiamas kaip C stiliaus eilutė (pavyzdžiui, “Hello”).

Return Values

Grąžina int32_t , nurodantį eilutės plotį pikseliais, kai ji vaizduojama „Brain“ ekrane.

Notes

• Grąžintas plotis priklauso nuo šiuo metu pasirinkto ekrano šrifto

• Ši funkcija matuoja eilutę jos nepiešdama ekrane.

• Grąžintas plotis parodo, kaip eilutė atrodytų atspausdinta.

printAt

Spausdina tekstą, skaičius arba logines reikšmes konkrečioje koordinatėje EXP Brain ekrane.

Available Functions

1 — Spausdina suformatuotą išvestį nurodytoje pikselio vietoje.

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

2 — Spausdina suformatuotą išvestį nurodytoje pikselio vietoje ir nustato, ar teksto fonas yra nepermatomas, ar permatomas.

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

Parameters

Parametras	Tipas	Aprašymas
x	int32_t	X padėtis, kurioje spausdinti, atsižvelgiant į ekrano pradžios tašką.
y	int32_t	Y ašies padėtis, kurioje spausdinti, atsižvelgiant į ekrano pradžios tašką.
bOpaque	bool	Valdo, ar spausdinamas tekstas piešiamas neskaidriai, ar permatomai: true — Spausdinamo teksto fonas užpildomas naudojant dabartinę užpildymo spalvą. false — Tekstas piešiamas permatomas, o fonas neužpildomas.
format	const char*	Formato eilutė, valdanti, kas spausdinama ekrane (pavyzdžiui, “Score: %d”).
…		Viena ar kelios papildomos reikšmės, įterptos į formatavimo eilutę, atskirtos kableliais.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• x ir y koordinatės yra santykinės dabartinio ekrano pradžios taško atžvilgiu, kurį galima pakeisti naudojant setOrigin.

• Spausdinamam tekstui naudojamas dabartinis ekrano šriftas

• Spausdinamam tekstui naudojama dabartinė rašiklio spalva .

• Naudojant formatavimo eilutę, perduodamų reikšmių skaičius ir tipai turi sutapti su eilutėje esančiais formato specifikacijomis.

Examples

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

clearScreen

Ištrina visus piešinius ir tekstą iš smegenų ekrano.

Available Functions

1 — Išvalo ekraną iki juodo.

void clearScreen();

2 — Išvalo ekraną naudodamas iš anksto nustatytą arba pasirinktinės spalvos objektą.

void clearScreen(
    const color& color );

3 — Išvalo ekraną naudodamas šešioliktainę spalvos reikšmę.

void clearScreen(
    const char* color );

4 — Išvalo ekraną naudodamas atspalvio reikšmę.

void clearScreen(
    int hue );

Parameters

Parametras	Tipas	Aprašymas
color	const color&	Išvalo ekraną naudodamas color objektą. Iš anksto apibrėžtos spalvos: black white red green blue yellow orange purple cyan transparent Taip pat galima naudoti pasirinktinės spalvos objektą.
color	const char*	Išvalo ekraną naudodamas šešioliktainę spalvos reikšmę, pateiktą kaip eilutę (pavyzdžiui, “#000000”).
hue	int	Išvalo ekraną naudodamas sveikojo skaičiaus atspalvio reikšmę diapazone 0iki359ir atitinkančią spalvų rato laipsnius.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• hue parametro reikšmė pagrįsta apskritu spalvų ratu, kaip parodyta žemiau, kur reikšmės nurodo laipsnius aplink ratą (pavyzdžiui, raudona prie 0°, žalia prie 120° ir mėlyna prie 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

Nustato šriftą, naudojamą tekstui, rodomam EXP Brain ekrane.

Tai kontroliuoja šriftą, taikomą vėlesnei teksto išvestiei, kai naudojamos ekrano teksto funkcijos, pvz., print.

Available Functions

void setFont(
  fontType font );

Parameters

Parametras	Tipas	Aprašymas
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

Ši funkcija negrąžina reikšmės.

Examples

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

setPenWidth

Nustato nubrėžtų linijų ir formos kontūrų storį.

Available Functions

void setPenWidth(
  uint32_t width );

Parameters

Parametras	Tipas	Aprašymas
width	uint32_t	Rašiklio plotis pikseliais intervale nuo 0 iki 32.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Rašiklio plotis taikomas piešimo funkcijoms, tokioms kaip drawLine, drawRectangle ir drawCircle.

Examples

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

setPenColor

Nustato rašiklio spalvą, naudojamą linijoms, figūroms ir tekstui piešti.

Available Functions

1 — Nustato rašiklio spalvą naudodamas iš anksto nustatytą arba pasirinktinės spalvos objektą.

void setPenColor(
    const color& color );

2 — Nustato rašiklio spalvą naudodama šešioliktainę spalvos reikšmę.

void setPenColor(
    const char* color );

3 — Nustato rašiklio spalvą naudojant atspalvio reikšmę.

void setPenColor(
    int hue );

Parameters

Parametras	Tipas	Aprašymas
color	const color&	Nustato rašiklio spalvą naudojant color objektą. Iš anksto apibrėžtos spalvos: black white red green blue yellow orange purple cyan transparent Taip pat galima naudoti pasirinktinės spalvos objektą.
color	const char*	Nustato rašiklio spalvą naudodama šešioliktainę spalvos reikšmę, pateiktą kaip eilutę (pavyzdžiui, “#FF0000”).
hue	int	Nustato rašiklio spalvą naudodamas sveikąjį skaičių atspalvio reikšmę diapazone 0iki359, kuri nurodo laipsnius aplink spalvų ratą (pavyzdžiui, 0 yra raudona, 120 yra žalia, o 240 yra mėlyna).

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Numatytoji rašiklio spalva projekto pradžioje yra white.

• Rašiklio spalva naudojama formų kontūrams (pvz., naudojant drawCircle arba drawRectangle), teksto ir skaitinei išvesčiai (su print ir printAt) ir atskiriems pikseliams, piešiamiems naudojant drawPixel.

• hue parametro reikšmė pagrįsta apskritu spalvų ratu, kaip parodyta žemiau, kur reikšmės nurodo laipsnius aplink ratą (pavyzdžiui, raudona prie 0°, žalia prie 120° ir mėlyna prie 240°).

Examples

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

setFillColor

Nustato užpildymo spalvą, naudojamą piešiant figūras.

Available Functions

1 — Nustato užpildymo spalvą naudodamas iš anksto nustatytą arba pasirinktinės spalvos objektą.

void setFillColor(
    const color& color );

2 — Nustato užpildymo spalvą naudodama šešioliktainę spalvos reikšmę.

void setFillColor(
    const char* color );

3 — Nustato užpildymo spalvą naudodama atspalvio reikšmę.

void setFillColor(
    int hue );

Parameters

Parametras	Tipas	Aprašymas
color	const color&	Nustato užpildymo spalvą naudojant color objektą. Iš anksto apibrėžtos spalvos: black white red green blue yellow orange purple cyan transparent Taip pat galima naudoti pasirinktinės spalvos objektą.
color	const char*	Nustato užpildymo spalvą naudodama šešioliktainę spalvos reikšmę, pateiktą kaip eilutę (pavyzdžiui, “#00FF00”).
hue	int	Nustato užpildymo spalvą naudodamas sveikąjį skaičių atspalvio reikšmę diapazone 0iki359, kuri nurodo laipsnius aplink spalvų ratą (pavyzdžiui, 0 yra raudona, 120 yra žalia, o 240 yra mėlyna).

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Numatytoji užpildymo spalva projekto pradžioje yra black.

• Užpildo spalva naudojama formų viduje (pvz., naudojant drawCircle arba drawRectangle).

• Užpildo spalva naudojama kaip spausdinto teksto fono spalva (pvz., su print ir printAt).

  • Jei su spausdintu tekstu naudojama transparent , fonas bus black.

• hue parametro reikšmė pagrįsta apskritu spalvų ratu, kaip parodyta žemiau, kur reikšmės nurodo laipsnius aplink ratą (pavyzdžiui, raudona prie 0°, žalia prie 120° ir mėlyna prie 240°).

Examples

// Draw a rectangle filled with purple
  Brain.Screen.setFillColor(purple);
  Brain.Screen.drawRectangle(20, 20, 75, 50);

setOrigin

Nustato pradžios tašką, naudojamą grafikai piešti smegenų ekrane.

Available Functions

void setOrigin(
  int32_t x,
  int32_t y );

Parameters

Parametras	Tipas	Aprašymas
x	int32_t	Pradinės taško x padėtis, palyginti su viršutiniu kairiuoju smegenų ekrano kampu nuo 0 iki 159.
y	int32_t	Pradinės taško y padėtis, palyginti su viršutiniu kairiuoju smegenų ekrano kampu nuo 0 iki 107.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Numatytoji pradžios taškas yra viršutinis kairysis ekrano kampas koordinatėse (0, 0).

• Pradinė taško reikšmė taikoma koordinatinėms funkcijoms, tokioms kaip drawLine, drawRectangle, drawCircle ir printAt.

• Pradinė vieta lieka galioti, kol ji vėl pakeičiama arba projektas neatkuriamas.

setClipRegion

Apibrėžia stačiakampę ekrano sritį, kurioje bus visi piešiniai ir tekstas. Turinys už šios srities ribų nebus rodomas.

Available Functions

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

Parameters

Parametras	Tipas	Aprašymas
x	int	Viršutinio kairiojo iškirpimo srities kampo x koordinatė, nurodyta kaip sveikasis skaičius nuo 0 iki 159.
y	int	Viršutinio kairiojo iškirpimo srities kampo y koordinatė, pateikta kaip sveikasis skaičius nuo 0 iki 107.
width	int	Įrašymo srities plotis pikseliais, nurodytas kaip sveikasis skaičius nuo 0 iki 159.
height	int	Iškarpos srities aukštis pikseliais, nurodytas kaip sveikasis skaičius nuo 0 iki 107.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Piešimo funkcijos vykdomos net jei jos nepatenka į iškirpimo sritį, tačiau matoma tik srities viduje esanti dalis.

• x ir y koordinatės yra santykinės dabartinio ekrano pradžios taško atžvilgiu, kurį galima pakeisti naudojant setOrigin.

• Iškirpimo sritis taikoma tik dabartinei gijai.

• Nustačius naują iškarpos sritį, pakeičiama bet kokia anksčiau nustatyta dabartinio gija iškarpos sritis.

Examples

drawPixel

EXP Brain ekrane pasirinktoje x ir y pikselių vietoje nupiešia vieną pikselį.

Available Functions

void drawPixel(
  int x,
  int y );

Parameters

Parametras	Tipas	Aprašymas
x	int	Pikselio x koordinatė, nurodyta sveikuoju skaičiumi nuo 0 iki 159, kur bus piešiamas pikselis.
y	int	Y koordinatė, kurioje bus piešiamas pikselis, pateikiama kaip sveikasis skaičius nuo 0 iki 107.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Pikseliai piešiami naudojant dabartinę rašiklio spalvą, nustatytą su setPenColor.

• x ir y koordinatės yra santykinės dabartinio ekrano pradžios taško atžvilgiu, kurį galima nustatyti naudojant setOrigin.

• Jei nurodyta pikselio vieta yra už ekrano ribų, pikselis nebraižomas.

Examples

// Draw the pixels marking the corners of a square
Brain.Screen.drawPixel(50, 50);
Brain.Screen.drawPixel(50, 75);
Brain.Screen.drawPixel(75, 50);
Brain.Screen.drawPixel(75, 75);

drawLine

Nubrėžia tiesią liniją, jungiančią du taškus EXP Brain ekrane.

Available Functions

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

Parameters

Parametras	Tipas	Aprašymas
x1	int	Pradinė linijos x koordinatė, pateikta kaip sveikasis skaičius nuo 0 iki 159.
y1	int	Pradinė tiesės y koordinatė, pateikta kaip sveikasis skaičius nuo 0 iki 107.
x2	int	Linijos galinė x koordinatė, pateikta kaip sveikasis skaičius nuo 0 iki 159.
y2	int	Linijos galinė y koordinatė, pateikta kaip sveikasis skaičius nuo 0 iki 107.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Linijos brėžiamos naudojant dabartinę rašiklio spalvą, nustatytą su setPenColor.

• Linijos plotis nustatomas pagal dabartinį rašiklio plotį, nustatytą naudojant setPenWidth.

• x ir y koordinatės yra santykinės dabartinio ekrano pradžios taško atžvilgiu, kurį galima nustatyti naudojant setOrigin.

• Jei kuri nors linijos dalis yra už ekrano ribų, piešiama tik matoma dalis.

Examples

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

drawRectangle

Nubrėžia stačiakampį EXP Brain ekrane nurodytoje vietoje ir dydžio.

Available Functions

1 — Nubrėžia ir užpildo stačiakampį naudodamas šiuo metu sukonfigūruotą užpildymo spalvą.

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

2 — Nubrėžia ir užpildo stačiakampį naudodamas iš anksto nustatytą arba pasirinktinės spalvos objektą.

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

3 — Nubrėžia ir užpildo stačiakampį naudodamas šešioliktainę spalvos reikšmę.

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

4 — Nubrėžia ir užpildo stačiakampį naudodamas atspalvio reikšmę.

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

Parameters

Parametras	Tipas	Aprašymas
x	int	Stačiakampio viršutinio kairiojo kampo x koordinatė, nurodyta kaip sveikasis skaičius nuo 0 iki 159.
y	int	Stačiakampio viršutinio kairiojo kampo y koordinatė, pateikta kaip sveikasis skaičius nuo 0 iki 107.
width	int	Stačiakampio plotis, nurodytas kaip sveikasis skaičius nuo 0 iki 159.
height	int	Stačiakampio aukštis, nurodytas kaip sveikasis skaičius nuo 0 iki 107.
color	const color&	Užpildo stačiakampį naudodamas color objektą. Iš anksto apibrėžtos spalvos: black white red green blue yellow orange purple cyan transparent Taip pat galima naudoti pasirinktinės spalvos objektą.
color	const char*	Užpildo stačiakampį šešioliktaine spalvos reikšme (pavyzdžiui, “#FF0000”).
hue	int	Užpildo stačiakampį atspalvio reikšme diapazone 0iki359.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Stačiakampio kontūras brėžiamas naudojant dabartinę rašiklio spalvą, nustatytą su setPenColor.

• Kontūro storis nustatomas pagal dabartinį rašiklio plotį, nustatytą naudojant setPenWidth.

• Kai nenurodytas color parametras, stačiakampio vidus užpildomas naudojant dabartinę užpildymo spalvą, nustatytą naudojant setFillColor.

• x ir y koordinatės yra santykinės dabartinio ekrano pradžios taško atžvilgiu, kurį galima pakeisti naudojant setOrigin.

• Jei kuri nors stačiakampio dalis yra už ekrano ribų, piešiama tik matoma dalis.

• hue parametro reikšmė pagrįsta apskritu spalvų ratu, kaip parodyta žemiau, kur reikšmės nurodo laipsnius aplink ratą (pavyzdžiui, raudona prie 0°, žalia prie 120° ir mėlyna prie 240°).

Examples

// Draw a rectangle on the screen
Brain.Screen.drawRectangle(20, 20, 80, 30);

drawCircle

Nubrėžia apskritimą EXP Brain ekrane nurodytoje vietoje ir spinduliu.

Available Functions

1 — Nubrėžia ir užpildo apskritimą naudodamas šiuo metu sukonfigūruotą užpildymo spalvą.

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

2 — Nubrėžia ir užpildo apskritimą naudodamas iš anksto nustatytą arba pasirinktinės spalvos objektą.

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

3 — Nubrėžia ir užpildo apskritimą naudodamas šešioliktainę spalvos reikšmę.

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

4 — Nubrėžia ir užpildo apskritimą naudodamas atspalvio reikšmę.

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

Parameters

Parametras	Tipas	Aprašymas
x	int	Apskritimo centro x koordinatė, pateikta kaip sveikasis skaičius nuo 0 iki 159.
y	int	Apskritimo centro y koordinatė, pateikta kaip sveikasis skaičius nuo 0 iki 107.
radius	int	Apskritimo spindulys, nurodytas kaip sveikasis skaičius nuo 0 iki 107 pikselių.
color	const color&	Užpildo apskritimą naudodamas color objektą. Iš anksto apibrėžtos spalvos: black white red green blue yellow orange purple cyan transparent Taip pat galima naudoti pasirinktinės spalvos objektą.
color	const char*	Užpildo apskritimą naudodamas šešioliktainę spalvos reikšmę (pavyzdžiui, “#FF0000”).
hue	int	Užpildo apskritimą atspalvio reikšme diapazone 0iki359.

Return Values

Ši funkcija negrąžina reikšmės.

Notes

• Apskritimo kontūras brėžiamas naudojant dabartinę rašiklio spalvą, nustatytą su setPenColor.

• Kontūro storis nustatomas pagal dabartinį rašiklio plotį, nustatytą naudojant setPenWidth.

• Kai nenurodytas color parametras, apskritimo vidus užpildomas naudojant dabartinę užpildymo spalvą, nustatytą naudojant setFillColor.

• x ir y koordinatės yra santykinės dabartinio ekrano pradžios taško atžvilgiu, kurį galima pakeisti naudojant setOrigin.

• hue parametro reikšmė pagrįsta apskritu spalvų ratu, kaip parodyta žemiau, kur reikšmės nurodo laipsnius aplink ratą (pavyzdžiui, raudona prie 0°, žalia prie 120° ir mėlyna prie 240°).

Examples

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

drawImageFromFile

Nubraižo vaizdą EXP Brain ekrane, naudodamas vaizdo failą, saugomą SD kortelėje.

Available Functions

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

Parameters

Parametras	Tipas	Aprašymas
name	const char*	Vaizdo failo pavadinimas SD kortelėje. Failas turi turėti plėtinį .bmp arba .png.
x	int	X koordinatė pikseliais nuo 0 iki 159, kurioje bus brėžiamas kairysis vaizdo kraštas.
y	int	Y koordinatė pikseliais nuo 0 iki 107, kurioje bus brėžiamas viršutinis vaizdo kraštas.

Return Values

Grąžina loginę reikšmę, nurodančią, ar vaizdas buvo sėkmingai nupieštas:

• true — Vaizdas buvo sėkmingai įkeltas ir nupieštas ekrane.
• false — Vaizdo nepavyko nupiešti (pavyzdžiui, jei failo nėra arba jis negalioja).

Notes

• Palaikomi vaizdo formatai yra .bmp ir .png.

• Vaizdo failo dydis neturi viršyti 512 KB

  • Rekomenduojamas 8 bitų RLE kodavimas, siekiant sumažinti failo dydį.

• Didžiausi palaikomi vaizdo matmenys yra „Brain“ ekrano dydis (apytiksliai 159 x 107 pikselių).

• x ir y koordinatės yra santykinės dabartinio ekrano pradžios taško atžvilgiu, kurį galima pakeisti naudojant setOrigin.

Examples

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

render

Įgalina dvigubą buferizavimą smegenų ekrane. Iškvietus, jokios piešimo funkcijos (pvz., tekstas, formos ar vaizdai) nebebus iš karto rodomos likusioje projekto dalyje. Vietoj to, atnaujinimai bus rodomi tik tada, kai vėl bus naudojamas render Tai leidžia sklandžiau ir labiau kontroliuojamai atnaujinti ekraną, bet reiškia, kad niekas nebus matoma, kol nebus naudojamas render.

Available Functions

1 — Įjungia dvigubą buferizavimą arba atvaizduoja galinį buferį ekrane.

bool render();

2 — Atkuria galinį buferį ekrane, valdydamas vertikalios sinchronizacijos elgseną ir pasirenkamą planuoklio vykdymą.

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

Parameters

Parametras	Tipas	Aprašymas
bVsyncWait	bool	​ true — Prieš vaizduojant palaukti, kol ekranas bus atnaujintas vertikaliai, kad sumažėtų vaizdo plyšimas. false — Prieš vaizduojant nelaukti, kol ekranas bus atnaujintas vertikaliai.
bRunScheduler	bool	Pasirinktinai. true (numatytasis) — Leisti foninėms užduotims vykdyti, kol laukiama, kol bus vaizduojamas. false — Neleisti foninėms užduotims vykdyti, kol laukiama, kol bus vaizduojamas.

Return Values

Grąžina loginę reikšmę, nurodančią, ar buferyje išsaugoti piešiniai buvo sėkmingai atvaizduoti ekrane:

• true — Piešiniai buvo sėkmingai atvaizduoti ekrane.
• false — Piešinių nepavyko atvaizduoti ekrane.
Notes

• Iškvietus render , likusiai projekto daliai reikės naudoti 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();