Genvid

Table of Contents I/O Input Output GenVid Command Line Manual Required Arguments Optional Arguments Command Line Examples GenVid GUI Manual

I/O

We strive to keep our data in open, accessible formats so that the information can be reused and modified by our other software components, or by external software such as Adobe After Effects or biotracking software from other organizations.

Input

• Video file
  • Highest resolution and quality version of the video you want
  • accepts most file types playable by VLC
  • tested with Quicktime h.264 encoded .mov files
• BTF data (carriage return delimited data)
  • X coordinates (pixels)
  • Y coordinates (pixels)
  • Rotation coordinates (radians)
  • Timestamps (milliseconds)
  • ID (tracked target ID)

Output

• Video file
  • Highest resolution and quality version of the video you want tracked
  • Returns .mov file playable by VLC
  • Returns Quicktime h.264 encoded .mov files

GenVid Command Line Manual

Required Arguments

'arg1' : Video path as first argument.

'arg2' : Tracking data directory as second argument.

'arg3' : Save path including file name as third argument.

Optional Arguments

Text Flags

'-id' : turns on ant label for export.

'-xy' : turns on ant XY position text for export.

'-ang' : turns on ant angle text for export.

'-s' : Small Font flag, makes font size small.

'-l' : Large Font flag, makes font size large.

Overlay Flags

'-cir' : Circle flag: Turns on circles of default radius for export.

Optional flags follow Circle flag:

'-crad' 'int' : radius flag followed by integer adjusts radius of circle.

'-cs' 'int' : Circle Stroke flag followed by integer adjusts stroke of circle.

'-ccol' : Turns on uniquely colored circles for export.

'-tr' : Trail flag: Turns on trails of default length for export.

Optional flags follow Trail flag:

'-tsize' 'int' : Trail Size flag followed by integer adjusts length of trail.

'-trs' 'int' : Circle Stroke flag followed by integer adjusts stroke of trail.

'-tcol' : Turns on uniquely colored trails for export.

'-ar' : Arrow flag: Arrow flag turns on orientation arrows for export.

Optional flags follow Arrow flag:

'-asize' 'int' : Arrow Size flag followed by integer adjusts length of arrow.

'-ars' 'int' : Arrow Stroke flag followed by integer adjusts stroke of arrow.

'-acol' : Turns on uniquely colored arrows for export.

Remark: Including just an "Optional flag" will automatically include the corresponding "Overlay Flag". See examples below.

Command Line Examples

'./GenVid ~/Desktop/InputFile.mov ~/Desktop/BTF_folder ~/Desktop/output.mov'

Will take in InputFile.mov & BTF_folder to output the output.mov file to the Desktop.

'./GenVid ~/Desktop/InputFile.mov ~/Desktop/BTF_folder ~/Desktop/output.mov -id -l -ccol'

Will take in InputFile.mov & BTF_folder to output the output.mov file to the Desktop. The resulting video will have an ID with a large font as well as circles turned on with uniquely colored circles on export.

'./GenVid ~/Desktop/InputFile.mov ~/Desktop/BTF_folder ~/Desktop/output.mov -xy -tsize 500'

Will take in InputFile.mov & BTF_folder to output the output.mov file to the Desktop. The resulting video will have an XY coordinates on with default small font as well as grey trails turned on with a trial size of 500 frames on export.

GenVid GUI Manual

Check out the video tutorial

http://youtu.be/p2CqR62TePA GenVid Walk Through

Load Video and select your BTF directory

File:gv_upload.png

Once files have been selected correctly you are ready to proceed

File:gv_ready.png

Adjust "Text Export Settings"

500px

Adjust "Overlay Export Settings"

500px

Click "Export" to begin rendering out a video.

File:gv_export.png

Once the export is in progress any adjustments you make to the "Export Settings" will be reflected in the rendered video. This feature is intended to allow a user to adjust video elements on the fly.

500px