somagic-capture

NAME

SYNOPSIS

DESCRIPTION

Initializes the Somagic EasyCAP DC60, Somagic EasyCAP002, or EzCAP ESB 2.0 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 or EzCAP USB 2.0, use the CVBS (composite) input for video capture. For the EasyCAP002, use the numbered inputs for video capture. Different devices seem to have different numbering schemes, so try each input in turn to determine which one is correct. This is the default.

-i, --cvbs-input=VALUE

For the EasyCAP002 only. Select the numbered input to use. Different devices seem to have different numbering schemes, so the numbering may not match your device. Try each input in turn to determine which one is correct. The default input is 3.

-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 and EzCAP USB 2.0.

--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

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 -

SEE ALSO

REPORTING BUGS

AUTHOR

COPYRIGHT

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXIT STATUS

EXAMPLES

SEE ALSO

REPORTING BUGS

AUTHOR

COPYRIGHT