% -*- texinfo -*-
% @deftypefn {Function File} {@var{X} =} grayslice (@var{I},@var{n})
% @deftypefnx {Function File} {@var{X} =} grayslice (@var{I},@var{v})
% creates an indexed image @var{X} from an intensitiy image @var{I}
% using multiple threshold levels.
% A scalar integer value @var{n} sets the levels to
% @example
%
% @group
% 1 2 n-1
% -, -, ..., ---
% n n n
% @end group
% @end example
%
% X = grayslice(I,5);
%
% For irregular threshold values a real vector @var{v} can be used.
% The values must be in the range [0,1].
%
% @group
% X = grayslice(I,[0.1,0.33,0.75,0.9])
% @end group
%
% @seealso{im2bw}
% @end deftypefn