qvplay and the Casio QV-10 Camera

Bob Hepple

Issue #47, March 1998

Linux software to control the Casio QV-10 camera is now available. Mr. Hepple tells us how to use qvplay.

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).

The Casio QV-10 Camera

Figure 1. Casio Camera

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

  • has fixed focal length lens (no zoom)

  • has fixed resolution of 320x240 pixels in 24-bit colour

  • stores up to 96 shots in Flash memory (immune from low battery power)

  • takes 4 AA alkaline cells or an optional, external power source, but not NiCad

  • has a serial link to a PC

  • has a separate printer available, driven directly by the camera

  • can also output to TV/video

  • has CAM default file format, proprietary to Casio

  • sells for about $400 in Singapore (about $263US), although I paid a lot more than that last Christmas—prices have dropped.

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 3000x2500 pixels—more than 100 times the number of pixels. On the other hand, while the resolution is so-so, the 320x240 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:

  1. Open CAM image on PC (10 seconds on my 486)

  2. Pull down File|Export menu or press ctrl-E

  3. Pull down Format|JPG

  4. Type in new file name (.jpg extension is provided automatically)

  5. Select OK

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

The qvplay Software

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:

  • Download individual or groups of pictures to or from the camera in JPEG, BMP, PPM, RGB or CAM formats.

  • Instruct the camera to take a picture.

  • Delete pictures from the camera's memory.

  • Instruct the camera to display a certain picture (or 4 or 9 thumbnail pictures).

  • Protect or UN-protect specific pictures from deletion.

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:

  • qvrec: send CAM files to the QV-10 camera.

  • qvalldel: clear the camera's memory.

The Software

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.

Cameras Supported by qvplay

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

  • QV-10 in its various flavours, e.g., QV-10a

  • QV-11

  • QV-30

  • QV-100 (including the fine resolution)

  • QV-300 (including the fine resolution)

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

Handy Scripts for qvplay

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:

  1. get_a_pic: A simple script to get one photo. (See Listing 1.)

  2. get_all_pics: Another way to get all the photos from the camera. (See Listing 2.)

Post-processing of JPEG Files

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 480x240 pixels and you must change them to an aspect ratio of 4:3 or 320x240 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

Using a WWW Browser to View Files

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>

A Graphical User Interface for qvplay

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.

Figure 2. Screen shot of qvplaytk

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.

Converting Casio CAM Files to JPEG or PPM

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/.

Figure 3. Singapore River

Figure 4. Lau Pau Sat Food Centre

Example Pictures

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.

Bob Hepple has been hacking at Unix since 1981 under a variety of excuses and has somehow been paid for it at least some of the time. It's allowed him to pursue another interest—living in warm, exotic places including Hong Kong, Australia, Qatar, Saudi Arabia, Lesotho and (presently) Singapore. His initial aversion to the cold was learned in the UK. His ambition is to stop working for the credit card company and tax man and to get a real job. Bob can be reached at bhepple@pacific.net.sg.