Magic Lantern Firmware Wiki
Register
No edit summary
No edit summary
 
(9 intermediate revisions by 5 users not shown)
Line 13: Line 13:
 
=Installing the SVN version of gphoto2=
 
=Installing the SVN version of gphoto2=
 
On Ubuntu Karmic, I had to follow these steps:
 
On Ubuntu Karmic, I had to follow these steps:
svn co https://gphoto.svn.sourceforge.net/svnroot/gphoto/trunk gphoto
+
svn co [[PTP|https://gphoto.svn.sourceforge.net/svnroot/gphoto/trunk]] gphoto
 
 
The README files from (lib)gphoto say that the default prefix for installation is /usr/local. Doing so resulted in conflicts with the stable version from Ubuntu package manager. So I've changed the prefix to /usr:
 
The README files from (lib)gphoto say that the default prefix for installation is /usr/local. Doing so resulted in conflicts with the stable version from Ubuntu package manager. So I've changed the prefix to /usr:
   
Line 35: Line 34:
 
''libgphoto2 2.4.99.7 INCOMPLETE CAMLIB SET (canon ptp2), gcc, ltdl, EXIF''
 
''libgphoto2 2.4.99.7 INCOMPLETE CAMLIB SET (canon ptp2), gcc, ltdl, EXIF''
 
''libgphoto2_port 0.10.0 gcc, ltdl, USB, serial without locking''
 
''libgphoto2_port 0.10.0 gcc, ltdl, USB, serial without locking''
  +
  +
<p style="border-bottom-width:0px;border-left-width:0px;font-style:inherit;font-weight:inherit;margin-top:0.4em;margin-right:0px;margin-bottom:0.5em;margin-left:0px;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;vertical-align:baseline;">On Osx Lion, Homebrew can install it:</p>
  +
brew install gphoto2
  +
   
 
=Quick Start=
 
=Quick Start=
   
 
After you have installed the latest libgphoto2, get piggyphoto from github:
 
After you have installed the latest libgphoto2, get piggyphoto from github:
git clone git://github.com/alexdu/piggyphoto.git
+
git clone [[PTP|git://github.com/alexdu/piggyphoto.git]]
 
cd piggyphoto
 
cd piggyphoto
   
Line 153: Line 156:
 
Trap focus functionality was requested by Magic Lantern users:
 
Trap focus functionality was requested by Magic Lantern users:
   
http://bitbucket.org/hudson/magic-lantern/issue/160/trap-focus-functionality
+
[[PTP|http://bitbucket.org/hudson/magic-lantern/issue/160/trap-focus-functionality]]
   
 
: ''"Trap Focus" is great functionality found in Nikons ''[and Pentax]'' is missing in entire Canon lineup. When enabled it delays firing shutter until central point becomes in focus. From the user perspective when MF (together with "Trap Focus") is enabled user presses (and holds) shutter button. Nothing happens until central point becomes in focus. When it happens - camera takes picture. It's great in any situation with manual lens, but especially suited for sports and macro photography.''
 
: ''"Trap Focus" is great functionality found in Nikons ''[and Pentax]'' is missing in entire Canon lineup. When enabled it delays firing shutter until central point becomes in focus. From the user perspective when MF (together with "Trap Focus") is enabled user presses (and holds) shutter button. Nothing happens until central point becomes in focus. When it happens - camera takes picture. It's great in any situation with manual lens, but especially suited for sports and macro photography.''
Line 211: Line 214:
 
*allow uploading files to camera's card
 
*allow uploading files to camera's card
 
*send ARM code to be executed, poke/peek memory locations, read/set properties...
 
*send ARM code to be executed, poke/peek memory locations, read/set properties...
  +
*'''review memory leak when running Live Preview''' [?! what memory leak? ] Canon 7D, live preview for a few minutes and my system (ubuntu 12.04 & python 2.7) ran out of memory :S please help!!
  +
**This is due to the camera file object (cfile) never being removed from memory. The object has a function to fix this error, it just needs to be called after the file is saved.
 
*<put your wishlist here>
 
*<put your wishlist here>
   
Line 217: Line 222:
 
I've been able to compile libptp/ptpcam (the one with CHDK support, from [http://www.mweerden.net/chdk_ptp.html]) as a DLL under windows, and call some functions from Python via ctypes. Experimental code is here:
 
I've been able to compile libptp/ptpcam (the one with CHDK support, from [http://www.mweerden.net/chdk_ptp.html]) as a DLL under windows, and call some functions from Python via ctypes. Experimental code is here:
   
https://github.com/alexdu/piggyPTP
+
[[PTP|https://github.com/alexdu/piggyPTP]]
   
 
However, I don't know how to compile ptpcam as a shared library (.so) under Linux. Does anyone know?
 
However, I don't know how to compile ptpcam as a shared library (.so) under Linux. Does anyone know?

Latest revision as of 19:36, 22 January 2014

Good news for Python lovers! You can control your DSLR camera with Python scripts via the USB cable, PTP protocol.

I've written a Python binding for gphoto2, called piggyphoto, available here:

http://github.com/alexdu/piggyphoto

The binding is based on ctypes, which means (only in theory) that you don't have to compile anything in order to use it. In practice, the stable version is almost useless, so you have to compile the latest SVN snapshot of gphoto2.

This is a test bed for various enhancements which can be implemented in Magic Lantern.

Related page: PTP

Installing the SVN version of gphoto2[]

On Ubuntu Karmic, I had to follow these steps:

svn co https://gphoto.svn.sourceforge.net/svnroot/gphoto/trunk gphoto

The README files from (lib)gphoto say that the default prefix for installation is /usr/local. Doing so resulted in conflicts with the stable version from Ubuntu package manager. So I've changed the prefix to /usr:

cd gphoto/trunk
cd libgphoto2
autoreconf --install --symlink
./configure --with-prefix=/usr --with-camlibs=canon
make
sudo make install

cd ../gphoto2
autoreconf -is
./configure --with-libgphoto2=/usr
make
sudo make install
gphoto2 -v
... 
gphoto2         2.4.99.2       gcc, popt(m), exif, no cdk, aa, jpeg, readline
libgphoto2      2.4.99.7       INCOMPLETE CAMLIB SET (canon ptp2), gcc, ltdl, EXIF
libgphoto2_port 0.10.0         gcc, ltdl, USB, serial without locking

On Osx Lion, Homebrew can install it:

brew install gphoto2


Quick Start[]

After you have installed the latest libgphoto2, get piggyphoto from github:

git clone git://github.com/alexdu/piggyphoto.git
cd piggyphoto

Now run the test scripts from the piggyphoto main directory. Let's try a few of them:

Autodetect the camera[]

python autodetect.py

libgphoto2 version:
2.4.99.7
INCOMPLETE CAMLIB SET (canon ptp2)
gcc (C compiler used)
ltdl (for portable loading of camlibs)v
EXIF (for special handling of EXIF files)

detected cameras:
[('Canon EOS 550D', 'usb:002,039')]

Take a picture[]

python snap.py

Model : Canon EOS 550D
Status : 0
Port : 4
Operations : 25
File Operations : 10
Folder Operations : 14
USB (vendor/product) : 0x4a9/0x31ea
USB class : 0x0/0x0/0x0
Library : /usr/lib/libgphoto2/2.4.99.7/ptp2
Id : PTP

Saving preview.jpg
Saving snap.jpg

Live Preview[]

Piggyphoto-preview

Live preview from 550D with piggyphoto

For this one you need Pygame:

sudo easy_install pygame
python preview.py

Now, your DSLR is behaving like a webcam :)

Look at camera settings[]

Changing settings does not seem to work well, so for now we'll just reading the settings:

python list-config.py 

Model : Canon EOS 550D
Status : 0
Port : 4
Operations : 25
File Operations : 10
Folder Operations : 14
USB (vendor/product) : 0x4a9/0x31ea
USB class : 0x0/0x0/0x0
Library : /usr/lib/libgphoto2/2.4.99.7/ptp2
Id : PTP

main.actions.focuslock = 2
main.actions.bulb = 2
main.actions.uilock = 2
main.actions.syncdatetime = None
main.actions.autofocusdrive = None
main.actions.manualfocusdrive = None
main.actions.eoszoom = 0
main.actions.eoszoomposition = 0,0
main.settings.datetime = 1286126968
main.settings.reviewtime = Hold
main.settings.output = Unknown value 0000
main.settings.evfmode = 1
main.settings.ownername = 
main.settings.artist = 
main.settings.copyright = 
main.settings.capturetarget = Internal RAM
main.settings.capture = 2
main.status.model = 21########
main.status.ptpversion = 256
main.status.batterylevel = 100%
main.status.lensname = EF50mm f/1.8 II
main.status.serialnumber = 83#######
main.status.shuttercounter = 12648    # after less than a month! wtf?!
main.status.availableshots = 42450
main.imgsettings.imageformat = Large Fine JPEG
main.imgsettings.imageformatsd = Large Fine JPEG
main.imgsettings.iso = 1600
main.imgsettings.whitebalance = Cloudy
main.imgsettings.whitebalanceadjusta = 0
main.imgsettings.whitebalanceadjustb = 0
main.imgsettings.whitebalancexa = 0
main.imgsettings.whitebalancexb = 0
main.capturesettings.exposurecompensation = 1.0
main.capturesettings.autoexposuremode = AV
main.capturesettings.drivemode = Continuous
main.capturesettings.picturestyle = User defined 3
main.capturesettings.aperture = 1.8
main.capturesettings.meteringmode = Evaluative
main.capturesettings.bracketmode = 0
main.capturesettings.aeb = off
main.other.d402 = Canon EOS 550D
main.other.d407 = 1
main.other.d406 = Unknown Initiator
main.other.d303 = 1
main.other.5001 = 100

Trap Focus[]

Trap focus functionality was requested by Magic Lantern users:

http://bitbucket.org/hudson/magic-lantern/issue/160/trap-focus-functionality

"Trap Focus" is great functionality found in Nikons [and Pentax] is missing in entire Canon lineup. When enabled it delays firing shutter until central point becomes in focus. From the user perspective when MF (together with "Trap Focus") is enabled user presses (and holds) shutter button. Nothing happens until central point becomes in focus. When it happens - camera takes picture. It's great in any situation with manual lens, but especially suited for sports and macro photography.

Here is an experiment for implementing trap focus in tethered shooting mode, with piggyphoto. It's not really useful in the current state, but if you like it, it may be implemented into Magic Lantern. It's really useful for macro shots and old manual lenses.

How to try it[]

Connect the camera via USB and run the script focus-snap.py:

python focus-snap.py

It will display a live preview. If you want to change settings, close the window, press the Live View button on the camera (while it's still connected to USB) and you can change shooting settings. Put a short exposure time, like 1/250, 1/500, to avoid motion blur. Then run the script again.


Look at the title bar of the preview window. It should display "Looking for focus peak". Now point the camera at some object and rotate the focus ring. The object will be focused; turn the ring a bit farther, and the object will become blurred. The title bar will say "Focus peak found". Now turn the focus ring back sloooooooowly and camera will take a picture when the object will come back into focus.

How it works[]

My implementation estimates the amount of focus on the live preview image, and takes a picture when it detects a peak (well, almost).

Estimating focus for an image[]

The 550D outputs live preview frames which are 1056 x 704 pixels. The focus is computed from the central area of the image, having 100x100 pixels.

The function for evaluating the focus is implemented in focus.py:

def estimate(file, s=5):
    """Estimates the amount of focus of an image file.
    Returns a real number: higher values indicate better focus.
    Bug: a high-contrast, blurry image can be considered with better focus
    than a low-contrast, perfectly focused image.
    """
    im = Image.open(file).convert("L")
    w,h = im.size
    box = (w/2 - 50, h/2 - 50, w/2 + 50, h/2 + 50)
    im = im.crop(box)
    imf = im.filter(ImageFilter.MedianFilter(s))
    d = ImageChops.subtract(im, imf, 1, 100)
    return ImageStat.Stat(d).stddev[0]

The main idea is that if you blur a focused image, you will lose lots of details. But if you blur a blurred image, it won't change much. So, a measure for how much the image is in focus will be the difference between the original and slightly blurred image.

Problems:

  • The focus measure is not absolute. Ideally, it should return a number between 0 and 1, with 0 = extremely blurry and 1 = perfectly focused. But not all lenses are able to give perfect focus, and the sampling rate is finite, so the algorithm may miss the sweet spot.
  • The focus measure is dependent on the scene analyzed. A high-contrast, blurry image will be evaluated as being better than a low-contrast, perfect-focus image. This function just returns a number which, for the same scene, is greater when the image is focused.

Another solution, which seems better, is to use morphological opening or closing. I'll experiment with it.


Improvements to the focus estimation function (estimate in focus.py) are welcome.

Detecting focus peak[]

As a workaround for the focus measure not being absolute, I've implemented a slightly less easy-to-use procedure: you have to bring the object into focus, then defocus it, and then bring the object into focus again. This allows the algorithm to detect the peak value for the current scene, and snaps when the focus value is greater than 98% of the peak. If you turn the focus ring slowly enough, this seems to work (well... almost).

Limitations and known bugs[]

  • If you turn the ring too fast, the image will be out of focus (because the picture is took too late). This is mainly due the communication delay between camera and PC, and slow implementation of focus evaluation function. It shouldn't be a problem if the method is implemented on the camera.
  • If you change the scene, the camera may snap randomly, even if nothing is in focus.
  • You have to bring the object into focus and continue turning the ring until the image blurs, and then turn the ring back.

TODO[]

  • document the API
  • wrap missing functions from gphoto2 (only a few are implemented right now)
  • add support for Magic Lantern's PTP functions (by wrapping libptp with mweerden's patches?)
  • allow uploading files to camera's card
  • send ARM code to be executed, poke/peek memory locations, read/set properties...
  • review memory leak when running Live Preview [?! what memory leak? ] Canon 7D, live preview for a few minutes and my system (ubuntu 12.04 & python 2.7) ran out of memory :S please help!!
    • This is due to the camera file object (cfile) never being removed from memory. The object has a function to fix this error, it just needs to be called after the file is saved.
  • <put your wishlist here>

libptp/win32 support[]

I've been able to compile libptp/ptpcam (the one with CHDK support, from [1]) as a DLL under windows, and call some functions from Python via ctypes. Experimental code is here:

https://github.com/alexdu/piggyPTP

However, I don't know how to compile ptpcam as a shared library (.so) under Linux. Does anyone know?