papywizard User Guide

• Installation
  • Linux
  • Nokia
• Configuration
• Usage overview
• Reference manual
  • Main window
  • Configuration dialog
  • Manual move dialog
  • Shoot dialog
• Keyboard shortcuts

This documentation refers to the release 0.9.1

Installation

papywizard is entirely written in python, and uses some third-party modules:

• ​PyGTK -- GTK+ for Python
• ​pySerial -- serial bus access for python
• ​pybluez -- bluetooth python wrapper
• ​Visual Python -- 3D Python project (optional)

Linux

As most distributions come with python and all needed modules (just install them through your application manager), there is no need to pre-build a package. Just install it with distutils tools:

$ python setup.py install --prefix=/usr/local

Nokia

As Nokia is based on Linux, it is possible to install papywizard through distutils tools (see previous section). However, it is easier to install the debian package, through the maemo application manager. Add this repository entry in the application manager:

Name	gbiloba.org
Address	http://www.gbiloba.org/debs
Distribution	bora
Component	free

You also need the python repository:

Name	Maemo extra
Address	http://repository.maemo.org/extras
Distribution	bora (770/N800) or chinook (N810)
Component	free non-free

Note 1: on the 770, you need to install OS-2007 HE firmeware, in order to run python2.5. Then, you have to manually install python2.5-runtime package with dpkg (from x-term) before installing papywizard.

Note 2: on N800 and N810, you first need to install maemo-python-device-env package, from the application manager, before installing papywizard.

Configuration

No external configuration is needed; all parameters can be modified from papywizard config. menu.

Usage overview

papywizard is very easy to use, and I hope the GUI is intuitive enough.

The first thing to do is to edit the configuration, to reflect you camera/lens/head/hardware config.

Second, you need to connect to the hardware (Menu Hardware > Connect). If you use the bluetooth driver (default config), you need to enter the correct address of your adapter in the config menu (see above).

Then, just move the head either by opening the Manual move dialog, or using the shortcuts (see below), and set the start/end positions. As an alternative, you can automatically set the yaw to 360° and/or the pitch to 180°.

Once it is done, just open the shooting dialog and launch the entire process. That's it!

Reference manual

Main window

Menus

• File > Quit: exit from papywizard
  
• Hardware > Connect: connect to the head hardware
  
• Hardware > Set origin: set the current position as origin (yaw=0.0°, pitch = 0.0°)
  
• Hardware > Reset: reset the head hardware
  
• Help > About: show the about dialog
  

labels

• Position: current position of the head
  
• Start: start shooting position
  
• End: end shooting position
  
• Total Fov: total shooting field of view
  
• Nb picts: shooting number of pictures
  
• Real overlap: real shooting overlap
  

buttons

• Set from current: set the start (end) shotting position from current position
  
• Set to 360° (180°): automatically set start/end position to shoot 360° (180°)
  
• Configuration: open the config. dialog
  
• Manual move...: open the manual move dialog
  
• Shoot...: open the shooting dialog
  

Configuration dialog

Shooting tab

• Stab. delay: delay to wait before shooting to let the head stablizing
  
• Overlap: minimum wanted overlap
  
• Orientation: camera orientation on the head

Camera tab

• Tv: delay to wait for shooting (Tv camera value)
  
• Nb picts: number of pictures to take at each position (bracketing)
  
• Sensor ratio: ratios to 24x36 sensor size and width/height

Lens tab

• Focal: real focal / flag for fisheye lens

Hardware tab

• Driver: hardware driver to use
  
• BT device address: bluetooth device address for 'bluetooth' driver
  
• Serial port: serial device port for 'serial' driver

Misc tab

• Logger level: level of informations to log

Manual move dialog

buttons

• Set Start: like Set from current for start position in main window
  
• Set End: like Set from current for end position in main window
  
• Yaw + / -: move head on yaw axis
  
• Pitch + / -: move head on pitch axis
  
• Set origin: like menu Hardware > Set origin in main window
  

Shoot dialog

labels

• Position: curent position
  
• Mosaic: current mosaic position
  
• Sequence: current shooting sequence (moving/stabilizing/shooting/idle)
  
• Progression: overall progress bar

buttons

• Manual shooting: if checked, automatically go to suspend mode at the end of each move
  
• Data file enable: if checkd, write a xml data file for APP
  
• Start: start shooting process
  
• Suspend: suspend shooting process
  
• Stop: stop shooting process

Keyboard shortcuts

papywizard main target is Nokia Internet Tablets, so keyboard shortcuts are dedicated for that plateform (but works fine with normal PC). Here are defined shortcuts:

• In main window:

Nokia	PC	Function
	Right	Turn the head right (Yaw +)
	Left	Turn the head left (Yaw -)
	Up	Move the head up (Pitch +)
	Down	Move the head down (Pitch -)
	Home	Set current position as start position
	End	Set current position as end position
	Return	Open shooting dialog

• In shooting dialog:

Nokia	PC	Function
	Return	Start/pause shooting
	Escape	Stop shooting - Return to main window

• In all dialogs:

Nokia	PC	Function
	F10	Show menu
	-	Standard maemo behaviour
	F6	Toggle fullscreen mode