Program details and information
JPEG Disk Optimizer is a Windows or Unix command prompt driven program for optimizing, resizing and watermarking multiple JPEGs or TIFs.
JPEG Disk Optimizer is designed to optimize multiple JPEGs in a directory and, optionally, in sub directories. JPEG Disk Optimizer is a command prompt program and so can be easily called from other programs or scripting languages.
Examples:
jdo -q 50 -d -ss D:\*.jpg
Compress all JPEGs on drive D: with quality level 50. Write a summary of space saved at the end.
jdo -d -q 80 -sv -rw 100 -rh 75 -rb -t 6 *.jpg
Create thumbnails of maximum size 100x75 and create HTML index files with 6 thumbnails per row.
jdo -q 90 -m 30 -we 10 -wm 30 -wc 41 320459 -wrn *.jpg
Optimize and embed watermarks with minimum durability 30.
Version 4 adds GIF and PNG compression, compress to given number of bytes, crop and enhance.
N.B. Version 4 is very similar but not identical to version 3. You may need to change your scripts a little..
Unix versions of JDO 3 are available. Note the functionality is less than the windows version.
Example:
jdo -q 50 -d -ssv D:\*.jpg
Compress all JPEGs on drive D: with quality level 50. Echo file names as they are compressed and write a summary of space saved at the end.
Overview:
JPEG Disk Optimizer is designed to compress multiple JPEGs in a directory and, optionally, in sub directories. JPEG Disk Optimizer is a command prompt program and so can be easily driven from other programs eg perl scripts.
Detailed usage:
dos: jdo [-Switch [Arg]] [directory]file(s)
unix: jdo [-Switch [Arg]] file(s)
Notes:
1 not in standard edition
2 not in Unix editions
| General Options | ||
| -h[nn] | Display help screen(s). -h for all screens, -h0 for summary screen, -hnn for specific help. | |
| 2 | -d | Recurse subdirectories |
| -n | Don't re-compress the file. This flag will instruct JPEG Disk Optimizer to write a marker into the JPEG file. If you then attempt to compress the file again the marker will be detected and the file skipped. Note that for this to work the -n flag must always be specified. | |
| -e | Stop on error. Normally JPEG Disk Optimizer will carry on compressing files even if it encounters a problem with a file. | |
| -a filename | Advanced options config file (see program help) | |
| JPEG Compression | ||
| -q nnn | Set output quality 1-100 (1=low, 100=high). Note, if you do not specify a quality, the quality of the input JPEG will be used (see also -a switch). You can also use -q low, -q medium, -q high. |
|
| 1 | -m nnn | Set % of MagiCompression, 0 = none, 100 = max (Default = 0%) (see also -a switch). You can also use -m low, -m medium, -m high. |
| 2 | -qb nnn | Set maximum size of image in bytes. Quality etc will be reduced until the image is less than the supplied size. |
| 2 | -uc nnn | Set number of colors in output palette (GIF/PNG) 1-256 (Default=256) |
| 2 | -ud nnn | Set % dithering (GIF/PNG), 0-100 (Default=0) |
| -x[f] | Keep Extra color. By default all color images are written with downsampled color. This option lets you keep extra color information (at the expense of file size). If you add an f (i.e. -xf) all JPEGs written will be made extra color. This might be useful in making high quality thumbnails. |
|
| -g[f] | Keep Progressive. Use this switch to preserve progressive JPEGs. If you don't specify this switch all JPEGs will be written as standard non progressive JPEGs. If you add an f (i.e. -gf) all JPEGs written will be made progressive. Progressive JPEGs are sometimes a little smaller but the progressive effect is not always desirable. |
|
| Status Options | ||
| -s[o][v][f][s][l] [filename] | ||
| -so | Don't write to standard output. Useful if you are running from another program. | |
| -sv | Verbose progress. Write out the file name as it is compressed. | |
| -sf | Display current file number on screen. Useful for monitoring progress with a lot of files. | |
| -ss | Write Summary Statistics at the end i.e. Storage and estimated cost saving. The cost savings are based on web traffic costs at $300 for 1G a day and 100 downloads a day of each image. |
|
| -sl filename | Write output to a log file. This will instruct JPEG Disk Optimizer to write it's output messages to a file. This is useful if you are running it from another program or want a log of any images that failed to be compressed. Note fatal errors are sent to the screen. | |
| Output Options | ||
| -o[j|t][r][x] Output file type | ||
| -oj | Output JPEGs (default) | |
| 2 | -og | Output GIFs |
| 2 | -on | Output PNGs |
| 2 | -ob | Output BMPs (24 bit) |
| -os | Output TIFFs (24 bit) |
|
| -or | Overwrite read only files | |
| -ox | Don't create the output images, e.g. for reporting potential savings | |
| Clean Image Options | ||
| 1 | -cn nn | Remove Noise and spots from image before compressing. -cn 0 means de-spot only -cn nn means remove noise where nn is the % amount to remove (1-100) |
| Resize and Thumbnailing Options | ||
| -rh[m] nnnn | Resize the image to have height nnnn pixels. | |
| -rw[m] nnnn | Resize the image to have width nnnn pixels (note if only height or width is specified the other dimension will be scaled proportionally to maintain the images aspect ratio) |
|
| (note if only height or width is specified the other dimension will be scaled proportionally to maintain the images aspect ratio) If option "m" is used no enlargement will be carried out |
||
| -rb#[rrggbb] | Resize the image to fit in a box whose size is given by the -rh and -rw switches. Maintain the aspect ratio of the image. If a color argument is supplied (in hexadecimal HTML format) the image will be padded out with this color to the size specified by the -rh and -rw switches. If only height or width is specified the other dimension will be set to the same as the other. | |
| -rk n.n | Resize sharpness. When resizing images it is usually best to sharpen them a little. Use this switch to override the default setting of 0.3. 0.0 is no sharpening, 1.0 is maximum sharpening. | |
| 2 | -rc xo yo ww hh | Crop image with xoffset yoffset width height |
| 2 | -t[b] nn | Thumbnail mode. Create thumbnails and HTML index files with links. The thumbnails will be created in every directory in a jdothumb directory. Each directory will have its own index file called jdothumb.html. |
| 2 | -ti[b] nn | Create an HTML index file to all the images with nn columns (jdoindex.html). |
| Note: you can force JDO to omit the html header and footer by adding a "b" to the -ti and -t switches, i.e. -tib or -tb | ||
| Digimarc Invisible Watermarking Options | ||
| 2 | -we nn | Embed Digimarc Watermarks at nn Intensity (Range:1-16, 1=minimum, 16=maximum). Set this switch to embed Digimarc watermarks. Also set the -wc switch to set your Creator ID. |
| 2 | -wm nn | Minimum Watermark Durability %, (Auto Watermark Mode). Set this switch to make jdo check the Durability of the embedded watermark. If the Durability is low jdo will repeat the watermarking and optimizing process using 1) more Intensity, 2) less MagiCompression, 3) more Quality. Up to 7 attempts will be made before giving in. |
| 2 | -wc nn nnnnnn | Digimarc Creator PIN and ID. To get your Digimarc ID go to http://www.digimarc.com/xat |
| 2 | -wy nnnn nnnn | Copyright Years. Set two Copyright years e.g. 1999 2000 |
| 2 | -wi nnnnnnnn[+] | Image ID, + for auto increment. Use this to uniquely identify an image. If you specify a + jdo will increment the ID for each image watermarked. |
| 2 | -wt nnnnnnnn[+] | Transaction ID, + for auto increment. Use this to uniquely identify an transaction. If you specify a + jdo will increment the ID for each image watermarked. |
| 2 | -w[r][n][a] | Specify any combination of r, n and a for Watermark 'r' Restricted, 'n' Do Not Copy, 'a' Adult Content |
| 2 | -ws nnn | Resolution in DPI - Dots per inch (default 100). Specify the target DPI. 100 DPI is typical for web use, 300 DPI is typical for printed images. |
| 2 | -wl filename | Append watermarking summary to log file (default jdo.log) |
| 2 | -wl- | Don't write watermarking log file |
| Visible Watermarking Options | ||
| -vf filename | Visible watermark file name (.TIF or .JPG) Specifies a smaller image to place on the image |
|
| -vo nn | Visible watermark opacity in % (default 100%) | |
| -vl pp | Visible watermark location, (default top left)0 tl 1 tm 2 tr 3 ml 4 m 5 mr 6 bl 7 bm 8 br eg -tl 0 or -tl tl for top left |
|
| -vm nnn nnn | Horizontal and vertical margins in pixels (default 20) | |
| -vt#rrggbb | Visible watermark transparent color (rgb hex) If specified all pixels in the visible watermark file that match this color will be treated as transparent. |
|
| -vs | Snap to JPEG 8x8 or 16x16 block (improves edges) | |
| Text Annotation Options | ||
| 2 | -tt text | Text to add to the image. The following codes are available: +f filename, +e extension, +p file path +t time (hh:mm), +d date (dd-Mmm-yy) ++ gives a single + |
| 2 | -tf[b][i] font nn | System font and size (default Arial, 24) Optionally, b for bold, i for italic |
| 2 | -tc#rrggbb | Text color in hex (default white) |
| 2 | -tg#rrggbb hh vv | Background color in hex (default no background) and margins around text (horizontal and vertical) |
| 2 | -to nn | Opacity in % (default 100%) |
| 2 | -tl pp | Location, (default top left). Value can be any from the following matrix: 0 tl 1 tm 2 tr 3 ml 4 m 5 mr 6 bl 7 bm 8 br eg -tl 0 or -tl tl for top left |
| 2 | -tm hh vv | Horizontal and vertical spacing from edge of image in pixels (default 20) |
| 2 | -ts | Snap to JPEG 8x8 or 16x16 block (reduces artefacts) |
| Enhancement | ||
| 12 | -ll nnn | Set % automatic levels adjustment (Default 0=OFF) |
| 12 | -lc nnn | Set % automatic color adjustment (Default 0=OFF) |
| 12 | -ls nnn | Set % sharpen (Default 0=OFF) |
| 12 | -lb nnn | Set % brightness adjustment (Default 0=OFF) |
| 12 | -ln nnn | Set % contrast adjustment (Default 0=OFF) |
| 12 | -lg nnn | Set % gamma adjustment (Default 0=OFF) |
| Input Image Information Reporting Options | ||
| -i[g][w][c] Output Image Information | ||
| These switches control how jdo outputs information. | ||
| -ig | Output general image Info e.g. width, height, filesize | |
| 2 | -iw | Output watermarking Info |
| -ic | create machine read CSV data with header rather than human readable | |
| Preferences Options | ||
| -pi nnnn | Ignore files > nnnn pixels in width or height (Default 3000). JPEG Disk Optimizer will skip any files that are larger than the specified dimension. This is to guard against a corrupt JPEG file header exhausting all your machine's memory. | |
| -pj | Only compress JPEGs (skip TIFFs). This will force a compatible behaviour with earlier versions on jdo. | |
Back to JPEG Disk Optimizer