DDJVU(1)

NAME
ddjvu - Command line DjVu decoder.

SYNOPSIS
ddjvu -format=fmt [options] [djvufile] [outputfile]

DESCRIPTION
This program decodes DjVu file djvufile, produces a raw image, and saves it into file outputfile. The DjVu data is read from the standard input when argument djvufile is not specified or when it is equal to a single dash. Similarly, the output data is written to the standard output when argument outputfile is not specified or equal to a single dash.

MAIN OPTIONS

-format=fmt
    Specify the output file formats. The recognized file formats are pbm, pgm, ppm, pnm, tiff, and rle.

    *   Formats pbm, pgm, and ppm respectively produce a Portable Bitmap (PBM), Portable Graymap (PGM), or Portable Pixmap (PGM) file. Format pnm produces either a PBM, a PGM, or a PPM output file according to the color nature of the output image.

    *   Format tiff produces a Tagged Image Format (TIFF) file. Command tiffcp(1) and tiffsplit(1) are useful for manipulating the resulting TIFF files.

    *   Format rle produces a compact run lenght encoded bitonal file that is understood by the DjVuLibre commands cjb2 and csepdjvu.

    When option -format is not specified, the extension of argument outputfile has no influence on the default output format. Instead the program behavior is modified to ensure backward compatibility with previous versions of ddjvu. We recommend to always specify the output format using this option.

-page=pagespec
    Specify which pages should be decoded. When this option is not specified, all pages of the documents are decoded and concatenated into the output file. The page specification pagespec contains one or more comma-separated page ranges. A page range is either a page number, or two page numbers separated by a dash. For instance, specification 1-10 outputs pages 1 to 10, and specification 1,3,99999-4 outputs pages 1 and 3, followed by all the document pages in reverse order up to page 4.

-mode=mod
    Selects which layers of the DjVu image should be rendered. Valid rendering modes are color, black, mask, foreground, and background.

    *   Rendering mode color is the default mode. When the DjVu file is bitonal, bitonal or gray-level output is produced depending on the subsampling factor. Otherwise a color image is produced.

    *   Rendering mode black is useful to extract a meaningful black and white image. bitonal or gray-level output is produced depending on the subsampling factor.

    *   Rendering modes mask, foreground, and background select specific layers of a DjVu image. These modes can fail if the DjVu image does not contain the selected layer.

RESOLUTION OPTIONS
The following options control the resolution of the output image. The default resolution is the native resolution of the DjVu file, equivalent to selecting -1.

-n  Specify an integer sub-sampling factor. The dimensions of the full output image will be n times smaller than the DjVu image size. The legal values for argument n range from 1 to 12. Option -1, for instance, produces an output image whose resolution is equal to the resolution of the input DjVu image file.

-subsample=n
    This is equivalent to option -n.

-scale=mag
    Specify a magnification factor relative to the resolution stored in the DjVu image. Specifying magnification of 100 produces an image suitable for displaying on a 100 dpi device such as a computer screen. The magnification factor mag can also be interpreted as the resolution of the output image expressed in dot per inch.

-size=wxh
    Specify the size of the full output image. Rendering the full DjVu image would create an output image whose width and height would not exceed w and h. To change the aspect ratio, you must also use option -aspect=no.

-aspect=yesno
    This option indicates whether the image aspect ratio should be preserved. The defaults is to preserve the aspect ration. This option permits changes in the aspect ratio when used in combination with option -size.

OTHER OPTIONS

-verbose
    Display informational messages describing the structure of the DjVu image and the format of the output file.

-segment=wxh+x+y
    Specify an image segment to render. Program ddjvu conceptually renders the full page using the specified resolution, and then extracts a sub-image of width w and height h, starting at position (x,y) relative to the bottom left corner of the page. Both operations of course happen simultaneously. Rendering a small sub-image is much faster than rendering the complete image. The output file will always have size wxh when this option is specified.

-quality=factor
    Enables lossy compression in TIFF files. Without this option, TIFF files always use lossless compression or no compression. Argument factor specifies a JPEG quantization factor ranging from 25 to 150. See command cjpeg(1) for more information on JPEG quantization factors.

DEPRECATED OPTIONS
Various options have been maintained to ensure backward compatibility with previous versions of ddjvu. Please do not rely on these features. When option -format is not specified, the program only decodes the first page of the document and the default resolution becomes -scale=100. Options -size, -scale, -segment, and -page accept an argument separated by a space. Options -foreground, -background, and -black are shorthands for the -mode=mod option.

EXAMPLES
Command

    ddjvu -format=tiff myfile.djvu myfile.tif

decodes all pages and produces a multipage TIFF file. Command

    ddjvu -format=ppm -page=1 -size=100x100 myfile.djvu -

produces a thumbnail for the first page of a document and outputs it as a PPM file on the standard output:

CREDITS
The new version of this program was written by Léon Bottou <leonb@users.sourceforge.net>.

SEE ALSO
djvu(1), djview(1), pnm(5), pbm(5), pgm(5), ppm(5), cjpeg(1), tiffsplit(1), tiffcp(1)