avitools

Introduction

avitools is a post processor for adding btf data to video files.

Compiling

avitools is compiled by running gnu make in the src directory.

Running

Try running the avitools binary by cd'ing to the directory the binary is located, and typing ./avitools. You should get something that looks like this:

./avitools USAGE:
./avitools input_avi btf_folder output_avi [OPTIONS]

Quadrants:
 2 | 1
---+---
 3 | 4

./avitools OPTIONS: (# is a number, x is a filename, $ is a quadrant)
-sf #   --startframe #          //Frame to start processing on
-ef #   --endframe #            //Frame to end processing on
-ts $   --timestamp $           //Timestamp
-rts $  --reltimestamp $                //Relative timestamp
-fs $   --framestamp $          //Framestamp
-rt $   --recordtime $          //Time of recording
-dr x   --drawregions x         //Draw the rectangular regions using color config file x
-d      --darken                //Cuts the brightness of an image in half
-ss #   --segmentsize #         //Size of a font segment, default 5

Lets look at this in more detail:

Required Arguments

Argument Name	What it Means
`input_avi`	This is the filename of the input avi that will compose the background for the avi. Or, another way of thinking, is that all data will be overlayed onto this avi.
`btf_folder`	This is the name of the folder, that has all the .btf files, which you want to visualize.
`output_avi`	This is the name of the avi to create.

Note: Any failure on the part of the three required objects, and avitools will not run.

Return to Top

Optional Arguments

Argument Name		What it Means
Short Name	Long Name	What it Means
`-sf #`	`--startframe #`	avitools normally starts from the first availible frame in the btf. If you want it to start later, add this.
`-ef #`	`--endframe #`	avitools normally runs until the btf file ends. Use this option to stop it at an earlier frame.
`-ts $`	`--timestamp $`	Adds a timestamp to the specified quadrant.
`-rts $`	`--reltimestamp $`	Adds a relative time stamp to the specified quadrant.
`-fs $`	`--framestamp $`	Adds the framestamp to the specified quadrant.
`-rt $`	`--recordtime $`	Adds the recording date and time to the specified quadrant.
`-dr x`	`--drawregions x`	`x` should be the name of the color config file used to make the btf. This command will draw boxes at the locations and sizes specified for recognized objects, in the highlight color of that object.
`-d`	`--darken`	This cuts the brightness of the source avi by half. Useful for making sure the regions stand out.
`-ss #`	`--segmentsize #`	This adjusts the size of the font overlayed. Default value is 5, and this seems fine for most purposes. Please note that this font size does not correspond to the font sizes in a text editor.

Note about Quadrants: A 'Quadrant' is merely a corner of the screen. Info that is placed in a certain quadrant will appear in that corner of the screen. the quadrants are defined as follows:

Use Quadrant number: If you want text to appear:

1 Upper right hand side

2 Upper left hand side

3 Lower left hand side

4 Lower right hand side

Return to Top

Example

For this example, the following invocations were used:
./avitools data/antprelim.avi ANTBTF/ ant-post.avi -d -fs 1 -dr data/color.txt -ef 300 produces:
post proceessed image, with -d
./avitools data/antprelim.avi ANTBTF/ ant-post.avi -fs 1 -dr data/color.txt -ef 300 produces:
post processed image
Return to Top

Download

The files have been consolidated in a single package. Get GTrack version 1.0 here MD5: 9b17ce83dda6851fe1528d20a2554583
Return to Top