Näyttö#

Johdanto#

screen -luokka on johdettu brain -perusluokasta. Se ohjaa sitä, miten IQ (1. sukupolven) aivot näyttävät tekstiä ja arvoja sisäänrakennetulla näytöllään.

IQ (1. sukupolvi) Brain -näyttö tukee jopa viittä riviä ja 21 saraketta tekstiä.

VEX IQ (1. sukupolvi) -aivot numeroidulla ruudukolla (sarakkeet 1–21 ja rivit 1–5). Punaiset viivat korostavat ruudukkorakenneta, ja nuolet osoittavat sarakkeen 1, sarakkeen 21, rivin 1, rivin 2 ja rivin 5. Ensimmäisellä rivillä näkyvät numerot 1–21 yläreunassa.

Pääsy#

screen -luokkaan pääsee käsiksi seuraavasti:

Brain.Screen

Muistiinpanoja#

  • Aivot tarjoavat screen -objektin. Sitä ei konstruoida suoraan.

  • Projektit käyttävät yhtä globaalia Brain -objektia, joten screen-funktioita kutsutaan käyttämällä Brain.Screen -objektia.

Esimerkki#

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

Jäsenten toiminnot#

screen -luokka sisältää seuraavat jäsenfunktiot:

  • print — Tulostaa muotoiltua tekstiä, numeroita tai totuusarvoja Brain-näytölle.

  • setCursor — Siirtää tekstikohdistimen määritettyyn riviin ja sarakkeeseen.

  • newLine — Tyhjentää nykyisen rivin loppuosan ja siirtää kohdistimen seuraavalle riville.

  • clearLine — Tyhjentää nykyisen rivin loppuosan tai tyhjentää määritetyn rivin.

  • row — Palauttaa rivin, jolle teksti tulostetaan.

  • column — Palauttaa sarakkeen, johon teksti tulostetaan.

  • getStringHeight — Palauttaa merkkijonon korkeuden pikseleinä käyttäen nykyistä fonttia.

  • getStringWidth — Palauttaa merkkijonon leveyden pikseleinä käyttäen nykyistä fonttia.

  • printAt — Tulostaa muotoiltua tekstiä x- ja y-pikselisijaintiin (valinnainen läpinäkymätön).

  • clearScreen — Tyhjentää koko näytön (valinnainen, määritettyyn väriin).

  • setFont — Asettaa näytölle tulostettaessa käytettävän fontin.

  • setPenWidth — Asettaa piirrettyjen viivojen ja ääriviivojen paksuuden.

  • setPenColor — Asettaa tekstin, pikseleiden, viivojen ja ääriviivojen värin.

  • setFillColor — Asettaa piirrettyjen muotojen ja tulostettujen tekstitaustojen täyttövärin.

  • setOrigin — Asettaa näyttökoordinaattien alkuperän.

  • setClipRegion — Rajoittaa näytön tulosteen suorakaiteen muotoiseen alueeseen.

  • drawPixel — Piirtää yhden pikselin koordinaattiin.

  • drawLine — Piirtää viivan kahden pisteen välille.

  • drawRectangle — Piirtää x- ja y-koordinaatteihin suorakulmion määritetyllä koolla.

  • drawCircle — Piirtää ympyrän x- ja y-koordinaateissa määritetyllä säteellä.

  • render — Ottaa käyttöön kaksoispuskuroinnin tai renderöi takapuskurin näytölle.

Ennen minkään screen -jäsenfunktion kutsumista on luotava brain -instanssi alla olevan mukaisesti:

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

print#

Näyttää tekstiä, numeroita tai loogisia arvoja IQ (1. sukupolvi) aivojen näytössä.

Available Functions

1 — Tulostaa muotoiltua tekstiä käyttämällä merkkijonoliteraaleja tai vain luettavia C-tyylisiä merkkijonoja.

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

2 — Tulostaa muotoiltua tekstiä muokattavia merkistötaulukoita käyttäen.

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

Parametri

Tyyppi

Kuvaus

format

const char*

Muotoilumerkkijono, joka annetaan merkkijonoliteraalina tai vain luettavana C-tyylisenä merkkijonona (esimerkiksi “Score: %d”).

format

char*

Muokattavana merkkijonona annettu muotoilumerkkijono.

…

Yksi tai useampi lisäarvo, jotka lisätään muotoilumerkkijonoon pilkuilla erotettuna.
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • Tuloste alkaa näytöllä kohdistimen nykyisestä sijainnista .

  • Tulostettu teksti käyttää nykyistä näytön fonttia .

  • Tulostetussa tekstissä käytetään nykyistä kynän väriä .

  • Teksti, joka tulostetaan arvolla print tulostetaan aina taustan kanssa, ja taustavärin määrää nykyinen täyttöväri

  • Muotoilumerkkijonoa käytettäessä välitettävien arvojen lukumäärän ja tyyppien on vastattava merkkijonon muotoilumäärittelijöitä.

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

setCursor#

Siirtää kohdistimen tiettyyn riviin ja sarakkeeseen IQ (1. sukupolvi) Brain -näytössä. Seuraava print -kutsu aloittaa tulostuksen tästä kohdasta.

Available Functions 
void setCursor(
  int32_t row, 
  int32_t col );
Parameters

Parametri

Tyyppi

Kuvaus

row

int32_t

Rivi, johon kohdistin siirretään.

col

int32_t

Sarake, johon kohdistin siirretään.
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • Vaikuttaa siihen, mistä seuraava tekstituloste alkaa käytettäessä print.

  • Rivit ja sarakkeet perustuvat nykyiseen asetettuun näyttöfonttiin.

  • Funktion setCursor kutsuminen vaikuttaa vain seuraavan tekstitulosteen sijaintiin.

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

Älykkyysosamäärää (1. sukupolvi) käyttävä aivonäyttö, jossa näkyy keskitetty teksti ”VEXcode!”.

newLine#

Siirtää kohdistimen Brain-näytön seuraavan rivin alkuun.

Available Functions 
void newLine();
Parameters

Tämä funktio ei hyväksy parametreja.

Return Values

Tämä funktio ei palauta arvoa.

Notes

  • Jos kohdistin on lauseen keskellä, newLine tyhjentää lopun rivin kohdistimen jälkeen ennen siirtymistä seuraavalle riville.

  • Kun funktiota newLinekutsutaan, kursori sijoitetaan seuraavan rivin ensimmäiseen sarakkeeseen.

  • Kohdistimen sijainti ja rivinumerointi asetetaan käyttämällä setCursor.

Examples 
// Display two lines of text
Brain.Screen.print("First message");
Brain.Screen.newLine();
Brain.Screen.print("Second message");

Älykkyysosamäärän (1. sukupolvi) aivojen näytössä näkyvät "Ensimmäinen viesti" ja "Toinen viesti" erillisillä riveillä.

clearLine#

Tyhjentää tekstin riviltä IQ (1. sukupolvi) Brain -näytössä.

Available Functions

1 — Tyhjentää nykyisen rivin lopun kohdistimen sijainnista.

void clearLine();

2 — Tyhjentää määritetyn rivin käyttämällä nykyistä määritettyä täyttöväriä.

void clearLine(
    int number );

3 — Tyhjentää määritetyn rivin käyttämällä ennalta määritettyä tai mukautettua väriä objektia.

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

4 — Tyhjentää määritetyn rivin käyttämällä heksadesimaaliväriarvoa.

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

5 — Tyhjentää määritetyn rivin käyttäen sävyarvoa.

void clearLine(
    int number,
    int hue );
Parameters

Parametri

Tyyppi

Kuvaus

number

int

Tyhjennettävän rivin numero. Rivien numerointi alkaa numerosta 1.

color

const color&

Clears the row 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*

Tyhjentää rivin käyttämällä heksadesimaaliväriarvoa (esimerkiksi “#000000”).

hue

int

Tyhjentää rivin käyttämällä kokonaislukuista sävyn arvoa väliltä 0359, joka edustaa asteita väriympyrän ympärillä.
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • Rivin tyhjentäminen ei muuta kohdistimen nykyistä sijaintia.

  • Kohdistimen sijainti ja rivinumerointi asetetaan käyttämällä setCursor.

  • IQ (1. sukupolvi) Brain -näyttö on yksivärinen, joten tietyt värit eivät näy näytöllä.

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#

Palauttaa kohdistimen nykyisen rivin sijainnin IQ (1. sukupolvi) Brain -näytössä.

Available Functions 
int32_t row();
Parameters

Tämä funktio ei hyväksy parametreja.

Return Values

Palauttaa arvon int32_t joka edustaa riviä, jolle teksti tulostetaan.

Rivien numerointi alkaa numerosta 1.

Notes

  • Kohdistimen sijainti perustuu nykyiseen näytön fonttiin .

  • Palautettu arvo osoittaa, missä seuraava tulostettu tuloste näkyy.

  • Rivin arvo muuttuu, kun teksti tulostetaan tai kun setCursor kutsutaan.

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

column#

Palauttaa sarakkeen, johon teksti tulostetaan IQ (1. sukupolvi) aivojen näytöllä.

Available Functions 
int32_t column();
Parameters

Tämä funktio ei hyväksy parametreja.

Return Values

Palauttaa arvon int32_t joka edustaa saraketta, johon teksti tulostetaan.

Sarakkeiden numerointi alkaa numerosta 1.

Notes

  • Kohdistimen sijainti perustuu nykyiseen näytön fonttiin .

  • Palautettu arvo osoittaa, missä seuraava tulostettu tuloste näkyy.

  • Sarakkeen arvo muuttuu, kun teksti tulostetaan tai kun setCursor kutsutaan.

Examples 
// Display the cursor's current column
Brain.Screen.print("column: ", Brain.Screen.column());

getStringHeight#

Palauttaa merkkijonon korkeuden pikseleinä, kun se renderöidään IQ (1. sukupolvi) Brain -näytössä.

Available Functions 
int32_t getStringHeight( 
    const char* cstr );
Parameters

Parametri

Tyyppi

Kuvaus

cstr

const char*

Mitattava teksti, joka annetaan C-tyylisenä merkkijonona (esimerkiksi “Hello”).
Return Values

Palauttaa arvon int32_t joka edustaa merkkijonon korkeutta pikseleinä Brain-näytössä renderöidyssä muodossa.

Notes

  • Palautettu korkeus riippuu valitusta näyttöfontista.

  • Tämä funktio mittaa merkkijonon piirtämättä sitä näytölle.

  • Palautettu korkeus heijastaa sitä, miltä merkkijono näyttäisi tulostettuna.

getStringWidth#

Palauttaa merkkijonon leveyden pikseleinä, kun se renderöidään IQ (1. sukupolvi) Brain -näytössä.

Available Functions 
int32_t getStringWidth( 
    const char* cstr );
Parameters

Parametri

Tyyppi

Kuvaus

cstr

const char*

Mitattava teksti, joka annetaan C-tyylisenä merkkijonona (esimerkiksi “Hello”).
Return Values

Palauttaa arvon int32_t joka edustaa merkkijonon leveyttä pikseleinä, kun se renderöidään Brain-näytöllä.

Notes

  • Palautettu leveys riippuu valitusta näyttöfontista.

  • Tämä funktio mittaa merkkijonon piirtämättä sitä näytölle.

  • Palautettu leveys heijastaa sitä, miltä merkkijono näyttäisi tulostettuna.

printAt#

Tulostaa tekstiä, numeroita tai loogisia arvoja tietyssä koordinaatissa IQ (1. sukupolvi) aivojen näytöllä.

Available Functions

1 — Tulostaa muotoillun tulosteen määritettyyn pikselisijaintiin.

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

2 — Tulostaa muotoillun tulosteen määritettyyn pikselisijaintiin ja määrittää, onko tekstin tausta läpinäkymätön vai peittävä.

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

Parametri

Tyyppi

Kuvaus

x

int32_t

Tulostettava x-sijainti, viitaten näytön lähtöpisteeseen.

y

int32_t

Tulostettava y-akselin sijainti suhteessa näytön lähtöpisteeseen.

bOpaque

bool

Määrittää, piirretäänkö tulostettava teksti läpinäkymättömäksi vai läpinäkyväksi:

  • true — Tulostettavan tekstin tausta täytetään käyttämällä nykyistä täyttöväriä.
  • false — Teksti piirretään läpinäkyväksi eikä taustaa täytetä.

format

const char*

Muotoilumerkkijono, joka määrittää, mitä näytölle tulostetaan (esimerkiksi “Score: %d”).

…

Yksi tai useampi lisäarvo, jotka lisätään muotoilumerkkijonoon pilkuilla erotettuna.
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • Koordinaatit x ja y ovat suhteessa nykyiseen näytön nollapisteeseen, jota voidaan muuttaa käyttämällä setOrigin.

  • Tulostettu teksti käyttää nykyistä näytön fonttia .

  • Tulostetussa tekstissä käytetään nykyistä kynän väriä .

  • Muotoilumerkkijonoa käytettäessä välitettävien arvojen lukumäärän ja tyyppien on vastattava merkkijonon muotoilumäärittelijöitä.

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

clearScreen#

Poistaa kaikki piirrokset ja tekstin aivojen näytöltä.

Available Functions

1 — Tyhjentää näytön mustaksi.

void clearScreen();

2 — Tyhjentää näytön käyttämällä ennalta määritettyä tai mukautettua väriä objektia.

void clearScreen(
    const color& color );

3 — Tyhjentää näytön käyttämällä heksadesimaaliväriarvoa.

void clearScreen(
    const char* color );

4 — Tyhjentää näytön käyttäen sävyarvoa.

void clearScreen(
    int hue );
Parameters

Parametri

Tyyppi

Kuvaus

color

const color&

Tyhjentää näytön käyttämällä color sisältävää objektia. Esimääritettyihin väreihin kuuluvat:

  • black
  • white
  • red
  • green
  • blue
  • yellow
  • orange
  • purple
  • cyan
  • transparent
Tässä voi käyttää myös mukautettua väriobjektia.

color

const char*

Tyhjentää näytön käyttämällä heksadesimaalimuotoista väriarvoa, joka esitetään merkkijonona (esimerkiksi “#000000”).

hue

int

Tyhjentää näytön käyttämällä kokonaislukuista sävyarvoa väliltä 0359, joka edustaa asteita väriympyrän ympärillä.
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • IQ (1. sukupolvi) Brain -näyttö on yksivärinen, joten tietyt värit eivät näy näytöllä.

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#

Asettaa IQ (1. sukupolvi) Brain -näytössä näkyvän tekstin fontin.

Tämä määrittää fontin, jota käytetään myöhemmässä tekstitulostuksessa käytettäessä näyttötekstifunktioita, kuten print.

Available Functions 
void setFont(
  fontType font );
Parameters

Parametri

Tyyppi

Kuvaus

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

Tämä funktio ei palauta arvoa.

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#

Määrittää piirrettyjen viivojen ja ääriviivojen paksuuden.

Available Functions 
void setPenWidth(
  uint32_t width );
Parameters

Parametri

Tyyppi

Kuvaus

width

uint32_t

Kynän leveys pikseleinä väliltä 0–32.
Return Values

Tämä funktio ei palauta arvoa.

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

Määrittää tekstin, pikseleiden, viivojen ja ääriviivojen värin.

Available Functions

1 — Asettaa kynän värin käyttämällä ennalta määritettyä tai mukautettua väriä objektia.

void setPenColor(
    const color& color );

2 — Asettaa kynän värin heksadesimaaliarvon avulla.

void setPenColor(
    const char* color );

3 — Asettaa kynän värin sävyarvon avulla.

void setPenColor(
    int hue );
Parameters

Parametri

Tyyppi

Kuvaus

color

const color&

Asettaa kynän värin käyttämällä color -objektia. Esimääritettyihin väreihin kuuluvat:

  • black
  • white
  • red
  • green
  • blue
  • yellow
  • orange
  • purple
  • cyan
  • transparent

color

const char*

Asettaa kynän värin käyttämällä heksadesimaalimuotoista väriarvoa, joka esitetään merkkijonona (esimerkiksi “#FF0000”).

hue

int

Asettaa kynän värin käyttämällä kokonaislukuarvoa väliltä 0359, joka edustaa asteita väriympyrän ympärillä (esimerkiksi 0 on punainen, 120 on vihreä ja 240 on sininen).
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • IQ (1. sukupolvi) Brain -näyttö on yksivärinen, joten tietyt värit eivät näy näytöllä.

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

setFillColor#

Määrittää muotojen piirtämisessä käytettävän täyttövärin.

Available Functions

1 — Asettaa täyttövärin käyttämällä ennalta määritettyä tai mukautettua väriä -objektia.

void setFillColor(
    const color& color );

2 — Asettaa täyttövärin heksadesimaaliarvon avulla.

void setFillColor(
    const char* color );

3 — Asettaa täyttövärin sävyarvon avulla.

void setFillColor(
    int hue );
Parameters

Parametri

Tyyppi

Kuvaus

color

const color&

Asettaa täyttövärin käyttämällä color -objektia. Esimääritettyihin väreihin kuuluvat:

  • black
  • white
  • red
  • green
  • blue
  • yellow
  • orange
  • purple
  • cyan
  • transparent

color

const char*

Asettaa täyttövärin käyttämällä heksadesimaalimuotoista väriarvoa, joka esitetään merkkijonona (esimerkiksi “#00FF00”).

hue

int

Asettaa täyttövärin kokonaislukuarvona väliltä 0359, joka edustaa asteita väriympyrän ympärillä (esimerkiksi 0 on punainen, 120 on vihreä ja 240 on sininen).
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • IQ (1. sukupolvi) Brain -näyttö on yksivärinen, joten tietyt värit eivät näy näytöllä.

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

setOrigin#

Asettaa Brainin näytöllä piirrettävien grafiikoiden alkuperän.

Available Functions 
void setOrigin(
  int32_t x,
  int32_t y );
Parameters

Parametri

Tyyppi

Kuvaus

x

int32_t

Origon x-sijainti suhteessa aivojen näytön vasempaan yläkulmaan välillä 0 - 159.

y

int32_t

Origon y-akselin sijainti suhteessa aivojen näytön vasempaan yläkulmaan välillä 0 - 107.
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • Oletusarvoinen lähtöpiste on näytön vasen yläkulma koordinaateissa (0, 0).

  • Origo pätee koordinaattifunktioihin, kuten drawLine, drawRectangle, drawCircle ja printAt.

  • Alkuperä pysyy voimassa, kunnes sitä muutetaan uudelleen tai projekti nollataan.

setClipRegion#

Määrittää näytölle suorakaiteen muotoisen alueen, johon kaikki piirrokset ja teksti rajataan. Tämän alueen ulkopuolella olevaa sisältöä ei näytetä.

Available Functions 
void setClipRegion(
  int x,
  int y,
  int width,
  int height );
Parameters

Parametri

Tyyppi

Kuvaus

x

int

Leikkausalueen vasemman yläkulman x-koordinaatti kokonaislukuna väliltä 0–159.

y

int

Leikkausalueen vasemman yläkulman y-koordinaatti kokonaislukuna väliltä 0–107.

width

int

Leikkausalueen leveys pikseleinä, kokonaislukuna 0–159.

height

int

Leikkausalueen korkeus pikseleinä, kokonaislukuna 0–107.
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • Piirtofunktioita suoritetaan edelleen, vaikka ne osuisivatkin leikealueen ulkopuolelle, mutta vain alueen sisällä oleva osa on näkyvissä.

  • Koordinaatit x ja y ovat suhteessa nykyiseen näytön nollapisteeseen, jota voidaan muuttaa käyttämällä setOrigin.

  • Leikkausalue koskee vain nykyistä säikettä.

  • Uuden leikealueen asettaminen korvaa kaikki aiemmin asetetut leikealueet nykyiselle säikeelle.

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#

Piirtää yhden pikselin IQ (1. sukupolvi) Brain -näyttöön määritettyyn x- ja y-pikselisijaintiin.

Available Functions 
void drawPixel(
  int x,
  int y );
Parameters

Parametri

Tyyppi

Kuvaus

x

int

Pikselin piirrettävä x-koordinaatti kokonaislukuna 0–159.

y

int

Y-koordinaatti, johon pikseli piirretään, kokonaislukuna 0–107.
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • IQ (1. sukupolvi) Brain -näyttö on yksivärinen, joten tietyt värit eivät näy näytöllä.

  • Koordinaatit x ja y ovat suhteessa nykyiseen näytön nollapisteeseen, joka voidaan asettaa käyttämällä setOrigin.

  • Jos määritetty pikselin sijainti on näytön rajojen ulkopuolella, pikseliä ei piirretä.

Examples 
// Draw one pixel at the center 
// of the screen
Brain.Screen.drawPixel(80, 50);

drawLine#

Piirtää suoran viivan, joka yhdistää kaksi pistettä IQ (1. sukupolvi) aivojen näytöllä.

Available Functions 
void drawLine(
  int x1,
  int y1,
  int x2,
  int y2 );
Parameters

Parametri

Tyyppi

Kuvaus

x1

int

Suoran aloitus-x-koordinaatti kokonaislukuna 0–159.

y1

int

Suoran aloitus-y-koordinaatti kokonaislukuna 0–107.

x2

int

Suoran päättymispisteen x-koordinaatti kokonaislukuna väliltä 0–159.

y2

int

Suoran päätepisteen y-koordinaatti kokonaislukuna väliltä 0–107.
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • IQ (1. sukupolvi) Brain -näyttö on yksivärinen, joten tietyt värit eivät näy näytöllä.

  • Viivan leveys määräytyy kynän nykyisen leveyden mukaan, joka on asetettu setPenWidth-metodilla.

  • Koordinaatit x ja y ovat suhteessa nykyiseen näytön nollapisteeseen, joka voidaan asettaa käyttämällä setOrigin.

  • Jos jokin osa viivasta on näytön rajojen ulkopuolella, vain näkyvä osa piirretään.

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

drawRectangle#

Piirtää suorakulmion IQ (1. sukupolvi) Brain -näytölle määritettyyn paikkaan ja kokoon.

Available Functions

1 — Piirtää ja täyttää suorakulmion käyttämällä nykyistä määritettyä täyttöväriä.

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

2 — Piirtää ja täyttää suorakulmion käyttämällä ennalta määritettyä tai mukautettua väriä objektia.

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

3 — Piirtää ja täyttää suorakulmion käyttämällä heksadesimaaliväriarvoa.

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

4 — Piirtää ja täyttää suorakulmion käyttäen sävyarvoa.

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

Parametri

Tyyppi

Kuvaus

x

int

Suorakulmion vasemman yläkulman x-koordinaatti kokonaislukuna väliltä 0–159.

y

int

Suorakulmion vasemman yläkulman y-koordinaatti kokonaislukuna väliltä 0–107.

width

int

Suorakulmion leveys kokonaislukuna väliltä 0–159.

height

int

Suorakulmion korkeus kokonaislukuna väliltä 0–107.

color

const color&

Fills the rectangle 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*

Täyttää suorakulmion heksadesimaaliväriarvolla (esimerkiksi “#FF0000”).

hue

int

Täyttää suorakulmion sävyarvolla väliltä 0359.
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • IQ (1. sukupolvi) Brain -näyttö on yksivärinen, joten tietyt värit eivät näy näytöllä.

  • Ääriviivan paksuus määräytyy kynän nykyisen leveyden mukaan, joka on asetettu setPenWidth-metodilla.

  • Koordinaatit x ja y ovat suhteessa nykyiseen näytön nollapisteeseen, jota voidaan muuttaa käyttämällä setOrigin.

  • Jos jokin osa suorakulmiosta on näytön rajojen ulkopuolella, vain näkyvä osa piirretään.

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

drawCircle#

Piirtää ympyrän IQ (1. sukupolvi) aivojen näytölle määritettyyn kohtaan ja säteeseen.

Available Functions

1 — Piirtää ja täyttää ympyrän käyttämällä nykyistä määritettyä täyttöväriä.

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

2 — Piirtää ja täyttää ympyrän käyttämällä ennalta määritettyä tai mukautettua väriä objektia.

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

3 — Piirtää ja täyttää ympyrän käyttämällä heksadesimaaliväriarvoa.

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

4 — Piirtää ja täyttää ympyrän käyttäen sävyarvoa.

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

Parametri

Tyyppi

Kuvaus

x

int

Ympyrän keskipisteen x-koordinaatti kokonaislukuna väliltä 0–159.

y

int

Ympyrän keskipisteen y-koordinaatti kokonaislukuna väliltä 0–107.

radius

int

Ympyrän säde, joka annetaan kokonaislukuna väliltä 0–107 pikseliä.

color

const color&

Täyttää ympyrän käyttämällä color sisältävää objektia. Esimääritettyihin väreihin kuuluvat:

  • black
  • white
  • red
  • green
  • blue
  • yellow
  • orange
  • purple
  • cyan
  • transparent
Tässä voi käyttää myös mukautettua väriobjektia.

color

const char*

Täyttää ympyrän heksadesimaaliväriarvolla (esimerkiksi “#FF0000”).

hue

int

Täyttää ympyrän käyttämällä sävyarvoa väliltä 0–359.
Return Values

Tämä funktio ei palauta arvoa.

Notes

  • IQ (1. sukupolvi) Brain -näyttö on yksivärinen, joten tietyt värit eivät näy näytöllä.

  • Ääriviivan paksuus määräytyy kynän nykyisen leveyden mukaan, joka on asetettu setPenWidth-metodilla.

  • Koordinaatit x ja y ovat suhteessa nykyiseen näytön nollapisteeseen, jota voidaan muuttaa käyttämällä setOrigin.

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

render#

Mahdollistaa Brainin näytön kaksoispuskuroinnin. Kun funktio on kutsuttu, piirtofunktiot (kuten teksti tai muodot) eivät enää näy välittömästi projektin loppuosassa. Sen sijaan päivitykset näkyvät vasta, kun render -käytetään uudelleen. Tämä mahdollistaa sujuvammat ja hallitummat näytön päivitykset, mutta tarkoittaa, että mikään ei ole näkyvissä ennen kuin render -käytetään.

Available Functions

1 — Ottaa käyttöön kaksoispuskuroinnin tai renderöi takapuskurin näytölle.

bool render();

2 — Renderöi takapuskurin näytölle ja hallitsee pystysuuntaisen synkronoinnin toimintaa ja valinnaista ajastimen suoritusta.

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

Parametri

Tyyppi

Kuvaus

bVsyncWait

bool

​

  • true — Odota näytön pystysuuntaista päivitystä ennen renderöintiä visuaalisen repeytymisen vähentämiseksi.
  • false — Älä odota näytön pystysuuntaista päivitystä ennen renderöintiä.

bRunScheduler

bool

Valinnainen.

  • true (oletus) — Salli taustatehtävien suorittamisen renderöintiä odotettaessa.
  • false — Älä salli taustatehtävien suorittamista renderöintiä odotettaessa.
Return Values

Palauttaa totuusarvon, joka ilmaisee, renderöitiinkö puskuriin tallennetut piirrokset näytölle onnistuneesti:

  • true — Piirrokset renderöitiin näytölle onnistuneesti.
  • false — Piirroksia ei voitu renderöidä näytölle.

    • Notes

    • Funktion render kutsuminen edellyttää, että projektin loppuosassa käytetään funktiota 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();
On this page