Pylibdv

= Welcome to pylibdv 0.1 =

Background
pylibdv is a project for one of my university courses; [http://www.uio.no/studier/emner/matnat/ifi/INF5660/index-eng.xml INF5660 - Advanced problem solving with high level languages].

pylibdv is a python wrapper for [http://libdv.sourceforge.net/ libdv].BR
From libdv home page: "libdv is a software codec for DV video, the encoding format used by most digital camcorders, typically those that support the IEEE 1394 Firewire or i.Link) interface. Libdv was developed according to the official standards for DV video: IEC 61834 and SMPTE 314M."

Requirements
libdv 1.4 (works with debian package 0.104-2 from debian repository)BR
python >= 2.4 (testing.py won't work with 2.3, doctest will fail due to a bug in 2.3)BR
gccBR Known bugs
libdv seg-faults on some versions of the libdv library. There seems to be a bug in the asm-optimization, so a quick work-around if this occurs is to turn off asm-optimization. Progress
So far the following is available:BR

pylibdv:
Constants:
DV_QUALITY_BESTBR
DV_QUALITY_FASTESTBR
DV_QUALITY_COLORBR
DV_QUALITY_DCBR
DV_QUALITY_AC_1BR
DV_QUALITY_AC_2BR
DV_QUALITY_AC_MASKBR
e_dv_color_rgbBR
e_dv_color_yuvBR
e_dv_color_bgr0BR
Object:
DecoderBR
Methods:
parse_header()BR
decode_full_frame()BR
Data:
frame_size (read only)BR
width (read only)BR
length (read only)BR
quality (read & write)BR

This project is ongoing and most functions will be wrapped by the end of the summer (depending on need).

Simple example {{{
import pylibdv

decoder = pylibdv.Decoder(ignored=1, clamp_luma=1, clamp_chroma=1)

file = open("somedvfile.dv,"r")
framebuffer = file.read(120000) # Just enough to make sure

decoder.parse_header(framebuffer)

1. Now we can get some information about the video
   frame_size = decoder.frame_size
   width = decoder.width
   height = decoder.height

file.seek(0) #Back to start
framebuffer = file.read(frame_size)
rgb_buffer = decoder.decode_full_frame(framebuffer)
#Now the rgb buffer can be drawn to screen, check out gtk package
}}}

Enjoy! BR
[mailto:nielsr@ifi.uio.no Niels Petter Rasch-Olsen]