Joe Maller: Joe's Debug and Explore Filters: Joe's Simple BlurA step by step explanation of how to build a simple FXScript blur filter for Final Cut Pro
This filter is very short and uses only one slider value and one function. It is here mostly as a step-by-step example of how to build a simple filter.
Step by Step Explanation
Final Cut Pro loads everything above the
The first line of the filter declares what type of FXScript this is, the choices are Filter, Generator and Transition. This line also defines the name of the filter (in quotes) as it will appear in the menus. Some characters like ampersands (&) are not allowed.
The next line defines where the filter will go in the menus, each group is a submenu of the three possible script types. If the script specifies a menu name that doesn't exist, the menu will be created.
After those two beginning definitions, the inputs are usually specified.
These can be any of the possible inputs
(sample) but each must have a
unique name. Duplicate names cause errors and prevent the script from
loading at startup. The following line declares a slider input whose value
will be stored in the variable
The code line is an important structural part of every FXScript. This is the breaking point between the definition section and the code section, where all the action will take place. Final Cut Pro preloads everything up to this point at startup, so any errors won't be apparent until the filter is applied to a clip.
And that's it. At some level, every FXScript in Final cut works the same way. Most all scripting is usually just a whole bunch of simple steps lumped together to produce a seemingly complex result.