~ubuntu-branches/ubuntu/natty/gavl/natty

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Free Ekanayaka
  • Date: 2006-05-17 14:24:46 UTC
  • Revision ID: james.westby@ubuntu.com-20060517142446-iqm0jgfbkmy27n5w
Tags: upstream-0.2.3
ImportĀ upstreamĀ versionĀ 0.2.3

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
This is gavl, a library for handling uncompressed audio- and video data.
 
2
 
 
3
Read the file INSTALL for detailed installation instructions.
 
4
 
 
5
Gavl defines generic types for audio and video formats,
 
6
which are applicable to a wide range of multimedia applications.
 
7
In addition, it provides conversion functions from all possible formats
 
8
to all other formats.
 
9
 
 
10
If you want to write a multimedia application, gavl will help you a lot:
 
11
You don't have to mess around with the large varieties of pixelformats,
 
12
interleaving modes, audio sample formats and so on.
 
13
 
 
14
Current features:
 
15
 
 
16
- Support for the following pixelformats:
 
17
  15 bpp RGB, 15 bpp BGR, 16 bpp RGB, 16 bpp BGR, 24 bpp RGB, 24 bpp BGR
 
18
  32 bpp RGB, 32 bpp BGR, 32 bpp RGBA, YUV 422 (YUY2), YUV 420 Planar,
 
19
  YUV 422 Planar (mpeg and jpeg), YUV 444 Planar (mpeg and jpeg)
 
20
  Conversions from all pixelformat to all others (NO multistep conversions,
 
21
  each conversion has it's own function)
 
22
 
 
23
- Audio samples can be 8 bit and 16 PCM (signed and unsigned),
 
24
  32 bit signed and floating point.
 
25
 
 
26
- High quality samplerate conversion using the Secret Rabbit Code
 
27
 
 
28
- Video frames will allocated with memory aligned scanlines for faster
 
29
  processing.
 
30
 
 
31
See the header file include/gavl.h and the sample files
 
32
src/colorspace_test.c and src/colorspace_time.c for
 
33
information and how to use this thing.
 
34
 
 
35
For testing the library, the src directory contains
 
36
some test programs.
 
37
 
 
38
colorspace_test:
 
39
Makes your current directory full of pngs, one test file
 
40
for each colorspace and one for each conversion.
 
41
Ideally, all these pictures should look the same.
 
42
 
 
43
colorspace_time:
 
44
Makes all defined conversions 20 times and prints, how long
 
45
it needed. Good for making C <-> MMX speed comparisons.
 
46
 
 
47
Every programmer, who agrees to this kind of API is welcome to
 
48
integrate gavl into his/her project so we can save some
 
49
energy while writing/searching the best and fastest
 
50
conversion routines.