Point
Point region of interest
Description
A Point
object specifies the position of a point
region-of-interest (ROI). You can customize the appearance and interactive behavior of the
ROI.
For more information about using the ROI, including keyboard shortcuts, see Tips.
Creation
There are two ways to create a Point
object. For more information, see
Create ROI Shapes.
Use the
drawpoint
function. Use this function when you want to create the ROI and set the appearance in a single command. You can specify the position of the ROI interactively by drawing the ROI over an image using the mouse, or programmatically by using name-value arguments.Use the
images.roi.Point
function described here. Use this function when you want to specify the appearance and behavior of the ROI before you specify the position of the ROI. After creating the object, you can specify the position interactively by using thedraw
function or programmatically by modifying properties of the object.
Syntax
Description
creates a
roi
= images.roi.PointPoint
object with default properties.
creates an ROI object in the axes specified by roi
= images.roi.Point(ax
)ax
.
sets properties of the
ROI using name-value arguments. You can specify multiple name-value arguments.roi
= images.roi.Point(___,PropertyName=Value
)
Example: images.roi.Point(Color="y")
creates a yellow colored
Point
object.
Input Arguments
Properties
Object Functions
addlistener | Create event listener bound to event source |
beginDrawingFromPoint | Begin drawing ROI from specified point |
bringToFront | Bring ROI to front of Axes stacking order |
draw | Begin drawing ROI interactively |
wait | Block MATLAB command line until ROI operation is finished |
Examples
More About
Tips
To draw the ROI interactively using the
draw
ordrawpoint
function, position the pointer on the image and then click and release.The ROI supports the following interactivity, including keyboard shortcuts.
Behavior Keyboard shortcut Cancel drawing ROI. Press Esc. The function returns a valid ROI object with an empty Position
property.Move the ROI. Position the pointer over the ROI. The pointer changes to a circle. Click and drag to move the ROI. Delete the ROI. Position the pointer over the point, right-click, and then choose Delete Point from the context menu. You can also delete the ROI programmatically using the delete
function.For information about using an ROI in an app created with App Designer, see Using ROIs in Apps Created with App Designer.