#!/bin/bash # # Developed by Fred Weinhaus 10/08/2007 .......... revised 4/25/2015 # # ------------------------------------------------------------------------------ # # Licensing: # # Copyright © Fred Weinhaus # # My scripts are available free of charge for non-commercial use, ONLY. # # For use of my scripts in commercial (for-profit) environments or # non-free applications, please contact me (Fred Weinhaus) for # licensing arrangements. My email address is fmw at alink dot net. # # If you: 1) redistribute, 2) incorporate any of these scripts into other # free applications or 3) reprogram them in another scripting language, # then you must contact me for permission, especially if the result might # be used in a commercial or for-profit environment. # # My scripts are also subject, in a subordinate manner, to the ImageMagick # license, which can be found at: http://www.imagemagick.org/script/license.php # # ------------------------------------------------------------------------------ # #### # # USAGE: saturation [value] infile outfile # USAGE: saturation [-h or -help] # # OPTIONS: # # value saturation gain factor (float); # sat>=0.0; default=1.0 (no change); # must specify one digit after decimal # -h or -help get help # ### # # NAME: SATURATION # # PURPOSE: To change the color saturation in an image. # # DESCRIPTION: SATURATION changes the color saturation in an # image in a linear manner. The image is first converted to # HSL colorspace and then the saturation value is used as a # multiplier for each value in the S channel. Then the modified # saturation channel is recombined with the H and L channels # and the image is converted to RGB colorspace as output. # # Arguments: # # -h or -help --- displays help information. # # value --- value is the saturation factor. It is a multiplier for # the saturation channel in an image. Values greater than 1.0 will # increase the saturation of the image and values less than 1.0 will # decrease the saturation of the image. The default is 1.0 or no gain. # Note: must specify the decimal point and one digit following it. # # 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. # ###### # # set default values; value=1.0 # set directory for temporary files dir="." # suggestions are dir="." or dir="/tmp" # # # set up functions to report Usage and Usage with Description PROGNAME=`type $0 | awk '{print $3}'` # search for executable on path PROGDIR=`dirname $PROGNAME` # extract directory of program PROGNAME=`basename $PROGNAME` # base name of program usage1() { echo >&2 "" echo >&2 "$PROGNAME:" "$@" sed >&2 -e '1,/^####/d; /^###/g; /^#/!q; s/^#//; s/^ //; 4,$p' "$PROGDIR/$PROGNAME" } usage2() { echo >&2 "" echo >&2 "$PROGNAME:" "$@" sed >&2 -e '1,/^####/d; /^######/g; /^#/!q; s/^#*//; s/^ //; 4,$p' "$PROGDIR/$PROGNAME" } # # function to report error messages errMsg() { echo "" echo $1 echo "" usage1 exit 1 } # # function to test for minus at start of value of second part of option 1 or 2 checkMinus() { test=`echo "$1" | grep -c '^-.*$'` # returns 1 if match; 0 otherwise [ $test -eq 1 ] && errMsg "$errorMsg" } # # # test for correct number of arguments and get values if [ $# -eq 0 ] then # help information echo "" usage2 exit 0 elif [ $# -gt 3 ] then errMsg "--- TOO MANY ARGUMENTS WERE PROVIDED ---" else while [ $# -gt 0 ] do # get parameters case "$1" in -h|-help) # help information echo "" usage2 ;; [0-9]*.[0-9]*) # value value=$1 ;; -) # STDIN and end of arguments break ;; -*) # any other - argument errMsg "--- UNKNOWN OPTION ---" ;; *) # end of arguments break ;; esac shift # next option done # # get infile and outfile infile="$1" outfile="$2" fi # test that infile provided [ "$infile" = "" ] && errMsg "NO INPUT FILE SPECIFIED" # test that outfile provided [ "$outfile" = "" ] && errMsg "NO OUTPUT FILE SPECIFIED" tmpA="$dir/saturation_$$.mpc" tmpB="$dir/saturation_$$.cache" tmp0="$dir/saturation_0_$$.png" tmp1="$dir/saturation_1_$$.png" tmp2="$dir/saturation_2_$$.png" trap "rm -f $tmpA $tmpB $tmp0 $tmp1 $tmp2;" 0 trap "rm -f $tmpA $tmpB $tmp0 $tmp1 $tmp2; exit 1" 1 2 3 15 trap "rm -f $tmpA $tmpB $tmp0 $tmp1 $tmp2; exit 1" ERR # get im_version im_version=`convert -list configure | \ sed '/^LIB_VERSION_NUMBER */!d; s//,/; s/,/,0/g; s/,0*\([0-9][0-9]\)/\1/g' | head -n 1` # colorspace RGB and sRGB swapped between 6.7.5.5 and 6.7.6.7 # though probably not resolved until the latter # then -colorspace gray changed to linear between 6.7.6.7 and 6.7.8.2 # then -separate converted to linear gray channels between 6.7.6.7 and 6.7.8.2, # though probably not resolved until the latter # so -colorspace HSL/HSB -separate and -colorspace gray became linear # but we need to use -set colorspace RGB before using them at appropriate times # so that results stay as in original script # The following was determined from various version tests using saturation. # with IM 6.7.4.10, 6.7.6.10, 6.7.9.0 if [ "$im_version" -lt "06070607" -o "$im_version" -gt "06070707" ]; then setcspace="-set colorspace RGB" else setcspace="" fi if [ "$im_version" -lt "06070606" -o "$im_version" -gt "06070707" ]; then cspace="RGB" else cspace="sRGB" fi # no need for setcspace for grayscale or channels after 6.8.5.4 if [ "$im_version" -gt "06080504" ]; then setcspace="" cspace="sRGB" fi if convert -quiet "$infile" +repage "$tmpA" then convert $tmpA $setcspace -colorspace HSL -channel R -separate $tmp0 convert $tmpA $setcspace -colorspace HSL -channel G -separate $tmp1 convert $tmpA $setcspace -colorspace HSL -channel B -separate $tmp2 convert $tmp0 -colorspace HSL \ $tmp0 -compose CopyRed -composite \ \( $tmp1 -evaluate multiply $value \) -compose CopyGreen -composite \ $tmp2 -compose CopyBlue -composite \ -colorspace $cspace "$outfile" else errMsg "--- FILE $infile DOES NOT EXIST OR IS NOT AN ORDINARY FILE, NOT READABLE OR HAS ZERO SIZE ---" fi exit 0