Server Mode Integration

Server mode is available in RetroCapture Pro only.

Server mode is entered using the -r command-line option:

java -jar retrocapture.jar -r <server_mode_directory>

The process runs until killed, monitoring the specified directory every 10 milliseconds for <prefix>.run files. Each run file must contain one or more RetroCapture command lines. These are processed to generate the requested passphrase images.

When complete, the <prefix>.run file is renamed to <prefix>.done and a <prefix>.map file is generated containing the passphrase to image mapping information (see the map file format). While processing, this map file is named <prefix>.tomap; these partial files should be ignored.

Each line in the run file can specify an image output directory using the -d <image_directory> option, and one or more style files can be loaded using the -s <style_file> option.

Here is a complete example of this server setup:

• Create a run directory: mkdir capturerun
• Create an image directory: mkdir captureimage
• Start a RetroCapture server process: java -jar retrocapture.jar -r capturerun
• Your web-application will create a run file (named capturerun/012345.torun during file creation) and name the file as capturerun/012345.run for processing. Here are example run-file contents:

  -d captureimage 1:lite
  -d captureimage -s mystyles.cap 43:mycustomstyle

• The RetroCapture server will process this file, moving it to capturerun/012345.done, will generate 1 image of the default style lite and 43 images of the custom style mycustomstyle in directory captureimage, and will generate a passphrase-to-image mapping file capturerun/012345.map in the run directory.
• Your web-application then uses these RetroCapture images and the map-file to prevent robots from accessing your web-site.