~ubuntu-branches/ubuntu/jaunty/xvidcap/jaunty-proposed

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): John Dong
  • Date: 2008-02-25 15:47:12 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080225154712-qvr11ekcea4c9ry8
Tags: 1.1.6-0.1ubuntu1
* Merge from debian-multimedia (LP: #120003), Ubuntu Changes:
 - For ffmpeg-related build-deps, remove cvs from package names.
 - Standards-Version 3.7.3
 - Maintainer Spec

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
XVidCap - Video Capture for X
2
 
Version 1.0.19
3
 
 
4
 
  Rasca, Berlin 1997-1999, Published under the GNU GPL
5
 
  extended by Karl, Frankfurt 2003
6
 
 
7
 
   Capture parts of your screen to single files for every frame or 
8
 
   to an mpeg stream.
9
 
   
10
 
   This program does not use a special hardware driver to access the
11
 
   video card. It just asks the X server about rectangular areas. This
12
 
   means you need a fast machine (>= 133 MHz) and a fast harddrive. Big
13
 
   frames (e.g. 384x288 = 1/2 PAL) at a high FPS rate are only possible
14
 
   with very very fast systems :-) but this program may also work on
15
 
   non-Linux systems.. try it.
16
 
   (verified on Lintel and Solaris/SPARC)
17
 
   
18
 
Features
19
 
 
20
 
     * Different frame output formats: XWD, PPM, PNG, MNG and JPEG
21
 
     * Supported visuals: TrueColor 15 bpp, 16 bpp, 24 bpp, and 32 bpp,
22
 
       StaticGray/8 bpp (not all for all output formats)
23
 
     * PseudoColor/8bpp and TrueColor/8bpp only for some output formats
24
 
     * I don't know about DirectColor-visual, may be it works or not ..
25
 
     * GT: QuickTime support (RGB, JPEG and PNG) for TrueColor 15, 16, 24
26
 
       and 32bpp. (KHB: haven't been able to verify this)
27
 
     * Command line arguments could be set by X resources
28
 
     * Define frames per second (fps) which should be recorded
29
 
     * Frames could be saved compressed (.gz)
30
 
     * Set the maximum number of frames which should be captured
31
 
     * Set the maximum time in seconds to capture
32
 
     * Usage of the X shared memory extension if the X Server supports it
33
 
     * Step mode for capturing single frames
34
 
     * Captures mouse-pointer movement through pseudo-mouse-pointer
35
 
       
36
 
Download Source Code, Binary (Linux glibc) and submit bug reports at:
37
 
 
38
 
   http://www.sourceforge.net/projects/xvidcap
39
 
 
40
 
Additional programs / libraries
41
 
 
42
 
   For compressed XWD and PPM files you need the zlib, for PNG support
43
 
   you need zlib and the PNG library (0.96 or newer), for JPEG support
44
 
   you need the jpeg library. For viewing the recorded frames as
45
 
   animation the animate program of the ImageMagick package is very
46
 
   handy.
47
 
   On-line video encoding uses ffmpeg, which is bundled for now due to
48
 
   color space conversion problems with 0.4.6. Watch out for dynamically
49
 
   linked versions with ffmpeg 0.next.
50
 
   
51
 
Installation
52
 
 
53
 
   ref. INSTALL
54
 
       
55
 
Todo
56
 
 
57
 
   ref. TODO
58
 
   
59
 
Tips and hints
60
 
 
61
 
   Disabling backing store (-bs) at the Xserver gives better (faster)
62
 
   results on my system. Don't ask me why, I don't know about X server
63
 
   internals. Perhaps it's only imagination :-)
64
 
   I think the XWD output is the fastest one. If you use compression it
65
 
   will slow down the capturing. Compressed PPM seems to be faster as PNG
66
 
   with the same compression level and produces also smaler files.
67
 
   Codecs to be used for on-line encoding can be configured through 
68
 
   $HOME/.xvidcap.scf and a parameter "codec". Supported values atm are
69
 
   "MPEG4", "MPEG1", or "MJPEG".
70
 
   
71
 
Documentation
72
 
 
73
 
   Have a look at the man-page of xvidcap.
74
 
   
75
 
   karl, 24. October 2003 - 17:30
 
1
 
 
2
BASICS:
 
3
 
 
4
This version no longer has an Xt UI!
 
5
 
 
6
In return it has a load of other goodies, like:
 
7
- fewer bugs :)
 
8
- documentation (need yelp to read it)
 
9
- availability in English, German, Italian, Spanish
 
10
- recent versions
 
11
- on-the-fly frame size reduction
 
12
 
 
13
 
 
14
COMPILATION:
 
15
 
 
16
Now, the usual triple does what most users want, so it's just:
 
17
 
 
18
./configure
 
19
make
 
20
make install
 
21
 
 
22
 
 
23
KNOWN ISSUES:
 
24
 
 
25
- if you use compiz/beryl and use the capture area selector to single click and select a window to capture, don't click on the window title but the contents. Other window managers can handle it.
 
26
 
 
27
- some codecs have certain requirements that they don't offer xvidcap a way of asking about it in advance. They may make xvidcap crash if configured to run with incompatible settings. Most notably it is DV which you cannot use with anything but a frame size of 720 x 576. So if you experience strange crashes, try running from command line and see if you get a message from libavcodec. Eventually, submit a bug. This is on the todo-list for xvidcap.next.
 
28
 
 
29
 
 
30
CODING:
 
31
 
 
32
I've taken to using indent with the following parameters: -bad -bap -bbo -nbc -bls -br -c40 -cd12 -cp12 -cs -hnl -kr -l80 -pcs -psl -saf -sai -saw -sob -ts4 -nut -sc
 
33
Also, I've started using doxygen for documentation, though I don't use that comment style just EVERYWHERE.
 
34
 
 
35