rbbox

为区域选择创建橡皮筋框

全页折叠

语法

rbbox
rbbox(initialRect)
rbbox(initialRect,fixedPoint)
rbbox(initialRect,fixedPoint,stepSize)
finalRect = rbbox(...)

说明

rbbox 在当前图窗中初始化并跟踪橡皮筋框。它将初始框设置为 0×0 像素的矩形，将其定位在图窗的 CurrentPoint 处并从该点开始跟踪。

rbbox(initialRect) 将橡皮筋框的初始位置和大小指定为 [x y width height]，其中 x 和 y 定义左下角，width 和 height 定义大小。initialRect 使用由当前图窗的 Units 属性指定的单位，并从图窗窗口的左下角开始测量。在 rbbox 收到按钮事件之前，橡皮筋框最接近指针位置的角将随着指针移动。

rbbox(initialRect,fixedPoint) 指定橡皮筋框中保持固定的角。所有参量都使用由当前图窗的 Units 属性指定的单位，并从图窗窗口的左下角开始测量。fixedPoint 是二元素向量 [x y]。跟踪点是与 fixedPoint 定义的定位角呈斜对角关系的角。

rbbox(initialRect,fixedPoint,stepSize) 指定橡皮筋框的更新频率。跟踪点超过 stepSize 图窗单位时，rbbox 会重新绘制橡皮筋框。默认 stepsize 为 1。

finalRect = rbbox(...) 返回一个四元素向量 [x y width height]，其中 x 和 y 是框左下角的 x 和 y 分量，width 和 height 是框的大小。

示例

全部折叠

要在图窗中以交互方式创建一个注解矩形，首先创建一个名为 createRectangle.m 的程序文件。在该程序文件中：

  • 创建一个图窗。通过设置图窗的 Units 属性来归一化图窗的单位。

  • 使用 waitforbuttonpress 函数阻止语句在您点击鼠标按键之前执行。

  • 使用 rbbox 函数初始化一个橡皮筋框。通过点击并拖动形成一个矩形。当您释放鼠标按键时，rbbox 函数返回矩形的位置。

  • 使用 annotation 函数显示矩形。

function createRectangle
    figure('Units','normalized')
    waitforbuttonpress
    pos = rbbox;
    annotation('rectangle',pos,'Color','r') 
end

运行程序文件。通过点击并拖动创建矩形。

createRectangle

A figure containing a red rectangle

要在 Axes 对象中创建一个注解矩形，必须首先禁用内置交互。否则，当您拖动矩形时，坐标区将平移（在二维视图中）或旋转（在三维视图中）。有关内置交互的详细信息，请参阅对图的交互进行控制。

创建一个名为 createRectangleInAxes.m 的程序文件。在该程序文件中：

  • 将当前图窗作为变量返回，并对其单位进行归一化。

  • 使用 waitforbuttonpress 函数阻止语句在您点击鼠标按键之前执行。

  • 使用 rbbox 函数初始化一个橡皮筋框。通过点击并拖动形成一个矩形。当您释放鼠标按键时，rbbox 函数返回矩形的位置。

  • 使用 annotation 函数显示矩形。

function createRectangleInAxes
    f = gcf;
    f.Units = 'normalized';
    waitforbuttonpress
    pos = rbbox;
    annotation('rectangle',pos,'Color','r') 
end

然后，创建一个图。通过调用 disableDefaultInteractivity 函数禁用内置交互。

plot(1:10)
ax = gca;
disableDefaultInteractivity(ax)

调用程序文件并创建矩形。

createRectangleInAxes

A chart containing a red rectangle

创建矩形后，您可以通过调用 enableDefaultInteractivity 函数来重新启用内置交互。

enableDefaultInteractivity(ax)

提示

rbbox 可用于定义矩形区域和调整其大小：

  • 对于框定义，initialRect 是 [x y 0 0]，其中 (x,y) 是图窗的 CurrentPoint。

  • 要调整框的大小，initialRect 定义您调整大小的矩形区域（例如图例）。fixedPoint 是与跟踪点呈斜对角关系的角。

如果当前未按按钮，rbbox 立即返回结果。因此将 rbbox 和 waitforbuttonpress 结合使用，这样在调用 rbbox 时按下鼠标按键。释放鼠标按键时 rbbox 返回结果。

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

| | | |