NAME

       imgsizer - automatically splice in height and width params for HTML IMG tags

SYNOPSIS

       imgsizer [-d file] [--document-root file] [-h file] [--help file] [-n] [--no-overwrite] [HTMLFile]
                [-v file] [--version]

OPTIONS

       Display version information and exit.

       Display usage information.

       Directory where absolute image filenames (i.e, ones which contain a leading "/") may be found.

       -n, --no-overwwrite, .SH DESCRIPTION
              The  imgsizer script automates away the tedious task of creating and updating the extension HEIGHT
              and WIDTH parameters in HTML  IMG  tags.  These  parameters  help  many  browsers  (including  the
              Netscape/Mozilla family) to multi-thread image loading, instead of having to load images in strict
              sequence in order to have each one's dimensions available so the next can be placed. This general‐
              ly allows text on the remainder of the page to load much faster.

       This  script  will  try  create such attributes for any IMG tag that lacks them. It will correct existing
       HEIGHT and WIDTH tags unless either contains a percent (%) sign, in which case  the  existing  dimensions
       are presumed to be relative and left unaltered.

       This  script  may  be  called with no arguments. In this mode, it filters HTML presented on stdin to HTML
       (unaltered except for added or corrected HEIGHT and WIDTH attributes) on stdout. If called with file  ar‐
       guments, it will attempt to transform each file in place. Each argument file is not actually modified un‐
       til the script completes a successful conversion pass.

       The -d <directory> option sets the DocumentRoot, where images with an absolute filename (i.e., ones which
       contain a leading "/") may be found. If none is specified, the DocumentRoot defaults to the current work‐
       ing directory.

       The  -n (no-overwrite) opion prevents the program from overwriting existing width and height tags if both
       are present.

       Additional options may also be specified in the environmental variable "IMGSIZER". For example, to  avoid
       typing  "imgsizer  -d  /var/www/docs" each time imgsizer is invoked, you might tell sh (or one of its de‐
       scendants):

       IMGSIZER="-d /var/www/docs"; export IMGSIZER

       or, if you use csh:

       setenv IMGSIZER "-d /var/www/docs"

       This script is written in Python, and thus requires a Python interpreter on the host system. It also  re‐
       quires  either  the identify(1) utility distributed in the open-source ImageMagick suite of image-display
       and manipulation tools, or a modern version of file(1) and rdjpgcom(1). These utilities are used  to  ex‐
       tract sizes from the images; imgsizer itself has no knowledge of graphics formats. The script will handle
       any image format known to identify(1) including PNG, GIF, JPEG, XBM, XPM, PostScript, BMP, TIFF, and any‐
       thing else even remotely likely to show up as an inline image.

NOTE

       The  -q,  -l, and -m options of the 1.0 versions are gone. What they used to do has been made unnecessary
       by smarter logic.

BUGS

       The code uses regular expressions rather than true HTML/XML parsing. Some perverse  but  legal  construc‐
       tions, like extraneous space within quoted numeric attributes, will be mangled.

AUTHOR

       Originally  created  by  Eric  S.  Raymond <esr@thyrsus.com>. Additional code contributed by Erik Rossen,
       Michael  C.  Toren  <michael@toren.net>,  and  others.  For   updates,   see   <http://www.catb.org/~esr:
       http://www.catb.org/~esr>

SEE ALSO

       identify(1), file(1), rdjpgcom(1).

                                                                                                     IMGSIZER(1)