% -*- texinfo -*-
% @deftypefn {Function File} {@var{map_out} =} brighten (@var{map}, @var{beta})
% @deftypefnx {Function File} {@var{map_out} =} brighten (@var{h}, @var{beta})
% @deftypefnx {Function File} {@var{map_out} =} brighten (@var{beta})
% Darkens or brightens the given colormap. If the @var{map} argument
% is omitted, the function is applied to the current colormap. The first
% argument can also be a valid graphics handle @var{h}, in which case
% @code{brighten} is applied to the colormap associated with this handle.
%
% Should the resulting colormap @var{map_out} not be assigned, it will be
% written to the current colormap.
%
% The argument @var{beta} should be a scalar between -1 and 1,
% where a negative value darkens and a positive value brightens
% the colormap.
% @seealso{colormap}
% @end deftypefn