USAGE: colortoning [-ch highcolor] [-cl lowcolor] [-ca allcolor] [-bh -blendhigh] [-bl blendlow] [-ba blenall] [-o order] [-i images] infile outfile

USAGE: colortoning [-help|h]

-ch ... highcolor ... desired highrange or highlight color; default=no
..................... highlight toning
-cl ... lowcolor ... desired lowrange or shadow color; default=no
..................... shadow toning
-ca ... allcolor .... desired overall color; default=no overall toning
-bh ... blendhigh ... blending amount for hightlights; 0≤integer≤100;
..................... default=100 (all hightoned and no input)
-bl ... blendlow .... blending amount for shadows; 0≤integer≤100;
..................... default=100 (all shadowtoned and no input)
-ba ... blendall .... blending amount for overall color; 0≤integer≤100;
..................... default=100 (all shadowtoned and no input)
-o ... order ........ order of tonal processing steps; comma separate
..................... string involving any non-duplicated combination
..................... of H,L,A; one, two, or three letters may be
..................... specified; default="HLA" to process highlights
..................... first, then shadows, then all
-i images ...... choice of view or save intermediate images
..................... resulting from each toning step; default=neither

PURPOSE: To color tone an image in highlights and/or shadows and/or overall.

DESCRIPTION: COLORTONING will color tone an image in highlights and/or shadows and/or overall. The amount of blending with the original image in each tonal range can be specified. The default is not to blend with the original image. Processing occurs sequentially from highlights to shadows to overall toning.

ARGUMENTS:

-ch highcolor ... HIGHCOLOR is the highrange or highlight color desired for the toning. Any valid opaque IM color is allowed. The default is no highlight color toning.

-cl lowcolor ... LOWCOLOR is the lowrange or shadow color desired for the toning. Any valid opaque IM color is allowed. The default is no shadow color toning.

-ca allcolor ... ALLCOLOR is the overall color desired for the toning. Any valid opaque IM color is allowed. The default is no overall color toning.

-bh blendhigh ... BLENDHIGH is the percent blending of the highlight toned image with the original (or previous toned version). Values are integers in the range of 0 to 100. The default=100 means all toned image and no blending.

-bl blendlow ... BLENDLOW is the percent blending of the shadow toned image with the original (or previous toned version). Values are integers in the range of 0 to 100. The default=100 means all toned image and no blending.

-ba blendall ... BLENDAll is the percent blending of the overall toned image with the original (or previous toned version). Values are integers in the range of 0 to 100. The default=100 means all toned image and no blending.

-o order ... ORDER is the order of the tonal processing steps. Values are a comma separate string involving any non-duplicated combination of H,L and A. One, two or three letters may be specified. The default="H,L,A" to process highlights first, then shadows, then all.

-i images ... IMAGES permits the viewing or saving of the intermediate images generated during the processing. The choices are: view (v) or save (s). The default is neither. If images=save, then files will be named for the input image with _colortoning_#.png where #=1 and/or 2 and/or 3.

REFERENCE: http://phlearn.com/color-toning-with-reference-episode110

CAVEAT: No guarantee that this script will work on all platforms, nor that trapping of inconsistent parameters is complete and foolproof. Use At Your Own Risk.