Skip to content

khangdpham/pyuvc

 
 

Repository files navigation

pyuvc

Python bindings for libuvc with super fast jpeg decompression using libjpegturbo (utilizing the tubojpeg api).

  • cross platform access to UVC capture devices.
  • Full access to all uvc settings (Zoom,Focus,Brightness,etc.)
  • Full access to all stream and format parameters (rates,sizes,etc.)
  • Enumerate all capture devices with device_list()
  • Capture instance will always grab mjpeg conpressed frames from cameras.

Image data is returned as Frame object. This object will decompress and convert on the fly when image data is requested. This gives the user the full flexiblity: Grab just the jpeg buffers or have them converted to YUV or Gray or RGB and only when you need.

The Frame class has caching build in to avoid double decompression or conversion.

Example

import uvc
import logging
logging.basicConfig(level=logging.INFO)

dev_list =  uvc.device_list()
print dev_list
cap = uvc.Capture(dev_list[0]['uid'])
print cap.avaible_modes
cap.print_info()
for x in range(10):
	print x
	cap.frame_mode = (640,480,30)
	for x in range(100):
		frame = cap.get_frame_robust()
		print frame.img.shape
		#cv2.imshow("img",frame.gray)
		#cv2.waitKey(1)
cap = None

#Dependencies Linux

###libuvc

git clone https://github.com/pupil-labs/libuvc
cd libuvc
mkdir build
cd build
cmake ..
make && sudo make install

libjpeg-turbo

Needs to be build with fpic! Will be installed to /opt/libjpeg-turbo.

sudo apt-get install nasm
wget -O libjpeg-turbo-1.3.90.tar.gz http://sourceforge.net/projects/libjpeg-turbo/files/1.3.90%20%281.4%20beta1%29/libjpeg-turbo-1.3.90.tar.gz/download
tar xvzf libjpeg-turbo-1.3.90.tar.gz
cd libjpeg-turbo-1.3.90
./configure --with-pic
sudo make install

cython

sudo pip install cython

###udev rules for running as normal user:

echo 'SUBSYSTEM=="usb",  ENV{DEVTYPE}=="usb_device", GROUP="plugdev", MODE="0664"' | sudo tee /etc/udev/rules.d/10-libuvc.rules > /dev/null 
sudo udevadm trigger

#Dependencies Mac

###libuvc

git clone https://github.com/pupil-labs/libuvc
cd libuvc
mkdir build
cd build
cmake ..
make && sudo make install

libjpeg-turbo

brew install libjpeg-turbo

cython,numpy

pip install cython
pip install numpy

just build locally

python setup.py build_ext -i

or install system wide

python setup.py install

WINDOWS

Please have a look at WINDOWS_USER.md for install instructions if you want to use PYUVC. Please have a look at WINDOWS_DEVELOER.md for install instructions if you want to modify PYUVC.

About

python binding to libuvc

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%