D2V(1)

NAME
d2v - produced country dance animations

SYNOPSIS
d2v [-/+test] [-o output-filename] [-couples number] [-minorsets number] [-part number] [-width number] [-height number] [-fps number] [-fpb number] [-usable fraction] [-audio number] [-bit-rate number] [-past-path number] [-background image-file] [-music-amplify fraction] [-crop w:h:x:y] [-music music-description-file] [-/+noaudio] [-/+title] [-/+frameTitle] [-/+sicilian] [-/+showFrame] [-/+showPerson] [-/+showGrid] [-/+minorset] [-/+honour] [-/+verbose] [-/+gif] [-/+png] [-frameDir directory] [-/+retain] [-/+append] [-/+testSlow] [-/+testDance] [-/+testMinor] [-/+testScot] dancefile ...

DESCRIPTION
The program d2v will take a dance xml file and produce a video animation. It is a command line tool with lots of arguments but no other user interaction.

OPTIONS

-/+test
    Produces a test version of the animation, at only 8 frames per second and only once through the minor set with no title and credits. This is a quick test to see if things are basically working. After it has finished making the video it will attempt to display it. A - turns off test mode, a + turns it on.

-o output-filename

-output output-filename
    Specify an output filename. If unspecified and test mode is not on then the output file will be the input file with the extension replaced by ".mp4". If test is on the output file will be "/tmp/test.mp4".

-couples number
    Specify the number of couples in a minor set dance.

-minorsets number
    Specify the number of times to run the dance.

-part number
    Start by displaying the specified part in a multipart dance.

-width number
    Specifies the number of pixels wide the output video should be.

-height number
    Specifies the number of pixels high the output video should be (if -width is specified and -height is not, then the height will be 9/16s of the width).

-fps number
    Specifies the number of frames per second in the output video (must be an integer).

-fpb number
    Specifies the number of frames per bar in the output video (must be an integer).

-usable fraction
    Specifies the fraction of the screen which should be used for the video, basically providing a margin around the edges.

-audio number
    This is untested. It should set the audio sample rate to the indicated number per second.

-bit-rate number
    Passed to the video codec.

-past-path number
    Draws a track on the screen showing where the dancers have been. Only the last number bars of the track are visible. The number can be a decimal.

-future-path number
    Draws a track on the screen showing where the dancers will be. Only the next number bars of the track are visible. The number can be a decimal.

-background image-file
    An image to be used as the video's background.

-music-amplify number
    Make the music (if any) more or less loud.

-crop w:h:x:y
    Crop the video output.

-music music-description-file
    Specifies a music description xml file to define music for this video. The music description must match the dance, of course. At the very least it should have the same number of bars in the minor set.

-/+noaudio
    A + will turn off audio output, producing a silent video.

-/+title
    A + will add a title and credits section before the dance starts. A - will remove it.

-/+frameTitle
    A + will mean the dance's name appears at the top of every frame. A - removes it.

-/+sicilian
    A + will mean the program should display the dance in a sicilian formation.

-/+showFrame
    A + will mean a frame counter (and bar counter) will appear at the bottom of the screen.

-/+showPerson
    A + will mean each dancer will have a small number attached to them.

-/+showGrid
    A + will mean a plus mark will be drawn at each dancer's starting position.

-/+showPath
    A + will mean a quick way of setting both past-path and future-path to reasonable values.

-/+minorset
    A + will mean the first minorset of the dance will be slowed down and focus on just the top few couples (and show a grid) in hopes of making the dance easier to understand. No music will play (it would sound slow and awful if it did).

-/+honour
    A + will mean the dance starts with an honour.

-/+verbose
    A + will mean verbose debugging output.

-/+gif
    A + will produce an animated gif.

-/+png
    A + will mean that instead of using libav to produce a video directly, the program will produce a bunch of png images (one for each frame) and an audio output file and then ask ffmpeg to put them all together into a video. This can be handy for debugging, if something goes wrong and the program crashes you've still got a bunch of png files to look at to see where things were going wrong.

-/+frameDir
    Only meaningful if +png is specified. Specifies a directory in which to put the temporary png files.

-/+retain
    Only meaningful if +png is specified. A + will mean the png files will be retained at the end of the run rather than converted into a video and delete.

-/+append
    Only meaningful if +png is specified. A + will mean new png files will be appended to the collection already present. It's a way of putting two dances in one video.

-/+open
    A + will mean that after the video has been created, the program will ask some other program to display it.

-/+testSlow
    Same as test except that the video will be slowed down by a factor of three.

-/+testDance
    Same as test except that the video will show more than one iteration of the minor set.

-/+testMinor
    Same as +test and +minorset.

-/+testScot
    Same as test except that the video will show three iterations of the minor set and slow down the first one.

SEE ALSO
verify(1)