Documentation

imdisplayrange

Display Range tool

Use theimdisplayrangefunction to create a Display Range tool. The Display Range tool shows the display range of the grayscale image or images in the figure.

Syntax

imdisplayrange
imdisplayrange(h)
imdisplayrange(hparent,himage)
htool = imdisplayrange(___)

Description

imdisplayrangecreates a Display Range tool in the current figure.

imdisplayrange(h)creates a Display Range tool in the figure specified by the handleh.

imdisplayrange(hparent,himage)creates a Display Range tool inhparentthat shows the display range ofhimage.

htool= imdisplayrange(___)returns a handle to the Display Range tool uipanel.

Examples

Create Display Range Tool

Display an image and include the Display Range tool.

imshow('bag.png'); imdisplayrange;

Import a 16-bit DICOM image and display it with its default range and scaled range in the same figure.

dcm = dicomread('CT-MONO2-16-ankle.dcm'); subplot(1,2,1), imshow(dcm); subplot(1,2,2), imshow(dcm,[]); imdisplayrange;

Input Arguments

collapse all

Handle to a figure, axes, uipanel, or image graphics object, specified as a handle. Axes, uipanel, or figure objects must contain at least one image object.

Handle to a figure or uipanel object that contains the Display Range tool, specified as a handle.

Handle to one or more images, specified as a handle or an array of image handles.

Output Arguments

collapse all

Handle to Display Range tool uipanel, returned as a handle.

Tips

  • The Display Range tool is a uipanel object, positioned in the lower-right corner of the figure. It contains the labelDisplay range:followed by the display range values for the image.

  • For an indexed, truecolor, or binary image, the display range is not applicable and is set to empty ([]).

  • The Display Range tool can work with multiple images in a figure. When the pointer is not in an image in a figure, the Display Range tool displays[black white].

See Also

Introduced before R2006a

Was this topic helpful?