The Preview command generates a plot of an image and displays it in the worksheet.

The img parameter is the image to be displayed.

The optional parameters MaxH and MaxW are the maximum height and width, respectively, to which the preview image is scaled. The units are pixels if the output option is image; otherwise they are characters. If omitted, suitable defaults are used.

The image is reduced to thumbnail size for previewing, and is displayed with axes corresponding to the pixel coordinates of the image. This is useful in determining where to crop an image.

chars = string

Specifies the characters to use when the output = text option is selected. The characters should be ordered from darkest to lightest, with the darkest listed first. The default is "@Oo*+=~- ".

method = bspline or nearest

Specifies the mode used to scale the image. See Scale. The default is bspline.

output = image or text

Specifies whether the output is an image or a text representation of the image. If the latter, the characters in the chars option represent the shades of gray in the image. The default is image, unless interface(plotdevice) is char.

     *****     *****
     *****     *****
     *****     *****
*****     *****     
*****     *****     
*****     *****     
     *****     *****
     *****     *****
     *****     *****
*****     *****     
*****     *****     
*****     *****