.\"             -*-Nroff-*-
.\" atisplit man page
.\"   Written by Gatos Devel. Team, and so grinded and scribbled by DCB.
.\"
.\" History:
.\"    0.1: (first generation)
.\"    0.2: some clean-ups and cosmetic changes 
.\"    0.3: update for 0.0.5.
.\"
.\" Last update: Mon Dec 20 03:05:42 CET 1999
.\" "
.TH atisplit 1 "20 Dec 1999 " " " "GATOS Manual"
.SH NAME
atisplit \- conversion utility from the \fBGATOS\fP package.
.SH SYNOPSIS
.BI "atisplit"
.SH DESCRIPTION
The program \fIatisplit\fP is a small utility to convert \fIgatos\fP
capture file (\fIgatos.yuv\fP) into a series of yuv frames good for
input to \fImpeg_encode\fP program.
.PP
\fImpeg_encode\fP can be obtained on metalab
(\fIhttp://www.metalab.unc.edu/\fP).
.PP	    
note that since mpeg_encode uses yuv files with only quarter of cb and
cr fields the output files have less information than the input
one. in particular the total size of the output files should be just
below 3/4 of the size of the input file.
.SH USAGE
.B "\-"
Start the "TV in a Window" application:
.RS
.I "./xatitv &"
.RE
  and capture whatever you want,
.RS
.I "atisplit"
.RE
  atisplit furiously prints out frames.
.PP
.PP
.B "\-"
You must edit the default.lparam file (see below);
.PP
.PP
.B "\-"
And,
.RS
.I "mpeg_encode default.lparam"
.RE
  this produce \fIoutput.mpg\fP MPEG file.
.SH MPEG_ENCODE CONFIGURATION FILE	    
You can find a sample \fIdefault.lparam\fP file below:
.nf

#
# use this as a guideline for any parameters you 
# don't really understand or don't care about.
#

PATTERN         IBBPBBPBBPBBPBB
OUTPUT          output.mpg

BASE_FILE_FORMAT        YUV
GOP_SIZE                10
SLICES_PER_FRAME        1

PIXEL                   HALF
RANGE                   10
PSEARCH_ALG             LOGARITHMIC
BSEARCH_ALG             CROSS2
IQSCALE                 8
PQSCALE                 10
BQSCALE                 25

REFERENCE_FRAME         ORIGINAL

#
# you really need to understand the following
#
YUV_SIZE                320x240
INPUT_CONVERT           *

INPUT_DIR               ./

INPUT
tv*.yuv                 [000001-000100]
END_INPUT
.fi
.SH FILES
.PP
.nf
default.lparam
output.mpg
.fi
.SH SEE ALSO
gatos, gatos-conf, atitv, atitogif, atitojpg, atitoppm, xatitv, 
yuvsum, scanpci.
.SH AUTHORS
\fIAtisplit\fP was written and copyrighted by Steaphan Greene, \(/Oyvind
Aabling, Octavian Purdila, Vladimir Dergachev, Christian Lupien, and
Daniel Caujolle-Bert.