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

``figures''

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>
• external
• thumbnail=<scale factor>
• map=<server-side image map URL>

  
  
  

• usemap=<client-side image map URL>
• flip=<flip_option>
• align=<alignment>

  
  
  

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.

The map and options specify that the image is to be made into an active image map. (See section 4.6 for more information.)

The flip   option specifies a change of orientation of the electronic image relative to the printed version. The <flip_option> is any single command recognized by pnmflip. The most useful of these include:

rotate90 or r90

This will rotate the image clockwise by .

rotate270 or r270

This will rotate the image counterclockwise by .

leftright

This will flip the image around a vertical axis of rotation.

topbottom

This will flip the image around a horizontal axis of rotation.

The align   option specifies how the ``figure'' will be aligned. The choices are: top, bottom, middle, left, right and center. The middle option specifies that the image is to be left-justified in the line, but centered vertically. The center option specifies that it should also be centered horizontally. This option is valid only if the HTML version is 3 or higher, or if the NETSCAPE   configuration variable is set. The default value is BOTTOM.

In order to be effective the command htmlimage and its options must be placed inside the environment on which it will operate.

• An embedded image example