chi96.dtx

FERET人脸库的处理代码。内函预处理

% \iffalse meta-comment
%
% Copyright 1995 the CHI96 commitee and any individual authors
% listed elsewhere in this file.  All rights reserved.
%
% For further copyright information see the file legal.txt, and any
% other copyright notices in this file.
%
% This package is distributed in the hope that it will be useful,
% but WITHOUT ANY WARRANTY; without even the implied warranty of
% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
%
% For error reports concerning UNCHANGED versions of this file no more
% than one year old, see bugs.txt.
%
% Please do not request updates from us directly.  Primary
% distribution is through the CTAN archives.
%
%
% IMPORTANT COPYRIGHT NOTICE:
%
% You are NOT ALLOWED to distribute this file alone.
% You are NOT ALLOWED to distribute this file alone.
%
% You are allowed to distribute this file under the condition that it is
% distributed together with all the files listed in manifest.txt.
%
% If you receive only some of these files from someone, complain!
%
% Permission is granted to copy this file to another file with a clearly
% different name and to customize the declarations in that copy to serve
% the needs of your installation, provided that you comply with
% the conditions in the file legal.txt.
%
% However, NO PERMISSION is granted to produce or to distribute a
% modified version of this file under its original name.
%
% You are NOT ALLOWED to change this file.
%
%
% \fi
% \CheckSum{144}
%% \CharacterTable
%%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
%%   Digits        \0\1\2\3\4\5\6\7\8\9
%%   Exclamation   \!     Double quote  \"     Hash (number) \#
%%   Dollar        \$     Percent       \%     Ampersand     \&
%%   Acute accent  \'     Left paren    \(     Right paren   \)
%%   Asterisk      \*     Plus          \+     Comma         \,
%%   Minus         \-     Point         \.     Solidus       \/
%%   Colon         \:     Semicolon     \;     Less than     \<
%%   Equals        \=     Greater than  \>     Question mark \?
%%   Commercial at \@     Left bracket  \[     Backslash     \\
%%   Right bracket \]     Circumflex    \^     Underscore    \_
%%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%%   Right brace   \}     Tilde         \~}
%
% \iffalse
\NeedsTeXFormat{LaTeX2e}[1995/06/01]
%<*dtx>
\ProvidesFile{chi96.dtx}
%</dtx>
%<driver>\ProvidesFile{chi96.drv}
%<chi96>\ProvidesClass{chi96}
%<*chi96|dtx>
              [1995/11/14 1.1 CHI 96
%</chi96|dtx>
%<chi96>                       document class]
%<*driver>
              documentation]

\newcommand*{\Lopt}[1]{\textsf {#1}}
\newcommand*{\BibTeX}{{\rm B\kern-.05em{\sc i\kern-.025em b}\kern-.08em\TeX}}

\documentclass{ltxdoc}
\begin{document}
 \DocInput{chi96.dtx}
\end{document}
%</driver>
% \fi
%
% \GetFileInfo{chi96.dtx}
%
% \title{Package `chi96' for \LaTeXe\thanks{This
%    file has version number \fileversion, last revised \filedate.}}
%
% \author{%
% Copyright (C) 1995 by Thomas Schulze
% }
% \date{\filedate}
% \maketitle
% \tableofcontents
%
% \StopEventually{}    ^^A
%
% \section{Abstract}
%    Most of this file is a variation of the standard document class
%    |article|.
%    Altogether it implements a class which
%    meets the formatting requirements for CHI 96. It is
%    strongly advised to be used whenever an author wants to send
%    his/her work as a submission to CHI 96. This documentation
%    does \textit{not} follow these guidelines, it is conformant to
%    standard \LaTeXe{} documentation. See the enclosed file
%    \texttt{96pubsf.tex} for an example of a CHI 96 formatted document.
%
%    Note: We do not provide a conforming \BibTeX{} style file. We really
%    think its not worth the time. Use the |thebibliography| environment
%    for your (probably and/or hopefully) short bibliography.
%
%    Another note: Currently we have no method for automatic placement
%    of the copyright box (the last 2.5cm of the left column on the first
%    page). Look into the example file, we implemented it with a
%    carefully placed |\vspace*{2.5cm}| command. A possible solution
%    is beeing thought of and will maybe included in the next
%    version.
%
% \section{Declaration of Options}
%
%  \subsection{Multicols option}
%
%    The option \Lopt{multicols} controls wether we use the \textit{multicols}
%    package to get balanced columns but with some problems with the
%    |title|-command. When not given we use plain old |twocolumn| as
%    an option to the underlying |article|-class. This can not balance
%    the columns on the last page.
%    \begin{macrocode}
\newif\if@multicols
\@multicolsfalse
\DeclareOption{multicols}{
 \@multicolstrue}
%    \end{macrocode} 
%
%  \subsection{Psfonts option}
%
%    The option \Lopt{psfonts} tries to use Postscript fonts. As specified
%    in |96pubsf| plain text shall be typeset using the font~\textit{Times}
%    or \textit{Times New Roman}. 
%    \begin{macrocode}
\newif\if@psfonts
\@psfontsfalse
%
\DeclareOption{psfonts}{
 \@psfontstrue}
%    \end{macrocode}
%
%  \subsection{Font sizes}
%
%    CHI 96 requires conforming articles to be written in a 10pt font.
%    We don't want the author to override it, so we just spit out a
%    message and ignore the offending font size command.
%    \begin{macrocode}
\DeclareOption{11pt}{\ClassWarning{chi96}{%
  CHI 96 does not allow the use of fonts in size 11pt.\MessageBreak
  We will continue with size 10pt.}}
\DeclareOption{12pt}{\ClassWarning{chi96}{%
  CHI 96 does not allow the use of fonts in size 12pt.\MessageBreak
  We will continue with size 10pt.}}
%    \end{macrocode}
%
%  \subsection{Titlepage}
%
%    We do not permit the optional separat \Lopt{titlepage} of the
%    article class. So, we issue a warning and ignore the request.
%    \begin{macrocode}
\DeclareOption{titlepage}{\Classwarning{chi96}{%
  CHI 96 does not allow the use of a separate titlepage.\MessageBreak
  We will ignore your request.}}
%    \end{macrocode}
%
%  \subsection{Other options}
%
%    Every other option will be passed to our parent class, |article|.
%    This \textit{may} not be the right behaviour for every option.
%    If you encounter problems or if an option disagrees with CHI~96
%    guidelines, please send me a message.
%    \begin{macrocode}
\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}}
%    \end{macrocode}
%
% \section{Execution of Options}
%
%    Here we execute the default options to initialize certain
%    variables. Note for Europeans and other people outside
%    US: Its perfectly legal to use A4 paper or something else.
%    We take care for the position of your text on the physical
%    paper, so go ahead, use A4 (even A3 could be used).
%    \begin{macrocode}
\ExecuteOptions{letterpaper,final}
%    \end{macrocode}
%
%    Now we are ready to process the users option.
%    The |\ProcessOptions| command causes the execution of the code
%    for every option \Lopt{FOO} which is declared and for which the user typed
%    the \Lopt{FOO} option in his |\documentclass| command.
%    For every option \Lopt{BAR} he typed,
%    which is not declared, the option is assumed to be a global option.
%    \begin{macrocode}
\ProcessOptions
%    \end{macrocode}
%
%  \section{Loading Classes}
%
%    The CHI 96 class is derived from the \LaTeXe{} standard class
%    |article|. We load it after all options are processed to
%    let it take use of the other options. And of course, we modify
%    certain things to match the required layout.
%    \begin{macrocode}
\if@multicols
 \LoadClass[10pt]{article}
\else
 \LoadClass[10pt,twocolumn]{article}
\fi
%    \end{macrocode}
%
%  \section{Loading Packages}
%
%    The CHI 96 formatting guidelines suggest a twocolumn format with
%    balanced paragraphs. So we may need the presence of the package
%    |multicol|, which will do that job automagically. We use it
%    automagically by using the document hooks for switching multi
%    columns on or off. This is a sub-optimal solution. Note: You have to
%    specify the |\title| and |\author| in the preamble of your file.
%    The |\date| command is ignored, anyway.
%    \begin{macrocode}
\if@multicols
 \RequirePackage{multicol}
 \AtBeginDocument{\maketitle\begin{multicols}{2}}
 \AtEndDocument{\end{multicols}}
\fi
%    \end{macrocode}
%
%    If the user requested the use of Postscript fonts we load the |times|
%    package.
%    \begin{macrocode}
\if@psfonts
 \RequirePackage{times}
\fi