您在此处：TI‑Nspire™ CX Reference Guide > TI-Nspire™ CX II - Draw 命令

TI-Nspire™ CX II - Draw 命令

这是 TI-Nspire™ 参考指南和 TI-Nspire™ CAS 参考指南的补充文档。所有 TI-Nspire™ CX II 命令将合并，并在 TI-Nspire™ 参考指南和 TI-Nspire™ CAS 参考指南的 5.1 版本中发布。

图形编程

在 TI-Nspire™ CX II 手持设备和 TI-Nspire™ 桌面应用程序中添加了用于图形编程的新命令。

TI-Nspire™ CX II 手持设备将在执行图形命令时切换到此图形模式，并在程序完成后切换回之前执行程序的上下文。

在执行程序期间，屏幕将在顶部菜单栏中显示“正在运行...”。程序完成后，将显示“已完成”。执行任何按键操作都会使系统退出图形模式。

•

在执行 TI Basic 程序期间遇到其中一个 Draw（图形）命令时，将导致自动转换到图形模式。

•

只有在从计算器执行程序时，才会发生此转换;即文档或便笺本中的计算器中。

•

在程序终止时，将退出图形模式。

•

图形模式仅可用于 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, width, height 如果未指定参数，则清除整个屏幕。如果指定了 x、y、width 和 height，则将清除由这些参数定义的矩形。	清除清除整个屏幕清除 10,10,100,50 清除左上角位于 (10, 10) 且宽度为 100、高度为 50 的矩形区域

清除

目录 >
CXII

清除 x, y, width, height

如果未指定参数，则清除整个屏幕。

如果指定了 x、y、width 和 height，则将清除由这些参数定义的矩形。

清除

清除整个屏幕

清除 10,10,100,50

清除左上角位于 (10, 10) 且宽度为 100、高度为 50 的矩形区域

D

DrawArc	目录 > CXII
DrawArc x, y, width, height, startAngle, arcAngle 使用提供的起始角度和圆弧角度在已定义的边界矩形内绘制圆弧。 x, y:边界矩形的左上角坐标 width, height:边界矩形的尺寸 “圆弧角度”定义了弧的扫过范围。这些参数可以作为表达式提供，这些表达式计算得出数值，然后四舍五入为最接近的整数。	DrawArc 20,20,100,100,0,90 DrawArc 50,50,100,100,0,180
另请参见:FillArc

DrawArc

目录 >
CXII

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

使用提供的起始角度和圆弧角度在已定义的边界矩形内绘制圆弧。

x, y:边界矩形的左上角坐标

width, height:边界矩形的尺寸

“圆弧角度”定义了弧的扫过范围。

这些参数可以作为表达式提供，这些表达式计算得出数值，然后四舍五入为最接近的整数。

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

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

另请参见:FillArc

DrawCircle	目录 > CXII
DrawCircle x, y, radius x, y:中心的坐标 radius:圆的半径	DrawCircle 150,150,40
另请参见:FillCircle

DrawCircle

目录 >
CXII

DrawCircle x, y, radius

x, y:中心的坐标

radius:圆的半径

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, width, height x, y:矩形的左上角坐标 width, height:矩形（从起始坐标向下和向右绘制的矩形）的宽度和高度。注:在指定的坐标和尺寸周围的边界框中绘制线条，使绘制的矩形的实际尺寸大于宽度和高度指示的值。	DrawRect 25,25,100,50
另请参见:FillRect

DrawRect

目录 >
CXII

DrawRect x, y, width, height

x, y:矩形的左上角坐标

width, height:矩形（从起始坐标向下和向右绘制的矩形）的宽度和高度。

注:在指定的坐标和尺寸周围的边界框中绘制线条，使绘制的矩形的实际尺寸大于宽度和高度指示的值。

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, width, height startAngle, arcAngle x, y:边界矩形的左上角坐标使用提供的起始角度和圆弧角度在已定义的边界矩形内绘制并填充圆弧。默认填充颜色为黑色。可以通过 SetColor 命令设置填充颜色 “圆弧角度”定义了弧的扫过范围	FillArc 50,50,100,100,0,180

FillArc

目录 >
CXII

FillArc x, y, width, height startAngle, arcAngle

x, y:边界矩形的左上角坐标

使用提供的起始角度和圆弧角度在已定义的边界矩形内绘制并填充圆弧。

默认填充颜色为黑色。可以通过 SetColor 命令设置填充颜色

“圆弧角度”定义了弧的扫过范围

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

FillCircle	目录 > CXII
FillCircle x, y, radius x, y:中心的坐标使用指定的半径在指定的中心绘制并填充圆。默认填充颜色为黑色。可以通过 SetColor 命令设置填充颜色。	FillCircle 150,150,40 此处！

FillCircle

目录 >
CXII

FillCircle x, y, radius

x, y:中心的坐标

使用指定的半径在指定的中心绘制并填充圆。

默认填充颜色为黑色。可以通过 SetColor 命令设置填充颜色。

FillCircle 150,150,40

此处！

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, width, height x, y:矩形的左上角坐标 width, height:矩形的宽度和高度绘制并填充左上角位于由 (x,y) 指定的坐标的矩形默认填充颜色为黑色。可以通过 SetColor 命令设置填充颜色注:线条和颜色由 SetColor 及 SetPen 指定	FillRect 25,25,100,50

FillRect

目录 >
CXII

FillRect x, y, width, height

x, y:矩形的左上角坐标

width, height:矩形的宽度和高度

绘制并填充左上角位于由 (x,y) 指定的坐标的矩形

默认填充颜色为黑色。可以通过 SetColor 命令设置填充颜色

注:线条和颜色由 SetColor 及 SetPen 指定

FillRect 25,25,100,50

G

getPlatform()	目录 > CXII
getPlatform() Returns: “dt”（在桌面软件应用程序上） “hh”（在 TI-Nspire™ CX 手持设备上） “ios”（在 TI-Nspire™ CX iPad® 应用程序上）

getPlatform()

目录 >
CXII

getPlatform()

Returns:
“dt”（在桌面软件应用程序上）
“hh”（在 TI-Nspire™ CX 手持设备上）
“ios”（在 TI-Nspire™ CX iPad® 应用程序上）

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,radius 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,radius

EndFor

PaintBuffer

该程序将同时显示所有 10 个圆。

如果移除“UseBuffer”命令，则将在绘制时显示每个圆。

另请参见:UseBuffer

PlotXY	目录 > CXII
PlotXY x, y, shape x, y:要用于绘制形状的坐标 shape:用于指定形状的、介于 1 到 13 之间的数字 1 - 实心圆 2 - 空心圆 3 - 实心正方形 4 - 空心正方形 5 - 十字线 6 - 加号 7 - 细 8 - 中等点，实心 9 - 中等点，空心 10 - 较大点，实心 11 - 较大点，空心 12 - 最大点，实心 13 - 最大点，空心	PlotXY 100,100,1 For n,1,13 DrawText 1+22n,40,n PlotXY 5+22n,50,n EndFor

PlotXY

目录 >
CXII

PlotXY x, y, shape

x, y:要用于绘制形状的坐标

shape:用于指定形状的、介于 1 到 13 之间的数字

1 - 实心圆

2 - 空心圆

3 - 实心正方形

4 - 空心正方形

5 - 十字线

6 - 加号

7 - 细

8 - 中等点，实心

9 - 中等点，空心

10 - 较大点，实心

11 - 较大点，空心

12 - 最大点，实心

13 - 最大点，空心

PlotXY 100,100,1

For n,1,13

DrawText 1+22*n,40,n

PlotXY 5+22*n,50,n

EndFor

S

SetColor	目录 > CXII
SetColor 红色值，绿色值，蓝色值对应于红色、绿色和蓝色的有效值介于 0 和 255 之间设置用于后续 Draw 命令的颜色	SetColor 255,0,0 DrawCircle 150,150,100

SetColor

目录 >
CXII

SetColor

红色值，绿色值，蓝色值

对应于红色、绿色和蓝色的有效值介于 0 和 255 之间

设置用于后续 Draw 命令的颜色

SetColor 255,0,0

DrawCircle 150,150,100

SetPen	目录 > CXII
SetPen 粗细，类型粗细: <= 粗细 <= 3 \| 1 最细，3 最粗样式:1 = 实线，2 = 虚线，3 = 长虚线设置用于后续 Draw 命令的画笔类型	SetPen 3,3 DrawCircle 150,150,50

SetPen

目录 >
CXII

SetPen

粗细，类型

粗细: <= 粗细 <= 3 | 1 最细，3 最粗

样式:1 = 实线，2 = 虚线，3 = 长虚线

设置用于后续 Draw 命令的画笔类型

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,radius 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,radius

EndFor

PaintBuffer

该程序将同时显示所有 10 个圆。

如果移除“UseBuffer”命令，则将在绘制时显示每个圆。

另请参见:PaintBuffer