[png2uri] Version 1.0.5, July 7, 2012: Eliminated use of "uname"

and use the return of "base64" and "uuencode" to select the workable one
(checking "base64" first); suggested by John Bowler.  Added a check for too
many arguments, also a JB suggestion.  Accept output filename as an optional
final argument.

README_master.txt

@@ -1,6 +0,0 @@
-
-/*
-  This is the master branch of the "pmt" tree.
-  Individual projects are in separate branches,
-    e.g. pngcrush is in the "pngcrush" branch.
-*/

png2uri

@@ -0,0 +1,173 @@
+#!/bin/sh
+#
+# png2uri version 1.0.5, July 7, 2012.
+#
+# NO COPYRIGHT RIGHTS ARE CLAIMED TO THIS SOFTWARE.
+#
+# To the extent possible under law, the author has waived all copyright and
+# related or neighboring rights to this work. This work is published from
+# the United States of America in 2012.
+#
+# This png2uri software may be used freely in any way.
+#
+# The source is the original work of the person named below.  No other person
+# or organization has made contributions to this work.
+#
+# ORIGINAL AUTHORS
+#     The following people have contributed to the code or comments in this
+#     file.  None of the people below claim any rights with regard to the
+#     contents of this file.
+#
+#     Glenn Randers-Pehrson <glennrp at users.sourceforge.net> is the author.
+#     John Bowler <jbower at acm.org> contributed some useful suggestions.
+#
+# png2uri is a command-line application that creates an HTML "img" tag on
+# standard output containing a data URI in accordance with RFC-2397, from
+# a PNG file or from a PNG datastream received from standard input.
+# Other formats besides the default, PNG, are supported, via the "-f" or
+# "--format" option or, if that option was not supplied, by inspection of the
+# filename extension.
+#
+# Usage: png2uri [-f type|--format type] [-u|--uri_only] [infile [outfile]]
+#
+#        options: -f|--format TYPE: 
+#                 write "image/TYPE" instead of "image/png" in the
+#                 data uri.  TYPE can be png, jpg, jpeg, bmp, or gif,
+#                 or any of those in upper case.  To write any other
+#                 type, include the complete MIME type as in
+#                 "--format image/x-jng" or "-f audio/mpeg".
+#
+#                 -u|--uri_only|--url_only
+#                 omit the surrounding "img" tag and only write the
+#                 data URI.
+#
+# Requires /bin/sh and a "base64" or "uuencode -m" that encodes its input
+# in base64 according to RFC-3548 and writes the result on standard output,
+# and a working "sed".
+#
+# If you prefer a web-based converter or a java application, this isn't
+# it. Use your search engine and look for "data uri" to find one.
+#
+# This script figures out which of base64(1) or uuencode(1) to use, since
+# neither is always present (uuencode must be installed as part of "sharutils"
+# on Gnu/Linux platforms, which often hasn't happened).
+
+png2uri_encode(){
+base64 2>/dev/null || uuencode -m "====" 2>/dev/null | grep -v "===="
+}
+
+PNG2URI_FMT="unknown"
+PNG2URI_URI="true"
+
+while true
+do
+case X$1 in
+  X-f|X--format)
+    shift
+
+    case X$1 in
+      Xpng|XPNG)
+        PNG2URI_FMT=image/png
+        ;;
+
+      Xjpeg|XJPEG|Xjpg|XJPG)
+        PNG2URI_FMT=image/jpeg
+        ;;
+
+      Xbmp|XBMP)
+        PNG2URI_FMT=image/bmp
+        ;;
+
+      Xgif|XGIF)
+        PNG2URI_FMT=image/gif
+        ;;
+
+      *)
+        PNG2URI_FMT=$1
+        ;;
+    esac
+    shift
+    ;;
+
+  X-u|X--ur*)
+      PNG2URI_URI="false"
+      shift
+      ;;
+
+  X)
+      # Convert standard input.
+      case X$PNG2URI_FMT in
+        Xunknown)
+          PNG2URI_FMT=image/png
+          ;;
+      esac
+
+      case X$PNG2URI_URI in
+        Xfalse)
+          echo "data:$PNG2URI_FMT;base64,"
+          png2uri_encode
+          ;;
+
+        *)
+          echo "<img alt=\"PNG\" title=\"PNG\" src=\"data:$PNG2URI_FMT;base64,"
+          png2uri_encode
+          echo "\">"
+          ;;
+      esac
+      exit
+      ;;
+
+  *)
+      # Convert the named file.
+
+      # First make sure there weren't extra arguments
+      case $# in
+        1)
+          :  # OK, continue
+          ;;
+        2)
+          exec < "$1" > "$2"
+          ;;
+        *)
+          echo "png2uri: too many arguments: $*" >&2
+          echo "usage: png2uri [options] [infile [outfile]" >&2
+          exit 1
+          ;;
+      esac
+
+      case X$PNG2URI_FMT in
+        Xunknown)
+          PNG2URI_FMT=image/png
+          png2uri_extension=`echo $1 | sed "s/.*\.//"`
+
+          case X$png2uri_extension in
+              Xjpeg|XJPEG|Xjpg|XJPG)
+                PNG2URI_FMT=image/jpeg
+                ;;
+
+              Xbmp|XBMP)
+                PNG2URI_FMT=image/bmp
+                ;;
+
+              Xgif|XGIF)
+                PNG2URI_FMT=image/gif
+                ;;
+            esac
+          ;;
+      esac
+
+      case X$PNG2URI_URI in
+        Xfalse)
+            echo "data:$PNG2URI_FMT;base64,"
+            png2uri_encode < "$1"
+            ;;
+        *)
+            echo "<img alt=\"$1\" title=\"$1\" src=\"data:$PNG2URI_FMT;base64,"
+            png2uri_encode < "$1"
+            echo "\">"
+            ;;
+      esac
+      exit
+      ;;
+esac
+done

png2uri-README.txt

@@ -0,0 +1,142 @@
+/*
+ png2uri
+
+ NO COPYRIGHT RIGHTS ARE CLAIMED TO THIS SOFTWARE.
+
+ To the extent possible under law, the author has waived all copyright and
+ related or neighboring rights to this work. This work is published from
+ the United States of America in 2012.
+
+ The png2uri software may be used freely in any way.
+
+ The source is the original work of the person named below.  No other person
+ or organization has made contributions to this work.
+
+ ORIGINAL AUTHORS
+     The following people have contributed to the code or comments in this
+     file.  None of the people below claim any rights with regard to the
+     contents of this file.
+
+     Glenn Randers-Pehrson <glennrp@users.sourceforge.net>
+
+ png2uri is a command-line application that creates an HTML "img" tag on
+ standard output containing a data URI, from a PNG file or from standard
+ input. Other formats besides the default, PNG, are supported, via the "-f"
+ or "--format" option or, if that option was not supplied, by inspection of
+ the filename extension.
+
+ Usage: png2uri [-f format|--format format] [-u|--uri_only] [infile [outfile]]
+
+        options: -f|--format TYPE: 
+                 write "image/TYPE" instead of "image/png" in the
+                 data uri.  TYPE can be png, jpg, jpeg, bmp, or gif,
+                 or any of those in upper case.  To write any other
+                 type, include the complete MIME type as in
+                 "--format image/x-jng" or "-f audio/mpeg".
+
+                 -u|--uri_only|--url_only
+                 omit the surrounding "img" tag and only write the
+                 data URI.
+
+ Requires /bin/sh and a base64(1) that encodes its input in base64
+ according to RFC-3548 and writes the result on standard output, and
+ a working "sed".  Versions 1.0.0 through 1.0.3 used uuencode(1) instead
+ of base64(), but a surprising number of machines that I've tried
+ (5 out of 11) don't have uuencode installed, while all 11 had base64(1)
+ which is a "core utility" rather than a "shar utility".  Using base64()
+ has an additional advantage that the lines are always folded to the same
+ width, 76 characters wide, while uuencode sometimes writes shorter lines.
+
+ REFERENCES:
+    http://en.wikipedia.org/wiki/Data_URI_scheme
+
+    Masinter, L. "RFC 2397 - The "data" URL scheme",
+      Internet Engineering Task Force, August 1998
+
+    http://en.wikipedia.org/wiki/Base64
+
+    IETF, "RFC 3548 - The Base16, Base32, and Base64 Data Encodings",
+      July 2003.
+
+ OTHER IMPLEMENTATIONS
+
+ If you prefer a web-based converter or a java application, this isn't
+ it. Use your search engine and look for "png data uri" to find one.
+ Here are some:
+
+   A PHP script:
+      http://css-tricks.com/snippets/php/create-data-uris/
+
+   Hixie's web-based converter
+      http://software.hixie.ch/utilities/cgi/data/data/
+ 
+   Websemantics' web-based converter
+      http://websemantics.co.uk/online_tools/image_to_data_uri_convertor
+
+   Mike Scalora's web-based converter
+      http://www.scalora.org/projects/uriencoder/
+
+   Data URL Maker (a web-based drag-and-drop converter), CSS Optimizer,
+   and Data URL Toolkit (a PERL implementation)
+      http://dataurl.net/#about
+
+ CHANGE LOG
+
+   Version 1.0.0, July 3, 2012:
+
+      Initial release.
+
+   Version 1.0.1, July 4, 2012:
+
+      The string "base64" could conceivably appear within the encoded data
+      and any line containing "base64" is removed; revised script to
+      use "====" instead to remove the first line of uuencode output.
+
+      Implemented "-u" and "--url_only" option.
+
+   Version 1.0.2, July 4, 2012:
+
+      Implemented "-f TYPE" and "--format TYPE" option.
+
+   Version 1.0.3, July 5, 2012:
+
+      Changed environment variable "format" to PNG2URI_FMT reduce possibility`
+      of name conflict, and changed "uri_only" to PNG2URI_URI.  Fixed some
+      indentation.
+
+   Version 1.0.4, July 6, 2012:
+
+      Use "base64" instead of "uuencode" when "uname" returns "Linux" to
+      generate the output, because "base64" seems to be more prevalently
+      available. On Gnu/Linux platforms, uuencode must be installed as part
+      of "sharutils", which often doesnn't happen.  SunOS and FreeBSD don't
+      supply "base64" so we use "uuencode" instead.
+
+   Version 1.0.5, July 7, 2012:
+
+      Eliminated use of "uname" and use the return of "base64" and "uuencode"
+      to select the workable one (checking "base64" first); suggested by
+      John Bowler.  Added a check for too many arguments, also a JB suggestion.
+      Accept output filename as an optional final argument.
+
+ TO DO
+
+ 1. Test on various other platforms. I assume we'll soon find one that has
+    neither "uuencode" nor "base64".  The following have been tried
+
+    Ubuntu 10.04 (using "base64")
+    Ubuntu 12.04 (using "base64")
+    SunOS 5.10   (using "uuencode")
+    SunOS 5.11   (using "uuencode")
+    FreeBSD 8.0  (using "uuencode")
+    Redhat Gnu/Linux (using "base64")
+    Redhat Enterprise (using "base64")
+
+ 2. Find out if the script works on Windows and Mac or can be modified to
+ do so.
+
+ 3. Make it work as a drag-and-drop application.
+
+ 4. But keep it simple! 
+
+*/