User`s guide
15-3
api = iptgetapi(h)
api.method()
Compatibility Considerations
The class of the data returned by the ROI tools is now a handle to an ROI class, such
as imline or impoly. In addition, several undocumented methods supported by the
ROI tools have been removed: getContextMenu, setContextMenu, getDrawAPI,
addCallback, and removeCallback.
ROI Tools Support New wait and resume Methods
The ROI tools now support wait and resume methods so that they can be used in
scripts. By using the wait method, you can enable users of your script to make the initial
placement of the ROI, adjust the ROI and accept it, and then use the position in the
script. For example, using the wait method with an ROI tool, you could write a script
that creates a mask.
The resume method is a programmatic way to return control to the command line. When
called after wait, resume causes wait to return the accepted position of the ROI.
Interactively Add New Vertices to ROI Polygons
You can now add vertices interactively to polygonal ROIs that you define using the
impoly function. To create the new vertex, position the pointer over an edge of the
polygon and press the A key. The pointer changes shape. Click the mouse to add a new
vertex. The roifill and roipoly functions, which use impoly to implement ROIs, also
support this new capability.
Enhancements to Color Functions
The following color functions have been enhanced.
makecform Supports Converting Between sRGB and CMYK
The makecform function now supports two new color space conversion types for
converting between sRGB and CMYK: 'srgb2cmyk' and 'cmyk2srgb'.
iccwrite Creates Smaller ICC Profiles
The iccwrite function now uses certain optimizations to reduce the size of the
International Color Consortium (ICC) color profiles that it creates. iccwrite uses