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.

   

-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 L^ATEX 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.

 
^97.1

-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.
^97.1

 

-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 L^ATEX2HTML 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 L^ATEX2HTML.

 
^96.1

-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.)
^96.1

  
^97.1

-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.
^97.1

^98.1
 

-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 L^ATEX2HTML on the same document. The translator now produces a L^ATEX format-dump of the preamble to images.tex which is used on subsequent runs. This significantly reduces the startup time when L^ATEX reads the images.tex file for image-generation.

This process actually consumes additional time on the first run, since L^ATEX 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.
^98.1