Setting Toolbox Display Preferences :: Displaying and Exploring Images (Image Processing Toolbox User's Guide)

Image Processing Toolbox User's Guide

Setting Toolbox Display Preferences

You can use Image Processing Toolbox preferences to control certain characteristics of how imshow and imtool display images on your screen. For example, using toolbox preferences, you can specify the initial magnification used by imtool and imshow.

This section

Lists the preferences supported by the toolbox
Describes how to get the current value of a preference using the iptgetpref function
Describes how to set the value of a preference using the iptsetpref function

Toolbox Preferences

The Image Processing Toolbox supports several preferences that affect how imshow and imtool display images. The following table lists these preferences with brief descriptions. For detailed information about toolbox preferences and their values, see the iptsetpref reference page.

Toolbox Preference
Description

ImshowBorder
Controls whether imshow displays the figure window as larger than the image (leaving a border between the image axes and the edges of the figure), or the same size as the image (leaving no border).

ImshowAxesVisible
Controls whether imshow displays images with the axes box and tick labels.

ImshowInitialMagnification
Controls the magnification imshow uses when it initially displays an image. This preference can be overridden for a single call to imshow; see Specifying the Initial Image Magnification for more details.

ImtoolInitialMagnification
Controls the magnification the Image Tool uses when it initially displays an image. This preference can be overridden for a single call to imtool; see Specifying the Initial Image Magnification for more details.

Toolbox Preference	Description
`ImshowBorder`	Controls whether `imshow` displays the figure window as larger than the image (leaving a border between the image axes and the edges of the figure), or the same size as the image (leaving no border).
`ImshowAxesVisible`	Controls whether `imshow` displays images with the axes box and tick labels.
`ImshowInitialMagnification`	Controls the magnification `imshow` uses when it initially displays an image. This preference can be overridden for a single call to `imshow`; see Specifying the Initial Image Magnification for more details.
`ImtoolInitialMagnification`	Controls the magnification the Image Tool uses when it initially displays an image. This preference can be overridden for a single call to `imtool`; see Specifying the Initial Image Magnification for more details.

Retrieving the Values of Toolbox Preferences

To determine the current value of a preference, use the iptgetpref function. This example uses iptgetpref to determine the value of the ImtoolInitialMagnification preference.

iptgetpref('ImtoolInitialMagnification')

ans =

   100

Preference names are case insensitive and can be abbreviated. For more information, see the iptgetpref reference page.

Setting the Values of Toolbox Preferences

To specify the value of a toolbox preference, use the iptsetpref function. This example calls iptsetpref to specify that imshow resize the figure window so that it fits tightly around displayed images.

```
iptsetpref('ImshowBorder', 'tight');
```

For detailed information about toolbox preferences and their values, see the iptsetpref reference page.

The value you specify lasts for the duration of the current MATLAB session. To preserve your preference settings from one session to the next, include the iptsetpref commands in your startup.m file.

Printing Images Building GUIs with Modular Tools