next up previous contents index
Next: FiguresTables and Up: Special Features Previous: Internationalization

Image Conversion


LaTeX2HTML converts equations, special accents, external postscript files, and LaTeX environments it cannot directly translate into inlined images. This section describes how it is possible to control the final appearance of such images. For the purposes of the discussion below,

``small images''
will refer to equations, special accents and any other image generating LaTeX commands, while
will apply to any image generating LaTeX environments (eg figure, table, minipage etc).

The size of all ``small images'' depends on a configuration variable MATH_SCALE_FACTOR which specifies how much to enlarge or reduce them in relation to their original size in the postscript version of the document. For example a scale factor of 0.5 will make all images half as big while a scale factor of 2 will make them twice as big. Larger scale factors result in longer processing times and larger intermediate image files. A scale factor will only be effective if it is greater than 0.

The configuration variable FIGURE_SCALE_FACTOR performs a similar function for ``figures''. Both of these configuration variables are initially set to 1.6.

For finer control, several parameters affecting the conversion of a single ``figure'' can be controlled with the command htmlimage which is defined in html.sty. The one argument of htmlimage is a string of options separated by commas. The options are

scale = <scale factor>
thumbnail = <scale factor>
map = <image map URL>

The scale option allows control over the size of the final image.

The external option will cause the image not to be inlined (images are inlined by default). External images will be accessible via a hypertext link.

The thumbnail option will cause a small inlined image to be placed in the caption. The size of the thumbnail depends on the scale factor. The use of the thumbnail option implies the external option. In order to be effective the command htmlimage and its options must be placed inside the environment on which it will operate.

The map option will turn the inlined image into an active image map.

Example: The effect of the LaTeX commands below can be seen in the thumbnail sketch of Figure 1.

    \caption{A sample figure showing part of a page generated by
\latextohtml containing a customized navigation panel (from the
\protect\htmladdnormallinkfoot{CSEP project}

The htmlimage command is also often useful to cancel-out the effect of the configuration variable FIGURE_SCALE_FACTOR. For example to avoid resizing a color screen snap despite the value of FIGURE_SCALE_FACTOR it is possible to use htmlimage{scale=0}.

next up previous contents index
Next: FiguresTables and Up: Special Features Previous: Internationalization

Gary M Wysin
Fri Aug 25 20:57:35 CDT 1995