diff options
author | Karl Berry <karl@freefriends.org> | 2009-01-18 01:02:30 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-01-18 01:02:30 +0000 |
commit | 9a5f9a8fbaf534d7f2b0afa74d07e45ea5fada89 (patch) | |
tree | 44f442c8f248f8e30563a2f3cd93808afd27f906 /Master/texmf-dist/doc/latex/bosisio/graphfig.html | |
parent | fb9eedce0aead30fcccca93da6d6b9a6d64bac46 (diff) |
new old latex packages bosisio (17jan09)
git-svn-id: svn://tug.org/texlive/trunk@11906 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/bosisio/graphfig.html')
-rw-r--r-- | Master/texmf-dist/doc/latex/bosisio/graphfig.html | 267 |
1 files changed, 267 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/bosisio/graphfig.html b/Master/texmf-dist/doc/latex/bosisio/graphfig.html new file mode 100644 index 00000000000..ed228a79368 --- /dev/null +++ b/Master/texmf-dist/doc/latex/bosisio/graphfig.html @@ -0,0 +1,267 @@ +<HTML> + +<!------------------------------------------------------------------------> + +<HEAD> +<TITLE>Package graphfig</TITLE> +</HEAD> +<BODY > + +<!------------------------------------------------------------------------> +<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> + +<HR><BR> +<!------------------------------------------------------------------------> + +<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> +<!------------------------------------------------------------------------> + +<H2> +<A NAME="SECTION01">Introduction</A> +</H2> + +<P> +This package provides some commands to make the use of graphic files +in LaTeX simpler. +</P> + +<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> + +<HR><BR> +<!------------------------------------------------------------------------> + +<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> +is used. +</P> + +<HR><BR> +<!------------------------------------------------------------------------> + +<H2> +<A NAME="SECTION03">The options</A> +</H2> + +<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> +standard package). +</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>, +in order to place the figure exaclty where the command is placed +(cfr. the <TT>float</TT> standard package). +</P> + +<HR><BR> +<!------------------------------------------------------------------------> + +<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 +argument used to specify the placement parameters (which now defaults to +``<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>] + ... + \end{Figure} +</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 +been specified. +</P> + +<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>'' +command (which is automatically included by this package; see the +<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> + +<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> +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 +declartion is required. +<PRE> + \begin{Figure}[<htbpH>]{<caption>}[<label>] + \graphfile[<width>]{<file>} + \end{Figure} +</PRE> +</P> + +<HR><BR> +<!------------------------------------------------------------------------> + +<H3> +<A NAME="SECTION04b">Sub-figures</A> +</H3> + +<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 +placement of a sub-caption below each picture. +</P> + +<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>] + ... + \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): +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 +case it is simply ignored). +</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 +the pictures and around them, without the need for any extra command. +</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>, +you can reference to each individual sub-figure by the labels +``<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> +<!------------------------------------------------------------------------> + +<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> + +<!------------------------------------------------------------------------> + +</BODY> +</HTML> + |