|Version 14 (modified by fma, 5 years ago) (diff)|
papywizard User Guide
- Usage overview
- Advanced usage
- Reference manual
- Tips and tricks
- Keyboard shortcuts
This documentation try to follow the developpement version of papywizard. It may or may not be up-to-date ;o)
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)
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
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:
You also need the python repository:
|Distribution||bora (770/N800) or chinook (N810)|
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.
No external configuration is needed; all parameters can be modified from papywizard configuration menu.
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. Basic settings are the delay to wait after moving (to let the head stop shaking), the delay to wait while shooting (camera Tv value), and the number of pictures to take at each position (bracketing). See below for specific mode settings.
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. Alternatively, you can get a list of all available bluetooth devices arround, and select the correct one.
Then, just move the head either using the big GUI arrows, or using the shortcuts (see below), and set the start/end positions.
Once it is done, just open the shooting dialog and launch the entire process. That's it!
Papywizard has now 2 modes: Mosaic mode, and Preset mode. The first one is mainly used for partial panos, and is especially designed for hi-res panos, using a large tele-lens. The second one is designed for full-spherical panos, using a wide-lens or a fisheye.
The mosaic mode computations are based on the following parameters:
- minimum overlap
- camera orientation
- sensor coef. and ratio
- focal lens
So, these settings must exactly reflect your configuration.
It also needs the start/end positions, which are two opposite corners of the pano you want to shoot. It does not matter which corner you use for start or end, but it will influence the direction the pano will be shot. Note that, depending of the settings, papywizard can start shooting from the start position, or from the end position. This is usefull to avoid the head to go back to the opposite corner before shooting (which takes time and uses batteries).
It is also possible to choose the initial shooting direction. Using 'yaw will shoot row by row; using pitch will shoot column by column. Same, the head can go back to the begining of the row (column) before shooting the next one. See Tips and tricks for advices.
This mode is very simple, and does not use any particular settings; it just shoots at all positions defined in the selected template. The only thing to do is to set the home position of the head (zero), which will be the reference for the template positions.
- File > Quit: exit from papywizard
- Hardware > Connect: connect to the head hardware
- Hardware > Reset: reset the head hardware
- Help > About: show the about dialog
- 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
- Position: current position of the head
- Mosaic/Preset?: switch between mosaic and preset mode
- Yaw/pitch/both: set the start (end) shooting positions from current position
- Template: template defining all positions
- Left/right Yaw arrows: move head on yaw axis
- Left/right pitch arrows: move head on pitch axis
- Set origin: set the current position as origin (yaw=0.0°, pitch = 0.0°)
- Configuration: open the config. dialog
- Shoot...: open the shooting dialog
- Stab. delay: delay to wait before shooting to let the head stablizing
- Overlap: minimum wanted overlap¹
- Orientation: camera orientation on the head¹
- Start from: start position¹
- Initial direction: initial moving direction¹
- CR: if set, go back to the start of the row/columns before starting a new one¹
¹: only used in mosaic mode.
- 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
- Focal: real focal / flag for fisheye lens
- Driver: hardware driver to use
- BT device address: bluetooth device address for 'bluetooth' driver
- Choose...: list all available bluetooth devices arround, and allow to select one
- Serial port: serial device port for 'serial' driver
- Logger level: level of informations to log
- Set Start: like Set from current for start position in main window
- Set End: like Set from current for end position in main window
- Position: curent position
- Mosaic: current mosaic position
- Sequence: current shooting sequence (moving/stabilizing/shooting/idle)
- Progression: overall progress bar
- 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
Tips and tricks
shooting direction (cloudy sky)
bubble level for home pos.
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:
|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:
|Escape||Stop shooting - Return to main window|
- In all dialogs:
|-||Standard maemo behaviour|
|F6||Toggle fullscreen mode|
- Down.png (4.3 KB) - added by fma 4 years ago.
- Escape.png (695 bytes) - added by fma 4 years ago.
- F4-menu.png (646 bytes) - added by fma 4 years ago.
- F5-home.png (536 bytes) - added by fma 4 years ago.
- F6-fullscreen.png (719 bytes) - added by fma 4 years ago.
- Left.png (4.3 KB) - added by fma 4 years ago.
- Return.png (4.2 KB) - added by fma 4 years ago.
- Right.png (4.3 KB) - added by fma 4 years ago.
- Up.png (4.3 KB) - added by fma 4 years ago.
- F7-increase.png (2.1 KB) - added by fma 4 years ago.
- F8-decrease.png (2.0 KB) - added by fma 4 years ago.