			
	        	 AVInfo v 0.7


                   					    RIFFHí‡xAVI LIST
                      					LIST~"  hdrlavih
                      					LIST”9  strlstrh  

                     					    	(c) *.avi


AVInfo is a utility for displaying AVI header information. It returns the
length of a clip, FPS, resolution, codec, sound parametrs, and the number
and type of streams, including detailed information for each.

Sample of usage:

"just output": avinfo movie.avi
"FAR output": edit:< avinfo movie.avi --far 
			  (FAR - File Archive Manager by E. Roshal - 4 win only)
"4programmers": avinfo -emi -fISX7 movie.avi --struct-report | more
"batch processing" (for w2k/xp):
for /r c:\anime\ %a in (*.avi) do @avinfo -fia -ees "%a" --description >>animelist.txt


Usage:

	avinfo [-params] file.avi [--mode] [template1] [template2] 

avaible params:

-f[ixs8]

i - turn off info reading (LIST-INFO)
I - turn on info reading
s - turn off streams reading (and displaying second template)
S - turn on stream reading
x - turn off index data (bitrate, waste space, etc)
X - turn on index data
7 - 7-bits output
8 - full, 8-bits output
a - m.... to heavy to explain. (see sources)
    Roughly speaking, "crop" garbage from output, (instead ~134Mb - 123Mb,
    00:34:33 - 34m, etc).
	Especially affected to the --description.

-e[imse]

m - turn on error messages
s - turn off error messages (silence mode)
i - ignore errors, try to dispay information anywere. 
	(may be usefull, but dangerous - program may crash)
e - exit @ error. ¢ëå®¤ ­  ®è¨¡ª¥.

Predefined templates:

--description    line for descript.ion
--short          short line for descript.ion
--far            output for FAR manager (use edit:< avinfo "!.!" --far)
--list           for list generating (see samples/filelist.bat)
--struct-report  programmers output (all data)
--html, --html-css, --html-b - for HTML report (see below)

About --html


They using for generating a html line (for table)
--html - plain html
--html-css - for css using (define in header avinfofilename, avinfovideo,
avinforesolution, avinfoaudio classes)
--html-b - only <b> formating.

for each of them you must add a head (html head, <table>) and foot 
(</table>, html foot). Try to look here (samples/htmllist.bat)


Template substitution:

(full list of avaible substitution - in DOC/info_chunk, DOC/meta, DOC/index)

You can use an a '^' char instead '%'

(for the template_header):      (for the template_stream):

%% - %                        $$ - $
%! - <cr> symbol              $f - fccType (vids/auds)
%f - fps                      $h - fccHandle (div3,vox,etc)
%x - Width                    $F - Flags
%y - Height                   $i - InitialFrames
%r - dwScale                  $r - Rate
%a - Rate                     $s - Start
%F - MicroSec Per Frame       $l - Length
%t - Streams                  $b - SuggestedBufferSize
%L - TotalFrames              $q - dwQuality
%l - length (in sec)          $S - dwSampleSize


video codec            %v (e.g. div3, xvid, dv50, mjpg, etc)
bits per pixel         %B (e.g. 4, 8, 16, 24)
format tag             %w (number) (todo - convert to text view)
Samples per second     %D (e.g. 44100, 48000, 22050, 11025)
Chanels                %C (e.g. 1, 2, 6)
Mono/Stereo/Number     %c (generating from %C e.g. Stereo, Mono, 3)

Codecs information: (from http://www.fourcc.org/ - big thanks to it owner)

codec name             %z
codec URL              %u
codec's author         %Z
author site URL        %U
comment 'bout codec    %p

audio codec name       %P
audio codec #define    %W
(mmreg.h)

You can use this substitution to output avi file description (INFO list-type):

@Xfoobar $ # * ]

X - see in the info_chunk.txt for detail.
$ - content of the param.
# - reference description
* - FourCC code.



for strf vids:
(video stream format data):      (audio stream format data)

#s - Size                       #f - wFormatTag
#w - Width                      #H - nChannels
#h - Height                     #p - nSamplesPerSec
#p - Planes                     #a - nAvgBytesPerSec
#c - BitCount                   #b - nBlockAlign
#C - Compression                #B - wBitsPerSample
#S - SizeImage                  #z - cbSize
#X - XPelsPerMeter
#Y - YPelsPerMeter
#u - ClrUsed
#i - ClrImportant

INDEX DATA:

&ab - audio bitrate
&vb - video bitrate
&Vn - number of video keyframes
&w
&W  - Wasted space
&b - bits per pixel

Sample of template_header:
        %xx%y, &ab, &vb, ^V
        %xx%y, %l sec, %f fps.%!


Sample of template_streams: "Stream $n: $f, $h"

Licensing:

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License (copying) for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

(c) George Shunklin 2003,  gs@shounen.ru

home page: http://shounen.ru/soft/avinfo/


P.S. Sorry for my poor-poor language. If someone wish to help me to translate
this document correctly, please, mail me. 
