% $Id: iscanning.tex,v 1.18 2006/02/09 20:07:56 glasser Exp $
% $Source: /afs/sipb/project/doc/iscanning/RCS/iscanning.tex,v $

\documentclass[12pt]{article}
\usepackage[conditional]{draftcopy}
\usepackage{helvet}    % not necessary for San-serif.
\usepackage[margin=3pc]{geometry}
\usepackage{fancyhdr}
  \renewcommand{\headrulewidth}{0pt} % fancyhdr sucks.
\usepackage{graphicx}

\def\rcsid#1,v #2 #3 #4${\def\rcsrev{#2}\def\rcsdate{#3}}
\rcsid $Id: iscanning.tex,v 1.18 2006/02/09 20:07:56 glasser Exp $

\pagestyle{plain}

% Courtesy of Ken Clary <kenclary@mit.edu>, code for graphics positioning
\def\corners{\raisebox{\footskip}[0pt][0pt]{%
  \vbox to\textheight{%
    \hbox to\textwidth{%
       \includegraphics[bb=0 0 201 201,height=4pc]{fancy-owl.ps}%
       \hfill%
       \includegraphics[bb=125 190 481 602,height=4pc]{whacker.eps}}%
    \vfill%
	{\tiny This document is%
	  \texttt{/afs/sipb/project/doc/current/iscanning.pdf}.%
	\hfill%
	Sheet-fed scanning is complicated but doable. Ask a SIPB member
	to look at\texttt{ /mit/scanner/bin/adfscan}.}%
}}}

\begin{document}
\sf % San-serif the document.
\thispagestyle{fancy}
\fancyhf{}
\lfoot{\corners}
\begin{center} 
% jhawk XXX: Why do we call this an ``inessential'' document? It's just
% confusing since users don't know what it means.
\emph{\bf Inessential Scanning on the SIPB Scanner}\\
% jhawk XXX: do we really need to blow a line by crediting people?
\emph{\{jemorris,jdaniel,aatharuv\}@mit.edu}\\
Revision \rcsrev, last revised \rcsdate.
\end{center}

\noindent
\textbf{If you have any problems or questions, just ask! We're here to help!}
% XXX: Can't eliminate the left margin space. Wtf?
% \noindent left margin test
\begin{enumerate}
% \addtolength{\parskip}{-2pt}	% When space gets tight.
\item Log in on the computer next to the scanner
(\emph{opus.mit.edu}).  If the machine is in use, please ask to use
the scanner.

\item Position the document on the scanner glass, as with a photocopier.
At the \texttt{athena\%} prompt, run:

\begin{tabular}{ll}
\texttt{cd /var/tmp}& Go to the directory to store large files on the scanning computer.\\

\texttt{add graphics scanner}& Add two lockers whose software you need.\\

\texttt{xv\&}& Start \emph{xv}, for playing with picture size, format,
etc, after scanning.\\

\texttt{xscanimage epson\&}& Start the scanner software.\\

\end{tabular}

%   Use of the pilcrow (\P, aka paragraph symbol; cf
% http://en.wikipedia.org/wiki/Pilcrow) here and later in this
% document is used to indicate a conceptual new paragraph, even though
% it may not be apparent from the reduced inter-paragraph linespacing.
%   Some may feel that it is confusing or perplexing, but I personally
% think it adds a nice stylistic touch to the document, and any confusion
% it might engender is minimal. "They can safely be ignored."
%             --jhawk 27 Jan 2005
\P~Sometimes, \emph{xscanimage} complains: ``\texttt{Failed to open
device `epson': Invalid argument}.'' If so, make sure the scanner is
on, and try running \emph{xscanimage} again. If this doesn't work,
point a SIPB member at this:
% \parbox[t]{5in}
{\tiny This often means that the scanner device isn't
world readable. Become root and make it world readable: \texttt{\bf
chmod 666 /dev/sg0}}

\item Select the {\bf Scan mode} field: \emph{Color} or \emph{Gray}
for pictures, as appropriate.  \emph{Binary} can be reasonable for
text, but does not preview acceptably. If necessary, you can select
one of them after previewing. Don't change the bit depth unless you
are sure you need to.

\item Click {\bf Preview Window}, and then {\bf Acquire Preview} to
see a low resolution version of your picture.  (If you move the paper,
hit {\bf Acquire Preview} again.)

\item You can change the resolution, brightness, and contrast with the
sliders; or click on them, use the arrow keys, and tab between fields.
For resolution, we recommend between 100 and 300dpi.  Higher
resolutions take up a lot of space; the box above the {\bf Scan}
button will tell you how much unless you've changed the {\bf Scan
mode} since previewing.  \parbox[t]{3in}{\tiny Athena printers can
print at 600dpi. (The preview window scans at 50dpi.)}

\item Use the mouse to drag a rubber-band box
% jhawk XXX: ``marquee''?
around the part of the picture you want to scan.  Do not resize the
preview window (the program will misbehave).

% jhawk XXX: Isn't it too late to change the filename after you
% hit Scan?
\item Hit {\bf Scan}.  This will pop up a window with a progress bar
which will disappear when it's finished. The file name defaults to
{\bf out.pnm}, and the scanner only writes in .pnm format. PNM files
are very space-inefficient, and use no compression, so be sure to
convert to a different file format after scanning and before you leave
(see below). If you get ``\texttt{Permission denied},'' another user
has left behind a file of the same name---change your file name.


% jhawk XXX: prior text; need to work in quota in new text:
%% The file will be in PPM format, and it's name defaults to {\bf
%% out.pnm}, change the name if you wish, but keep it something ending in
%% .pnm (PNM is a subset of PPM).  PPM files are big so you don't want
%% them in your homedir (you can use {\tt quota~-v} to see how much space
%% you have left there).

\item Load the file into {\emph xv}.  (If you don't know how to use
\emph{xv}, ask for someone to show you.  Right-click in the \emph{xv}
window get a control window.) Use \emph{xv} to crop the dimensions, or
to change anything else.  Then save the picture in an appropriate
format (GIF, JPEG, PNG, Postscript, or TIFF) in your home directory.
Save using the \texttt{/mit} path; e.g. you might use
\texttt{/mit/\emph{username}/flowers.gif} from \emph{xv} to save a GIF
of flowers to your top-level directory.  Saving into your home
directory is important; if you leave the files only in
\texttt{/var/tmp}, you won't be able to access them from any other
workstation, and they will be deleted automatically. {\tiny Try
\texttt{gimp\&} instead of \texttt{xv\&} for a more PhotoShop-like
experience.}

\P~If \emph{xv} runs out of memory, type {\tt unlimit} and restart
\emph{xv}.

\item To scan another piece of the same paper, drag another
rubber-band box and repeat.  If you move the paper or replace it, hit
{\bf Acquire Preview} in the preview window afterwards.

\item Before you leave, please rm all the files you left in /var/tmp;
otherwise it fills up and others can't save.  Remember to copy or move
what you want to keep to your homedir first.

\end{enumerate}

\vfill


% LaTeX, shut up about vertical space issues.
\vbadness=10001

\end{document}
