1DJVUMAKE(1)                      DjVuLibre-3.5                     DJVUMAKE(1)
2
3
4

NAME

6       djvumake - Assemble DjVu image files.
7
8

SYNOPSIS

10       djvumake djvufile [chkid=argument]...
11
12

DESCRIPTION

14       Program  djvumake assembles a single-page DjVu file djvufile by copying
15       or creating chunks according  to  the  provided  arguments.   Supported
16       arguments are as follows:
17
18       INFO=w,h,dpi
19              Create  the  initial information chunk.  Arguments w, h, and dpi
20              describe the width, height and resolution  of  the  image.   All
21              arguments  may  be  omitted.  The default resolution is 300 dpi.
22              The default width and height will be retrieved  from  the  first
23              mask chunk specified in the command line options.
24
25       Sjbz=jb2file
26              Create  a  JB2  foreground mask chunk.  File jb2file may contain
27              raw JB2 data, or be a DjVu file  containing  JB2  data  such  as
28              those produced by program cjb2.
29
30       Smmr=mmrfile
31              Create a MMR/G4 foreground mask chunk.  File mmrfile may contain
32              raw MMR data or be a DjVu file containing MMR data.
33
34       BG44=iw44file[:n]
35              Create one or more IW44 background chunks.  File  iw44file  must
36              contain  IW44  data.   Such files can be obtained by compressing
37              the background image with program c44  and  extracting  the  raw
38              IW44  data  using  program djvuextract.  The optional argument n
39              indicates the number of chunks  to  copy  from  the  IW44  file.
40              Omitting the number of chunks copies all available chunks.
41
42       BGjp=jpegfile
43              Create a JPEG encoded background chunk.  File jpegfile must con‐
44              tain JPEG encoded data.
45
46       BG2k=jpegfile
47              Create a JPEG-2000 background chunk.  File jpegfile must contain
48              JPEG-2000  encoded  data.  The DjVu decoder does not yet display
49              files containing JPEG-2000 data.
50
51       FGbz=(filename|{#color[:x,y,w,h]})
52              Create a foreground color chunk describing one solid  color  for
53              each JB2 encoded mark.  The argument can be the name filename of
54              a file containing the raw data.  Such  files  are  best  created
55              using  program djvuextract(1).  Alternatively the argument could
56              describe a sequence of color zones.  Each color zone specifies a
57              color  name  color,  and optionally the coordinates x,y,w,h of a
58              rectangle.  Each mark receives the color of the last color  zone
59              whose  rectangle  intersects  the bounding box of the mark.  The
60              mark is painted black if its bounding box does not intersect one
61              of the zones.  The rectangle coordinates are expressed in pixels
62              with the origin at the bottom left corner of the page.  The full
63              page  is  assumed  when  no rectangle coordinates are specified.
64              Color names can be specified with exactly six  hexadecimal  dig‐
65              its, e.g.  FGbz=#FF8080, or by one of the following sixteen HTML
66              color names defined by the W3C, e.g.  FGbz=#red.
67
68                            ┌──────────────────────────────────┐
69aqua     black   blue     fuchsia 
70gray     green   lime     maroon  
71navy     olive   purple   red     
72silver   teal    white    yellow  
73                            └──────────────────────────────────┘
74       FG44=iw44file
75              Create a IW44 foreground color chunk.  File iw44file  must  con‐
76              tain  IW44  data.  Such files can be obtained by compressing the
77              background image with command c44 and extracting  the  raw  IW44
78              data using program djvuextract.  Only the first chunk is copied.
79
80       FGjp=jpegfile
81              Create a JPEG foreground color chunk.
82
83       FG2k=jpegfile
84              Create  a  JPEG-2000  foreground  color chunk.  The DjVu decoder
85              does not yet display files containing JPEG-2000 data.
86
87       INCL=fileid
88              Create a DjVu3 include chunk  pointing  to  the  component  file
89              named fileid.  The resulting file should then be included into a
90              multipage document using command djvm.
91
92       Djbz=jb2file
93              Create a JB2 shape dictionary.  File jb2file  must  contain  raw
94              JB2 data describing a JB2 dictionary.
95
96       PPM=ppmfile
97              Create a IW44 background chunk and a IW44 foreground color chunk
98              by masking and subsampling the PPM file ppmfile.
99
100              Assume, for instance, that we have a PPM image  myimage.ppm  and
101              an  identically  sized  PBM bitonal image mymask.pbm whose black
102              pixels indicate which pixels belong to the foreground.   Such  a
103              bitonal  file might have been obtained by thresholding or color-
104              keying the PPM image. We can then produce a  DjVuDocument  image
105              using the following two commands:
106
107          cjb2 mymask.pbm mymask.djvu
108          djvumake my.djvu Sjbz=mymask.djvu PPM=myimage.ppm
109
110       The  DjVu specification documents in the directory doc of the DjVuLibre
111       distribution provide the authoritative information about  the  composi‐
112       tion of a legal DjVu image file.
113
114

CREDITS

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

SEE ALSO

122       djvu(1), djvuextract(1), cjb2(1), c44(1)
123
124
125
126DjVuLibre-3.5                     10/11/2001                       DJVUMAKE(1)
Impressum