% TIMSHOW is a flexible function for displaying multiple images tightly on the
% same figure. Padding between images, grid dimensions, contrast scale,
% and colourmaps can be specified. Attributes apply to all images. Best
% results with same sized images. Grayscale or colour images.
%
% Input arguments: (any order, no string names required, just arguments)
% image(s) - any number of 2D grayscale or colour images. Rendered in the
% order they are presented, top to bottom, left to right.
% * The x-dimension of any image should not have a size of 3,
% else it will be confused for a colourmap.
%
% padval - decimal value on the interval (0, 0.5) dictating the relative
% padded spacing between images.
% Default: 0.005
%
% gridstr - string like "5x2", specifying the number of images to tile
% horizontally (5) and vertically (2)
% Default: square as possible based on num. images, wider bias
%
% minmax - minmax specification for contrast scaling, as in imshow(I,[]).
% array of size: 1 by 2, or a empty array: []
% Default: []
%
% colourmap - colourmap used for displaying images:
% array of size: M by 3 or a colourmap function
% Default: curent default figure colormap
%
% * if 2+ non-image arguments are given, only the last one is used.
%
% Examples:
%
% timshow(I1, I2, I3, I4, hot, 0, [0,1], '4x1');
% Show images I1, I2, I3, I4 using the hot colourmap, with no
% space between, contrast from 0 to 1, and in a horizontal line.
%
% timshow(DB(:).I);
% Show all image fields .I in the struct array DB using the
% default figure colourmap, automatic contrast scaling per image,
% with 0.5% of total figure size padded between, and arranged as
% close to square as possible.
%
% Jesse Knight 2015