Scáileán

Réamhrá

Díorthaítear an rang screen ón rang bonn brain. Rialaíonn sé an chaoi a léiríonn an V5 Brain téacs, uimhreacha agus grafaicí ar a scáileán tadhaill, agus an chaoi a bhfreagraíonn sé d’ionchur tadhaill.

De réir réamhshocraithe, is é beag aonspáis an cló le haghaidh priontála chuig an Brain, ina bhfuil 12 shraith agus 48 colún.

Chun líníocht a dhéanamh, is é 480 x 240 picteilín taifeach na hinchinne.

Rochtain

Is féidir rochtain a fháil ar an rang screen trí:

Brain.Screen

Nótaí

• Soláthraíonn an Inchinn an réad screen Ní thógtar go díreach é.

• Úsáideann tionscadail réad domhanda aonair Brain , mar sin glaotar ar fheidhmeanna scáileáin ag baint úsáide as Brain.Screen.

Sampla

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

Feidhmeanna na mBall

Áirítear leis an rang screen na feidhmeanna ball seo a leanas:

• print — Priontálann sé téacs, uimhreacha, nó luachanna Booleánacha formáidithe chuig an scáileán Brain.

• setCursor — Bogann sé seo cúrsóir an téacs go dtí ró agus colún sonraithe.

• newLine — Glanann sé an chuid eile den líne reatha agus bogann sé an cúrsóir go dtí an chéad líne eile.

• clearLine — Glanann sé an chuid eile den líne reatha nó glanann sé líne shonraithe.

• row — Tugann sé seo an tsraith ar ais ina gclófar an téacs.

• column — Tugann sé seo an colún ar ais ina gclófar an téacs.

• getStringHeight — Tugann sé airde teaghráin ar ais i bpicteilíní ag baint úsáide as an gcló reatha.

• getStringWidth — Tugann sé leithead teaghráin ar ais i bpicteilíní ag baint úsáide as an gcló reatha.

• printAt — Priontálann sé téacs formáidithe ag suíomh picteilín x, y.

• clearScreen — Glanann sé seo na líníochtaí agus an téacs go léir ón scáileán Brain.

• setFont — Socraíonn sé seo an cló a úsáidtear le haghaidh priontála ar an scáileán.

• setPenWidth — Socraíonn sé tiús na línte tarraingthe agus imlínte na gcruthanna.

• setPenColor — Socraíonn sé dath an téacs, na bpicteilíní, na línte, agus imlínte an chrutha.

• setFillColor — Socraíonn sé an dath líonta do chruthanna tarraingthe agus do chúlraí téacs clóite.

• setOrigin — Socraíonn sé an bunús a úsáidtear do chomhordanáidí an scáileáin.

• setClipRegion — Cuireann sé srian ar aschur an scáileáin go réigiún dronuilleogach.

• drawPixel — Tarraingíonn sé picteilín amháin ag comhordanáid.

• drawLine — Tarraingíonn líne idir dhá phointe.

• drawRectangle — Tarraingíonn sé dronuilleog ag suíomh x, y le méid sonraithe.

• drawCircle — Tarraingíonn sé ciorcal ag suíomh x, y le ga sonraithe.

• drawImageFromFile — Tarraingíonn sé íomhá ó chomhad cárta SD ar an scáileán.

• render — Cumasaíonn sé maolánú dúbailte nó rindreálann sé an maolán cúil don scáileán.

• pressing — Tugann sé seo le fios an bhfuil an scáileán á bhrú faoi láthair.

• xPosition — Tugann sé seo comhordanáid-x an bhrú scáileáin is déanaí ar ais.

• yPosition — Tugann sé seo comhordanáid y an bhrú scáileáin is déanaí ar ais.

• pressed — Cláraíonn sé feidhm athghlaoite le rith nuair a bhrúitear an scáileán.

• released — Cláraíonn feidhm athghlaoite le rith nuair a scaoiltear an scáileán tar éis é a bhrú.

Sula nglaotar ar aon fheidhmeanna ball screen , ní mór sampla brain a chruthú, mar a thaispeántar thíos:

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

print

Taispeánann sé téacs, uimhreacha, nó luachanna Booleánacha ar scáileán V5 Brain.

Available Functions

1 — Priontáiltear téacs formáidithe ag baint úsáide as litriúla teaghrán nó teaghráin stíl C inléite amháin.

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

2 — Priontálann sé téacs formáidithe ag baint úsáide as eagair charachtar inathraithe.

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

Parameters

Paraiméadar	Cineál	Cur síos
format	const char*	Teaghrán formáide a chuirtear ar fáil mar theaghrán liteartha nó teaghrán stíl C inléite amháin (mar shampla, “Score: %d”).
format	char*	Teaghrán formáide a chuirtear ar fáil mar eagar carachtar inmhodhnaithe.
…		Luach amháin nó níos mó breise a chuirtear isteach sa teaghrán formáide, scartha le camóga.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Tosaíonn an t-aschur ag suíomh reatha an chúrsóra ar an scáileán.

• Úsáideann téacs clóite an cló scáileáin reatha .

• Úsáideann téacs clóite an dath pinn reatha .

• Priontáiltear téacs atá priontáilte le print i gcónaí le cúlra, agus is é an dath líonta reatha a chinneann dath an chúlra.

• Agus teaghrán formáide á úsáid, ní mór líon agus cineálacha na luachanna a chuirtear ar aghaidh a bheith mar an gcéanna leis na sonraitheoirí formáide sa teaghrán.

Examples

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

setCursor

Bogann sé an cúrsóir go dtí sraith agus colún ar leith ar scáileán V5 Brain. Tosóidh an chéad ghlao eile print ag priontáil ag an suíomh sin.

Available Functions

void setCursor(
  int32_t row, 
  int32_t col );

Parameters

Paraiméadar	Cineál	Cur síos
row	int32_t	An tsraith le bogadh an cúrsóir chuici.
col	int32_t	An colún le bogadh an cúrsóir chuige.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Bíonn tionchar aige ar an áit a dtosaíonn aschur téacs ina dhiaidh sin nuair a úsáidtear print.

• Tá sraitheanna agus colúin bunaithe ar an cló scáileáin atá socraithe faoi láthair.

• Úsáideann an cló réamhshocraithe (mono20) 12 shraith agus 48 colún.

• Ní dhéanann glaoch ar setCursor difear ach do shuíomh an aschuir téacs ina dhiaidh sin.

Examples

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

newLine

Bogann sé an cúrsóir go dtí tús an chéad ró eile ar an scáileán Inchinn.

Available Functions

void newLine();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Má tá an cúrsóir i lár abairte, glanfaidh newLine an chuid eile den tsraith i ndiaidh an chúrsóra sula mbogfar go dtí an chéad tsraith eile.

• Tar éis glaoch ar newLine, cuirtear an cúrsóir sa chéad cholún den chéad líne eile.

• Socraítear suíomh an chúrsóra agus uimhriú na sraithe ag baint úsáide as setCursor.

Examples

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

clearLine

Glanann sé téacs as ró ar scáileán V5 Brain.

Available Functions

1 — Glanann sé an chuid eile den líne reatha ó shuíomh an chúrsóra.

void clearLine();

2 — Glanann sé an tsraith shonraithe ag baint úsáide as an dath líonta atá cumraithe faoi láthair.

void clearLine(
    int number );

3 — Glanann sé an tsraith shonraithe ag baint úsáide as réad réamhshainithe nó dath saincheaptha.

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

4 — Glanann sé an tsraith shonraithe ag baint úsáide as luach datha heicsidheachúlach.

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

5 — Glanann sé an tsraith shonraithe ag baint úsáide as luach datha.

void clearLine(
    int number,
    int hue );

Parameters

Paraiméadar	Cineál	Cur síos
number	int	Uimhir na sraithe le glanadh. Tosaíonn uimhriú na sraithe ag 1.
color	const color&	Glanann sé an tsraith ag baint úsáide as réad color Áirítear leis seo na dathanna réamhshainithe: black white red green blue yellow orange purple cyan transparent Is féidir réad datha saincheaptha a úsáid freisin.
color	const char*	Glanann sé an tsraith ag baint úsáide as luach datha heicsidheachúlach (mar shampla, “#000000”).
hue	int	Glanann sé an tsraith ag baint úsáide as luach slánuimhir datha sa raon 0–359, a léiríonn céimeanna timpeall roth datha.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Ní athraíonn líne a ghlanadh suíomh reatha an chúrsóra.

• Socraítear suíomh an chúrsóra agus uimhriú na sraithe ag baint úsáide as setCursor.

• Tá luach an pharaiméadair hue bunaithe ar roth datha ciorclach, mar a thaispeántar thíos, áit a léiríonn luachanna céimeanna timpeall an rotha (mar shampla, dearg gar do 0°, glas gar do 120°, agus gorm gar do 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

Tugann sé seo an tsraith ar ais ina gclófar téacs ar scáileán V5 Brain.

Available Functions

int32_t row();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Tugann sé int32_t a léiríonn an tsraith ina bpriontálfar téacs.

Tosaíonn uimhriú na sraitheanna ag 1.

Notes

• Tá suíomh an chúrsóra bunaithe ar an gcló atá ar an scáileáin reatha.

• Léiríonn an luach a chuirtear ar ais cá háit a mbeidh an chéad aschur priontáilte eile le feiceáil.

• Athraíonn luach an tsraithe nuair a phriontáiltear téacs nó nuair a ghlaotar ar setCursor.

Examples

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

column

Tugann sé seo an colún ar ais ina gclófar téacs ar scáileán V5 Brain.

Available Functions

int32_t column();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Tugann sé int32_t a léiríonn an colún ina bpriontálfar téacs.

Tosaíonn uimhriú na gcolún ag 1.

Notes

• Tá suíomh an chúrsóra bunaithe ar an gcló atá ar an scáileáin reatha.

• Léiríonn an luach a chuirtear ar ais cá háit a mbeidh an chéad aschur priontáilte eile le feiceáil.

• Athraíonn luach an cholúin nuair a phriontáiltear téacs nó nuair a ghlaotar ar setCursor.

Examples

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

getStringHeight

Tugann sé airde teaghráin ar ais, i bpicteilíní, nuair a dhéantar í a rindreáil ar scáileán V5 Brain.

Available Functions

int32_t getStringHeight( 
    const char* cstr );

Parameters

Paraiméadar	Cineál	Cur síos
cstr	const char*	An téacs atá le tomhas, curtha ar fáil mar téacs stíl C (mar shampla, “Hello”).

Return Values

Tugann sé int32_t a léiríonn airde an tsreangáin i bpicteilíní nuair a dhéantar é a rindreáil ar an scáileán Brain.

Notes

• The returned height depends on the currently selected screen font.

• Tomhaiseann an fheidhm seo an teaghrán gan é a tharraingt chuig an scáileán.

• Léiríonn an airde a chuirtear ar ais an chuma a bheadh ​​ar an teaghrán nuair a phriontálfaí é.

getStringWidth

Tugann sé leithead teaghráin ar ais, i bpicteilíní, nuair a dhéantar é a rindreáil ar scáileán V5 Brain.

Available Functions

int32_t getStringWidth( 
    const char* cstr );

Parameters

Paraiméadar	Cineál	Cur síos
cstr	const char*	An téacs atá le tomhas, curtha ar fáil mar téacs stíl C (mar shampla, “Hello”).

Return Values

Tugann sé int32_t a léiríonn leithead an tsreangáin i bpicteilíní nuair a dhéantar é a rindreáil ar an scáileán Brain.

Notes

• The returned width depends on the currently selected screen font.

• Tomhaiseann an fheidhm seo an teaghrán gan é a tharraingt chuig an scáileán.

• Léiríonn an leithead a chuirtear ar ais an chuma a bheadh ​​ar an teaghrán nuair a phriontálfaí é.

printAt

Priontálann sé téacs, uimhreacha, nó luachanna Boole ag comhordanáid shonrach ar scáileán V5 Brain.

Available Functions

1 — Priontálann sé aschur formáidithe ag an suíomh picteilín sonraithe.

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

2 — Priontáiltear aschur formáidithe ag an suíomh picteilín sonraithe agus socraítear an bhfuil cúlra an téacs teimhneach nó trédhearcach.

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

Parameters

Paraiméadar	Cineál	Cur síos
x	int32_t	An suíomh-x le priontáil ann, i dtagairt do bhunús an scáileáin.
y	int32_t	An suíomh-y le priontáil ann, i dtagairt do bhunús an scáileáin.
bOpaque	bool	Rialaíonn sé seo an bhfuil an téacs clóite tarraingthe go teimhneach nó go trédhearcach: true — Líontar cúlra an téacs clóite ag baint úsáide as an dath líonta reatha. false — Tarraingítear an téacs go trédhearcach agus níl an cúlra líonta.
format	const char*	Teaghrán formáide a rialaíonn a bhfuil priontáilte ar an scáileán (mar shampla, “Score: %d”).
…		Luach amháin nó níos mó breise a chuirtear isteach sa teaghrán formáide, scartha le camóga.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Tá na comhordanáidí x agus y i gcoibhneas le bunús an scáileáin reatha, agus is féidir iad seo a athrú ag baint úsáide as setOrigin.

• Úsáideann téacs clóite an cló scáileáin reatha .

• Úsáideann téacs clóite an dath pinn reatha .

• Agus teaghrán formáide á úsáid, ní mór líon agus cineálacha na luachanna a chuirtear ar aghaidh a bheith mar an gcéanna leis na sonraitheoirí formáide sa teaghrán.

Examples

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

clearScreen

Scriosann sé gach líníocht agus téacs ón scáileán Brain agus athshocraíonn sé suíomh an chúrsóra go ró 1, colún 1.

Available Functions

1 — Glanann sé an scáileán go dubh.

void clearScreen();

2 — Glanann sé an scáileán ag baint úsáide as réad réamhshainithe nó dath saincheaptha.

void clearScreen(
    const color& color );

3 — Glanann sé an scáileán ag baint úsáide as luach datha heicsidheachúlach.

void clearScreen(
    const char* color );

4 — Glanann sé an scáileán ag baint úsáide as luach datha.

void clearScreen(
    int hue );

Parameters

Paraiméadar	Cineál	Cur síos
color	const color&	Clears the screen using a color object. Predefined colors include: black white red green blue yellow orange purple cyan transparent This can also use a custom color object.
color	const char*	Glanann sé an scáileán ag baint úsáide as luach datha heicsidheachúlach a léirítear mar theaghrán (mar shampla, “#000000”).
hue	int	Glanann sé an scáileán ag baint úsáide as luach slánuimhreach datha sa raon 0–359, a léiríonn céimeanna timpeall roth datha.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Tá luach an pharaiméadair hue bunaithe ar roth datha ciorclach, mar a thaispeántar thíos, áit a léiríonn luachanna céimeanna timpeall an rotha (mar shampla, dearg gar do 0°, glas gar do 120°, agus gorm gar do 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

Socraíonn sé an cló a úsáidtear le haghaidh téacs a thaispeántar ar scáileán V5 Brain.

Rialaíonn sé seo an cló a chuirtear i bhfeidhm ar aschur téacs ina dhiaidh sin nuair a úsáidtear feidhmeanna téacs scáileáin amhail print.

Available Functions

void setFont(
  fontType font );

Parameters

Paraiméadar	Cineál	Cur síos
font	fontType	Socraíonn sé seo an cló go ceann amháin díobh seo a leanas: mono12 mono15 mono20 mono30 mono40 mono60 prop20 prop30 prop40 prop60 fontType::cjk16 — Is féidir carachtair Síneacha, Seapánacha agus Cóiréacha a phriontáil. Sínis Shimplithe — Le feiceáil suas go dtí colún 28. Sínis Thraidisiúnta — Le feiceáil suas go dtí colún 28. Seapáinis (Kanji) — Le feiceáil suas go dtí colún 28. Cóiréis (Hangul) — Le feiceáil suas go dtí colún 30. Taispeántar na roghanna seo thíos.

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

Return Values

Ní thugann an fheidhm seo luach ar ais.

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

Socraíonn sé tiús na línte tarraingthe agus imlínte na gcruthanna.

Available Functions

void setPenWidth(
  uint32_t width );

Parameters

Paraiméadar	Cineál	Cur síos
width	uint32_t	Leithead an pheann, i bpicteilíní, ó 0 go 32.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Baineann leithead an pheann le feidhmeanna líníochta ar nós drawLine, drawRectangle, agus drawCircle.

Examples

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

setPenColor

Socraíonn sé dath an téacs, na bpicteilíní, na línte, agus imlínte na gcruthanna.

Available Functions

1 — Socraíonn sé dath an pheann ag baint úsáide as réad réamhshainithe nó dath saincheaptha.

void setPenColor(
    const color& color );

2 — Socraíonn sé dath an pheann ag baint úsáide as luach datha heicsidheachúlach.

void setPenColor(
    const char* color );

3 — Socraíonn sé dath an phinn ag baint úsáide as luach datha.

void setPenColor(
    int hue );

Parameters

Paraiméadar	Cineál	Cur síos
color	const color&	Socraíonn sé dath an pheann ag baint úsáide as réad le dath color Áirítear leis na dathanna réamhshainithe: black white red green blue yellow orange purple cyan transparent
color	const char*	Socraíonn sé dath an pheann ag baint úsáide as luach datha heicsidheachúlach a léirítear mar theaghrán (mar shampla, “#FF0000”).
hue	int	Socraíonn sé dath an pheann ag baint úsáide as luach slánuimhir lí sa raon 0–359, a léiríonn céimeanna timpeall roth datha (mar shampla, is dearg é 0 , is glas é 120 , agus is gorm é 240).

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Is é white an dath peann réamhshocraithe ag tús tionscadail.

• Úsáidtear dath an pheann le haghaidh imlínte cruthanna (mar shampla le drawCircle nó drawRectangle), aschur téacs agus uimhriúil (le print agus printAt), agus picteilíní aonair a tharraingítear le drawPixel.

• Tá luach an pharaiméadair hue bunaithe ar roth datha ciorclach, mar a thaispeántar thíos, áit a léiríonn luachanna céimeanna timpeall an rotha (mar shampla, dearg gar do 0°, glas gar do 120°, agus gorm gar do 240°).

Examples

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

setFillColor

Socraíonn sé an dath líonta a úsáidtear nuair a tharraingítear cruthanna.

Available Functions

1 — Socraíonn sé an dath líonta ag baint úsáide as réad réamhshainithe nó dath saincheaptha.

void setFillColor(
    const color& color );

2 — Socraíonn sé an dath líonta ag baint úsáide as luach datha heicsidheachúlach.

void setFillColor(
    const char* color );

3 — Socraíonn sé an dath líonta ag baint úsáide as luach datha.

void setFillColor(
    int hue );

Parameters

Paraiméadar	Cineál	Cur síos
color	const color&	Socraíonn sé an dath líonta ag baint úsáide as réad color Áirítear leis na dathanna réamhshainithe: black white red green blue yellow orange purple cyan transparent
color	const char*	Socraíonn sé an dath líonta ag baint úsáide as luach datha heicsidheachúlach a léirítear mar theaghrán (mar shampla, “#00FF00”).
hue	int	Socraíonn sé seo an dath líonta ag baint úsáide as luach slánuimhir lí sa raon 0–359, a léiríonn céimeanna timpeall roth datha (mar shampla, is dearg é 0 , is glas é 120 , agus is gorm é 240).

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Is é black an dath líonta réamhshocraithe ag tús tionscadail.

• Úsáidtear an dath líonta le haghaidh taobh istigh de chruthanna (mar shampla le drawCircle nó drawRectangle).

• Úsáidtear an dath líonta mar dhath cúlra do théacs clóite (mar shampla le print agus printAt).

  • Má úsáidtear transparent le téacs clóite, beidh an cúlra black.

• Tá luach an pharaiméadair hue bunaithe ar roth datha ciorclach, mar a thaispeántar thíos, áit a léiríonn luachanna céimeanna timpeall an rotha (mar shampla, dearg gar do 0°, glas gar do 120°, agus gorm gar do 240°).

Examples

// Draw a rectangle filled with purple
  Brain.Screen.setFillColor(purple);
  Brain.Screen.drawRectangle(50, 100, 130, 60);

setOrigin

Socraíonn sé an bunús a úsáidtear le haghaidh líníochta agus priontáil bunaithe ar chomhordanáidí ar an scáileán Brain.

Available Functions

void setOrigin(
  int32_t x,
  int32_t y );

Parameters

Paraiméadar	Cineál	Cur síos
x	int32_t	Suíomh-x an bhunphointe i gcoibhneas leis an gcúinne uachtarach ar chlé den scáileán Brain ó 0 go 479.
y	int32_t	Suíomh-y an bhunphointe i gcoibhneas leis an gcúinne uachtarach ar chlé den scáileán Brain ó 0 go 239.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Is é an bunús réamhshocraithe cúinne uachtarach na láimhe clé den scáileán ag comhordanáid (0, 0).

• Baineann an bunús le feidhmeanna comhordanáideacha ar nós drawLine, drawRectangle, drawCircle, agus printAt.

• Fanann an bunús i bhfeidhm go dtí go n-athraítear arís é nó go ndéantar an tionscadal a athshocrú.

setClipRegion

Sainmhíníonn sé seo limistéar dronuilleogach ar an scáileán ina mbeidh gach líníocht agus téacs teoranta. Ní thaispeánfar aon ábhar lasmuigh den réigiún seo.

Available Functions

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

Parameters

Paraiméadar	Cineál	Cur síos
x	int	Comhordanáid-x chúinne uachtarach na láimhe clé den réigiún gearrthóige, tugtha mar shlánuimhir ó 0 go 479.
y	int	Comhordanáid y chúinne uachtarach na láimhe clé den réigiún gearrthóige, tugtha mar shlánuimhir ó 0 go 239.
width	int	Leithead réigiún an ghearrthóige i bpicteilíní, tugtha mar shlánuimhir ó 0 go 479.
height	int	Airde réigiún an ghearrthóige i bpicteilíní, tugtha mar shlánuimhir ó 0 go 239.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Déantar feidhmeanna líníochta a fhorghníomhú fós fiú má thiteann siad lasmuigh den réigiún ghearrthóige, ach ní fheictear ach an chuid atá laistigh den réigiún.

• Tá na comhordanáidí x agus y i gcoibhneas le bunús an scáileáin reatha, agus is féidir iad seo a athrú ag baint úsáide as setOrigin.

• Ní bhaineann an réigiún gearrthóige ach leis an snáithe reatha.

• Cuireann socrú réigiún gearrthóige nua in ionad aon réigiúin gearrthóige a socraíodh roimhe seo don snáithe reatha.

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

Tarraingíonn sé picteilín amháin ar scáileán V5 Brain ag an suíomh picteilín x agus y roghnaithe.

Available Functions

void drawPixel(
  int x,
  int y );

Parameters

Paraiméadar	Cineál	Cur síos
x	int	An comhordanáid-x ina dtarraingeofar an picteilín, tugtha mar shlánuimhir ó 0 go 479.
y	int	An comhordanáid y ina dtarraingeofar an picteilín, tugtha mar shlánuimhir ó 0 go 239.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Déantar picteilíní a tharraingt ag baint úsáide as an dath peann reatha atá socraithe le setPenColor.

• Tá na comhordanáidí x agus y i gcoibhneas le bunús an scáileáin reatha, ar féidir é sin a shocrú ag baint úsáide as setOrigin.

• Mura bhfuil an suíomh picteilín sonraithe lasmuigh de theorainneacha an scáileáin, ní tharraingítear an picteilín.

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

Tarraingíonn líne dhíreach a nascann dhá phointe ar scáileán V5 Brain.

Available Functions

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

Parameters

Paraiméadar	Cineál	Cur síos
x1	int	Comhordanáid x tosaigh na líne, tugtha mar shlánuimhir ó 0 go 479.
y1	int	Comhordanáid y tosaigh na líne, tugtha mar shlánuimhir ó 0 go 239.
x2	int	Comhordanáid x deiridh na líne, tugtha mar shlánuimhir ó 0 go 479.
y2	int	Comhordanáid y deiridh na líne, tugtha mar shlánuimhir ó 0 go 239.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Tarraingítear línte ag baint úsáide as an dath pinn reatha atá socraithe le setPenColor.

• Is é leithead an phinn reatha atá socraithe le setPenWidth a chinneann leithead na líne.

• Tá na comhordanáidí x agus y i gcoibhneas le bunús an scáileáin reatha, ar féidir é sin a shocrú ag baint úsáide as setOrigin.

• Má luíonn aon chuid den líne lasmuigh de theorainneacha an scáileáin, ní tharraingítear ach an chuid atá le feiceáil.

Examples

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

drawRectangle

Tarraingíonn sé dronuilleog ar scáileán V5 Brain ag an suíomh agus méid sonraithe.

Available Functions

1 — Tarraingíonn agus líonann sé dronuilleog ag baint úsáide as an dath líonta atá cumraithe faoi láthair.

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

2 — Tarraingíonn agus líonann sé dronuilleog ag baint úsáide as réad réamhshainithe nó dath saincheaptha.

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

3 — Tarraingíonn agus líonann sé dronuilleog ag baint úsáide as luach datha heicsidheachúlach.

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

4 — Tarraingíonn agus líonann sé dronuilleog ag baint úsáide as luach datha.

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

Parameters

Paraiméadar	Cineál	Cur síos
x	int	Comhordanáid-x chúinne uachtarach na láimhe clé den dronuilleog, tugtha mar shlánuimhir ó 0 go 479.
y	int	Comhordanáid y chúinne uachtarach na láimhe clé den dronuilleog, tugtha mar shlánuimhir ó 0 go 239.
width	int	Leithead na dronuilleoige, tugtha mar shlánuimhir ó 0 go 479.
height	int	Airde na dronuilleoige, tugtha mar shlánuimhir ó 0 go 239.
color	const color&	Líonann sé an dronuilleog ag baint úsáide as réad color Áirítear leis seo na dathanna réamhshainithe: black white red green blue yellow orange purple cyan transparent Is féidir réad datha saincheaptha a úsáid freisin.
color	const char*	Líonann sé an dronuilleog ag baint úsáide as luach datha heicsidheachúlach (mar shampla, “#FF0000”).
hue	int	Líonann sé an dronuilleog ag baint úsáide as luach datha sa raon 0–359.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Tarraingítear imlíne an dronuilleoige ag baint úsáide as an dath peann reatha atá socraithe le setPenColor.

• Is é an leithead peann reatha atá socraithe le setPenWidth a chinneann tiús an imlíne.

• Nuair nach soláthraítear aon pharaiméadar color , líontar taobh istigh an dronuilleoige ag baint úsáide as an dath líonta reatha atá socraithe le setFillColor.

• Tá na comhordanáidí x agus y i gcoibhneas le bunús an scáileáin reatha, agus is féidir iad seo a athrú ag baint úsáide as setOrigin.

• Má luíonn aon chuid den dronuilleog lasmuigh de theorainneacha an scáileáin, ní tharraingítear ach an chuid atá infheicthe.

• Tá luach an pharaiméadair hue bunaithe ar roth datha ciorclach, mar a thaispeántar thíos, áit a léiríonn luachanna céimeanna timpeall an rotha (mar shampla, dearg gar do 0°, glas gar do 120°, agus gorm gar do 240°).

Examples

// Draw a rectangle on the screen
Brain.Screen.drawRectangle(50, 50, 130, 60);

drawCircle

Tarraingíonn sé ciorcal ar scáileán V5 Brain ag an suíomh agus ga sonraithe.

Available Functions

1 — Tarraingíonn agus líonann sé ciorcal ag baint úsáide as an dath líonta atá cumraithe faoi láthair.

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

2 — Tarraingíonn agus líonann sé ciorcal ag baint úsáide as réad réamhshainithe nó dath saincheaptha.

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

3 — Tarraingíonn agus líonann sé ciorcal ag baint úsáide as luach datha heicsidheachúlach.

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

4 — Tarraingíonn agus líonann sé ciorcal ag baint úsáide as luach datha.

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

Parameters

Paraiméadar	Cineál	Cur síos
x	int	Comhordanáid-x lár an chiorcail, tugtha mar shlánuimhir ó 0 go 479.
y	int	Comhordanáid y lár an chiorcail, tugtha mar shlánuimhir ó 0 go 239.
radius	int	Ga an chiorcail, tugtha mar shlánuimhir ó 0 go 239 picteilín.
color	const color&	Líonann sé an ciorcal ag baint úsáide as réad color Áirítear leis seo na dathanna réamhshainithe: black white red green blue yellow orange purple cyan transparent Is féidir réad datha saincheaptha a úsáid freisin.
color	const char*	Líonann sé an ciorcal ag baint úsáide as luach datha heicsidheachúlach (mar shampla, “#FF0000”).
hue	int	Líonann sé an ciorcal ag baint úsáide as luach datha sa raon 0–359.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Tarraingítear imlíne an chiorcail ag baint úsáide as an dath peann reatha atá socraithe le setPenColor.

• Is é an leithead peann reatha atá socraithe le setPenWidth a chinneann tiús an imlíne.

• Nuair nach soláthraítear aon pharaiméadar color , líontar taobh istigh an chiorcail ag baint úsáide as an dath líonta reatha atá socraithe le setFillColor.

• Tá na comhordanáidí x agus y i gcoibhneas le bunús an scáileáin reatha, agus is féidir iad seo a athrú ag baint úsáide as setOrigin.

• Tá luach an pharaiméadair hue bunaithe ar roth datha ciorclach, mar a thaispeántar thíos, áit a léiríonn luachanna céimeanna timpeall an rotha (mar shampla, dearg gar do 0°, glas gar do 120°, agus gorm gar do 240°).

Examples

// Draw a circle on the screen
Brain.Screen.drawCircle(240, 120, 40);

drawImageFromFile

Tarraingíonn sé íomhá ar scáileán V5 Brain ag baint úsáide as comhad íomhá atá stóráilte ar an cárta SD.

Available Functions

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

Parameters

Paraiméadar	Cineál	Cur síos
name	const char*	Ainm comhaid na híomhá ar an gcárta SD. Ní mór síneadh .bmp nó .png a bheith ag an gcomhad.
x	int	An comhordanáid-x, i bpicteilíní ó 0 go 479, ag a dtarraingeofar imeall clé na híomhá.
y	int	An comhordanáid-y, i bpicteilíní ó 0 go 239, ag a dtarraingeofar imeall uachtarach na híomhá.

Return Values

Tugann sé seo luach Booleach ar ais a léiríonn an ndearnadh an íomhá a tharraingt go rathúil:

• true — Luchtaíodh agus tarraingíodh an íomhá go rathúil ar an scáileán.
• false — Níorbh fhéidir an íomhá a tharraingt (mar shampla, mura bhfuil an comhad ann nó má tá sé neamhbhailí).

Notes

• Is iad na formáidí íomhá a dtacaítear leo ná .bmp agus .png.

• Ní mór don chomhad íomhá a bheith níos mó ná 512 KB.

  • Moltar ionchódú RLE 8-giotán chun méid an chomhaid a íoslaghdú.

• Is iad uasmhéid na toisí íomhá a dtacaítear leo ná méid an scáileáin Brain (thart ar 479 x 239 picteilín).

• Tá na comhordanáidí x agus y i gcoibhneas le bunús an scáileáin reatha, agus is féidir iad seo a athrú ag baint úsáide as setOrigin.

Examples

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

render

Cumasaíonn sé maolánú dúbailte do scáileán na hInchinne. Nuair a ghlaofar air, ní bheidh aon fheidhmeanna líníochta (cosúil le téacs, cruthanna, nó íomhánna) le feiceáil láithreach don chuid eile den tionscadal. Ina áit sin, ní thaispeánfar nuashonruithe ach amháin nuair a úsáidtear render arís. Ligeann sé seo do nuashonruithe scáileáin a bheith níos réidhe agus níos rialaithe, ach ciallaíonn sé nach mbeidh aon rud le feiceáil go dtí go n-úsáidtear render.

Available Functions

1 — Cumasaíonn sé maolánú dúbailte nó rindreálann sé an maolán cúil don scáileán.

bool render();

2 — Rindreálann sé an maolán cúil don scáileán le rialú ar iompar sioncrónaithe ingearach agus forghníomhú sceidealóra roghnach.

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

Parameters

Paraiméadar	Cineál	Cur síos
bVsyncWait	bool	​ true — Fan go dtí go ndéanfar athnuachan ingearach an scáileáin sula ndéantar rindreáil chun stróiceadh amhairc a laghdú. false — Ná fan go dtí go ndéanfar athnuachan ingearach an scáileáin sula ndéantar rindreáil.
bRunScheduler	bool	Roghnach. true (réamhshocraithe) — Ceadaigh do thascanna cúlra rith agus tú ag fanacht le rindreáil. false — Ná lig do thascanna cúlra rith agus tú ag fanacht le rindreáil.

Return Values

Tugann sé seo luach Booleach ar ais a léiríonn an ndearnadh na líníochtaí sábháilte sa mhaolán a rindreáil go rathúil ar an scáileán:

• true — Rinneadh na líníochtaí a rindreáil go rathúil ar an scáileán.
• false — Níorbh fhéidir na líníochtaí a rindreáil ar an scáileán.
Notes

• Má ghlaonn tú render beidh ort render a úsáid don chuid eile den tionscadal.

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

Tuairiscíonn sé an bhfuil an scáileán V5 Brain á bhrú faoi láthair.

Available Functions

bool pressing();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Tugann sé seo luach Booleach ar ais a léiríonn staid bhrúite reatha an scáileáin:true — Tá an scáileán á bhrú faoi láthair. nó false — Níl an scáileán á bhrú.

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

Tugann sé seo comhordanáid-x an bhrú dheireanaigh ar an scáileán V5 Brain ar ais.

Available Functions

int32_t xPosition();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Tugann sé int32_t a léiríonn comhordanáid-x, i bpicteilíní ó 0 go 479, den bhrú scáileáin dheireanach.

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

Tugann sé seo comhordanáid y na brúighe deireanaí ar an scáileán V5 Brain ar ais.

Available Functions

int32_t yPosition();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Tugann sé int32_t a léiríonn comhordanáid y, i bpicteilíní ó 0 go 239, den bhrú scáileáin dheireanach.

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

Cláraíonn sé feidhm le glaoch uirthi nuair a bhrúitear an scáileán V5 Brain.

Available Functions

1 — Glaonn feidhm nuair a bhrúnn tú an scáileán.

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

2 — Glaonn sé feidhm nuair a bhrúitear an scáileán agus cuireann sé argóint shainithe ag an úsáideoir chuig an bhfeidhm athghlaoite.

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

Parameters

Paraiméadar	Cineál	Cur síos
callback	void (*)(void)	Feidhm a ghlaoitear nuair a bhrúitear an scáileán.
callback	void ()(void)	Feidhm a ghlaoitear nuair a bhrúitear an scáileán agus a fhaigheann argóint atá sainithe ag an úsáideoir.
arg	void*	Luach sainmhínithe ag an úsáideoir a chuirtear chuig an fheidhm athghlaoite nuair a bhrúnn tú an scáileán.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Déantar an fheidhm athghlao a fhorghníomhú gach uair a bhrúnn tú an scáileán Brain.

• Ní féidir ach feidhm athghlaoite amháin a chlárú ag an am céanna; má bhrúitear pressed cuirtear an athghlao roimhe sin in ionad na feidhm athghlaoite roimhe sin.

• Caithfidh an fheidhm athghlaoite void a thabhairt ar ais.

Examples

Sainmhínigh an fheidhm athghlaoite (lasmuigh de 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);
}

Cláraigh an glao ar ais taobh istigh de int main()

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

Cláraíonn sé feidhm le glaoch uirthi nuair a scaoiltear an scáileán V5 Brain tar éis é a bhrú.

Available Functions

1 — Glaonn feidhm nuair a scaoiltear an scáileán tar éis é a bhrú.

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

2 — Glaonn sé feidhm nuair a scaoiltear an scáileán tar éis é a bhrú agus cuireann sé argóint shainithe ag an úsáideoir chuig an bhfeidhm athghlaoite.

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

Parameters

Paraiméadar	Cineál	Cur síos
callback	void (*)(void)	Feidhm a ghlaoitear nuair a scaoiltear an scáileán tar éis é a bhrú.
callback	void ()(void)	Feidhm a ghlaoitear nuair a scaoiltear an scáileán tar éis é a bhrú agus a fhaigheann argóint atá sainithe ag an úsáideoir.
arg	void*	Luach sainmhínithe ag an úsáideoir a chuirtear chuig an fheidhm athghlaoite nuair a scaoiltear an scáileán tar éis é a bhrú.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

• Déantar an fheidhm athghlaoite a fhorghníomhú gach uair a scaoiltear an scáileán Brain tar éis é a bhrú.

• Ní féidir ach feidhm athghlaoite amháin a chlárú ag an am céanna; má ghlaonn tú released arís, cuirtear an athghlao roimhe sin in ionad an ghlaoite ais roimhe sin.

• Caithfidh an fheidhm athghlaoite void a thabhairt ar ais.

Examples

Sainmhínigh an fheidhm athghlaoite (lasmuigh de 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);
}

Cláraigh an glao ar ais taobh istigh de int main()

int main() {
  int releaseCount = 0;

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

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