@Section
   @Title { Figures and tables }
   @Tag { figures }
@Begin
@PP
Figures are created in a similar way to footnotes:
figures. @Index { figures }
@ID @OneRow @Code {
"@Figure"
"    @Caption { Basser Lout }"
"@Fig {"
"    { @Box Lout }{ @HArrow { 2c @Wide } }{ @Box PostScript }"
"}"
}
The @Code "@Figure" symbol places the figure (which in this example is
figure. @Index @Code "@Figure"
created using the advanced graphics features of Chapter {@NumberOf fig})
at the top of the following column or page,
@Figure
    @Tag { figex }
    @Caption { Basser Lout }
@Fig {
    { @Box Lout }{ @HArrow { 2c @Wide } }{ @Box PostScript }
}
labelled by the @Code "@Caption" option and automatically numbered.  You
captions. @RawIndex { captions }
captions.figures @SubIndex { in @Code "@Figure" and @Code "@Table" }
can see this example at the top of page {@PageOf figex}.  Tables are
table. @Index @Code "@Table"
obtained in the same way using {@Code "@Table"} instead of {@Code "@Figure"}.
@PP
The @Code "@Caption" options of @Code "@Figure" and @Code "@Table"
suffer from the same problem as @Code "@FootNote" and {@Code "@EndNote"},
in being restricted to one paragraph, not an arbitrary object.  If you
want a longer caption, the solution is the same:
@ID @Code {
"@Figure"
"    @LongCaption { @FigureNum  This is a long caption ... }"
}
The corresponding symbol to use inside the @Code "@LongCaption" of
@Code "@Table" is {@Code "@TableNum"}.  You should leave two spaces
between @Code "@FigureNum" and what follows.  These symbols include
the word `Figure' or `Table' in the current language, and contain the
appropriate font changes, etc.
@PP
By default, the body of the figure will be centred, and this usually looks
best, at least for small figures.  @Code "@Figure" and @Code "@Table" each
have a @Code "@Format" option which controls this format:
@ID @Code {
"@Figure"
"    @Format { @CurveBox @HExpand { @CentredDisplay @Body } }"
}
Within the @Code "@Format" option, the @Code "@Body" symbol stands
for the body of the figure or table.  This example centres the figure
inside a @Code "@CurveBox" which is horizontally expanded (by the
@Code "@HExpand" symbol) to occupy the full width of the page, rather
than fitting snugly around the figure.  Actually the most useful format
is probably just
@ID @Code {
"@Figure"
"    @Format { @Body }"
}
which turns off the default centring.  This is the most practical format
for multi-page figures, for example.
@PP
@Code "@Figure" and @Code "@Table" each have an @Code "@InitialLanguage"
option which determines the language of the figure or table.  If this is
omitted, the language of the document as a whole will be used (or of the
chapter in books), not the language where the figure or table occurs.
@PP
There are setup file options called @Code "@FigureNumbers" and
figurenumbers. @Index @Code "@FigureNumbers"
tablenumbers. @Index @Code "@TableNumbers"
@Code "@TableNumbers" that determine whether figures and tables are
numbered automatically or not.  Your choices for these options are
{@Code "None"}, {@Code "Arabic"}, {@Code "Roman"}, {@Code "UCRoman"},
{@Code "Alpha"}, and {@Code "UCAlpha"}.  Depending on the document
type and where the figure or table occurs, the number might include
a chapter number as well.
@End @Section
