tools/makebuttons

   1 #!/bin/sh
   2 #
   3 # "$Id$"
   4 #
   5 #   Button generation script for the Common UNIX Printing System (CUPS).
   6 #
   7 #   Originally created and donated by Philippe Combes (see STR #2231).
   8 #
   9 #   Copyright 2007 by Easy Software Products, all rights reserved.
  10 #
  11 #   These coded instructions, statements, and computer programs are the
  12 #   property of Easy Software Products and are protected by Federal
  13 #   copyright law.  Distribution and use rights are outlined in the file
  14 #   "LICENSE.txt" which should have been included with this file.  If this
  15 #   file is missing or damaged please contact Easy Software Products
  16 #   at:
  17 #
  18 #       Attn: CUPS Licensing Information
  19 #       Easy Software Products
  20 #       44141 Airport View Drive, Suite 204
  21 #       Hollywood, Maryland 20636-3142 USA
  22 #
  23 #       Voice: (301) 373-9600
  24 #       EMail: cups-info@cups.org
  25 #         WWW: http://www.cups.org
  26 #
  27
  28 #
  29 # This little script uses convert from ImageMagick to generate CUPS buttons.
  30 # It requires ImageMagick version 6.2.4 or higher.
  31 #
  32 # It can generate 20-pixel high one-line buttons and 40-pixel high two-line
  33 # buttons.
  34 #
  35 # Usage:
  36 #
  37 #     tools/makebuttons locale buttons.txt
  38 #
  39 # "Locale" is the locale name, either "ll" or "ll_CC" where "ll" is the
  40 # 2-letter language abbreviation and "CC" is the 2-letter ISO country
  41 # code.  The new "ll-region" syntax is *not* supported at this time
  42 # and should not be used!
  43 #
  44 # "Buttons.txt" is a file containing the buttons to be created and must
  45 # be formatted as follows:
  46 #
  47 #     filename.gif color text for button
  48 #
  49 # "filename.gif" is the name of the image file to create.
  50 #
  51 # "color" is the color of the button, one of "std" (the normal olive
  52 # background), "black", "green", or "red".
  53 #
  54 # The remainder of the line following the color is used as the text
  55 # for the button.  Use "@UP" and "@DOWN" to include up and down arrows,
  56 # and "\\n" to break the text into 2 lines (not generally recommended).
  57 #
  58 # Lines starting with '#' are treated as comments.  See the file
  59 # "tools/buttons.txt" for inspiration...
  60 #
  61
  62 if test $# -lt 2; then
  63         echo Usage: tools/makebuttons locale buttons.txt
  64         exit 1
  65 elif test ! -d tools; then
  66         echo ERROR: You MUST run the makebuttons script from the main CUPS source directory!
  67         exit 1
  68 elif test "x`convert --help | grep extent`" = x; then
  69         echo ERROR: This script requires ImageMagick 6.2.4 or higher.
  70         exit 1
  71 else
  72         locale=$1
  73         list=$2
  74 fi
  75
  76 if test ! -f $list; then
  77         echo "ERROR: $list: file not found."
  78         exit 1
  79 elif test ! -r $list; then
  80         echo "ERROR: $list: cannot read file."
  81         exit 1
  82 fi
  83
  84
  85 # Bitstream Vera font...
  86 font="fonts/Vera.ttf"
  87
  88 # Colors
  89 background="#d4d4a4"
  90 black="#000000"
  91 green="#009900"
  92 red="#cc0000"
  93 standard="#666633"
  94
  95
  96 # 'generate_button()' - Create a button image.
  97 #
  98 # Arg 1: button filename (WITH .gif extension!)
  99 # Arg 2: button color: black, green, red or std (only the initial letter matters)
 100 # Arg 3+: the text !
 101
 102 function generate_button()
 103 {
 104         # Collect arguments...
 105         filename=$1
 106         shift
 107
 108         color=$1
 109         shift
 110
 111         txt="$*"
 112
 113         # Show progress...
 114         echo Creating $filename...
 115
 116         # Figure out the foreground and background colors...
 117         bgclr=$background
 118
 119         case x$color in
 120                 xb*)
 121                         fgclr=$black
 122                         fuzz="10%"
 123                         ;;
 124
 125                 xg*)
 126                         fgclr=$green
 127                         fuzz="10%"
 128                         ;;
 129
 130                 xr*)
 131                         fgclr=$red
 132                         fuzz="1%"
 133                         ;;
 134
 135                 xs*)
 136                         fgclr=$standard
 137                         fuzz="10%"
 138                         ;;
 139
 140                 *)
 141                         echo "ERROR: Unknown color $color for $filename!"
 142                         exit 1
 143                         ;;
 144         esac
 145
 146         # See if we need to add the up or down arrows...
 147         add_arrows=0 # 1: up arrows, 2: down arrows
 148
 149         if echo $txt | grep '@UP' > /dev/null 2>&1; then
 150                 add_arrows=1
 151                 txt="`echo $txt | sed 's|@UP||g'`"
 152         elif echo $txt | grep '@DOWN' > /dev/null 2>&1; then
 153                 add_arrows=2
 154                 txt="`echo $txt | sed 's|@DOWN||g'`"
 155         fi
 156
 157         tmp_btn=/tmp/cups-btn-$$.bmp
 158
 159         # First step: generate an image trimmed to the text.
 160         #  -> annotate a 40x400 rectangle with the provided text
 161         #  -> trim to the text
 162         convert xc:transparent -extent 400x40 -fill "$fgclr" \
 163                 -draw "rectangle 0,0 399,39" \
 164                 -fill "#ffffff" -encoding Unicode -pointsize 13 -font "$font" \
 165                 -gravity Center -annotate 0x0+0+0 "$txt" -trim $tmp_btn
 166
 167         # From the 1st step, we get text width and height
 168         txt_h=`identify -format "%h" $tmp_btn`
 169         txt_w=`identify -format "%w" $tmp_btn`
 170
 171         if test $txt_h -gt 32; then
 172                 echo "ERROR: 2 lines maximum for the button text"
 173                 exit 1
 174         fi
 175
 176         # With the default font, one line is less than 16 pixels high, and a
 177         # two lines of text is at least 20 pixels high.  So, from the text
 178         # height we guess if we need a one- or two-line button.
 179         if test $txt_h -ge 18; then
 180                 btn_h=40
 181         else
 182                 btn_h=20
 183         fi
 184
 185         if test $add_arrows -gt 0; then
 186                 if test $btn_h -eq 20; then
 187                         txt_w=`expr $txt_w + 36`
 188                 elif test $btn_h -eq 40; then
 189                         txt_w=`expr $txt_w + 58`
 190                 fi
 191         fi
 192
 193         # Second step: generate the button.
 194         #
 195         # Procedure:
 196         #
 197         #     - Draw a rectangle with the background color (for correct
 198         #       button borders)
 199         #     - Draw a roundRectangle (args are coordinates, not lengths!)
 200         #     - Make the background transparent (with correct fuzz feature)
 201         #     - Annotate centered text (in height, it is necessary to have
 202         #       -1 in y parameter so that the text is not too low)
 203         rad=`expr $btn_h / 2`
 204         btn_w=`expr $txt_w + $rad + $rad`
 205         btn_top=`expr $btn_h - 1`
 206
 207         convert xc:transparent \
 208                 -extent $btn_w'x'$btn_h -fill "$bgclr" \
 209                 -draw "rectangle 0,0 $btn_w,$btn_h" -fill "$fgclr" \
 210                 -draw "roundRectangle 0,0 `expr $btn_w - 1`,$btn_top `expr $rad - 1`,$rad" \
 211                 -fuzz $fuzz -transparent "$bgclr" -write $filename \
 212                 -fill "#ffffff" -encoding Unicode -pointsize 13 \
 213                 -font "$font" -gravity Center -annotate 0x0+0-1 "$txt" \
 214                 $filename
 215
 216         if test $add_arrows -gt 0; then
 217                 if test $add_arrows -eq 1; then
 218                         # UP arrows
 219                         if test $btn_h -eq 20; then
 220                                 # 1-line buttons
 221                                 pts1="9,15 21,15 15,4"
 222                                 pts2="`expr $btn_w - 10`,15 `expr $btn_w - 22`,15 `expr $btn_w - 16`,4"
 223                         else
 224                                 # 2-line buttons
 225                                 pts1="16,30 34,30 25,10"
 226                                 pts2="`expr $btn_w - 17`,30 `expr $btn_w - 35`,30 `expr $btn_w - 26`,10"
 227                         fi
 228                 else
 229                         # DOWN arrows
 230                         if [ $btn_h -eq 20 ]; then
 231                                 # 1-line buttons
 232                                 pts1="9,4 21,4 15,15"
 233                                 pts2="`expr $btn_w - 10`,4 `expr $btn_w - 22`,4 `expr $btn_w - 16`,15"
 234                         else
 235                                 # 2-line buttons
 236                                 pts1="16,10 34,10 25,30"
 237                                 pts2="`expr $btn_w - 17`,10 `expr $btn_w - 35`,10 `expr $btn_w - 26`,30"
 238                         fi
 239                 fi
 240
 241                 convert $filename -fill "#ffffff" -draw "polygon $pts1" \
 242                         -draw "polygon $pts2" $filename
 243         fi
 244
 245         rm -f $tmp_btn
 246 }
 247
 248 # Make sure the locale-specific destination directory exists...
 249 if test ! -d doc/$locale/images; then
 250         echo Creating doc/$locale/images...
 251         mkdir -p doc/$locale/images
 252 fi
 253
 254 # Process each line in the file...
 255 cat $list | while read line; do
 256         if test "x`echo $line | cut -c1`" = "x#"; then
 257                 continue
 258         fi
 259
 260         generate_button doc/$locale/images/$line
 261 done
 262
 263 #
 264 # End of "$Id$".
 265 #