1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
|
#!/bin/bash
#
# Developed by Fred Weinhaus 10/22/2007 .......... revised 1/1/2008
#
# USAGE: grid [-s spacing] [-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
# -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
# offset between lines. Spacing must be provided as 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=8.
# 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.
#
# -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
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 -n '/^###/q; /^#/!q; s/^#//; s/^ //; 4,$p' "$PROGDIR/$PROGNAME"
}
usage2()
{
echo >&2 ""
echo >&2 "$PROGNAME:" "$@"
sed >&2 -n '/^######/q; /^#/!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 10 ]
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="$1,"
;;
-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; exit 0" 0
trap "rm -f $tmpA $tmpB; exit 1" 1 2 3 15
#
if convert -quiet -regard-warnings "$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=`expr $width - 1`
height1=`expr $height - 1`
xinc=`echo "$spacing" | cut -d, -f1`
yinc=`echo "$spacing" | cut -d, -f2`
[ "$yinc" = "" ] && yinc=$xinc
testx=`expr $xinc : '[0-9]*'`
testy=`expr $yinc : '[0-9]*'`
[ $testx -eq 0 -o $testy -eq 0 ] && errMsg "--- SPACING MUST BE AN INTEGER ---"
# get string for drawing grid lines
drawstr=""
if [ $yinc -le $height ]
then
i=0
while [ $i -le $height ]
do
drawstr="$drawstr M 0,$i L $width1,$i"
i=`expr $i + $yinc`
done
fi
if [ $xinc -le $width ]
then
i=0
while [ $i -le $width ]
do
drawstr="$drawstr M $i,0 L $i,$height1"
i=`expr $i + $xinc`
done
fi
# process image
convert $tmpA -fill none -stroke $color -strokewidth $thickness -draw "stroke-opacity $opacity path '$drawstr'" $outfile
exit 0
|
