% -*- texinfo -*-
% @deftypefn {Function File} {} imshow (@var{im})
% @deftypefnx {Function File} {} imshow (@var{im}, @var{limits})
% @deftypefnx {Function File} {} imshow (@var{im}, @var{map})
% @deftypefnx {Function File} {} imshow (@var{rgb}, @dots{})
% @deftypefnx {Function File} {} imshow (@var{filename})
% @deftypefnx {Function File} {} imshow (@dots{}, @var{string_param1}, @var{value1}, @dots{})
% Display the image @var{im}, where @var{im} can be a 2-dimensional
% (gray-scale image) or a 3-dimensional (RGB image) matrix.
%
% If @var{limits} is a 2-element vector @code{[@var{low}, @var{high}]},
% the image is shown using a display range between @var{low} and
% @var{high}. If an empty matrix is passed for @var{limits}, the
% display range is computed as the range between the minimal and the
% maximal value in the image.
%
% If @var{map} is a valid color map, the image will be shown as an indexed
% image using the supplied color map.
%
% If a file name is given instead of an image, the file will be read and
% shown.
%
% If given, the parameter @var{string_param1} has value
% @var{value1}. @var{string_param1} can be any of the following:
% @table @samp
% @item 'displayrange'
% @var{value1} is the display range as described above.
% @end table
% @seealso{image, imagesc, colormap, gray2ind, rgb2ind}
% @end deftypefn