pixval (Image Processing Toolbox User's Guide)

Image Processing Toolbox User's Guide

Display information about image pixels

Syntax

pixval on
pixval off
pixval
pixval(fig,option)
pixval(ax,option)
pixval(H,option)

Description

pixval on turns on interactive display of information about image pixels in the current figure. pixval installs a black bar at the bottom of the figure, which displays the (x,y) coordinates for whatever pixel the cursor is currently over and the color information for that pixel. If the image is binary or intensity, the color information is a single intensity value. If the image is indexed or RGB, the color information is an RGB triplet. The values displayed are the actual data values, regardless of the class of the image array, or whether the data is in normal image range.

If you click the image and hold down the mouse button while you move the cursor, pixval also displays the Euclidean distance between the point you clicked and the current cursor location. pixval draws a line between these points to indicate the distance being measured. When you release the mouse button, the line and the distance display disappear.

You can move the display bar by clicking it and dragging it to another place in the figure.

pixval off turns interactive display off in the current figure. You can also turn off the display by clicking the button on the right side of the display bar.

pixval toggles interactive display on or off in the current figure.

pixval(fig,option) applies the pixval command to the figure specified by fig. option is a string containing 'on' or 'off'.

pixval(ax,option) applies the pixval command to the figure that contains the axes ax. option is a string containing 'on' or 'off'.

pixval(H,option) applies the pixval command to the figure that contains the image object H. option is a string containing 'on' or 'off'.

Example

```
figure, imshow peppers.png
pixval
```

See Also

impixel, improfile

phantom poly2mask