." Text automatically generated by txt2man-1.4.7
.TH avicalc  "August 06, 2003" "" ""

.SH ABOUT

avicalc is a small script to calculate some values which
are very important for encoding videos: bitrate and resolution.
.SH SYNOPSIS
.nf
.fam C

\fBavicalc\fP [-Hh] [-c] [-m \fImode\fP]
[-s \fIsize\fP -d \fIduration\fP]
[-b \fIbitrate\fP [-f \fIfps\fP] [-a \fIaspectration\fP] [-r \fIresolution\fP]]
.fam T
.fi
.SH OPTIONS

.TP
.B
-h
display usage
.TP
.B
-H
display full help
.TP
.B
-m
\fImode\fP (\fIbitrate\fP|bpp|lr)
.PP
.nf
.fam C
        bitrate - calculates the needed
          br for a wanted endsize of
          an avi of a given length/duration

        bpp - calculates the bits per
          pixel-rate for a given resolution,
          bitrate and frames per second.

        bpb - calculates bits per block (16x16)
          for a given resolution, bitrate
          and frames per second.

        lr - display a lot of resolutions
          and the responding bpp's. enable
          colormode to see what would look
          ok.

        lb - display a lot of resolutions and
          the responding bpps/bpb for a list of
          bitrates

.fam T
.fi
.TP
.B
-s
wanted \fIsize\fP (x|xKB|xMB)
.TP
.B
-d
\fIduration\fP (in seconds)
.TP
.B
-b
\fIbitrate\fP (in kbit/s)
.TP
.B
-a
aspect ratio (16/9|4/3|1.33)
.TP
.B
-r
\fIresolution\fP (widthxheight)
.TP
.B
-f
\fIfps\fP (25 is default)
.TP
.B
-i
increment (for -m lb)
.TP
.B
-c
color \fImode\fP
.RE
.PP

.SH BPPS

.TP
.B
red
: < 0.10 : don't do it. please. i beg you!
.TP
.B
yellow
: < 0.15 : It will look bad.
.TP
.B
cyan
: < 0.20 : You will notice blocks, but it will look ok.
.TP
.B
green
: < 0.25 : It will look really good.
.TP
.B
white
: < 0.25 : It won't really improve visually.
magenta : > 0.30 : Don't do that either - try a bigger \fIresolution\fP instead.
.SH EXAMPLES

calculate br for 5 minutes of the movie that
will result in a 10mb - file:
.PP
.nf
.fam C
    $> avicalc -m bitrate -s 10mb -d 300  -> 279kbit/s

.fam T
.fi
calculate the bpp for this movie:
.PP
.nf
.fam C
    $> avicalc -c -m bpp -r 512x244 -c -b 279 ->  0.8 bpp

.fam T
.fi
last output should be displayed red for showing it
wont look good for sure. so, display some more
resolutions to getting near the final \fIresolution\fP:
.PP
.nf
.fam C
    $> avicalc -c -m lr -b 279 -a 16/9

.fam T
.fi
now choose one of the cyan or (better) green marked
resolutions for encoding the avi.
.SH LINKS

the main-source for this script:
.PP
.nf
.fam C
    http://www.mplayerhq.hu/DOCS/tech/encoding-tips.txt


.fam T
.fi
.SH AUTHOR

mathias gumz <gumz at cs.uni-magdeburg.de>
.SH BUGS

not yet known