Content-type: text/html Manpage of CC2Y4M

CC2Y4M

Section: User Manuals (1)
Updated: JUNE 2004
Index Return to Main Contents

NAME

cc2y4m - translates broken PAL signals to YUV4MPEG2

SYNOPSIS

cc2y4m [ -V ] [ -h ] [ -D ] [ -q ] [ -k ] [ -B ] [ -C ] [ -m 1|2 ] [ -S ] [ -c ] [ -d DEVICE ] [ -i ]

DESCRIPTION

Some channels broadcast a tv signal which is not standards compliant. It usually lacks sync pulses, gets inverted at random times and even may include disinformation. Those signals can't be comfortably viewed on a normal television set. The Brooktree 87[89](A) chip has a special mode in which it doesn't get confused because of missing sync signals. This program enables this mode, very much alike cabletv(1), and takes special measures to keep the image stable and adjust for the inversion. The output of this program appears on standard output in YUV4MPEG2 format, and can, for example, be fed to mplayer(1).

Note that in some countries might have draconian laws which may require you to get some kind of permission from the broadcaster before you may use this program legally. Consult a lawyer if you are in doubt.

This program needs access to private registers of the Bt87[89](A) chip, so root privileges are required.

OPTIONS

-q: The program will only print error messages (and debug information if requested to do so with -D).
-D: Want to see what the program does? This is the option you want to specify on the commandline. An SDL window will be opened with the raw output of the Bt87[89](A), position of the window can be changed in the source.
-d DEVICE: Use DEVICE as the device special file of the bttv-card. Default is /dev/video0.
-i: Enable interlaced output.
-k: Enable catching <UP> and <DOWN> from the MPlayer window, to be able to change channels on the fly.
-c NUMBER: Tune to channel NUMBER. 0 is the first channel, 1 is the second channel, etc.
-n: Don't read the configuration file at ~/.cc2y4m.
-m 1|2: This option selects the locking mechanism. Mechanism 1 is the default and the original one. If it doesn't work for you; try mechanism 2.
-B NUMBER: Change the 'brightness' used by the PAL->YUV converter to NUMBER, default is 37.
-C NUMBER: Change the 'contrast' used by the PAL->YUV converter to NUMBER, default is 37.
-S NUMBER: Change the 'saturation' used by the PAL->YUV converter to NUMBER, default is 37.

EXAMPLES

Some examples:

# cabletv | mplayer -

for viewing the first channel defined in ~/.cc2y4m .

If you want to record the video

# cabletv | mencoder -o test.avi - -ovc lavc \
-lavcopts vcodec=mpeg4:vbitrate=1000

FILES

The configuration file of this program should be named ~/.cc2y4m . For an explanation of the file format, look through cc2y4m.conf in the source distribution of this program. If you adapted cc2y4m.conf to suit your needs, you can copy it to ~/.cc2y4m, where it will be found by cc2y4m.

AVAILABILITY

The latest version of cc2y4m should be available at
http://www.phys.uu.nl/~snel/cc2y4m/.

BUGS

For more bugs see the BUGS file. (I am too lazy to maintain two seperate compies of LARGE databases that should be identical) The subject of submitting patches for bugs is detailed in the README file.

VERSION

The version of cc2y4m documented here is 0.0.11.

AUTHOR

Rik Snel <snel@phys.uu.nl>, PAL color decoding routines written and (C) by Ewald Snel. A complete list of contributors can be found in the file AUTHORS

THANKS

Thanks go out to TWISTI and FUX for making cabletv(1) and releasing the source, thereby providing me with valuable insights into the working of their program. Further thanks to Ewald Snel for his PAL color decoding routines (also from cabletv(1)).

This document was created by man2html, using the manual pages.
Time: 22:26:29 GMT, July 30, 2004