Ekranas#

Įvadas #

screen klasė yra kilusi iš brain bazinės klasės. Ji kontroliuoja, kaip IQ (1-osios kartos) Brain rodo tekstą ir reikšmes savo integruotame ekrane.

IQ (1-osios kartos) smegenų ekranas palaiko iki 5 teksto eilučių ir 21 stulpelio.

VEX IQ (1-osios kartos) smegenys su sunumeruotu tinklelio perdengimu (1–21 stulpeliai ir 1–5 eilutės). Raudonos perdengimo linijos paryškina tinklelio struktūrą, o rodyklės žymi 1 stulpelį, 21 stulpelį, 1 eilutę, 2 eilutę ir 5 eilutę. Pirmoje eilutėje viršuje rodomi skaičiai nuo 1 iki 21.

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 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.
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 Brain
brain Brain = brain();

print #

Rodo tekstą, skaičius arba logines reikšmes IQ (1-osios kartos) smegenų 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į IQ (1-osios kartos) smegenų 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.
Funkcijos setCursor iškvietimas paveikia tik vėlesnės teksto išvesties poziciją.

Examples

// Print at row 3 column 7
Brain.Screen.setCursor(3, 7);
Brain.Screen.print("VEXcode!");

! IQ 1-osios kartos smegenų ekranas, kuriame centre rodomas tekstas „VEXcode!“.

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("First message");
Brain.Screen.newLine();
Brain.Screen.print("Second message");

IQ (1-osios kartos) smegenų ekranas, kuriame atskirose eilutėse rodomi „Pirmasis pranešimas“ ir „Antrasis pranešimas“.

clearLine #

Išvalo tekstą iš eilutės IQ (1-osios kartos) smegenų 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 `0`iki`359`, 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.
„IQ“ (1-osios kartos) smegenų ekranas yra nespalvotas, todėl nurodytos spalvos jame nebus rodomos.

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 dabartinę žymeklio eilutės poziciją IQ (1-osios kartos) smegenų 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, 12);
Brain.Screen.print("row: ", Brain.Screen.row());

column #

Grąžina stulpelį, kuriame tekstas bus spausdinamas IQ (1-osios kartos) smegenų 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.print("column: ", Brain.Screen.column());

getStringHeight #

Grąžina eilutės aukštį pikseliais, kai ji pateikiama IQ (1-osios kartos) smegenų 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 IQ (1-osios kartos) smegenų 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 #

IQ (1-osios kartos) smegenų ekrane tam tikroje koordinatėje spausdina tekstą, skaičius arba logines reikšmes.

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 `0`iki`359`ir atitinkančią spalvų rato laipsnius.

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

„IQ“ (1-osios kartos) smegenų ekranas yra nespalvotas, todėl nurodytos spalvos jame nebus rodomos.

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

setFont #

Nustato šriftą, naudojamą tekstui, rodomam IQ (1-osios kartos) smegenų 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.

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.

Return Values

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

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

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 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 circle with a pen width of 5
Brain.Screen.drawCircle(40, 70, 20);
Brain.Screen.setPenWidth(5);
Brain.Screen.drawCircle(100, 70, 20);

setPenColor #

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

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`
`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 `0`iki`359`, kuri nurodo laipsnius aplink spalvų ratą (pavyzdžiui, `0` yra raudona, `120` yra žalia, o `240` yra mėlyna).

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

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

„IQ“ (1-osios kartos) smegenų ekranas yra nespalvotas, todėl nurodytos spalvos jame nebus rodomos.

Examples

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

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`
`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 `0`iki`359`, kuri nurodo laipsnius aplink spalvų ratą (pavyzdžiui, `0` yra raudona, `120` yra žalia, o `240` yra mėlyna).

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

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

„IQ“ (1-osios kartos) smegenų ekranas yra nespalvotas, todėl nurodytos spalvos jame nebus rodomos.

Examples

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

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

// 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 #

IQ (1-osios kartos) smegenų ekrane nupiešia vieną pikselį nurodytoje x ir y pikselių vietoje.

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

„IQ“ (1-osios kartos) smegenų ekranas yra nespalvotas, todėl nurodytos spalvos jame nebus rodomos.
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 one pixel at the center 
// of the screen
Brain.Screen.drawPixel(80, 50);

drawLine #

Brėžia tiesią liniją, jungiančią du taškus IQ (1-osios kartos) smegenų 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

„IQ“ (1-osios kartos) smegenų ekranas yra nespalvotas, todėl nurodytos spalvos jame nebus rodomos.
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 #

Nurodytoje vietoje ir dydžio IQ (1-osios kartos) smegenų ekrane nubrėžia stačiakampį.

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 `0`iki`359`.

Return Values

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

Notes

„IQ“ (1-osios kartos) smegenų ekranas yra nespalvotas, todėl nurodytos spalvos jame nebus rodomos.
Kontūro storis 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 pakeisti naudojant setOrigin.
Jei kuri nors stačiakampio dalis yra už ekrano ribų, piešiama tik matoma dalis.

Examples

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

drawCircle #

Nubrėžia apskritimą IQ (1-osios kartos) smegenų 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 `0`iki`359`.

Return Values

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

Notes

„IQ“ (1-osios kartos) smegenų ekranas yra nespalvotas, todėl nurodytos spalvos jame nebus rodomos.
Kontūro storis 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 pakeisti naudojant setOrigin.

Examples

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

render #

Įgalina dvigubą buferizavimą smegenų ekrane. Iškvietus, jokios piešimo funkcijos (pvz., tekstas ar formos) 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 laukiant vaizdavimo. `false` — Neleisti foninėms užduotims vykdyti laukiant vaizdavimo.

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 laukiant vaizdavimo.
false — Neleisti foninėms užduotims vykdyti laukiant vaizdavimo.

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