Scripts
The script sets variables, and
uses them to perform OpenGL drawing instructions.
Scripting Overview
Vizzy scripts determine how each frame is drawn from the current music
data. The scripts use a sequence like this (various steps
may be omitted or repeated):
- Set up the background (clear it? fade it? import an image?)
- Set up the data: how many seconds of music are we seeing? etc..
- Place the camera and rotate the scene to the desired angle,
possibly using time-dependancies
- Set up an array of coordinates and colors
- Modify the coordinate arrays
- Draw
Results depend on getting instructions in the right order! Also,
some types of instructions are much faster than others, so getting the
hang of the system results in better, faster movies.
Much of the documentation is in the tooltips, which can also be seen in
the value inspector.
The most basic types of instructions are: Prep, Color, Adjust, and Draw.
- Prep: use
spectral data to create a collection of spatial points and colors
- Adjust: modify the
points and colors
- Draw: lay down ink
Additional types help with special cases:
- State : set program
values that other instructions can refer to
- Color: Modify existing colors
- Annotate : make text
notations in the frames, or draw staff
lines.
- Path: time-dependant
movement
The presets are useful example scripts.
There really should be some
documentation here about the specific panels and how they work.
