BKTRREC(1)

NAME
bktrrec - record raw video streams from bktr(4) to file

SYNOPSIS
bktrrec [-glv] [-e encoding] [-f file] [-h height] [-i field] [-n norm] [-o output] [-p pidfile] [-r rate] [-s source] [-w width]

DESCRIPTION
The bktrrec program reads raw video data from bktr(4) device file and writes it to output. bktrrec will run until it receives a SIGINT. By default, file is /dev/bktr0. If the -l option is not used, and output is not specified, bktrrec will exit with an error.

The options are as follows:

-e encoding
    Set the output encoding format. Supported encodings can be viewed with the -l option. The default is “10”.

-f file
    Alternative bktr(4) device to read from.

-g  Specifying this option will cause bktrrec to only grab a single video frame. Note that bktrrec will sleep for a small time before grabbing the frame. This is done because bktr(4) devices may need some time to lock onto the signal.

-h height
    Set the vertical resolution to height pixels. Valid arguments are integers from 0 to 576. The default is determined from the driver, which is influenced by the norm setting.

-i field
    A normal frame consists of two interlaced fields. This option directs file to only generate one of the two fields. Valid arguments are “even” and “odd”. Note that specifying this option will cause the video height to be halved. Default is to grab both fields.

-l  List the encodings supported by file. The values in the ‘index’ column are used with the -e option. The ‘description’ column reports information about the encoding, such as bit-depth and colorspace.

-n norm
    The video norm to use. Specifying a norm is a shortcut for setting default width, height, and rate. Valid arguments are “ntsc” (640,480,30), “pal” and “secam” (768,576,25). The default is “ntsc”.

-o output
    Write raw video data to output.

-p pidfile
    Write process ID to pidfile.

-r rate
    Set the frame rate to rate frames per second. Valid arguments are integer values from 0 to 30, but specifying a frame rate less than 10 is not likely to work. The default is determined from the driver, which is influenced by the norm setting.

-s source
    Set the video input to source. Valid arguments are “tuner”, “svideo”, “composite”, “scomp”, and “input3”.

-v  Increments level of informational output. All messages are output to standard error. Multiple instances of this option are allowed.

-w width
    Set the horizontal resolution to height pixels. Valid arguments are integers from 0 to 768. The default is determined from the driver, which is influenced by the norm setting.

EXAMPLES
The command

    $ bktrrec -n pal -o raw.vid

reads UYVY video frames of size 768x576 generated by /dev/bktr0 at 25 frames per second, and writes them to the file “raw.vid”. Recording continues until bktrrec receives a SIGINT, such as by pressing Ctl-C.

SEE ALSO
bktr(4)

AUTHORS
bktrrec and this manual page were written by Jacob Meuser <jakemsr@jakemsr.com>.