function ShowCImage
% ShowCImage(image1,...)
% 
% OBSOLETE - Use Screen 'PutImage' instead. Also see GratingDemo.
% 
% MEX file to display matrices as color images.
%
% The passed arguments are shown as color images.  The matrix must
% have dimensions N^2 by 3.  Each column of the matrix is treated
% as one color plane with spatial dimensions N by N.  The order of
% color planes is red, green, blue.  The data in each color plane
% should be between 0 and 1.  Within a color plane, the data are
% packed with row as the inner index.   This is consistent with
% the way Matlab stores its matrices. 
%
% Because of the convention used to extract dimensions from the
% passed matrix, all images are shown as square.  Indeed, funny
% things will happen if you pass a matrix whose column dimension
% is not a perfect square.
%
% Control returns to Matlab when all of the windows have been closed.
% You cannot leave an image up and continue on in the Matlab command window.

% 8/19/94		dhb		Link in new version of pixel handling code.
% 7/11/00		dgp		Note obsolescence.

