TI-Nspire™ CX II - 繪圖指令

此為《TI-Nspire™ 參考手冊》和《TI-Nspire™ CAS 參考手冊》的補充文件。所有 TI-Nspire™CX II 指令都將納入並在《TI-Nspire™ 參考手冊》5.1 版和《TI-Nspire™ CAS 參考手冊》中發佈。

函數繪圖程式設計

新指令已新增至 TI-Nspire™ CX II 計算機和 TI-Nspire™ 桌面應用程式，專用於函數繪圖程式設計。

TI-Nspire™ CX II 計算機將在執行函數繪圖指令時切換到此函數繪圖模式，並會在程式完成後切換回程序執行內容。

執行程式時，畫面會在頂端列上顯示「執行中…」。程式完成後，則顯示「完成」。按下任一按鍵均可使系統退出函數繪圖模式。

•

若在執行 TI-Basic 程式期間遇到其中一個「繪圖」（函數繪圖）指令，系統便會自動觸發函數繪圖模式轉換功能。

•

只有在從計算工具，在速寫板的文件或計算工具中執行程式時，才會發生模式轉換。

•

程式終止後，即會退出函數繪圖模式。

•

只有 TI-Nspire™ CX II 計算機和桌面 TI-Nspire™ CX II 計算機檢視才可使用函數繪圖模式。這表示桌面或 iOS 上的電腦文件檢視或 PublishView (.tnsp) 均無法使用此模式。

如果從錯誤的內容執行 TI-Basic 程式時遇到函數繪圖指令，系統將會顯示錯誤訊息並終止 TI-Basic 程式。

函數繪圖畫面

函數繪圖畫面頂端將會包含一個標頭，且該標頭無法由函數繪圖指令寫入。

初始化函數繪圖畫面時，系統將會清除函數繪圖畫面的繪製區域（色彩 = 255,255,255）。

函數繪圖畫面	預設值
高度	212
寬度	318
顏色	白色:255,255,255

預設檢視與設定

•

執行函數繪圖程式時，系統不會顯示頂端列上的狀態圖示（電池狀態、隨按即試狀態，以及網路指示條等）。

•

預設繪製色彩:黑色 (0,0,0)

•

預設畫筆樣式 - 標準、平滑

粗細:1（細）、2（標準）、3（最粗）

樣式:1（平滑）、2（點線）、3（虛線）

•

所有繪製指令均會使用目前的色彩和畫筆設定;對於預設值或透過 TI-Basic 指令設定的值也是如此。

•

文字字型已固定，無法變更。

•

函數繪圖畫面上的任何輸出都將在裁剪視窗內繪製，裁剪視窗大小與函數繪圖畫面的繪製區域大小相同。對於超出此裁剪函數繪圖畫面繪製區域以外的任何繪製輸出，系統均不會進行繪製。同時亦不會顯示錯誤訊息。

•

對於為繪製指令指定的所有 x,y 座標，系統均會作出定義，因此 0,0 將位於函數繪圖畫面繪製區域的左上角。

例外情況:

DrawText 使用座標作為文字邊界框的左下角。

SetWindow 使用畫面的左下角

•

指令的所有參數均能以運算式提供，得出數字求值後，系統會將其四捨五入到最接近的整數。

函數繪圖畫面錯誤訊息

若驗證失敗，系統會顯示錯誤訊息。

錯誤訊息	說明	檢視
錯誤語法	如果語法檢查器發現任何語法錯誤，會顯示一個錯誤訊息，並嘗試將游標放在第一個錯誤附近，讓您能夠進行更正。
錯誤引數太少	函數或指令缺少一個或多個引數
錯誤引數太多	函數或指令包含過多引數，無法求值。
錯誤資料類型無效	引數的資料類型錯誤。

函數繪圖模式中的無效指令

當程式切換到函數繪圖模式時，某些指令將無法使用。如果在函數繪圖模式中遇到這些指令，系統將會顯示錯誤訊息並終止程式。

不允許的指令	錯誤訊息
Request	Request 不可以在函數繪圖模式中執行
RequestStr	RequestStr 不可以在函數繪圖模式中執行
文字	Text 不可以在函數繪圖模式中執行

用於將文字列印到計算工具的指令（disp 和 dispAt）將在函數繪圖內容中受到支援。系統會將這些指令中的文字傳送到計算工具畫面（而非函數繪圖），並在程式結束以及系統切換回計算工具應用程式後予以顯示

C

清除	目錄 > CXII
清除 x, y, 寬度, 高度若未指定參數，系統將清除整個畫面。若已指定 x、y、寬度和高度，系統將會清除由參數定義的矩形區域。	清除清除整個畫面清除 10,10,100,50 清除左上角 (10, 10) 以及寬度為 100、高度為 50 的矩形區域

清除

目錄 >
CXII

清除 x, y, 寬度, 高度

若未指定參數，系統將清除整個畫面。

若已指定 x、y、寬度和高度，系統將會清除由參數定義的矩形區域。

清除

清除整個畫面

清除 10,10,100,50

清除左上角 (10, 10) 以及寬度為 100、高度為 50 的矩形區域

D

DrawArc	目錄 > CXII
DrawArc x, y, 寬度, 高度, 起始角度, 弧角使用所提供的起始角度和弧角，在定義的週框內繪製圓弧。 x, y:週框的左上角座標寬度, 高度:週框的維度「弧角」用於定義圓弧的範圍。這些參數均能以運算式提供，得出數字求值後，系統會將其四捨五入到最接近的整數。	DrawArc 20,20,100,100,0,90 DrawArc 50,50,100,100,0,180
另請參考:FillArc

DrawArc

目錄 >
CXII

DrawArc x, y, 寬度, 高度, 起始角度, 弧角

使用所提供的起始角度和弧角，在定義的週框內繪製圓弧。

x, y:週框的左上角座標

寬度, 高度:週框的維度

「弧角」用於定義圓弧的範圍。

這些參數均能以運算式提供，得出數字求值後，系統會將其四捨五入到最接近的整數。

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

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

另請參考:FillArc

DrawCircle	目錄 > CXII
DrawCircle x, y, 半徑 x, y:中心座標半徑:圓的半徑	DrawCircle 150,150,40
另請參考:FillCircle

DrawCircle

目錄 >
CXII

DrawCircle x, y, 半徑

x, y:中心座標

半徑:圓的半徑

DrawCircle 150,150,40

另請參考:FillCircle

DrawLine	目錄 > CXII
DrawLine x1, y1, x2, y2 從 x1, y1, x2, y2 繪製一條線條。對運算式得出數字求值後，系統會將其四捨五入到最接近的整數。畫面界限:如果指定的座標導致任何線條部分在繪製時超出函數繪圖畫面，則系統將會剪切超出的部分，而不會顯示錯誤訊息。	DrawLine 10,10,150,200

DrawLine

目錄 >
CXII

DrawLine x1, y1, x2, y2

從 x1, y1, x2, y2 繪製一條線條。

對運算式得出數字求值後，系統會將其四捨五入到最接近的整數。

畫面界限:如果指定的座標導致任何線條部分在繪製時超出函數繪圖畫面，則系統將會剪切超出的部分，而不會顯示錯誤訊息。

DrawLine 10,10,150,200

DrawPoly	目錄 > CXII
指令分為以下兩種: DrawPoly xlist, ylist 或 DrawPoly x1, y1, x2, y2, x3, y3...xn, yn 注意:DrawPoly xlist, ylist 作圖時，系統會將 x1, y1 連接至 x2, y2，並將 x2, y2 連接至 x3, y3，依此類推。注意:DrawPoly x1, y1, x2, y2, x3, y3...xn, yn xn, yn 將不會自動連接至 x1, y1。求值為系列實數浮點數的運算式 xlist, ylist 求值為單一實數浮點數的運算式 x1, y1...xn, yn = 多邊形頂點的座標注意:DrawPoly:相對於繪製線條的輸入大小維度（寬度/高度）。系統會在圈定指定座標和維度的邊界框中繪製線條，如此一來，所繪製的多邊形的實際大小便會大於已有的寬高值。	xlist:={0,200,150,0} ylist:={10,20,150,10} DrawPoly xlist,ylist DrawPoly 0,10,200,20,150,150,0,10
另請參考:FillPoly

DrawPoly

目錄 >
CXII

指令分為以下兩種:

DrawPoly xlist, ylist

或

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

注意:DrawPoly xlist, ylist
作圖時，系統會將 x1, y1 連接至 x2, y2，並將 x2, y2 連接至 x3, y3，依此類推。

注意:DrawPoly x1, y1, x2, y2, x3, y3...xn, yn
xn, yn 將不會自動連接至 x1, y1。

求值為系列實數浮點數的運算式
xlist, ylist

求值為單一實數浮點數的運算式
x1, y1...xn, yn = 多邊形頂點的座標

注意:DrawPoly:相對於繪製線條的輸入大小維度（寬度/高度）。
系統會在圈定指定座標和維度的邊界框中繪製線條，如此一來，所繪製的多邊形的實際大小便會大於已有的寬高值。

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

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

DrawPoly xlist,ylist

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

另請參考:FillPoly

DrawRect	目錄 > CXII
DrawRect x, y, 寬度, 高度 x, y:矩形的左上角座標寬度, 高度:矩形的寬度與高度（從起始座標往右下方繪製的矩形）。注意:系統會在圈定指定座標和維度的邊界框中繪製線條，如此一來，所繪製的矩形的實際大小便會大於指定的寬度和高度。	DrawRect 25,25,100,50
另請參考:FillRect

DrawRect

目錄 >
CXII

DrawRect x, y, 寬度, 高度

x, y:矩形的左上角座標

寬度, 高度:矩形的寬度與高度（從起始座標往右下方繪製的矩形）。

注意:系統會在圈定指定座標和維度的邊界框中繪製線條，如此一來，所繪製的矩形的實際大小便會大於指定的寬度和高度。

DrawRect 25,25,100,50

另請參考:FillRect

DrawText	目錄 > CXII
DrawText x, y, exprOrString1 [,exprOrString2]... x, y:文字輸出的座標在指定 x, y 座標位置的 exprOrString 內繪製文字。 exprOrString 與 Disp 的適用規則相同 – DrawText 可使用多個引數。	DrawText 50,50,"Hello World"

DrawText

目錄 >
CXII

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

x, y:文字輸出的座標

在指定 x, y 座標位置的 exprOrString 內繪製文字。

exprOrString 與 Disp 的適用規則相同 – DrawText 可使用多個引數。

DrawText 50,50,"Hello World"

F

FillArc	目錄 > CXII
FillArc x, y, 寬度, 高度, 起始角度, 弧角 x, y:週框的左上角座標使用所提供的起始角度和弧角，在定義的週框內繪製並填滿圓弧。預設填滿色彩為黑色。可透過 SetColor 指令設定填滿色彩「弧角」用於定義圓弧的範圍	FillArc 50,50,100,100,0,180

FillArc

目錄 >
CXII

FillArc x, y, 寬度, 高度, 起始角度, 弧角

x, y:週框的左上角座標

使用所提供的起始角度和弧角，在定義的週框內繪製並填滿圓弧。

預設填滿色彩為黑色。可透過 SetColor 指令設定填滿色彩

「弧角」用於定義圓弧的範圍

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

FillCircle	目錄 > CXII
FillCircle x, y, 半徑 x, y:中心座標在指定中心以指定半徑繪製並填滿圓。預設填滿色彩為黑色。可透過 SetColor 指令設定填滿色彩。	FillCircle 150,150,40 Here!

FillCircle

目錄 >
CXII

FillCircle x, y, 半徑

x, y:中心座標

在指定中心以指定半徑繪製並填滿圓。

預設填滿色彩為黑色。可透過 SetColor 指令設定填滿色彩。

FillCircle 150,150,40

Here!

FillPoly	目錄 > CXII
FillPoly xlist, ylist 或 FillPoly x1, y1, x2, y2, x3, y3...xn, yn 注意:線條與色彩由 SetColor 和 SetPen 指定	xlist:={0,200,150,0} ylist:={10,20,150,10} FillPoly xlist,ylist FillPoly 0,10,200,20,150,150,0,10

FillPoly

目錄 >
CXII

FillPoly xlist, ylist

或

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

注意:線條與色彩由 SetColor 和 SetPen 指定

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

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

FillPoly xlist,ylist

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

FillRect	目錄 > CXII
FillRect x, y, 寬度, 高度 x, y:矩形的左上角座標寬度, 高度:矩形的寬度與高度在 (x, y) 指定的座標處繪製並填滿左上角的矩形預設填滿色彩為黑色。可透過 SetColor 指令設定填滿色彩注意:線條與色彩由 SetColor 和 SetPen 指定	FillRect 25,25,100,50

FillRect

目錄 >
CXII

FillRect x, y, 寬度, 高度

x, y:矩形的左上角座標

寬度, 高度:矩形的寬度與高度

在 (x, y) 指定的座標處繪製並填滿左上角的矩形

預設填滿色彩為黑色。可透過 SetColor 指令設定填滿色彩

注意:線條與色彩由 SetColor 和 SetPen 指定

FillRect 25,25,100,50

G

getPlatform()	目錄 > CXII
getPlatform() 傳回結果如下: 桌面軟體應用程式:"dt" TI-Nspire™ CX 計算機:"hh" TI-Nspire™ CX iPad® 應用程式:"ios"

getPlatform()

目錄 >
CXII

getPlatform()

傳回結果如下:
桌面軟體應用程式:"dt"
TI-Nspire™ CX 計算機:"hh"
TI-Nspire™ CX iPad® 應用程式:"ios"

P

PaintBuffer	目錄 > CXII
PaintBuffer 在螢幕上繪製函數繪圖緩衝區此指令與 UseBuffer 搭配使用，可在程式產生多個圖形物件時提高螢幕的顯示速度。	UseBuffer For n,1,10 x:=randInt(0,300) y:=randInt(0,200) radius:=randInt(10,50) Wait 0.5 DrawCircle x, y, 半徑 EndFor PaintBuffer 此程式將一次顯示全部結果，即 10 個圓。如果移除「UseBuffer」指令，則系統會在繪製每個圓時即時顯示。
另請參考:UseBuffer

PaintBuffer

目錄 >
CXII

PaintBuffer

在螢幕上繪製函數繪圖緩衝區

此指令與 UseBuffer 搭配使用，可在程式產生多個圖形物件時提高螢幕的顯示速度。

UseBuffer

For n,1,10

x:=randInt(0,300)

y:=randInt(0,200)

radius:=randInt(10,50)

Wait 0.5

DrawCircle x, y, 半徑

EndFor

PaintBuffer

此程式將一次顯示全部結果，即 10 個圓。

如果移除「UseBuffer」指令，則系統會在繪製每個圓時即時顯示。

另請參考:UseBuffer

PlotXY	目錄 > CXII
PlotXY x, y, 形狀 x, y:用於繪製形狀的座標形狀:介於 1 和 13 之間的數字，用於指定形狀 1 - 填滿的圓 2 - 空心圓 3 - 填滿的方形 4 - 空心方形 5 - 交叉 6 - 加號 7 - 細線 8 - 中型實心點 9 - 中型空心點 10 - 大實心點 11 - 大空心點 12 - 最大實心點 13 - 最大空心點	PlotXY 100,100,1 針對 n,1,13 DrawText 1+22n,40,n PlotXY 5+22n,50,n EndFor

PlotXY

目錄 >
CXII

PlotXY x, y, 形狀

x, y:用於繪製形狀的座標

形狀:介於 1 和 13 之間的數字，用於指定形狀

1 - 填滿的圓

2 - 空心圓

3 - 填滿的方形

4 - 空心方形

5 - 交叉

6 - 加號

7 - 細線

8 - 中型實心點

9 - 中型空心點

10 - 大實心點

11 - 大空心點

12 - 最大實心點

13 - 最大空心點

PlotXY 100,100,1

針對 n,1,13

DrawText 1+22*n,40,n

PlotXY 5+22*n,50,n

EndFor

S

SetColor	目錄 > CXII
SetColor 紅色值、綠色值、藍色值紅、綠、藍的有效值必須介於 0 和 255 之間設定後續「繪圖」指令的顏色	SetColor 255,0,0 DrawCircle 150,150,100

SetColor

目錄 >
CXII

SetColor

紅色值、綠色值、藍色值

紅、綠、藍的有效值必須介於 0 和 255 之間

設定後續「繪圖」指令的顏色

SetColor 255,0,0

DrawCircle 150,150,100

SetPen	目錄 > CXII
SetPen 粗細、樣式粗細:1 <= 粗細 <= 3\|1 最細、3 最粗樣式:1 = 平滑、2 = 點線、3 = 虛線設定後續「繪圖」指令的畫筆樣式	SetPen 3,3 DrawCircle 150,150,50

SetPen

目錄 >
CXII

SetPen

粗細、樣式

粗細:1 <= 粗細 <= 3|1 最細、3 最粗

樣式:1 = 平滑、2 = 點線、3 = 虛線

設定後續「繪圖」指令的畫筆樣式

SetPen 3,3

DrawCircle 150,150,50

SetWindow	目錄 > CXII
SetWindow xMin、xMax、yMin、yMax 建立一個與函數繪圖區域相對應的邏輯視窗。所有參數皆必填。如果繪製物件的一部分位於視窗之外，則系統將會剪切輸出（未顯示），而不會顯示錯誤訊息。如果 xmin 大於或等於 xmax，或者 ymin 大於或等於 ymax，則系統會顯示錯誤訊息。在新設定中，系統不會重新繪製在執行 SetWindow 指令之前所繪製的任何物件。若要將視窗參數重設為預設值，請使用: SetWindow 0,0,0,0	SetWindow 0,160,0,120 如此一來，輸出視窗將設定為左下角的 0,0，且寬度和高度會分別設定為 160 和 120 DrawLine 0,0,100,100 SetWindow 0,160,0,120 SetPen 3,3 DrawLine 0,0,100,100

SetWindow

目錄 >
CXII

SetWindow

xMin、xMax、yMin、yMax

建立一個與函數繪圖區域相對應的邏輯視窗。所有參數皆必填。

如果繪製物件的一部分位於視窗之外，則系統將會剪切輸出（未顯示），而不會顯示錯誤訊息。

如果 xmin 大於或等於 xmax，或者 ymin 大於或等於 ymax，則系統會顯示錯誤訊息。

在新設定中，系統不會重新繪製在執行 SetWindow 指令之前所繪製的任何物件。

若要將視窗參數重設為預設值，請使用:

SetWindow 0,0,0,0

SetWindow 0,160,0,120

如此一來，輸出視窗將設定為左下角的 0,0，且寬度和高度會分別設定為 160 和 120

DrawLine 0,0,100,100

SetWindow 0,160,0,120

SetPen 3,3

DrawLine 0,0,100,100

U

UseBuffer	目錄 > CXII
UseBuffer 繪製至螢幕外函數繪圖緩衝區而非螢幕（以增加效能）此指令與 PaintBuffer 搭配使用，可在程式產生多個圖形物件時提高螢幕的顯示速度。若使用 UseBuffer，只有在執行下一個 PaintBuffer 指令後才會顯示所有圖形。您只需在程式中呼叫一次 UseBuffer，亦即每次使用 PaintBuffer 時都不需要相應的 UseBuffer	UseBuffer For n,1,10 x:=randInt(0,300) y:=randInt(0,200) radius:=randInt(10,50) Wait 0.5 DrawCircle x, y, 半徑 EndFor PaintBuffer 此程式將一次顯示全部結果，即 10 個圓。如果移除「UseBuffer」指令，則系統會在繪製每個圓時即時顯示。
另請參考:PaintBuffer

UseBuffer

目錄 >
CXII

UseBuffer

繪製至螢幕外函數繪圖緩衝區而非螢幕（以增加效能）

此指令與 PaintBuffer 搭配使用，可在程式產生多個圖形物件時提高螢幕的顯示速度。

若使用 UseBuffer，只有在執行下一個 PaintBuffer 指令後才會顯示所有圖形。

您只需在程式中呼叫一次 UseBuffer，亦即每次使用 PaintBuffer 時都不需要相應的 UseBuffer

UseBuffer

For n,1,10

x:=randInt(0,300)

y:=randInt(0,200)

radius:=randInt(10,50)

Wait 0.5

DrawCircle x, y, 半徑

EndFor

PaintBuffer

此程式將一次顯示全部結果，即 10 個圓。

如果移除「UseBuffer」指令，則系統會在繪製每個圓時即時顯示。

另請參考:PaintBuffer