TI-Nspire™ CX II – Piirtokomennot

Tämä on täydentävä asiakirja TI-Nspire™-viiteoppaalle ja TI-Nspire™ CAS -viiteoppaalle. Kaikki TI-Nspire™ CX II -komennot sisällytetään ja julkaistaan TI-Nspire™-viiteoppaassa ja TI-Nspire™ CAS -viiteoppaassa.

Kuvaajien ohjelmointi

Uusia komentoja on lisätty TI-Nspire™ CX II -kämmenlaitteisiin ja TI-Nspire™-työpöytäsovellukseen kuvaajaohjelmointia varten.

TI-Nspire™ CX II -kämmenlaitteet siirtyvät tähän kuvaajatilaan, kun ne suorittavat kuvaajakomentoja, ja siirtyvät ohjelman suorittamisen jälkeen takaisin kontekstiin, jossa ohjelma suoritettiin.

Näytön yläreunassa näkyy ”Running…”, kun ohjelmaa suoritetaan. Näkyviin tulee ”Finished”, kun ohjelma on valmis. Minkä tahansa näppäimen painaminen siirtää järjestelmän pois kuvaajatilasta.

Siirtyminen kuvaajatilaan käynnistyy automaattisesti, kun jokin Draw (kuvaajat) -komennoista kohdataan TI-Basic -ohjelman suorituksen aikana.
Tämä siirtyminen tapahtuu vain, kun ohjelma suoritetaan laskimella; asiakirjassa tai muistiolehtiön laskimessa.
Siirtyminen pois kuvaajatilasta tapahtuu ohjelman sulkemisen jälkeen.
Kuvaajatila on käytettävissä vain TI‑Nspire™ CX II- kämmenlaitteissa ja TI‑Nspire™ CX II -kämmenlaitteiden työpöytäversion näkymässä. Tämä tarkoittaa, että se ei ole käytettävissä tietokoneen asiakirjanäkymässä tai PublishView-asiakirjassa (.tnsp) työpöytäversiossa tai iOS-käyttöjärjestelmässä.
- Jos kuvaajakomento kohdataan, kun TI-Basic -ohjelmaa suoritetaan virheellisestä kontekstista, näkyviin tulee virheviesti ja TI-Basic -ohjelma suljetaan.

Kuvaajanäyttö

Kuvaajanäytön yläosassa on otsikko, jota ei voi kirjoittaa kuvaajakomennoilla.

Kuvaajanäytön piirustusalue tyhjennetään (color = 255,255,255), kun kuvaajanäyttö alustetaan.

Kuvaajanäyttö

Oletus

Korkeus

212

Leveys

318

Väri

valkoinen: 255,255,255

Oletusnäkymä ja asetukset

Yläpalkin tilakuvakkeet (akun tila, press-to-start-tila, verkon ilmaisin jne.) eivät näy, kun kuvaajaohjelma on käynnissä.
Piirtämisen oletusväri: Musta (0,0,0)
Kynän oletustyyli – normaali, tasainen
- Paksuus: 1 (tasainen), 2 (normaali), 3 (paksuin)
- Tyyli 1 (tasainen), 2 (pisteet), 3 (viivat)
Kaikki piirtokomennot käyttävät nykyisiä väri- ja kynäasetuksia eli joko oletusarvoja tai TI-Basic-komentojen avulla asetettuja arvoja.
Tekstin fontti on pysyvä eikä sitä voi muuttaa.
Kaikki kuvaajanäytön piirrokset piirretään leikkausikkunassa, joka on kuvaajanäytön piirustusalueen kokoinen. Mitään piirroksia, jotka ulottuvat leikatun kuvaajanäytön piirustusalueen ulkopuolelle, ei piirretä. Virheviestiä ei näytetä.
Kaikki piirtokomennoille määritetyt x- ja y-koordinaatit on määritelty siten, että 0,0 on kuvaajanäytön piirustusalueen vasemmassa yläkulmassa.
- Poikkeukset:
- DrawText käyttää koordinaatteja tekstin rajaavan ruudun vasemmassa alakulmassa.
- SetWindow käyttää näytön vasenta alakulmaa.
Kaikki komentojen parametrit voidaan antaa lausekkeina, jotka arvioidaan numeroksi, joka pyöristetään sitten lähimpään kokonaislukuun.

Kuvaajanäytön virheviestit

Jos validointi epäonnistuu, näyttöön ilmestyy virheviesti.

Virheviestit

Kuvaus

Tarkastele

Virhe
Syntaksi

Jos syntaksin tarkastuksessa löytyy syntaksivirheitä, näkyviin tulee virheilmoitus, ja editori yrittää asettaa kohdistimen ensimmäisen virheen kohdalle, jotta voit korjata sen.

Virhe
Liian vähän argumentteja

Funktiosta tai komennosta puuttuu yksi tai useampia argumentteja

Virhe
Liian monta argumenttia

Funktio tai komento sisältää liian monta argumenttia eikä sitä voida arvioida.

Virhe
Virheellinen tietotyyppi

Argumentin tietotyyppi on väärä.

Virheelliset komennot kuvaajatilassa

Jotkin komennot eivät ole sallittuja, kun ohjelma siirtyy kuvaajatilaan. Jos nämä komennot kohdataan kuvaajatilassa, näyttöön tulee virheviesti ja ohjelma suljetaan.

Komentoa ei sallita

Virheviestit

Pyyntö

Pyyntöä ei voida toteuttaa kuvaajatilassa

PyydäMerkkij

RequestStr-toimintoa ei voida toteuttaa kuvaajatilassa

Teksti

Tekstiä ei voida toteuttaa kuvaajatilassa

Komennot, jotka kirjoittavat tekstin laskimeen – disp ja dispAt – ovat tuettuja komentoja kuvaajakontekstissa. Näiden komentojen teksti lähetetään Laskin-näyttöön (ei Kuvaaja-näyttöön) ja se näkyy sen jälkeen, kun ohjelma on suljettu ja järjestelmä siirtyy takaisin Laskin-sovellukseen.

 

 


C

Tyhjennä

 

Clear x, y, width, height

Tyhjentää koko näytön, jos parametreja ei ole.

Jos x, y, width ja height on määritetty, parametrien määrittämä suorakulmio tyhjennetään.

Tyhjennä

Tyhjentää koko näytön

 

Clear 10,10,100,50

Tyhjentää suorakulmioalueen, jonka vasen yläkulma on (10, 10), leveys on 100 ja korkeus on 50.

 


D

DrawArc

 

DrawArc x, y, width, height, startAngle, arcAngle

Piirrä kaari rajaavan suorakulmion sisällä annetulla aloitus- ja kaarikulmalla.

x, y: rajaavan suorakulmion vasen yläkoordinaatti

width, height: rajaavan suorakulmion mitat

”Arc Angle” määrittää kaaren kaarevuuden.

Nämä parametrit voidaan antaa lausekkeina, jotka arvioidaan numeroksi, joka pyöristetään sitten lähimpään kokonaislukuun.

DrawArc 20,20,100,100,0,90

 

DrawArc 50,50,100,100,0,180

 

Katso myös: FillArc

 

DrawCircle

 

DrawCircle x, y, radius

x, y: keskikohdan koordinaatti

radius: ympyrän säde

DrawCircle 150,150,40

 

Katso myös: FillCircle

 

 

DrawLine

 

DrawLine x1, y1, x2, y2

Piirrä viiva pisteillä x1, y1, x2, y2.

Lausekkeet, jotka arvioidaan numeroksi, joka pyöristetään sitten lähimpään kokonaislukuun.

Näytön rajat: Jos määritetyt koordinaatit aiheuttavat viivan osan piirtämisen kuvaajanäytön ulkopuolelle, kyseinen viivan osa leikataan eikä virheilmoitusta näytetä.

DrawLine 10,10,150,200

 

DrawPoly

 

Komennoilla on kaksi varianttia:

DrawPoly xlist, ylist

tai

DrawPoly x1, y1, x2, y2, x3, y3...xn, yn

Huomaa: DrawPoly xlist, ylist
Muoto yhdistää kohteet x1, y1 to x2, y2, x2, y2 to x3, y3 ja niin edelleen.

Huomaa: DrawPoly x1, y1, x2, y2, x3, y3...xn, yn
Kohteita xn, yn EI yhdistetä automaattisesti kohteisiin x1, y1.

Lausekkeet, jotka arvioidaan todellisten liukulukujen luetteloon
xlist, ylist

Lausekkeet, jotka arvioidaan yksittäiseksi liukuluvuksi
x1, y1...xn, yn = monikulmion kärkien koordinaatit

Huomaa: DrawPoly: Lisää kokomitat (leveys/korkeus), jotka vastaavat piirrettyjä viivoja.
Viivat piirretään rajaavan ruudun määritellyn koordinaatin ja mittojen ympärille siten, että piirretyn monikulmion todellinen koko on suurempi kuin leveys ja korkeus.

xlist:={0,200,150,0}

ylist:={10,20,150,10}

DrawPoly xlist,ylist

 

DrawPoly 0,10,200,20,150,150,0,10

Katso myös: FillPoly

 

DrawRect

 

DrawRect x, y, width, height

x, y: suorakulmion vasen yläkoordinaatti

width, height: suorakulmion leveys ja korkeus (suorakulmio, joka on piirretty alaspäin ja oikealle lähtökoordinaatista)

Huomaa: Viivat piirretään rajaavan ruudun määritellyn koordinaatin ja mittojen ympärille siten, että piirretyn suorakulmion todellinen koko on suurempi kuin leveys ja korkeus osoittavat.

DrawRect 25,25,100,50

Katso myös: FillRect

 

DrawText

 

DrawText x, y, exprOrString1 [,exprOrString2]...

x, y: tekstisyötön koordinaatti

Piirtää tekstin kohteeseen exprOrString määritetyssä x, y -koordinaattien sijainnissa.

Säännöt kohteelle exprOrString ovat samat kuin kohteelle DispDrawText voi käsitellä useita argumentteja.

DrawText 50,50,”Hello World”

 


F

FillArc

 

FillArc x, y, width, height, startAngle, arcAngle

x, y: rajaavan suorakulmion vasen yläkoordinaatti

Piirrä ja täytä kaari rajaavan suorakulmion sisällä annetulla aloitus- ja kaarikulmalla.

Täytön oletusväri on musta. Täyttöväri voidaan asettaa komennolla SetColor.

”Arc Angle” määrittää kaaren kaarevuuden.

FillArc 50,50,100,100,0,180

FillCircle

 

FillCircle x, y, radius

x, y: keskikohdan koordinaatti

Piirrä ja täytä ympyrä määritellyllä keskikohdalla ja määritetyllä säteellä.

Täytön oletusväri on musta. Täyttöväri voidaan asettaa komennolla SetColor.

FillCircle 150,150,40

Täällä!

FillPoly

 

FillPoly xlist, ylist

tai

FillPoly x1, y1, x2, y2, x3, y3...xn, yn

Huomaa: Viivan ja värin määrittää komennot SetColor ja SetPen

xlist:={0,200,150,0}

ylist:={10,20,150,10}

FillPoly xlist,ylist

 

FillPoly 0,10,200,20,150,150,0,10

 

FillRect

 

FillRect x, y, width, height

x, y: suorakulmion vasen yläkoordinaatti

width, height: suorakulmion leveys ja korkeus

Piirrä ja täytä suorakulmio, jonka vasen yläkulma koordinaatissa, jonka määrittää (x,y).

Täytön oletusväri on musta. Täyttöväri voidaan asettaa komennolla SetColor.

Huomaa: Viivan ja värin määrittää komennot SetColor ja SetPen

FillRect 25,25,100,50

 

 


G

getPlatform()

 

getPlatform()

Palauttaa:
”dt” työpöytäohjelmistosovelluksissa
”hh” TI-Nspire™ CX -kämmenlaitteissa
“ios” TI-Nspire™ CX iPad® -sovelluksessa

 


P

PaintBuffer

 

PaintBuffer

Maalaa kuvaajan puskurin näytölle

Tätä komentoa käytetään yhdessä UseBuffer-komennon kanssa näyttönopeuden lisäämiseksi, kun ohjelma luo useita kuvaajaobjekteja.

UseBuffer

Luvulle n,1,10

x:=randInt(0,300)

y:=randInt(0,200)

radius:=randInt(10,50)

Wait 0,5

DrawCircle x,y,radius

EndFor

PaintBuffer

Tämä ohjelma näyttää 10 ympyrää samanaikaisesti.

Jos UseBuffer-komento poistetaan, jokainen ympyrä näytetään sellaisena kuin se on piirretty.

Katso myös: UseBuffer

 

 

PlotXY

 

PlotXY x, y, shape

x, y: koordinaatit muodon muodostamiseen

shape : numero väliltä 1–13, joka määrittää muodon

1 – Täytetty ympyrä

2 – Tyhjä ympyrä

3 – Täytetty neliö

4 – Tyhjä neliö

5 – Risti

6 – Plusmerkkikuvio

7 – Ohut

8 – keskikokoinen piste, täytetty

9 – keskikokoinen piste, tyhjä

10 – suurempi piste, täytetty

11 – suurempi piste, tyhjä

12 – suurin piste, täytetty

13 – suurin piste, tyhjä

 

PlotXY 100,100,1

 

Luvulle n,1,13

DrawText 1+22*n,40,n

PlotXY 5+22*n,50,n

EndFor

 

 


J

SetColor

 

SetColor

Red-arvo, Green-arvo, Blue-arvo

Kelvolliset arvot punaiselle, vihreälle ja siniselle ovat välillä 0–255

Asettaa tulevien Draw-komentojen värin

SetColor 255,0,0

DrawCircle 150,150,100

 

SetPen

 

SetPen

paksuus, tyyli

Paksuus: 1 <= paksuus <= 3 | 1 on ohuin, 3 on paksuin

style: 1 = tasainen, 2 = pisteet, 3 = viivat

Asettaa tulevien Draw-komentojen kynän tyylin

SetPen 3,3

DrawCircle 150,150,50

SetWindow

 

SetWindow

xMin, xMax, yMin, yMax

Luo loogisen ikkunan, joka kartoittaa kuvaajan piirustusalueen. Kaikki parametrit vaaditaan.

Jos piirretyn objektin osa on ikkunan ulkopuolella, syöttö leikataan (ei näytetä) eikä virheilmoitusta näytetä.

Jo xmin on suurempi tai yhtä suuri kuin xmax tai ymin on suurempi tai yhtä suuri kuin ymax, näyttöön tulee virheviesti.

Mitään objekteja, jotka on piirretty ennen SetWindow-komentoa, ei piirretä uudelleen uudessa kokoonpanossa.

Käytä seuraavia ikkunan parametrien nollaamiseksi oletusarvoihin:

SetWindow 0,0,0,0

SetWindow 0,160,0,120

Asettaa syöttöikkunan vasemman alakulman kohtaan 0,0. Leveys on 160 ja korkeus on 120.

DrawLine 0,0,100,100

SetWindow 0,160,0,120

SetPen 3,3

DrawLine 0,0,100,100

 


l

UseBuffer

 

UseBuffer

Piirrä kuvaaja puskuriin näytön sijaan (suorituskyvyn parantamiseksi)

Tätä komentoa käytetään yhdessä PaintBuffer-komennon kanssa näyttönopeuden lisäämiseksi, kun ohjelma luo useita kuvaajaobjekteja.

UseBuffer-komennolla kaikki kuvaajat näytetään vasta seuraavan PaintBuffer-komennon suorittamisen jälkeen.

UseBufferia täytyy käyttää vain kerran ohjelmassa, eli jokainen käytetty PaintBuffer-komento ei tarvitse vastaavaa UseBuffer-komentoa.

 

UseBuffer

Luvulle n,1,10

x:=randInt(0,300)

y:=randInt(0,200)

radius:=randInt(10,50)

Wait 0,5

DrawCircle x,y,radius

EndFor

PaintBuffer

Tämä ohjelma näyttää 10 ympyrää samanaikaisesti.

Jos UseBuffer-komento poistetaan, jokainen ympyrä näytetään sellaisena kuin se on piirretty.

Katso myös: PaintBuffer