--- c44.1.orig 2008-08-07 12:58:42.000000000 +0100 +++ c44.1 2008-08-07 12:58:36.000000000 +0100 @@ -22,37 +22,37 @@ .TH C44 1 "10/11/2001" "DjVuLibre-3.5" "DjVuLibre-3.5" .SH NAME c44 \- DjVuPhoto encode. - +. .SH SYNOPSIS .BI "c44 [" "options" "] " "inputfilename" " [" "outputfilename" "]" - +. .SH DESCRIPTION Produces a DjVuPhoto encoded image. The input image file .I inputfilename -can be either a portable gray-map ( -.SM PGM -) or a portable pix-map (\ -.SM PPM +can be either a portable gray-map (\c +.SM PGM\c +) or a portable pix-map (\c +.SM PPM\c ). Input images compressed with .SM JPEG are also accepted. It is however suggested to only use high quality .SM JPEG -files ( low compression ratio, large size ) +files (low compression ratio, large size) because the wavelet compression will increase the defects already present in highly compressed .SM JPEG files. - +.P The program produces a DjVuPhoto file .IR outputfilename . If the output file name is not specified, a default file name will be generated by replacing the input file name suffix by suffix .IR djvu . - +.P The main design objective for the DjVu wavelets consisted of allowing progressive rendering and smooth scrolling of large images with limited memory requirements. Decoding functions process the compressed data and update a @@ -67,15 +67,15 @@ wavelets reach these requirements today and may in the future implement more modern refinements if these refinements can be implemented within our constraints. - +. .SH QUALITY SELECTION OPTIONS - +. DjVuPhoto files are logically composed of a sequence of "slices" containing successive image refinements. Slices are grouped in "chunks" defining the progressive rendering sequence. The viewer is able to display an intermediate image after processing each chunk. A typical DjVuPhoto files contains 80 to 120 slices grouped into 1 to 4 chunks. - +.P The quality selection options provide various ways to specify the number of chunks and the number of slices per chunk. The .B c44 @@ -84,7 +84,7 @@ The following options define targets for each chunk. The option argument contain several numerical values (one per chunk) separated by either commas or pluses. - +. .TP .BI "-slice " "n" "+...+" "n" Specify the number of slices in each chunk. @@ -100,7 +100,7 @@ Specify the cumulative number of slices for each chunk. Since the final quality is determined by the total number of slices, it is often more convenient to use comma-separated values (one per chunk) -indicating the cumulative number of slices for each chunk (i.e. including +indicating the cumulative number of slices for each chunk (i.e.\& including those encoded in all previous chunks). The values suggested above can also be expressed as .B "-slice 74,87,97" @@ -142,7 +142,7 @@ should be computed by averaging the mean squared errors of only the fraction .I frac of the most mis-represented blocks of 32 x 32 pixels. This option is useful -with composite images containing solid color features (e.g. an image with a +with composite images containing solid color features (e.g.\& an image with a large white border). .PP Providing no quality specification options automatically selects a default @@ -152,7 +152,7 @@ file whose total number of chunks is the largest number of chunks of all quality specifications. Slices are added to each chunk until reaching any of the quality target for this chunk. - +. .SH OTHER OPTIONS The following additional options are supported: .TP @@ -221,27 +221,25 @@ .BI "-crcbnone " Disable the encoding of the chrominance. Only the luminance information will be encoded. The resulting image will show in shades of gray. -.PP - +. .SH REMARKS The default quality setting of the DjVuLibre version of .B c44 has been increased. It produces larger files with a better quality. -Quality can be lowered using the quality selection options!. - +Quality can be lowered using the quality selection options! +. .SH BUGS The encoder requires more memory than necessary. .br The rechunking capability is currently broken. - +. .SH CREDITS This program was written by L\('eon Bottou and was then improved by Andrei Erofeev , Bill Riemers and many others. - - +. .SH SEE ALSO .BR djvu (1), .BR pnm (5), -.BR cjpeg (1) +.BR cjpeg (1).