imoverview (Image Processing Toolbox User's Guide)

Image Processing Toolbox User's Guide

Overview navigation tool for image displayed in scroll panel

Syntax

imoverview(himage)
hfig = imoverview(himage)

Description

imoverview(himage) creates an Overview tool associated with the image specified by the handle himage, called the target image. The target image must be contained in a scroll panel created by imscrollpanel.

The Overview tool is a navigation aid for images displayed in a scroll panel. imoverview creates the tool in a separate figure window that displays the target image in its entirety, scaled to fit. Over this scaled version of the image, the tool draws a rectangle, called the detail rectangle, that shows the portion of the target image that is currently visible in the scroll panel. To view portions of the image that are not currently visible in the scroll panel, move the detail rectangle in the Overview tool.

hfig = imoverview(...) returns ta handle to the Overview tool figure.

Note

To create an Overview tool that can be embedded in an existing figure or uipanel object, use imoverviewpanel.

Example

This example creates a figure, disabling the toolbar and menubar, because the toolbox navigation tools are not compatible with the standard MATLAB zoom and pan tools. The example then creates a scroll panel in the figure and uses scroll panel API functions to set the magnification.

hFig = figure('Toolbar','none',...
'Menubar','none');
hIm = imshow('tape.png');
hSP = imscrollpanel(hFig,hIm);
api = iptgetapi(hSP);
api.setMagnification(2) % 2X = 200%
imoverview(hIm)

See Also

imoverviewpanel, imscrollpanel

imopen imoverviewpanel