BackupGGCode / pyueye

uEye camera driver wrapper for python
BSD 3-Clause "New" or "Revised" License
4 stars 2 forks source link

Pyueye

pyueye is a wrapper for the uEye camera drivers written in Cython, currently under development. This wrapper allows to use the IDS uEye cameras under python, capturing the images directly as a Numpy array, where they can be used in image processing libraries such as OpenCV.

This wrapper is not a product from IDS nor is it in any way affiliated with or approved by them.

This project is developed by the technological development groups of CIHologramas and Pratt & Miller.

This software is in an alpha state, and not ready for production use. Use it at your own risk.

News

October 18, 2013 - ReadEEPROM and WriteEEPROM now implemented. New version available in SVN Trunk and the Downloads section.
- Chris

August 14, 2013 - Now compatible with uEye driver version 4.20. This driver can be found in the Downloads section.
Note: The 4.20 driver seems slightly less stable than 4.02; occasionally the GigE daemon crashes. Pyueye will continue to work with both versions.

- Chris

July 2 2013 - New version available in Trunk. Updates include functional free-running video mode, waitEvent, and captureStatus. Also added RGB/BGR flag to GrabImage. Should be backwards compatible with all code, but please let us know if you find bugs.

- Chris

Jan 29 2013 - The version in trunk should work with the UEYE drivers for linux version 4.02. This driver can be found in the Downloads section

Jul 12 2012 - pyueye now works with ueye driver version 3.90


Installation

To compile this wrapper, you need to have installed Cython > 0.12,
Numpy and the ueye drivers.

Under Linux

To install the wrapper under linux (tested in recent Ubuntu distros) do:

sudo python setup.py install

Under Windows

The wrapper should install under windows, but we haven't done it yet.
If any one has successfully installed it under Windows, please let us know.

Usage

This wrapper has been tested with UI-1545LE-M and UI-1645LE-C ueye USB
cameras under Linux (Ubuntu 10.04), and the UI-5240CP-C GigE camera under Linux (Mint 13), but should work with any uEye camera
if the driver is correctly installed. Almost all the configuration
methods work as their C counterpart. A documentation of each method can
be found in its python docstring.

The following is a short example to capture an image and show it as
a pylab image from a ipython console (ipython -pylab).

   import ueye

a=ueye.Cam() # Get the first available cam
b=a.GrabImage() # Grab an image
imshow(b)

Comments, Bugs, Suggestions

ramezquitao@cihologramas.com