\section{The Snapshot Window}\index{Snapshot window}\index{window, Snapshot}
%
%
%
\begin{figure}[H]
%\vspace{3.0in}
\centerline{\psfig{figure=ps/snapshot.ps,height=123pt}}
\caption{\label{snapshot}
The Snapshot window.
}
\end{figure}
 
%
%
%
\begin{description}
 
\item[Window title:] DsTool:  Snap
\item[Function:] The Snapshot window allows the user to store the image displayed in the canvas of 
	a 2-D View window in an image file.
\item[Description:] The Snapshot window is opened by selecting the Snapshot option 
	from the Options menu button located in any 2-D View window.  The image that will be saved is the image
	in the 2-D View window from which the Snapshot window is opened.  In order to save an image from
	a different 2-D View window, the Snapshot window must be closed, and re-opened from the other
	2-D View window.  The user may save the image to an image file in PPM, GIF, TIFF, or X11 Bitmap 
	format, and view the output.
\item[Panel items:] \mbox{}
	\begin{itemize}
        \item Directory read-write text field: 
                Displays the currently selected directory to which DsTool will save the image.  
                The default is the current working directory.  
	\item Filename read-write text field:
                Displays the currently selected filename to which
                DsTool will save the image.  The default is the file ``twod.snap''.
	\item Hor Width (Pixels) numeric field:
		Displays the (horizontal) width of the image in pixels.
	\item Ver Height (Pixels) numeric field:
		Displays the (vertical) height of the image in pixels.
	\item Hor Offset (Pixels) numeric field:	
		Displays the number of pixels to offset the image to the left.
		That is, if hor offset is set to a positive number, then the image in the 2-D 
		View window will appear that number of pixels to the left in the saved image.
		If hor offset is set to a negative number, then the image in the 2-D View
		window will appear (the absolute value of) that number of pixels to the right 
		in the saved image.
	\item Ver Offset (Pixels) numeric field:
		Displays the number of pixels to offset the image up. 
		That is, if ver offset is set to a positive number, then the image in the 
		2-D View window will appear that number of pixels up in the saved image.
		If ver offset is set to a negative number, then the image in the 2-D View
		window will appear (the absolute value of) that number of pixels down in the saved image.
	\item Format stack setting:\index{image formats}
		Allows the user to choose the file format in which to save the image.   The allowed formats are:
		X11 Bitmap, PPM, GIF, and TIFF.  The default format is X11 Bitmap.   To save into GIF and TIFF formats,
		DsTool first saves into X11 Bitmap format, then calls an external program (the default is ``convert'')
		to convert to GIF or TIFF format.  For information on changing this external program, see the 
		accompanying documentation in \unix{\$DSTOOL/my\_dstool/README}\index{customization}.
	\item Go window button:\index{Files window}\index{window, Files}
		Opens and brings to the foreground the Files window to save the data to an image file.
	\item Preview command/window button:
		Invokes an external program which opens a window containing the image.  The file must be
		saved before this option is used.  The default program is ``xv''.  For information on changing
		this external program, see the accompanying documentation 
                in \unix{\$DSTOOL/my\_dstool/README}\index{customization}.
	\item Dismiss command button:
		Closes the Snapshot window.   
%The fields will revert to their default values when the window is closed.  
	\end{itemize}
\end{description}
