# Package `graphfig`
This is version 2.2, last revised 1997/12/15; documentation date 2005/04/09.

Author: F. Bosisio
E-mail: `fbosisio@bigfoot.com`
CTAN location: `macros/latex/contrib/bosisio`

### Abstract

Documentation for the package `graphfig`.

## Table of contents

- Introduction
- Required packages
- The options
- The `Figure` environment and its relatives
  - The `graphfile` command
  - Sub-figures

## Introduction

This package provides some commands to make the use of graphic files in LaTeX simpler.

It declares the ```Figure`'' environment (capitalized!) and the two commands ```\graphfile`'' and ```\graphfile*`''. Combining this commands, it is possible to include graphic files in a LaTeX document very simply.

## Required packages

This package uses the ```\includegraphics*`'' command defined in the standard `graphics` package. Moreover, it uses the package `subfigure` when the `subfigure` option is specified, and the `float` package if the `AllowH` option is used.

## The options

At now, two options are available: ```subfigure`'' and ```AllowH`''.

The ```subfigure`'' option allow the use of sub-figures inside a `Figure` environment, in order to place multiple pictures in a single LaTeX figure (cfr. the `subfigure` standard package).

The ```AllowH`'' option allow the use of the ```H`'' float specifier for the `Figure` environment, in order to place the figure exaclty where the command is placed (cfr. the `float` standard package).

## The `Figure` environment and its relatives

The ```Figure`'' environment (capitalized!) is somewhat different from the standard LaTeX ```figure`'' environment: besides an optional argument used to specify the placement parameters (which now defaults to ```[htbp]`''), it has a mandatory agrument specifying the ``caption'' and another optional argument, used as a ``label'' for cross-referencies:

    		\begin{Figure}[<htbpH>]{<caption>}[<label>]
    		            ...
    		\end{Figure}

The use of the ```H`'' specifier (i.e. ``I want my float here!'') is possible only if the ```AllowH`'' option has been specified.

### The `graphfile` command

Inside the ```Figure`'' environment, are available the commands:

    		\graphfile[<width>]{<file>}[<sub-caption>]
    		\graphfile*[<heigth>]{<file>}[<sub-caption>]

which are a simplified version of the ```\includegraphics*`'' command (which is automatically included by this package; see the `graphics` 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 ```\linewidth`'' (e.g. ``|50|'' means ```.50\linewidth`'', i.e. half a line! ), so no unit of measure (as ```cm`'' or ```pt`'') is required.

Moreover, since the ``*-form'' of ```\includegraphics`'' is used, the regions outside the bounding-box of postscript files are not drawn.

Another advantage of the combined use of the ```Figure`'' environment and the ```\graphfile`'' commands is that the picture is automatically centered horizontally, so no ```\centering`'' or similar declartion is required.

    		\begin{Figure}[<htbpH>]{<caption>}[<label>]
    		        \graphfile[<width>]{<file>}
    		\end{Figure}

### Sub-figures

If you want to include more than one file in a single figure, you may specify the ```subfigure`'' option, which includes the `subfigure` package and provides the authomatic placement of a sub-caption below each picture.

If the ```subfigure`'' option is not specified, multiple graphs are still allowed but no sub-caption will appear.

    		\graphfile[<width_1>]{<file_1>}[<sub-caption_1>]
    			...
    		\graphfile[<width_N>]{<file_N>}[<sub-caption_N>]

This is a combined version of ```\subfigure`'' and ```\includegraphics*`'' (see the `subfigure` and `graphics` 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 `subfigure` option was not specified, in which case it is simply ignored).

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 ```\graphfile[...]{...}[...]`'' commands inside a ```Figure`'' environment provides an equal spacing beetween the pictures and around them, without the need for any extra command.

Finally, if a ```<label>`'' was specified as the last optional argument to the ```Figure`'' environment, you can reference to each individual sub-figure by the labels ```<label>:a`'', ```<label>:b`'', and so on, without the need for declaring them.

    	\begin{Figure}[<htbpH>]{<caption>}[<label>]
    		\graphfile[<width_1>]{<file_1>}[<sub-caption_1>]
    		\graphfile[<width_2>]{<file_2>}[<sub-caption_2>]
    		       :
    		       :
    	\end{Figure}