diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/bosisio/graphfig.html')
-rw-r--r-- | Master/texmf-dist/doc/latex/bosisio/graphfig.html | 384 |
1 files changed, 195 insertions, 189 deletions
diff --git a/Master/texmf-dist/doc/latex/bosisio/graphfig.html b/Master/texmf-dist/doc/latex/bosisio/graphfig.html index ed228a79368..23f985da8dd 100644 --- a/Master/texmf-dist/doc/latex/bosisio/graphfig.html +++ b/Master/texmf-dist/doc/latex/bosisio/graphfig.html @@ -1,267 +1,273 @@ -<HTML> +<html> +<!-- ++ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + +| Copyright(C) 1997-2010 by F. Bosisio | +| | +| This program can be redistributed and/or modified under | +| the terms of the LaTeX Project Public License, either | +| version 1.3 of this license or (at your option) any later | +| version. The latest version of this license is in | +| http://www.latex-project.org/lppl.txt | +| and version 1.3 or later is part of all LaTeX distributions | +| version 2005/12/01 or later. | +| | +| This work has the LPPL maintenance status `maintained'. | +| The Current Maintainer of this work is F. Bosisio. | +| | +| This work consists of files graphfig.dtx and graphfig.html | +| and of the derived files graphfig.sty and graphfig.pdf. | +| | +| E-mail: fbosisio@bigfoot.com | +| CTAN location: macros/latex/contrib/bosisio/ | ++ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + +--> +<head> + <title>Package graphfig</title> +</head> +<body> + +<h1 align="CENTER"> +Package <tt>graphfig</tt><br /> +<small> +This is version 2.2, last revised 1997/12/15; documentation date 2005/04/09. +</small> +</h1> + +<p align="CENTER"> +<strong> +Author: <i>F. Bosisio</i><br /> +<small> +E-mail: <a href="mailto:fbosisio@bigfoot.com"> + <tt>fbosisio@bigfoot.com</tt> + </a><br /> +CTAN location: <a href="http://mirror.ctan.org/macros/latex/contrib/bosisio"> + <tt>macros/latex/contrib/bosisio</tt> + </a> +</small> +</strong> +</p> + +<p align="LEFT"></p> <!------------------------------------------------------------------------> +<p> -<HEAD> -<TITLE>Package graphfig</TITLE> -</HEAD> -<BODY > +<h3>Abstract</h3> +<div> +Documentation for the package <tt>graphfig</tt>. +</div> +<hr /><br /> <!------------------------------------------------------------------------> -<P> - -<H1 ALIGN="CENTER"> -Package <TT>graphfig</TT><BR> -<SMALL> -This is version 2.0, last revised 1997/15/12; documentation date 1997/15/12 -</SMALL> -</H1> - -<P ALIGN="CENTER"> -<STRONG> -Author: <I>F. Bosisio</I><BR> -<SMALL> -E-mail: <A HREF="MAILTO:bosisio@mate.polimi.it"> - <TT>bosisio@mate.polimi.it</TT> - </A><BR> -Web page: <A HREF="http://ftp.mate.polimi.it/~bosisio/LaTeX"> - <TT>http://ftp.mate.polimi.it/~bosisio/LaTeX</TT> - </A><BR> -CTAN location: <A HREF="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/supported/bosisio/"> - <TT>CTAN:macros/latex/contrib/supported/bosisio/</TT> - </A> -</SMALL> -</STRONG> -</P> - -<P ALIGN="LEFT"></P> -<!------------------------------------------------------------------------> -<P> - -<H3>Abstract</H3> -<DIV> -Documentation for the package <TT>graphfig</TT>. -</DIV> +<h2>Table of contents</h2> -<HR><BR> -<!------------------------------------------------------------------------> +<ul> + <li><a href="#SECTION01">Introduction</a></li> + <li><a href="#SECTION02">Required packages</a></li> + <li><a href="#SECTION03">The options</a></li> + <li><a href="#SECTION04">The <tt>Figure</tt> environment and its relatives</a> + <ul> + <li><a href="#SECTION04a">The <tt>graphfile</tt> command</a></li> + <li><a href="#SECTION04b">Sub-figures</a></li> + </ul></li> +</ul> -<H2>Table of contents</H2> - -<P> -<UL> <!-- Beginning of list --> - <LI><A HREF="#SECTION01">Introduction</A> - <LI><A HREF="#SECTION02">Required packages</A> - <LI><A HREF="#SECTION03">The options</A> - <LI><A HREF="#SECTION04">The <TT>Figure</TT> environment and its relatives</A> - <UL> <!-- Beginning of sublist --> - <LI><A HREF="#SECTION04a">The <TT>graphfile</TT> command</A> - <LI><A HREF="#SECTION04b">Sub-figures</A> - </UL> <!-- End of sublist --> -</UL> <!-- End of list --> -</P> - -<HR><BR> +<hr /><br /> <!------------------------------------------------------------------------> -<H2> -<A NAME="SECTION01">Introduction</A> -</H2> +<h2> +<a name="SECTION01">Introduction</a> +</h2> -<P> +<p> This package provides some commands to make the use of graphic files in LaTeX simpler. -</P> +</p> -<P> -It declares the ``<TT>Figure</TT>'' environment (capitalized!) and the two -commands ``<TT>\graphfile</TT>'' and ``<TT>\graphfile*</TT>''. +<p> +It declares the ``<tt>Figure</tt>'' environment (capitalized!) and the two +commands ``<tt>\graphfile</tt>'' and ``<tt>\graphfile*</tt>''. Combining this commands, it is possible to include graphic files in a LaTeX document very simply. -</P> +</p> -<HR><BR> +<hr /><br /> <!------------------------------------------------------------------------> -<H2> -<A NAME="SECTION02">Required packages</A> -</H2> +<h2> +<a name="SECTION02">Required packages</a> +</h2> -<P> -This package uses the ``<TT>\includegraphics*</TT>'' command defined in -the standard <TT>graphics</TT> package. -Moreover, it uses the package <TT>subfigure</TT> when the -<A HREF="#SECTION03"><TT>subfigure</TT> option</A> is specified, and the -<TT>float</TT> package if the <A HREF="#SECTION03"><TT>AllowH</TT> option</A> +<p> +This package uses the ``<tt>\includegraphics*</tt>'' command defined in +the standard <tt>graphics</tt> package. +Moreover, it uses the package <tt>subfigure</tt> when the +<a href="#SECTION03"><tt>subfigure</tt> option</a> is specified, and the +<tt>float</tt> package if the <a href="#SECTION03"><tt>AllowH</tt> option</a> is used. -</P> +</p> -<HR><BR> +<hr /><br /> <!------------------------------------------------------------------------> -<H2> -<A NAME="SECTION03">The options</A> -</H2> +<h2> +<a name="SECTION03">The options</a> +</h2> -<P> -At now, two options are available: ``<TT>subfigure</TT>'' and -``<TT>AllowH</TT>''. -</P> +<p> +At now, two options are available: ``<tt>subfigure</tt>'' and +``<tt>AllowH</tt>''. +</p> -<P> -The ``<TT>subfigure</TT>'' option allow the use of sub-figures inside a -<A HREF="#SECTION04"><TT>Figure</TT> environment</A>, in order to place -multiple pictures in a single LaTeX figure (cfr. the <TT>subfigure</TT> +<p> +The ``<tt>subfigure</tt>'' option allow the use of sub-figures inside a +<a href="#SECTION04"><tt>Figure</tt> environment</a>, in order to place +multiple pictures in a single LaTeX figure (cfr. the <tt>subfigure</tt> standard package). -</P> +</p> -<P> -The ``<TT>AllowH</TT>'' option allow the use of the ``<TT>H</TT>'' float -specifier for the <A HREF="#SECTION04"><TT>Figure</TT> environment</A>, +<p> +The ``<tt>AllowH</tt>'' option allow the use of the ``<tt>H</tt>'' float +specifier for the <a href="#SECTION04"><tt>Figure</tt> environment</a>, in order to place the figure exaclty where the command is placed -(cfr. the <TT>float</TT> standard package). -</P> +(cfr. the <tt>float</tt> standard package). +</p> -<HR><BR> +<hr /><br /> <!------------------------------------------------------------------------> -<H2> -<A NAME="SECTION04">The <TT>Figure</TT> environment and its relatives</A> -</H2> +<h2> +<a name="SECTION04">The <tt>Figure</tt> environment and its relatives</a> +</h2> -<P> -The ``<TT>Figure</TT>'' environment (capitalized!) is somewhat different from -the standard LaTeX ``<TT>figure</TT>'' environment: besides an optional +<p> +The ``<tt>Figure</tt>'' environment (capitalized!) is somewhat different from +the standard LaTeX ``<tt>figure</tt>'' environment: besides an optional argument used to specify the placement parameters (which now defaults to -``<TT>[htbp]</TT>''), it has a mandatory agrument specifying the ``caption'' +``<tt>[htbp]</tt>''), it has a mandatory agrument specifying the ``caption'' and another optional argument, used as a ``label'' for cross-referencies: -<PRE> - \begin{Figure}[<htbpH>]{<caption>}[<label>] +<pre> + \begin{Figure}[<htbpH>]{<caption>}[<label>] ... \end{Figure} -</PRE> -</P> +</pre> +</p> -<P> -The use of the ``<TT>H</TT>'' specifier (i.e. ``I want my float here!'') is -possible only if the <A HREF="#SECTION03">``<TT>AllowH</TT>'' option</A> has +<p> +The use of the ``<tt>H</tt>'' specifier (i.e. ``I want my float here!'') is +possible only if the <a href="#SECTION03">``<tt>AllowH</tt>'' option</a> has been specified. -</P> +</p> -<HR><BR> +<hr /><br /> <!------------------------------------------------------------------------> -<H3> -<A NAME="SECTION04a">The <TT>graphfile</TT> command</A> -</H3> - -<P> -Inside the ``<TT>Figure</TT>'' environment, are available the commands: -<PRE> - \graphfile[<width>]{<file>}[<sub-caption>] - \graphfile*[<heigth>]{<file>}[<sub-caption>] -</PRE> -which are a simplified version of the ``<TT>\includegraphics*</TT>'' +<h3> +<a name="SECTION04a">The <tt>graphfile</tt> command</a> +</h3> + +<p> +Inside the ``<tt>Figure</tt>'' environment, are available the commands: +<pre> + \graphfile[<width>]{<file>}[<sub-caption>] + \graphfile*[<heigth>]{<file>}[<sub-caption>] +</pre><br /> +which are a simplified version of the ``<tt>\includegraphics*</tt>'' command (which is automatically included by this package; see the -<TT>graphics</TT> package for reference), since you don't have to worry +<tt>graphics</tt> package for reference), since you don't have to worry about scaling: the mandatory argument is the name of the graphic file to include, whereas the first optional argument specifies the desired width (in the non *-form) or heigth (in the *-form) of the figure as a fraction -of ``<TT>\linewidth</TT>'' (e.g. ``|50|'' means -``<TT>.50\linewidth</TT>'', i.e. half a line! ), so no unit of measure -(as ``<TT>cm</TT>'' or ``<TT>pt</TT>'') is required. -</P> +of ``<tt>\linewidth</tt>'' (e.g. ``|50|'' means +``<tt>.50\linewidth</tt>'', i.e. half a line! ), so no unit of measure +(as ``<tt>cm</tt>'' or ``<tt>pt</tt>'') is required. +</p> -<P> -Moreover, since the ``*-form'' of ``<TT>\includegraphics</TT>'' is used, +<p> +Moreover, since the ``*-form'' of ``<tt>\includegraphics</tt>'' is used, the regions outside the bounding-box of postscript files are not drawn. -</P> +</p> -<P> +<p> Another advantage of the combined use of the -<A HREF="#SECTION04">``<TT>Figure</TT>'' environment</A> and the -``<TT>\graphfile</TT>'' commands is that the picture is automatically -centered horizontally, so no ``<TT>\centering</TT>'' or similar +<a href="#SECTION04">``<tt>Figure</tt>'' environment</a> and the +``<tt>\graphfile</tt>'' commands is that the picture is automatically +centered horizontally, so no ``<tt>\centering</tt>'' or similar declartion is required. -<PRE> - \begin{Figure}[<htbpH>]{<caption>}[<label>] - \graphfile[<width>]{<file>} +<pre> + \begin{Figure}[<htbpH>]{<caption>}[<label>] + \graphfile[<width>]{<file>} \end{Figure} -</PRE> -</P> +</pre> +</p> -<HR><BR> +<hr /><br /> <!------------------------------------------------------------------------> -<H3> -<A NAME="SECTION04b">Sub-figures</A> -</H3> +<h3> +<a name="SECTION04b">Sub-figures</a> +</h3> -<P> +<p> If you want to include more than one file in a single figure, you may -specify <A HREF="#SECTION03">the ``<TT>subfigure</TT>'' option</A>, which -includes the <TT>subfigure</TT> package and provides the authomatic +specify <a href="#SECTION03">the ``<tt>subfigure</tt>'' option</a>, which +includes the <tt>subfigure</tt> package and provides the authomatic placement of a sub-caption below each picture. -</P> +</p> -<P> -If the ``<TT>subfigure</TT>'' option is not specified, multiple graphs are +<p> +If the ``<tt>subfigure</tt>'' option is not specified, multiple graphs are still allowed but no sub-caption will appear. -<PRE> - \graphfile[<width_1>]{<file_1>}[<sub-caption_1>] +<pre> + \graphfile[<width_1>]{<file_1>}[<sub-caption_1>] ... - \graphfile[<width_N>]{<file_N>}[<sub-caption_N>] -</PRE> -This is a combined version of ``<TT>\subfigure</TT>'' and -``<TT>\includegraphics*</TT>'' (see the <TT>subfigure</TT> and -<TT>graphics</TT> packages for reference): + \graphfile[<width_N>]{<file_N>}[<sub-caption_N>] +</pre><br /> +This is a combined version of ``<tt>\subfigure</tt>'' and +``<tt>\includegraphics*</tt>'' (see the <tt>subfigure</tt> and +<tt>graphics</tt> packages for reference): the last optional argument specify a ``caption'' for the sub-figure under consideration, while the first two arguments work exactly like as described above in the case of one only picture (indeed, you can use the last optional -argument even if the <TT>subfigure</TT> option was not specified, in which +argument even if the <tt>subfigure</tt> option was not specified, in which case it is simply ignored). -</P> +</p> -<P> +<p> Each individual caption is printed preceded by a bracketed letter, which is the sub-figure counter and is printed even if no caption is specified. -Using only a series of ``<TT>\graphfile[...]{...}[...]</TT>'' commands -inside a ``<TT>Figure</TT>'' environment provides an equal spacing beetween +Using only a series of ``<tt>\graphfile[...]{...}[...]</tt>'' commands +inside a ``<tt>Figure</tt>'' environment provides an equal spacing beetween the pictures and around them, without the need for any extra command. -</P> +</p> -<P> -Finally, if a ``<TT><label></TT>'' was specified as the last optional -argument to the <A HREF="#SECTION04">``<TT>Figure</TT>'' environment</A>, +<p> +Finally, if a ``<tt><label></tt>'' was specified as the last optional +argument to the <a href="#SECTION04">``<tt>Figure</tt>'' environment</a>, you can reference to each individual sub-figure by the labels -``<TT><label>:a</TT>'', ``<TT><label>:b</TT>'', and so on, without +``<tt><label>:a</tt>'', ``<tt><label>:b</tt>'', and so on, without the need for declaring them. -<PRE> - \begin{Figure}[<htbpH>]{<caption>}[<label>] - \graphfile[<width_1>]{<file_1>}[<sub-caption_1>] - \graphfile[<width_2>]{<file_2>}[<sub-caption_2>] - : - : - \end{Figure} -</PRE> -</P> - -<HR><BR> +<pre> + \begin{Figure}[<htbpH>]{<caption>}[<label>] + \graphfile[<width_1>]{<file_1>}[<sub-caption_1>] + \graphfile[<width_2>]{<file_2>}[<sub-caption_2>] + : + : + \end{Figure} +</pre> +</p> + +<hr /><br /> <!------------------------------------------------------------------------> -<ADDRESS> -<I>Francesco Bosisio</I><BR> -E-mail: <A HREF="MAILTO:bosisio@mate.polimi.it"> - <TT>bosisio@mate.polimi.it</TT> - </A><BR> -Web page: <A HREF="http://ftp.mate.polimi.it/~bosisio/LaTeX"> - <TT>http://ftp.mate.polimi.it/~bosisio/LaTeX</TT> - </A> -</ADDRESS> +<address> + <i>F. Bosisio</i><br /> + E-mail: <a href="mailto:fbosisio@bigfoot.com"><tt>fbosisio@bigfoot.com</tt></a> +</address> <!------------------------------------------------------------------------> -</BODY> -</HTML> +</body> +</html> |