Scáileán#

Réamhrá #

Díorthaítear an rang screen ón rang bonn brain. Rialaíonn sé an chaoi a dtaispeánann an Inchinn IQ (1ú glúin) téacs agus luachanna ar a scáileán ionsuite.

Tacaíonn scáileán inchinne IQ (1ú glúin) le suas le 5 shraith agus 21 colún téacs.

An VEX IQ (1ú glúin) Inchinn le forleagan eangaí uimhrithe (colúin 1–21 agus sraitheanna 1–5). Aibhsíonn línte forleagan dearga struchtúr an eangaí, le saigheada ag lipéadú Colún 1, Colún 21, Sraith 1, Sraith 2, agus Sraith 5. Taispeánann an chéad shraith uimhreacha 1 go 21 trasna an bharr.

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 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 (teimhneach más féidir).
clearScreen — Glanann sé an scáileán ar fad (go dath sonraithe más mian leat).
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.
render — Cumasaíonn sé maolánú dúbailte nó rindreálann sé an maolán cúil don scáileán.

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

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

print #

Taispeánann sé téacs, uimhreacha, nó luachanna Booleánacha ar scáileán IQ (1ú glúin) Inchinne.

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é seo an cúrsóir go sraith agus colún ar leith ar scáileán IQ (1ú glúin) 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.
Ní dhéanann glaoch ar setCursor difear ach do shuíomh an aschuir téacs ina dhiaidh sin.

Examples

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

An scáileán inchinne IQ (1ú glúin) ag taispeáint téacs láraithe ag léamh “VEXcode!”.

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

An scáileán inchinne IQ (1ú glúin) ag taispeáint “An Chéad Teachtaireacht” agus “An Dara Teachtaireacht,” ar línte ar leithligh.

clearLine #

Glanann sé téacs as ró ar scáileán Inchinn IQ (1ú glúin).

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.
Is taispeántas monacrómach é scáileán IQ (1ú glúin) Brain, mar sin ní bheidh dathanna sonraithe le feiceáil ar an scáileán.

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 suíomh reatha an ró cúrsóra ar an scáileán IQ (1ú glúin) Brain ar ais.

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("row: ", Brain.Screen.row());

column #

Tugann sé seo an colún ar ais ina gclófar téacs ar scáileán Inchinn IQ (1ú glúin).

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.print("column: ", 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 IQ (1ú glúin) 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 IQ (1ú glúin) 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 IQ (1ú glúin) 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 cad a phriontáiltear 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 the number 1 at pixel (100, 40)
Brain.Screen.printAt(100, 40, 1);

clearScreen #

Scriosann sé gach líníocht agus téacs ó scáileán na hinchinne.

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.

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

Is taispeántas monacrómach é scáileán IQ (1ú glúin) Brain, mar sin ní bheidh dathanna sonraithe le feiceáil ar an scáileán.

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 #

Socraíonn sé seo an cló a úsáidtear le haghaidh téacs a thaispeántar ar scáileán IQ (1ú glúin) 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` Taispeántar na roghanna seo thíos.

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

Taispeántar na roghanna seo thíos.

Return Values

Ní thugann an fheidhm seo luach ar ais.

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 #

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

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`).

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 taispeántas monacrómach é scáileán IQ (1ú glúin) Brain, mar sin ní bheidh dathanna sonraithe le feiceáil ar an scáileán.

Examples

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

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`).

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 taispeántas monacrómach é scáileán IQ (1ú glúin) Brain, mar sin ní bheidh dathanna sonraithe le feiceáil ar an scáileán.

Examples

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

setOrigin #

Socraíonn sé an bunús a úsáidtear chun grafaicí a tharraingt ar scáileán an Inchinn.

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 bhunaidh i gcoibhneas le cúinne uachtarach na láimhe clé de scáileán na hinchinne ó 0 go 159.
`y`	`int32_t`	Suíomh-y an bhunaidh i gcoibhneas le cúinne uachtarach clé scáileáin na hinchinne ó 0 go 107.

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 159.
`y`	`int`	Comhordanáid y chúinne uachtarach na láimhe clé den réigiún gearrthóige, tugtha mar shlánuimhir ó 0 go 107.
`width`	`int`	Leithead réigiún an ghearrthóige i bpicteilíní, tugtha mar shlánuimhir ó 0 go 159.
`height`	`int`	Airde réigiún an ghearrthóige i bpicteilíní, tugtha mar shlánuimhir ó 0 go 107.

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 aonair ar scáileán Inchinn IQ (1ú glúin) ag an suíomh picteilín x agus y sonraithe.

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 159.
`y`	`int`	An comhordanáid y ina dtarraingeofar an picteilín, tugtha mar shlánuimhir ó 0 go 107.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

Is taispeántas monacrómach é scáileán IQ (1ú glúin) Brain, mar sin ní bheidh dathanna sonraithe le feiceáil ar an scáileán.
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 one pixel at the center 
// of the screen
Brain.Screen.drawPixel(80, 50);

drawLine #

Tarraingíonn líne dhíreach a nascann dhá phointe ar scáileán inchinne IQ (1ú glúin).

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 159.
`y1`	`int`	Comhordanáid y tosaigh na líne, tugtha mar shlánuimhir ó 0 go 107.
`x2`	`int`	Comhordanáid x deiridh na líne, tugtha mar shlánuimhir ó 0 go 159.
`y2`	`int`	Comhordanáid y deiridh na líne, tugtha mar shlánuimhir ó 0 go 107.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Notes

Is taispeántas monacrómach é scáileán IQ (1ú glúin) Brain, mar sin ní bheidh dathanna sonraithe le feiceáil ar an scáileán.
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, 159, 107);

drawRectangle #

Tarraingíonn sé dronuilleog ar scáileán inchinne IQ (1ú glúin) 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 159.
`y`	`int`	Comhordanáid y chúinne uachtarach na láimhe clé den dronuilleog, tugtha mar shlánuimhir ó 0 go 107.
`width`	`int`	Leithead na dronuilleoige, tugtha mar shlánuimhir ó 0 go 159.
`height`	`int`	Airde na dronuilleoige, tugtha mar shlánuimhir ó 0 go 107.
`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

Is taispeántas monacrómach é scáileán IQ (1ú glúin) Brain, mar sin ní bheidh dathanna sonraithe le feiceáil ar an scáileán.
Is é an leithead peann reatha atá socraithe le setPenWidth a chinneann tiús an imlíne.
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.

Examples

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

drawCircle #

Tarraingíonn sé ciorcal ar scáileán inchinne IQ (1ú glúin) 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 159.
`y`	`int`	Comhordanáid y lár an chiorcail, tugtha mar shlánuimhir ó 0 go 107.
`radius`	`int`	Ga an chiorcail, tugtha mar shlánuimhir ó 0 go 107 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

Is taispeántas monacrómach é scáileán IQ (1ú glúin) Brain, mar sin ní bheidh dathanna sonraithe le feiceáil ar an scáileán.
Is é an leithead peann reatha atá socraithe le setPenWidth a chinneann tiús an imlíne.
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 green circle on the screen
Brain.Screen.drawCircle(80, 50, 20, green);

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 nó cruthanna) le feiceáil láithreach don chuid eile den tionscadal. Ina áit sin, ní thaispeánfar nuashonruithe ach amháin nuair a úsáidtear rindreáil 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 rindreáil 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.

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