Generate notification images

scripts/generate_notification_images.sh

@@ -0,0 +1,106 @@
+#!/bin/bash
+# vim: tabstop=4 shiftwidth=4 softtabstop=4
+
+# Create notification image(s).
+# The default ones are listed in this file, but
+# other scripts can create custom messages on-the-fly by passing arguments to this script.
+# This is quick - on a Pi 4 it takes about one second per image.
+
+# Allow this script to be executed manually, which requires several variables to be set.
+if [ -z "${ALLSKY_HOME}" ] ; then
+	export ALLSKY_HOME=$(realpath $(dirname "${BASH_ARGV0}")/..)
+fi
+source "${ALLSKY_HOME}/variables.sh"
+ME="$(basename "${BASH_ARGV0}")"
+
+readonly USAGE="Usage: ${ME} [StartingUp TextColor Font FontSize StrokeColor StrokeWidth BgColor BorderColor Extensions ImageSize 'Message']"
+readonly ALL_EXTS="jpg png"		# all the image filename extensions we support
+
+function make_image() {
+	BASENAME="$1"
+	TEXTCOLOR="${2:-"white"}"
+	FONT="${3:-"Helvetica-Bold"}"
+	FONT_SIZE="${4:-128}"
+	INTERLINE_SPACING=$(echo "${FONT_SIZE} / 3" | bc)
+	STROKE_COLOR="${5:-"black"}"
+	STROKE_WIDTH="${6:-2}"
+	BGCOLOR="${7:-"#404040"}"
+	BORDER_WIDTH="${8:-0}"
+	BORDER_COLOR="${9:-"white"}"
+	EXTS="${10:-"${ALL_EXTS}"}"
+	# IM_SIZE is a hack to make these images more detectable. Typically camera images are
+	# at least an even number of pixels, and usually a multiple of 8 pixels.
+	# So just in case someone has a camera configured for 960x720 images, or
+	# is rescaling to 960x720... this will allow these notification images to be detected.
+	IM_SIZE="${11:-"959x719"}"
+	MSG="${12}"
+
+	echo "${BASENAME}" | grep -qEi "[.](${ALL_EXTS/ /|})"
+	if [ $? -ne 1 ] ; then
+		echo -e "${RED}ERROR: Do not add an extension to the basename${NC}."
+		echo "${USAGE}"
+		exit 1
+	fi
+
+	if [ ${BORDER_WIDTH} -ne 0 ]; then
+		BORDER="-border ${BORDER_WIDTH} -bordercolor ${BORDER_COLOR}"
+	else
+		BORDER=""
+	fi
+
+	echo "Creating '${BASENAME}'"
+	for EXT in ${EXTS} ; do
+		convert \
+			-fill "${TEXTCOLOR}" \
+			-font "${FONT}" \
+			-pointsize "${FONT_SIZE}" \
+			-interline-spacing "${INTERLINE_SPACING}" \
+			-stroke "${STROKE_COLOR}" \
+			-strokewidth "${STROKE_WIDTH}" \
+			-background "${BGCOLOR}" \
+			${BORDER} \
+			-gravity center \
+			-depth 8 \
+			-size "${IM_SIZE}" \
+			label:"${MSG}" \
+			"${BASENAME}.${EXT}"
+	done
+}
+
+which mogrify > /dev/null
+if [ $? -ne 0 ] ; then
+	# Testing for mogrify which seems like a much more distinctive executable
+	# name than "convert". I assume that if "mogrify" is in the path, then
+	# ImageMagick is installed and "convert" will run ImageMagick and not some
+	# other tool.
+	echo -e "${RED}ERROR: ImageMagick does not appear to be installed. Please install it.${NC}" >&2
+	exit 2
+fi
+
+# If the arguments were specified on the command line, use them instead of the list below.
+if [ $# -eq 12 ]; then
+	if [ "${1}" = "" -o "${12}" = "" ]; then
+		echo -e '${RED}ERROR: Basename ($1) and message ($12) must be specified.${NC}' >&2
+		echo "${USAGE}"
+		exit 1
+	fi
+	make_image "${@}"
+
+elif [ $# -eq 0 ]; then
+#            #1                   #2         #3                 #4     #5        #6      #7         #8      #9        #10         #11       #12
+#            Basename             Text       Font               Font   Stroke    Stroke  Background Border  Border    Extensions  Image     Message
+#                                 Color      Name               Size   Color     Width   Color      Width   Color                 Size
+#            ""                   "white"    "Helvetica-Bold"   128    "black"   2       "#404040"  0       "white"   ${ALL_EXTS} "959x719" ""
+#            +--------------------+----------+------------------+------+---------+-------+----------+-------+---------+-----------+---------+--------------------------------------
+  make_image NotRunning           ""         ""                 ""     ""        ""      ""         ""      ""        ""          ""        "AllSky\nsoftware\nis not running"
+  make_image DarkFrames           "green"    ""                 ""     "white"   ""      "black"    ""      ""        ""          ""        "Camera\nis taking\ndark frames"
+  make_image StartingUp           "green"    ""                 ""     ""        ""      ""         ""      ""        ""          ""        "AllSky\nsoftware\nis starting up"
+  make_image Restarting           "lime"     ""                 ""     ""        ""      ""         ""      ""        ""          ""        "AllSky\nsoftware\nis restarting"
+  make_image CameraOffDuringDay   "#ffff4a"  ""                 ""     ""        ""      ""         ""      ""        ""          ""        "Camera\nis off\nduring the day"
+  make_image Error                "red"      ""                 80     ""        ""      ""         10      "red"     ""          ""        "ERROR\n\nSee\n/var/log/allsky.log\nfor details"
+
+else
+	echo -e "${RED}ERROR: Either specify ALL arguments, or don't specify any.${NC}" >&2
+	echo "${USAGE}"
+	exit 1
+fi