VGB Command Line Options
Use the VisualGestureBuilder command-line tool to build, analyze, and alter gesture database files.
To use the command-line tool, run a command prompt as an administrator, and call “VisualGestureBuilder.exe <option>” with one of the options listed below:
| Option | Description |
|---|---|
| -analyze gestureAnalysisProject outputResultFile.adf |
Analyzes all test clips within the gestureAnalysisProject (.a.vgbproj) against the specified database (.gba or .gbd) and outputs the results to outputResultFile.adf. You can open the outputResultFile.adf using the Analyze button for the Analysis project from within the UI. |
| -build buildFile database |
Trains all gestures contained in the buildFile and saves the resulting gesture detectors to a database. To build multiple gesture detectors, provide the solution file (.vgbsln) as the buildFile argument and specify a .gbd database as the result. To build a single gesture detector, provide the training project (.vgbprog) as the buildFile argument and specify a .gba database as the result. |
| -join destDatabase srcDatabase [srcDatabase [srcDatabase]...] |
Joins one or more database files together. The resulting destDatabase file (.gbd) must be specified first. All remaining database files (.gba/.gbd) will be treated as srcDatabase arguments. The srcDestination accepts the wildcard symbol (*) to support joining all/multiple databases within the same path. Note: if two database files contain the same gesture name, only the first instance of that gesture will be included in destDatabase. |
| -list database | Opens the .gbd/.gba file specified by database and lists the gestures contained within. |
| -split database outputdirectory | Splits the .gbd/.gba file specified by database, and extracts the gestures contained within. Generates the individual gestures as .gba files and saves them in the outputdirectory specified. |
| -rename srcDatabase destDatabase oldName newName |
Renames a gesture from oldName found in srcDatabase to newName. Saves the updated database as destDatabase. Use this command to avoid naming conflicts when joining multiple gesture database files together or to allow side-by-side comparison of the same gestures across different builds. |
| Solution.vgbsln | Launches VisualGestureBuilder and loads the specified solution file. |
| Clip.vgbclip | Launches VisualGestureBuilder and loads the specified clip as a solution. |
| -? | Displays usage information. |
Examples
Here are some examples.
VisualGestureBuilder -analyze c:\myDir\testProject.a.vgbproj c:\myDir\Database.gba c:\myDir\analysisResults.adf VisualGestureBuilder -build c:\myDir\solution.vgbsln c:\myDir\Database.gbd VisualGestureBuilder -join c:\myDir\allKickGestures.gbd c:\mySourceFilesDir\kick* VisualGestureBuilder -join c:\myDir\KickAndPunchGestures.gbd c:\mySourceFilesDir\kick* c:\mySourceFilesDir\punch* VisualGestureBuilder -list c:\myDir\Database.gbd VisualGestureBuilder -split c:\myDir\Database.gbd c:\myGeneratedFilesDir VisualGestureBuilder -rename c:\myDir\kickDatabase.gbd c:\myDir\newKickDatabase.gbd kick newKick VisualGestureBuilder solutionName.vgbsln VisualGestureBuilder clipFile.vgbclip