Switches controlling Image Generation

These switches affect whether images are created at all, whether old images are reused on subsequent runs or new ones created afresh, and whether anti-aliasing effects are used within the images themselves.

* -image_type
Specify the type of images to be generated. Depending on your setup, LaTeX2HTML can generate svg, png or gif images. Vector formats such as svg look better at high resolution, while bitmap formats such as png or gif are generally faster to download and to render.

* -use_dvipng
Use the dvipng program to generate png images, rather than dvips followed by gs. This method produces better alignment of math formulas which extend significantly above or below the line of text in which they are contained. An example of this behavior can be seen in the file tests/eq_line_spacing.tex. The dvipng method also eliminates the ugly crop marks that appear with 12pt documents. It does not respect the $MATH_SCALE_FACTOR option.

* -(no)use_pdftex
By default, pdflatex is used to process input files. Specify -nouse_pdftex for documents that rely on standard, dvi-producing latex.

The pdflatex method uses the pdflatex program followed by pdfcrop and gs to generate images, rather than latex followed by dvips. This method can be useful for pdfLaTeX documents which cannot be translated by latex. The pdflatex method generally produces better alignment of math formulas and eliminates ugly crop marks. It does not respect the $MATH_SCALE_FACTOR option.

The pdflatex method uses the pdfwrite GhostScript driver by default. If called together with the -use_dvipng option, it will use the png16m driver and produce slightly different math alignment.

* -use_luatex
Use the lualatex program followed by pdfcrop and gs to generate images, rather than latex followed by dvips. This method can be useful for LuaLaTeX documents which cannot be translated by latex or pdflatex. This method can sometimes produce slightly better alignment of math formulas and eliminate ugly crop marks. It does not respect the $MATH_SCALE_FACTOR option.

This method uses the pdfwrite GhostScript driver by default. If called together with the -use_dvipng option, it will use the png16m driver and produce slightly different math alignment.

An example of using the -use_luatex option can be seen on the file tests/polyglossia.tex.

* -use_luadvi
Use the dvilualatex program instead of latex to generate images. This method can be useful for dvilualatex documents which cannot be translated by latex. It can be combined with the -use_dvipng option as usually.

* -ascii_mode
Same as setting: $ASCII_MODE = $EXTERNAL_IMAGES = 1;
Use only ASCII characters and do not include any images in the final output. With -ascii_mode the output of the translator can be used on character-based browsers, such as lynx, which do not support inlined images (via the <IMG> tag).

* -nolatex
Same as setting: $NOLATEX = 1;
Disable the mechanism for passing unknown environments to LATEX for processing. This can be thought of as “draft mode” which allows faster translation of the basic document structure and text, without fancy figures, equations or tables.

(This option has been superseded by the -no_images option, see below.)

* -external_images
Same as setting: $EXTERNAL_IMAGES = 1;
Instead of including any generated images inside the document, leave them outside the document and provide hypertext links to them.

* -ps_images
Same as setting: $PS_IMAGES = $EXTERNAL_IMAGES = 1;
Use links to external PostScript files rather than inlined images in the chosen graphics format.

* -discard
Same as setting: $DISCARD_PS = 1;
The temporary PostScript files are discarded immediately after they have been used to create the image in the desired graphics format.

* -no_images
Same as setting: $NO_IMAGES = 1;
Do not attempt to produce any inlined images. The missing images can be generated “off-line” by restarting LATEX2HTML with the option -images_only .

* -images_only
Same as setting: $IMAGES_ONLY = 1;
Try to convert any inlined images that were left over from previous runs of LATEX2HTML.

* -reuse <reuse_option>
Same as setting: $REUSE = <reuse_option>;
This switch specifies the extent to which image files are to be shared or recycled.
There are three valid options:
* 0
Do not ever share or recycle image files.
This choice also invokes an interactive session prompting the user about what to do about a pre-existing HTML directory, if it exists.
* 1
Recycle image files from a previous run if they are available,
but do not share identical images that must be created in this run.
* 2
Recycle image files from a previous run and share identical images from this run.
This is the default.
A later section provides additional information about image-reuse.

* -no_reuse
Same as setting: $REUSE = 0;
Do not share or recycle images generated during previous translations. This is equivalent to -reuse 0 . (This will enable the initial interactive session during which the user is asked whether to reuse the old directory, delete its contents or quit.)

* -antialias
Same as setting: $ANTI_ALIAS = 1; (Default is 0.)
Generated images of figure environments and external PostScript files should use anti-aliasing. By default anti-aliasing is not used with these images, since this may interfere with the contents of the images themselves.

* -antialias_text
Same as setting: $ANTI_ALIAS_TEXT = 1; (Default is 1.)
Generated images of typeset material such as text, mathematical formulas, tables and the content of makeimage environments, should use anti-aliasing effects.
The default is normally to use anti-aliasing for text, since the resulting images are much clearer on-screen. However the default may have been changed locally.

* -no_antialias
Same as setting: $ANTI_ALIAS = 0; (Default is 0.)
Generated images of figure environments and external PostScript files should not use anti-aliasing with images, though the local default may have been changed to use it.

* -no_antialias_text
Same as setting: $ANTI_ALIAS_TEXT = 0; (Default is 1.)
Generated images of typeset material should not use anti-aliasing effects. Although on-screen images of text are definitely improved using anti-aliasing, printed images can be badly blurred, even at 300dpi. Higher resolution printers do a much better job with the resulting grey-scale images.

* -white
Same as setting: $WHITE_BACKGROUND = 1; (Default is 1.)
Ensures that images of figure environments have a white background. Otherwise transparency effects may not work correctly.

* -no_white
Same as setting: $WHITE_BACKGROUND = ”; (Default is 1.)
Cancels the requirement that figure environments have a white background.

* -ldump
Same as setting: $LATEX_DUMP = 1; (Default is 0.)
Use this if you want to speed up image processing during the 2nd and subsequent runs of LATEX2HTML on the same document. The translator now produces a LATEX format-dump of the preamble to images.tex which is used on subsequent runs. This significantly reduces the startup time when LATEX reads the images.tex file for image-generation.

This process actually consumes additional time on the first run, since LATEX is called twice -- once to create the format-dump, then again to load and use it. The pay-off comes with the faster loading on subsequent runs. Approximately 1 Meg of disk space is consumed by the dump file.