#!/bin/bash # # Developed by Fred Weinhaus 10/22/2007 .......... revised 5/20/2017 # # ------------------------------------------------------------------------------ # # 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: grid [-s spacing] [-d displace] [-c color] [-t thickness] [-o opacity] # infile outfile # USAGE: grid [-h or -help] # # OPTIONS: # # -s spacing x,y spacing between grid lines; default=16,16 or 16; # second number is defaulted to the first # -d displace x,y displacement (offset) of the first grid lines in x and y; # default=0,0 or 0; second number is defaulted to the first # -c color color of grid lines; default="black" # -t thickness thickness of grid lines; default=1 # -o opacity opacity of grid lines opacity between 0.0 and 1.0; # opacity=0 is transparent; opacity=1 is opaque; # default=1 # ### # # NAME: GRID # # PURPOSE: To superimpose a set of horizontal and/or vertical grid lines # on an image. # # DESCRIPTION: GRID superimposes a set of horizontal and/or vertical grid # lines on an image. Parameters are available to select the grid line color, # thickness and opacity. # # # OPTIONS: # # -s spacing ... SPACING specifies the horizontal (x) and vertical (y) grid # distance between lines. Spacing must be provided as non-negative integer values. # If the second value is left off, then it will be set identical to the first. # If only vertical lines are desired, set the horizontal (x) spacing larger # than the width of the image. If only horizontal lines are desired, set # the vertical (y) spacing larger than the height of the image. The default=16. # Note: if you want the bottom and/or right grid line to show, then the image # dimension(s) must be a multiple of the grid spacing plus 1. # # -d displace ... DISPLACE specifies the horizontal (x) and vertical (y) grid # offset from the top left corner for the first grid line. Distance must be provided # as non-negative integer values. If the second value is left off, then it will be set # identical to the first. If you do not want the first grid line at x=0 and/or y=0, # then specify the displace value as spacing-1. # # -c color ... COLOR is the color of the grid lines. Any valid IM color # specification is allowed. Be sure to color values in double quotes. # The default="black". # # -t thickness ... THICKNESS is the grid line thickness. Values are positive # integers. The default=1 # # -o opacity ... OPACITY is the grid line opacity. Values are non-negative # floats between 0.0 and 1.0. The default=1 # # 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 spacing=16 displace=0 color="black" thickness=1 opacity=1 # 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 12 ] then errMsg "--- TOO MANY ARGUMENTS WERE PROVIDED ---" else while [ $# -gt 0 ] do # get parameter values case "$1" in -h|-help) # help information echo "" usage2 exit 0 ;; -s) # get spacing shift # to get the next parameter - spacing # test if parameter starts with minus sign errorMsg="--- INVALID SPACING SPECIFICATION ---" checkMinus "$1" spacing=`expr "$1" : '\([0-9]*,*[0-9]*\)'` ;; -d) # get displace shift # to get the next parameter - spacing # test if parameter starts with minus sign errorMsg="--- INVALID DISPLACE SPECIFICATION ---" checkMinus "$1" displace=`expr "$1" : '\([0-9]*,*[0-9]*\)'` ;; -c) # get color shift # to get the next parameter - lineval # test if parameter starts with minus sign errorMsg="--- INVALID COLOR SPECIFICATION ---" checkMinus "$1" # test lineval values color="$1" ;; -t) # get thickness shift # to get the next parameter - thickness # test if parameter starts with minus sign errorMsg="--- INVALID THICKNESS SPECIFICATION ---" checkMinus "$1" # test width values thickness=`expr "$1" : '\([0-9]*\)'` [ "$thickness" = "" -o $thickness -eq 0 ] && errMsg "--- THICKNESS=$thickness MUST BE A POSITIVE INTEGER ---" ;; -o) # get opacity shift # to get the next parameter - opacity # test if parameter starts with minus sign errorMsg="--- INVALID OPACITY SPECIFICATION ---" checkMinus "$1" # test width values opacity=`expr "$1" : '\([.0-9]*\)'` [ "$opacity" = "" ] && errMsg "OPACITY=$opacity IS NOT A NON-NEGATIVE FLOATING POINT NUMBER" opacitytest=`echo "$opacity > 1" | bc` [ $opacitytest -eq 1 ] && errMsg "OPACITY=$opacity MUST BE BETWEEN 0.0 AND 1.0" ;; -) # 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" # setup temporary images and auto delete upon exit # use mpc/cache to hold input image temporarily in memory tmpA="$dir/profile_$$.mpc" tmpB="$dir/profile_$$.cache" trap "rm -f $tmpA $tmpB;" 0 trap "rm -f $tmpA $tmpB; exit 1" 1 2 3 15 trap "rm -f $tmpA $tmpB; exit 1" ERR # if convert -quiet "$infile" +repage "$tmpA" then : 'do nothing - continue processing below' else errMsg "--- FILE $infile DOES NOT EXIST OR IS NOT AN ORDINARY FILE, NOT READABLE OR HAS ZERO SIZE ---" fi # get image dimensions width=`identify -format "%w" $tmpA` height=`identify -format "%h" $tmpA` width1=$((width - 1)) height1=$((height - 1)) # get spacing values xinc=`echo "$spacing" | cut -d, -f1` yinc=`echo "$spacing" | cut -d, -f2` # get displace values delx=`echo "$displace" | cut -d, -f1` dely=`echo "$displace" | cut -d, -f2` # get string for drawing grid lines drawstr="" if [ $yinc -le $height ] then i=$dely while [ $i -le $height ] do drawstr="$drawstr M 0,$i L $width1,$i" i=$((i + yinc)) done fi if [ $xinc -le $width ] then i=$delx while [ $i -le $width ] do drawstr="$drawstr M $i,0 L $i,$height1" i=$((i + xinc)) done fi # process image convert $tmpA -fill none -stroke $color -strokewidth $thickness -draw "stroke-opacity $opacity path '$drawstr'" "$outfile" exit 0