Main Content

ginput

标识坐标区坐标

说明

示例

[x,y] = ginput(n) 可用于标识笛卡尔坐标区、极坐标区或地理坐标区内 n 个点的坐标。要选择一个点,请将光标移至所需位置,然后按下鼠标按键或键盘上的键。在选中全部 n 个点之前,按 Return 键可停止选择。MATLAB® 返回所选点的坐标。如果没有坐标区,则调用 ginput 会创建一个笛卡尔坐标区对象。

示例

[x,y] = ginput 可用于选择无限多个点,直到您按 Return 键为止。

示例

[x,y,button] = ginput(___) 还返回用于选择每个点的鼠标按键或键盘上的键。

示例

全部折叠

使用 ginput 标识一个坐标区中的四个点。要选择各点,请将光标移至所需位置,然后按鼠标按键或键。

[x,y] = ginput(4)

Cartesian axes with cursor for selecting a point

x =

    0.3699
    0.4425
    0.5450
    0.6130


y =

    0.6690
    0.5605
    0.4719
    0.6025

绘制标识的点。

plot(x,y);

Cartesian axes with plot of four identified points

使用 ginput 标识一个坐标区中的五个坐标。要选择各点,请将光标移至所需位置,然后按鼠标按键、小写字母键、大写字母键、数字键或空格键。返回用于选择每个点的鼠标按键或键的 ASCII 数字。

[x,y,button] = ginput(5);
button
button =

     3
   104
    32
    51
    82

在本例中,标识坐标用到了鼠标右键 (3)、小写字母键 h(104)、空格键 (32)、数字键 3 (51) 和大写字母键 R(82)。

创建地理坐标区并标识四个点的纬度和经度坐标。然后,绘制您标识的点。

geoaxes
[lat,lon] = ginput(4);

Geographic axes with cursor for selecting a point

使用 hold on 命令和 geolimits 函数来保持地图范围不变。绘制标识的点。

hold on
geolimits('manual')
geoscatter(lat,lon,'filled','b')

Geographic axes with blue circles identifying four points

输入参数

全部折叠

要标识的点的数目,指定为正整数。

输出参数

全部折叠

标识的坐标的第一个分量,以标量或列向量形式返回。

  • 对于笛卡尔坐标区,值为 x 坐标。

  • 对于极坐标区,值为 theta 角度。theta 角度在范围 [tmin, tmin+2*pi] 内,其中 tmin 是极坐标区的 ThetaLim 向量的第一个值。角度是在 ThetaDir 属性指定的方向上从零角度位置开始测量的。零角度的位置由 ThetaZeroLocation 属性指定。

  • 对于地理坐标区,值是纬度。正值对应于北纬,负值对应于南纬。

如果选择坐标区范围之外的点,则这些值是相对于笛卡尔坐标区和地理坐标区的原点的。对于极坐标区,这些值是相对于 ThetaZeroLocation 的。

标识的坐标的第二个分量,以标量或列向量形式返回。

  • 对于笛卡尔坐标区,值为 y 坐标。

  • 对于极坐标区,值是半径。每个半径值都大于或等于 rmin,其中 rmin 是极坐标区的 RLim 向量中的第一个值。

  • 对于地理坐标区,值是经度。正值对应于原点以东的位置,负值对应于原点以西的位置。

如果选择坐标区范围之外的点,仍会返回相对于坐标区原点的值。

用于标识点的键或鼠标按键,以标量或列向量形式返回。对于鼠标按键,用 1 表示鼠标左键,2 表示鼠标中键,3 表示鼠标右键。双击由两个值表示。第一个值为 1 表示鼠标左键,为 2 表示鼠标中键,为 3 表示鼠标右键。第二个值为 1。

键盘上的键由其对应的 ASCII 数字表示。屏幕上的点击由 1 表示。

例如,调用 ginput,用鼠标中键点击,用鼠标右键双击,然后按 Enter 键。输出 button 是一个包含 231 的向量。

[~,~,button] = ginput
button =

     2
     3
     1

版本历史记录

在 R2006a 之前推出

另请参阅

函数