Child pages
  • Setting up and Running the DjVu Standalone Encoder - 5.0.2

This space has moved to IU's Confluence.
It is located at https://uisapp2.iu.edu/confluence-prd/display/iulV3/

Skip to end of metadata
Go to start of metadata

Setting up and Running the DjVu Standalone Encoder

This convenience utility is a Java Application that wraps the command line tools convert (ImageMagick), c44, and cjb2 (djvulibre).

Contents

Setting up the DjVu Standalone Encoder

Installing ImageMagick

Download & Install

Remember where it was installed because it will need to be specified in the configuration file.

Recommend Installation Location

  • ImageMagick File: Q16-windows-dll 6.3.3-4
  • Recommend Location: C:/Program Files/ImageMagick-6.3.3-4-Q16/
    • The configuration file is set to look in this default place for ImagMagick.

Installing DjVuLibre

Windows

Other platforms

Remember where it was extracted (or installed) because it will need to be specified in the configuration file.

Recommended Extraction Location

  • Extracted directory: DjVuLibre-x.x.x-win32
  • Recommended Default Location : C:/Program Files/DjVuLibre/,
  • Recommended Path for the bitonal encoder C:/Program Files/DjVuLibre/DjVuLibre-3.5.17-win32/cjb2.exe.
    • The configuration file is set to look in this default place for the encoder.

Testing the DjVu Standalone Encoder

All files necessary to run the gui encoder can be found in the Client directory. Included in this directory is djvuencoder.jar which can be run from the commandline or from double clicking it.

  • Running the Jar
    • Double click djvuencoder.jar
      • The jar requires that encoder.conf (The configuration file) is in the same directory
      • A different djvuencoder.conf can be specified in the jar file
    • The jar file will run similar to the example Running the Encoder

Configuration File

The configuration file djvuencoder.conf, located in the Client directory, has four configurable properties.

Warning

Paths should use forward slashes, not the Windows-style backslash.

  • convertPath
    • This value should point to where you have the convert executable.
  • djvuBitonalPath
    • This valueshould point to where you have the djvulibre encoder executables.
  • djvuColorPath
    • This value should point to where you have the djvulibre encoder executables.
  • saveDirectory
    • This value specifies a default directory to save encoded files. If this property is not set, the default location is the directory of the tiff to be encoded. The user is not given a choice of where to save files currently. This property can be set to the incoming directory Samba share on the Variations server to avoid having to copy the derivative files as a separate step.

Example

djvuencoder.conf
convertPath="C:/Program Files/ImageMagick-6.3.0-Q16/convert.exe" +dither +antialias
djvuBitonalPath="C:/Program Files/djvulibre-3.5.17-1-win32/cjb2.exe" -dpi 400 -clean
djvuColorPath="C:/Program Files/djvulibre-3.5.17-1-win32/c44.exe"               

#Do not quote the following values!
saveDirectory=Z:/score/incoming

Installing the DjVu Standalone Encoder

See Building the Client Installer - 5.0.7 for instructions on building digitizer client installers which create a Desktop shortcut and start menu item for the DjVu Encoder.

Running the Encoder

(As mentioned before the the encoder can be run with the djvuencoder.jar file)

Adding Files to the Encode List

There are Four ways to add files to the Encode List:

  1. Type the full file (or directory) path in the Filename text field and click Add File.
  2. Click Add File and navigate to the file (or directory) and click Open.
  3. Drag and Drop the file(s) (or directory) onto the Encode List.
  4. Right-click on the Encode List and click Add Files.... Then navigate to the file (or directory) and click Open.

Adding a directory to the Encode List will add all files in that directory or beneath that directory except Thumbs.db. If you attempt to add a file that already exists in the list with the same specified output file, it will be skipped without warning.

Starting Encoding

Click the Encode button to start encoding the files in the Encode List. If a file already exists at the specified output location, a warning dialog will ask if you want to overwrite the preexisting file. Files that have already been successfully encoded and are still in the Encode List will be skipped unless their status has been reset by selecting the file, right-clicking the mouse, and clicking Reset File Status.

Stop Encoding

To stop the current and all subsequent files from being encoded by the current encoding process, click the Stop button.

Removing Files from the Encode List

To remove all files from the Encode List either click Clear All or right-click in the Encode List and click Clear All Files.
To remove one or multiple files, select the file(s), right-click the mouse to bring up the popup menu, and click Remove File.

Reset a File's Status

To reset the status of one or multiple files, select the file(s), right-click the mouse to bring up the popup menu, and click Reset File Status. The tooltip text for these files should read Unprocessed after doing this.

Setting a File's Color Status (Disabled)

This is currently disabled because the score viewer in Variations cannot handle color pages at the moment.

By default pages are set to encode using DjVuLibre's bitonal encoder. To set a page to be encoded in color, select the file, right-click, and select Set Color. To return a file to its bitonal default, reset the file's status by clicking Reset File Status from the popup menu you get by selecting the file and right-clicking.

Next Steps

After you have completed the encoder configuration process, you can being building the installer at Building the Client Installer.

  • No labels