« Previous - Version 84/102 (diff) - Next » - Current version
Kwabena Agyeman, 03/11/2013 10:02 pm


CMUcam4 Graphical User Interface

Windows Setup

Follow the steps below to setup the CMUcam4GUI for Windows:

1. Download the CMUcam4GUI.zip file
2. Unzip it and extract the contents
3. Run the CMUcam4GUI.exe file

Linux Setup

Follow the steps below to setup the CMUcam4GUI for Linux:

1. Add your user name to the dialout group

sudo adduser username dialout

2. Now verify by typing

groups username

3. Now log out and then log back in
4. Download the CMUcam4GUI.zip file
5. Unzip it and extract the contents
6. Run the CMUcam4GUI.sh file

Macintosh Setup

Follow the steps below to setup the CMUcam4GUI for Macintosh:

1. Install the QtSDK for Mac here.
2. Download the CMUcam4GUI Source
3. Open the CMUcam4GUI.pro file using QtCreator and switch to release mode from debug mode
4. Run the CMUcam4GUI.app file

Question: Why don't you have a prebuilt MAC application?

Answer: Kwabena, the CMUcam4 developer, does not have a MAC...

Note: The Macintosh version runs at a maximum baud rate of 115,000 BPS versus the Windows and Linux versions that run at a maximum baud rate of 230,400 BPS. If you can, please use the Windows or Linux versions for faster functionality.

CMUcam4GUI Manual

The CMUcam4GUI is very intuitive and implements all the same functionality in the CMUcam4 Arduino Interface Library. This manual only exists to give an overview of the CMUcam4GUI and you should read the CMUcam4 Command List User Manual if you need more information about CMUcam4 commands. If you encounter errors trying to connect to the CMUcam4, unplug your USB to serial device from your computer and plug it back in again. Also, make sure your serial converter can handle 19200 BPS, 115200 BPS, and 230400 BPS. If you are using a FTDI chip based converter then you should be fine.

Menu Bar and Tool Bar commands

Tool Bar Commands

  • Begin/Reset - Connect to the CMUcam4
  • End - Disconnect from the CMUcam4
  • Sleep Lightly - Put the CMUcam4 into a very low power state
  • Sleep Deeply - Put the CMUcam4 into a ultra low power state
  • Send Frame - Take a color image and display it in the viewing window
  • Send Bitmap - Take a binary image and display it in the viewing window
    • This is an 80x60 binary image of whatever the CMUcam4 is tracking - the CMUcam4 must be tracking something for this to be useful
  • Dump Frame - Take a color image and save it to the SD card
  • Dump Bitmap - Take a binary image and save it to the SD card
    • This is an 80x60 binary image of whatever the CMUcam4 is tracking - the CMUcam4 must be tracking something for this to be useful

Menu Bar Commands

  • Save Frame - Save the color image in the viewing window to a file
  • Save Bitmap - Save the binary image in the viewing window to a file
    • This is an 80x60 binary image of whatever the CMUcam4 is tracking - the CMUcam4 must be tracking something for this to be useful
  • Clear Frame - Erase the color image in the viewing window
  • Clear Bitmap - Erase the binary image in the viewing window
    • This is an 80x60 binary image of whatever the CMUcam4 is tracking - the CMUcam4 must be tracking something for this to be useful
  • Open - Open a color image to use with the track selection feature
  • Exit - Exit the application

Viewing Tab

  • Send Frame Control - Select the horizontal and vertical resolution for the send frame button in the tool bar
    • You cannot move whatever you are taking a picture of while the send frame command is running
    • If the image quality looks bad then turn off auto-gain and auto-white balance and make sure the CMUcam4 is looking at an illuminated object
    • Use a smaller resolution to capture the image quicker - like 160x120
  • Dump Frame Control - Select the horizontal and vertical resolution for the dump frame button in the tool bar
    • You cannot move whatever you are taking a picture of while the dump frame command is running
    • If the image quality looks bad then turn off auto-gain and auto-white balance and make sure the CMUcam4 is looking at an illuminated object
    • Use a smaller resolution to capture the image quicker - like 160x120
  • Opacity Control - Select the sent frame and sent bitmap opacity - between 1.00 for 100% and 0.00 for 0%
  • Tracking Control - Select a color blob in the viewing window to track
    • The selection rectangle should only enclose the pixels within the color blob you want to track
    • After selecting the color blob click the track color button to compute the color bounds to track that color blob
      • The algorithm works by computing the mean and standard deviation of the red, green, and blue color channels inside of the selection rectangle
      • The Confidence Interval Level Coefficient selects how much of the standard deviation to add +/- to the means of the red, green, and blue color channels - between 0 for +/- (stdev * 1) to 99 for +/- (stdev * 10)

Tracking Tab

Options Tab

Disk Tab

CMUcam4GUI Source

Click here to download the source code for the CMUcam4GUI.

You will need the Qt 1.2.1 SDK (Desktop 4.8.1) to compile the code which you can download here.

CMUcam4GUI.zip - Tentative Final Source Code (1.7 MB) Kwabena Agyeman, 02/21/2013 10:13 pm

viewing_tab.png (88.2 kB) Kwabena Agyeman, 03/11/2013 08:54 pm

tracking_tab.png (39 kB) Kwabena Agyeman, 03/11/2013 08:54 pm

options_tab.png (73 kB) Kwabena Agyeman, 03/11/2013 08:54 pm

disk_tab.png (69.8 kB) Kwabena Agyeman, 03/11/2013 08:54 pm

viewing_tab_resize.png (78.3 kB) Kwabena Agyeman, 03/11/2013 11:35 pm

tracking_tab_resize.png (19.1 kB) Kwabena Agyeman, 03/11/2013 11:35 pm

options_tab_resize.png (30.8 kB) Kwabena Agyeman, 03/11/2013 11:35 pm

disk_tab_resize.png (25.4 kB) Kwabena Agyeman, 03/11/2013 11:35 pm