contrib/pic2graph/pic2graph.sh

   1 #! /bin/sh
   2 #
   3 # pic2graph -- compile PIC image descriptions to bitmap images
   4 #
   5 # by Eric S. Raymond <esr@thyrsus.com>, July 2002
   6
   7 # In Unixland, the magic is in knowing what to string together...
   8 #
   9 # Take a pic/eqn diagram on stdin, emit cropped bitmap on stdout.
  10 # The pic markup should *not* be wrapped in .PS/.PE, this script will do that.
  11 # An -unsafe option on the command line enables gpic/groff "unsafe" mode.
  12 # A -format FOO option changes the image output format to any format
  13 # supported by convert(1).  An -eqn option changes the eqn delimiters.
  14 # All other options are passed to convert(1).  The default format in PNG.
  15 #
  16 # Requires the groff suite and the ImageMagick tools.  Both are open source.
  17 # This code is released to the public domain.
  18 #
  19 # Here are the assumptions behind the option processing:
  20 #
  21 # 1. Only the -U option of gpic(1) is relevant.  -C doesn't matter because
  22 #    we're generating our own .PS/.PE, -[ntcz] are irrelevant because we're
  23 #    generating Postscript.
  24 #
  25 # 2. Ditto for groff(1), though it's a longer and more tedious demonstration.
  26 #
  27 # 3. Many options of convert(1) are potentially relevant (especially
  28 #    -density, -interlace, -transparency, -border, and -comment).
  29 #
  30 # Thus, we pass -U to gpic and groff, and everything else to convert(1).
  31 #
  32 # We don't have complete option coverage on eqn because this is primarily
  33 # intended as a pic translator; we can live with eqn defaults.
  34 #
  35 groffpic_opts=""
  36 gs_opts=""
  37 convert_opts=""
  38 format="png"
  39 eqndelim='$$'
  40
  41 while [ "$1" ]
  42 do
  43     case $1 in
  44     -unsafe)
  45         groffpic_opts="-U";;
  46     -format)
  47         format=$2
  48         shift;;
  49     -eqn)
  50         eqndelim=$2
  51         shift;;
  52     -v | --version)
  53         echo "GNU pic2graph (groff) version @VERSION@"
  54         exit 0;;
  55     --help)
  56         echo "usage: pic2graph [ option ...] < in > out"
  57         exit 0;;
  58     *)
  59         convert_opts="$convert_opts $1";;
  60     esac
  61     shift
  62 done
  63
  64 if [ "$eqndelim" ]
  65 then
  66     eqndelim="delim $eqndelim"
  67 fi
  68
  69 # create temporary directory
  70 tmp=
  71 for d in "$GROFF_TMPDIR" "$TMPDIR" "$TMP" "$TEMP" /tmp; do
  72     test -z "$d" && continue
  73
  74     tmp=`(umask 077 && mktemp -d -q "$d/pic2graph-XXXXXX") 2> /dev/null` \
  75     && test -n "$tmp" && test -d "$tmp" \
  76     && break
  77
  78     tmp=$d/pic2graph$$-$RANDOM
  79     (umask 077 && mkdir $tmp) 2> /dev/null \
  80     && break
  81 done;
  82 if test -z "$tmp"; then
  83     echo "$0: cannot create temporary directory" >&2
  84     { (exit 1); exit 1; }
  85 fi
  86
  87 trap 'exit_status=$?; rm -rf $tmp && exit $exit_status' EXIT INT TERM
  88
  89 # Here goes:
  90 # 1. Wrap the input in dummy .PS/PE macros (and add possibly null .EQ/.EN)
  91 # 2. Process through eqn and pic to emit troff markup.
  92 # 3. Process through groff to emit Postscript.
  93 # 4. Use convert(1) to crop the PostScript and turn it into a bitmap.
  94 (echo ".EQ"; echo $eqndelim; echo ".EN"; echo ".PS"; cat; echo ".PE") | \
  95     groff -e -p $groffpic_opts -Tps -P-pletter > $tmp/pic2graph.ps \
  96     && convert -trim $convert_opts $tmp/pic2graph.ps $tmp/pic2graph.$format \
  97     && cat $tmp/pic2graph.$format
  98
  99 # End