qvplay and the Casio QV-10 Camera

In the continuing battle with the Evil Empire, I have recently reduced my dependence on “Them” by one program—I discovered a way to use my Casio QV-10 digital camera with Linux.

This article is a simple HOWTO on the method I used—hopefully to encourage more people and Casio to use Linux.

One of these days, every peripheral will ship with Linux drivers and support software—until then, let’s “share and enjoy!” (Douglas Adams, Hitchhiker’s Guide to the Galaxy).

Describing the camera in full is probably best left to Casio but suffice it to say that it:

The resolution of the pictures is adequate for simple web pages but nowhere near as fine grained as some of the models recently on the market. By comparison, a Kodak PhotoCD image digitised from a 35mm slide or film would be about 3000×2500 pixels—more than 100 times the number of pixels. On the other hand, while the resolution is so-so, the 320×240 jpeg files that are produced are reasonably fast to download with current modems.

It is quite possible that Casio’s proprietary CAM format is superior to others for certain purposes (I am no graphics expert), but it is no good for web pages, which need JPEG or GIF files. The Windows software that Casio provides makes converting more than one or two files to JPEG format very difficult. No filter is provided for batch conversion of files to other formats. The process for each conversion is:

On one file this is manageable, but on 96—forget it.

qvplay was written by ken-ichi HAYASHI and Jun-ichiro “itojun” ITOH to control the QV-10 and is really great. Itojun also wrote a filter called cam2jpeg to convert CAM files to JPEG. (I haven’t tested this program yet.) With qvplay running on Linux you can:

It seemed to me that the quality of the pictures from qvplay was better than from the QV-LINK software provided with the camera—apparently, some older versions of QV-LINK do some automatic re-touching of the pictures which seems to make things worse. Also included in the package were two utilities:

I used version 0.92 of qvplay. Just use your favorite search engine to find qvplay-0_92_tar.gz and download from the site nearest you.

Configuration couldn’t be easier. Expand the distribution file and follow the instructions. A setup script is provided that worked just fine “out of the box”. I use Red Hat Linux 4.1 with a 2.0.18 kernel. One thing you might want to tinker with is the default serial port for qvplay to use. I changed the supplied default of /dev/cua1 to /dev/cua0. Once it’s working, use strip on the executables to remove extraneous lines such as debug commands and run the command make install.

I have written man pages for the qvplay, qvrec and qvalldel software (not in the original distribution). These pages are available at http://home.pacific.net.sg/~bhepple/qvplay/qvplay.html.

According to the source code, qvplay appears to support the following cameras:

The only camera I have tested is the QV-10.

Listing 1

#!/bin/sh
# wrapper for qvplay to get a specific picture -10
# from a QV assumes that qvplay is configured
# correctly and that 'mid' spped is OK
#
SPEED=mid
PORT=/dev/cua0"
VERBOSE=-v
FORMAT=jpeg
WIDTH=320
HEIGHT=240
prog=`basename $0`
usage() {
	echo "Usage: $prog num" >&2
	echo "Reads num'th picture from the Casio\
	QV-10 digital camera to stdout" >&2
	exit 1;
}
#
#Check at least one parameter
if [ "X$1" = "X" ]
then
	usage
fi
qvplay -S $SPEED -D $PORT -F $FORMAT $VERBOSE -g\
$1 | djpeg | pnmscale -xsize $WIDTH -ysize\
$HEIGHT | cjpeg
qvplay -r

Listing 2

#!/bin/sh
# wrapper for get_a_pic to get all pictures from
# Casio QV-10
#
prog=`basename $0`
usage() {
	echo "Usage: $prog basename [start [end]]"\
		>&2
	echo "Reads all pictures from the Casio \
QV-10 digital camera" >&2
	echo "If given, start (>=1) and end (<=96)\
limit the grab" >&2
	exit 1;
}
#
#Check at least one parameter
if [ "X$1" = "X" ]
then
	usage
fi
BASENAME=$1
START=1
if [ "X$2" != "X" ]
then
	START=$2
fi
END=96
if [ "X$3" != "X" ]
then
	END=$3
fi
trap "qvplay -r" 0
trap "qvplay -r" 2
trap "qvplay -r" 9
MAX=`qvplay -n`
set - $MAX
MAX=$3
if [ $END -gt $MAX ]
then
	END=$MAX
fi
if [ $START -lt 1 -o $END -gt 96 -o $START -gt
$END ]
then
	usage
fi
echo "Total pictures = $MAX"
NUM=$START
while [ $NUM -le $END ]
do
	# echo -ne "Getting picture $NUM...\r"

	if [ $NUM -lt 10 ]
	then
		POSTFIX=-$NUM
	else
		POSTFIX=$NUM
	fi
	get_a_pic $NUM >$BASENAME$POSTFIX.jpg
	NUM=`expr $NUM + 1`
done
echo

Once I got the hang of qvplay, I wrapped it up in a couple of simple scripts to do the things I normally do without reading the manual pages. These two scripts are:

One weird thing that you have to do is fix the size of the JPEG images (see the get_a_pic script). I must confess I don’t fully understand what’s going on here but apparently the images come across as 480×240 pixels and you must change them to an aspect ratio of 4:3 or 320×240 pixels. You can do this with the xv program or using the Independent JPEG Group’s commands, djpeg and cjpeg, along with the Poskanzer portable bitmap utilities. These utilities are normally found in the various Linux distributions. For example:

qvplay -g 1 | djpeg | pnmscale -xsize 320\
        -ysize 240 | cjpeg > foobar.jpg

You can view your JPEG files quite nicely with xv(1) or with a WWW browser such as Netscape. In the latter case, you might want to generate HTML index files for your shots using something like the following automatic procedure.

Assuming your JPEG files are sitting in a directory—e.g., I keep all the files from one day’s shooting together under a directory labelled with the date, something like ~/photos/971128/*.jpg—I then run the following script on them to create an index page viewable by the browser. This could be put into a Makefile:

(cat hdr
ls $i*.jpg |sed "s/^/<IMG SRC=\"/" |sed
"s/$/\">/"
cat tlr) > index.html

The file hdr simply contains a standard HTML startup:

<HTML>
<HEAD>
  <TITLE>Photo viewer</TITLE>
  <META NAME="Author" CONTENT="Bob Hepple">
</HEAD>
<BODY>
<H1>Photo viewer</H1><HR>

Similarly, the file tlr contains your standard HTML wrap-up script:

<P>
<HR>
<ADDRESS>
<A HREF="mailto:bhepple@pacific.net.sg">Bob
Hepple</A> <P> Copyright © 1997 Bob
 Hepple. All rights reserved.
</ADDRESS>
</BODY>
</HTML>

qvplaytk is a Tcl/Tk wrapper for qvplay which provides a GUI interface. Figure 2 is a screen shot of the program which can be found at its author’s (Mr. Amano) home page at http://www.bekkoame.or.jp/~tormato/qvplayk.htm.

As a Tcl/Tk script, qvplaytk is very easy to configure and adapt. For example, you might like to change the obscure “G”, “S” and “T” buttons to “Get”, “Save” and “Take”.

One very nice feature of qvplaytk is that the “Take” mode allows you to take a photo every N seconds—this could be used in a remote monitoring application. Perhaps it could be used for one of those strange web sites which offer a changing view of the level of the coffee in the kitchen, or for keeping an eye on your kids in the next room.

Apart from qvplay, qvplaytk requires Tcl 7.4 and Tk 4.0 or Tcl 7.5 and Tk 4.1. It also relies on xv for the viewing functions.

Itojun wrote cam2jpeg (sometimes written as camtojpeg) as a filter to batch convert CAM files to JPEG or PPM formats. It works with a whole range of Casio products that output the CAM format such as the QV-10, 10A, 30 and 100. It can also be found through ken-ichi HAYASHI’s home page at http://www.asahi-net.or.jp/~xg2k-hys/.

The camera works well in full daylight, as shown in Figure 3, a shot of the Singapore River from the famous “Boat Quay”. It also works well in very low light conditions, as shown in Figure 4, a shot of one of our wonderful food centres, “Lau Pau Sat”, in the business district.