NAME

somagic-capture - Perform video capture with the Somagic EasyCAP DC60 or Somagic EasyCAP002

SYNOPSIS

somagic-capture [OPTION]...

DESCRIPTION

Initializes the Somagic EasyCAP DC60 or Somagic EasyCAP002 registers and performs video capture. This program must be run as root in order to interact with the USB capture device directly.

OPTIONS

-B, --brightness=VALUE

Luminance brightness control. The brightness VALUE must be between 0 and 255, inclusive. The default brightness is 128, which selects the ITU level.

*VALUE*	Brightness
255	Bright
149	NTSC-J
128	ITU level
0	Dark

-C, --contrast=VALUE

Luminance contrast control. The contrast VALUE must be between -128 and 127, inclusive. The default contrast is 71, which selects the ITU level.

*VALUE*	Contrast
127	1.984375
72	1.125000	NTSC-J
71	1.109375	ITU level
64	1.000000
1	0.015625
0	0.000000	Luminance off
-64	-1.000000	Inverse luminance
-128	-2.000000	Inverse luminance

-c, --cvbs

For the EasyCAP DC60, use the CVBS (composite) input for video capture. For the EasyCAP002, use the "2" input for video capture. This is the default.

-f, --frames=COUNT

Maximum number of video frames to capture. The default is -1, which allows unlimited frames.

--help

Print program usage and examples.

-H, --hue=VALUE

Hue phase in degrees. The hue VALUE must be between -128 and 127, inclusive. The default hue is 0.

*VALUE*	Phase
-128	-180.00000°
0	0.00000°
1	1.40635°
127	178.59375°

--iso-transfers=COUNT

Number of concurrent iso transfers. Selecting a higher value might help alleviate sync artifacts. The default is 4.

--lum-aperture=MODE

Luminance aperture factor. The aperture factor MODE must be between 0 and 3, inclusive. Increasing this value can increase perceived sharpness. The default aperture factor is 1.

*MODE*	Aperture Factor
0	0.00
1	0.25
2	0.50
3	1.00

--lum-prefilter

Activate the luminance prefilter. This is bypassed (not active) by default.

--luminance=MODE

Luminance mode for the CVBS video input, selecting a center frequency in MHz. Does not apply to the S-VIDEO video input. The MODE must be between 0 and 3, inclusive. Decreasing the MHz value can increase perceived sharpness. The default is 0.

*MODE*	Center Frequency
0	4.1 MHz
1	3.8 MHz
2	2.6 MHz
3	2.9 MHz

-n, --ntsc

Decode the NTSC-M video standard, which is used in North America. To decode the NTSC-J video standard, which is used in Japan, select -n along with -B 147 and -C 72. The internal vertical resolution is 525 lines. The output resolution is 720x480, which should be scaled to 720x540 for the correct aspect ratio of 4:3. The output framerate is approximately 29.97 Hz, or 30/1.001 Hz exactly.

--ntsc-4.43-50

Decode the NTSC-4.43 50 Hz video standard. The internal vertical resolution is 525 lines. The output resolution is 720x480, which should be scaled to 720x540 for the correct aspect ratio of 4:3. The output framerate is 25 Hz exactly.

--ntsc-4.43-60

Decode the NTSC-4.43 60 Hz video standard. The internal vertical resolution is 525 lines. The output resolution is 720x480, which should be scaled to 720x540 for the correct aspect ratio of 4:3. The output framerate is approximately 29.97 Hz, or 30/1.001 Hz exactly.

--ntsc-n

Decode the NTSC-N video standard. The internal vertical resolution is 625 lines. The output resolution is 720x576, which should be scaled to 720x540 for the correct aspect ratio of 4:3. The output framerate is 25 Hz exactly.

-p, --pal

Decode any of the PAL-B, PAL-G, PAL-H, PAL-I, or PAL-N video standards, which are used in many regions. The internal vertical resolution is 625 lines. The output resolution is 720x576, which should be scaled to 720x540 for the correct aspect ratio of 4:3. The output framerate is 25 Hz exactly. This is the default.

--pal-4.43

Decode the PAL-4.43 video standard, also commonly known as PAL 60. The internal vertical resolution is 525 lines. The output resolution is 720x480, which should be scaled to 720x540 for the correct aspect ratio of 4:3. The output framerate is approximately 29.97 Hz, or 30/1.001 Hz exactly.

--pal-m

Decode the PAL-M video standard, which is used in Brazil. The internal vertical resolution is 525 lines. The output resolution is 720x480, which should be scaled to 720x540 for the correct aspect ratio of 4:3. The output framerate is approximately 29.97 Hz, or 30/1.001 Hz exactly.

--pal-combination-n

Decode the PAL Combination-N video standard. The internal vertical resolution is 625 lines. The output resolution is 720x576, which should be scaled to 720x540 for the correct aspect ratio of 4:3. The output framerate is 25 Hz exactly.

-C, --contrast=VALUE

Chrominance saturation control. The saturation VALUE must be between -128 and 127, inclusive. The default saturation is 64, which selects the ITU level.

*VALUE*	Saturation
127	1.984375
64	1.000000	ITU level
1	0.015625
0	0.000000	Color off
-64	-1.000000	Inverse chrominance
-128	-2.000000	Inverse chrominance

-s, --s-video

Use the S-VIDEO input for video capture. Only available on EasyCAP DC60.

--secam

Decode the SECAM video standard. The internal vertical resolution is 625 lines. The output resolution is 720x576, which should be scaled to 720x540 for the correct aspect ratio of 4:3. The output framerate is 25 Hz exactly.

--sync=VALUE

Sync algorithm. Selects the method used to decode the video and control information into frames of video. The sync VALUE must be either 1 or 2. The default is 2.

*VALUE*	Algorithm
1	TB
2	MD

--test-only

Parses command-line options and performs capture setup, but does not initiate capture. The purpose of this option is to allow scripts to determine whether capture should be possible.

--vo=FILENAME

Select a file (or pipe) to output raw UYVY video frames to. The default is to output video to standard output rather than a file.

--version

Print the program version, the program copyright, a list of authors, and a notice that there is no warranty.

EXIT STATUS

The program exits with a status of zero on success. A status of one will be returned if any errors were encountered.

EXAMPLES

Play PAL video from CVBS/composite input

somagic-capture | mplayer -vf yadif,screenshot -demuxer rawvideo -rawvideo "pal:format=uyvy:fps=25" -aspect 4:3 -

Play PAL video from S-VIDEO input

somagic-capture -s | mplayer -vf yadif,screenshot -demuxer rawvideo -rawvideo "pal:format=uyvy:fps=25" -aspect 4:3 -

Play PAL video from CVBS/composite with increased sharpness

somagic-capture --luminance=2 --lum-aperture=3 | mplayer -vf yadif,screenshot -demuxer rawvideo -rawvideo "pal:format=uyvy:fps=25" -aspect 4:3 -

Play NTSC video from CVBS/composite input

somagic-capture -n | mplayer -vf yadif,screenshot -demuxer rawvideo -rawvideo "ntsc:format=uyvy:fps=30000/1001" -aspect 4:3 -

Play NTSC video from S-VIDEO input


somagic-capture -n -s | mplayer -vf yadif,screenshot -demuxer rawvideo -rawvideo "ntsc:format=uyvy:fps=30000/1001" -aspect 4:3 -

Play NTSC video from CVBS/composite input with increased sharpness

somagic-capture -n --luminance=2 --lum-aperture=3 | mplayer -vf yadif,screenshot -demuxer rawvideo -rawvideo "ntsc:format=uyvy:fps=30000/1001" -aspect 4:3 -

Play NTSC video from CVBS/composite input with increased sharpness, using alternate sync algorithm

somagic-capture -n --luminance=2 --lum-aperture=3 --sync=1 | mplayer -vf yadif,screenshot -demuxer rawvideo -rawvideo "ntsc:format=uyvy:fps=30000/1001" -aspect 4:3 -

Play SECAM video from CVBS/composite input

somagic-capture --secam | mplayer -vf yadif,screenshot -demuxer rawvideo -rawvideo "pal:format=uyvy:fps=25" -aspect 4:3 -

REPORTING BUGS

Report bugs to the easycap-somagic-linux project on Google Project Hosting: <http://code.google.com/p/easycap-somagic-linux/issues/list>

AUTHOR

This manual page was written by Jeffry Johnston <somagic@kidsquid.com>.

COPYRIGHT

Copyright © 2011, 2012 Tony Brown, Michal Demin, Jeffry Johnston, Jon Arne Jørgensen. License GPLv2+: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

somagic-capture(1)