NAME

       djvumake - Assemble DjVu image files.

SYNOPSIS

       djvumake djvufile [chkid=argument]...

DESCRIPTION

       Program  djvumake  assembles  a single-page DjVu file djvufile by copying or creating chunks according to
       the provided arguments.  Supported arguments are as follows:

       INFO=w,h,dpi
              Create the initial information chunk.  Arguments w, h, and dpi  describe  the  width,  height  and
              resolution  of  the image.  All arguments may be omitted.  The default resolution is 300 dpi.  The
              default width and height will be retrieved from the first mask chunk specified in the command line
              options.

       Sjbz=jb2file
              Create  a  JB2  foreground  mask  chunk.  File jb2file may contain raw JB2 data, or be a DjVu file
              containing JB2 data such as those produced by program cjb2.

       Smmr=mmrfile
              Create a MMR/G4 foreground mask chunk.  File mmrfile may contain raw MMR data or be  a  DjVu  file
              containing MMR data.

       BG44=iw44file[:n]
              Create  one or more IW44 background chunks.  File iw44file must contain IW44 data.  Such files can
              be obtained by compressing the background image with program c44 and extracting the raw IW44  data
              using  program  djvuextract.   The optional argument n indicates the number of chunks to copy from
              the IW44 file.  Omitting the number of chunks copies all available chunks.

       BGjp=jpegfile
              Create a JPEG encoded background chunk.  File jpegfile must contain JPEG encoded data.

       BG2k=jpegfile
              Create a JPEG-2000 background chunk.  File jpegfile must contain JPEG-2000 encoded data.  The DjVu
              decoder does not yet display files containing JPEG-2000 data.

       FGbz=(filename|{#color[:x,y,w,h]})
              Create  a  foreground  color  chunk  describing  one  solid  color for each JB2 encoded mark.  The
              argument can be the name filename of a file containing the raw data.  Such files are best  created
              using  program  djvuextract(1).   Alternatively  the  argument  could describe a sequence of color
              zones.  Each color zone specifies a color name color, and optionally the coordinates x,y,w,h of  a
              rectangle.   Each  mark  receives  the color of the last color zone whose rectangle intersects the
              bounding box of the mark.  The mark is painted black if its bounding box does not intersect one of
              the  zones.   The rectangle coordinates are expressed in pixels with the origin at the bottom left
              corner of the page.  The full page is assumed when no rectangle coordinates are specified.   Color
              names  can  be specified with exactly six hexadecimal digits, e.g.  FGbz=#FF8080, or by one of the
              following sixteen HTML color names defined by the W3C, e.g.  FGbz=#red.

                                             ┌──────────────────────────────────┐
                                             │aqua     black   blue     fuchsia │
                                             │gray     green   lime     maroon  │
                                             │navy     olive   purple   red     │
                                             │silver   teal    white    yellow  │
                                             └──────────────────────────────────┘
       FG44=iw44file
              Create a IW44 foreground color chunk.  File iw44file must contain IW44 data.  Such  files  can  be
              obtained  by  compressing  the  background image with command c44 and extracting the raw IW44 data
              using program djvuextract.  Only the first chunk is copied.

       FGjp=jpegfile
              Create a JPEG foreground color chunk.

       FG2k=jpegfile
              Create a JPEG-2000 foreground color chunk.  The DjVu decoder does not yet display files containing
              JPEG-2000 data.

       INCL=fileid
              Create  a  DjVu3  include  chunk  pointing to the component file named fileid.  The resulting file
              should then be included into a multipage document using command djvm.

       Djbz=jb2file
              Create a JB2 shape  dictionary.   File  jb2file  must  contain  raw  JB2  data  describing  a  JB2
              dictionary.

       PPM=ppmfile
              Create  a  IW44  background chunk and a IW44 foreground color chunk by masking and subsampling the
              PPM file ppmfile.

              Assume, for instance, that we have a PPM image myimage.ppm and an identically  sized  PBM  bitonal
              image  mymask.pbm  whose  black  pixels  indicate  which  pixels belong to the foreground.  Such a
              bitonal file might have been obtained by thresholding or color-keying the PPM image. We  can  then
              produce a DjVuDocument image using the following two commands:

          cjb2 mymask.pbm mymask.djvu
          djvumake my.djvu Sjbz=mymask.djvu PPM=myimage.ppm

       The  DjVu  specification  documents  in  the  directory  doc  of  the  DjVuLibre distribution provide the
       authoritative information about the composition of a legal DjVu image file.

CREDITS

       This program was written by Léon Bottou <leonb@users.sourceforge.net> and was  then  improved  by  Andrei
       Erofeev <andrew_erofeev@yahoo.com>, Bill Riemers <docbill@sourceforge.net> and many others.

SEE ALSO

       djvu(1), djvuextract(1), cjb2(1), c44(1)