next up previous contents index
Next: Switches controlling Navigation Panels Up: Command-Line Options Previous: Options controlling Extensions and

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

 
change_begin97.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.
change_end 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 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.

 
change_begin96.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.)
change_end 96.1

  
change_begin97.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.
change_end 97.1


change_begin98.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 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.
change_end 98.1


next up previous contents index
Next: Switches controlling Navigation Panels Up: Command-Line Options Previous: Options controlling Extensions and
root
1998-02-23