\section{GCF Get Current Figure}

\subsection{Usage}

Returns the figure number for the current figure (which is also its handle,
and can be used to set properties of the current figure using \verb|set|).  
The syntax for its use
is
\begin{verbatim}
  figure_number = gcf
\end{verbatim}
where \verb|figure_number| is the number of the active figure (also the handle of
the figure).

Note that figures have handles, just like axes, images, plots, etc.  However
the handles for figures match the figure number (while handles for other 
graphics objects tend to be large, somewhat arbitrary integers).  So, to 
retrieve the colormap of the current figure, you could 
use \verb|get(gcf,'colormap')|, or to obtain the colormap for figure 3, 
use \verb|get(3,'colormap')|.
