Vizzy Cue Controls

For advanced scripting, see the Scripts page.

Camera

Use the camera positioner to change the view angle.

The red ball is the camera.  Double-clicking in the gray field restores its default position.


Scripts

To draw each frame, Vizzy runs a script-- a sequence of steps.  Each script belongs to a cue in the timeline, so you can associate the script with a certain section of music.

The current cue is the one starting at, or to the immediate left, of the current frame (the red line in the timeline).

The 'Presets' tab gets you started by putting a short script in the current cue.
  (The preset can also be added to the cue script; choose this option in File > Preferences.)




The cue window has 'save' and 'load' buttons that let you save and load your own presets. 

You can choose an icon for the saved preset to help remember what it looks like, using File > Use Frame as Icon.



The Cue Script tab lets you arrange and adjust the script's steps.

script window

Steps execute top to bottom.   The selected step is highlighted in blue.
The flippy triangles open to show adjustments that you can make.  Most widgets have tooltips (seen when the mouse floats over the widget).

The selected step (or group) can be cut, copied, and pasted into cues.


Instruction Groups

Script steps are collected into groups by selecting the top step and typing apple-g (or from the menu: Edit>Group).  Continue typing apple-g until all the steps you want have been added.

To ungroup, select a group and type apple-shift-G.

Clicking the green circle opens a group editor, for rearranging the steps in a group.


Tweening



Tweening means moving smoothly from one script to another.  Vizzy does this in two ways: either by fade out/fade in, or morphing. which tries to smoothly change the settings.  They can be used seperately or together.

Over the width of the current cue, tweening takes into account both the current and the previous cue.  Beyond the cue end, only the current cue controls the rendering (until the next cue starts).

To try out a tween, create a cue and give it some width.  Give it a preset script; give the previous cue a different one.  Click the "Fade" button.

If you drag the mouse over the width of the cue, you should see a Fade Out/Fade In tween.

Morph tweening

For Morph tweening, Vizzy goes through the 2 scripts step by step.  If the two steps are of the same type (e.g. Adjust/Boost), the resulting render will average their settings.   The camera settings are also averaged.

The Timeline controls for transferring scripts come in handy for setting this up.  Once you have a visual you like, transfer it to an adjacent cue.  Then in one of the cues, you can change the settings-- just don't add or remove any instructions.

Note that morph tweening can't merge settings that are either on or off.  For example, if one script draws triangles and the next draws rectangles, there is no way to morph between them.  You can, however, turn fade tweening on also.


Tween Options (experimental)



This allows morph tweening to go back and forth over the width of the cue, rather than just straight through.  The exact path is programmed using an interface similar to the Cue Script.  Let me know what you think.



More details of advanced scripting can be found on the Scripts page.