Back to Table of Contents | Next: Page headers/footers, pagination |
You can insert images into a document by using the PSPIC
macro. PSPIC isn’t actually part of mom; it comes packaged
with groff itself. Images must be in PostScript format, either
straight .ps or .eps (Encapsulated PostScript). If you have the
ImageMagick suite of programmes installed on your system, a simple way
to convert most image formats to .eps is with convert, at
the command line, as in this jpg => eps example:
convert <filename>.jpg <filename>.eps
There have been reports of trouble with PostScript level 2 images,
so don’t save your images in this format.
man groff-tmac contains the documentation for PSPIC, but I’ll repeat it here with a few modifications for clarity.
<file> is the name of the file containing the image; width and height give the desired width and height of the image as you wish it to appear within the document. The width and height arguments may have units of measure attached; the default unit of measure is i. PSPIC will scale the graphic uniformly in the x and y directions so that it is no more than width wide and height high. By default, the graphic will be horizontally centered. The -L and -R options cause the graphic to be left-aligned and right-aligned, respectively. The -I option causes the graphic to be indented by <n>; the default unit of measure is m (ems).
Unless you’re a PostScript whiz and have futzed around with bounding boxes and whatnot, it’s unlikely that your image will occupy an easily predictable and precise amount of space on the page. This is particularly significant when it comes to the amount of vertical space occupied by the image. A certain amount of manual tweaking of the vertical placement of the image will probably be required, via the ALD and RLD macros.
Additionally, images inserted into running text will almost certainly disrupt the baseline placement of running text. In order to get mom back on track after invoking .PSPIC, I strongly recommend using the SHIM macro so that the bottom margin of running text falls where it should.
Back to Table of Contents | Top | Next: Page headers/footers, pagination |