The FXScript Reference

This is a switch to let Final Cut Pro know that the script will be explicitly specifying color spaces to work with. In order to use any of the GetPixelFormat, ConvertImage or SetPixelFormat functions the script must set the YUVaware flag in it's definition section.

This one appears in several Apple-authored generators including Color, Noise, Particle Noise, Outline Text and Text. All of those include the comment:

"// Hint FCP not to spend time erasing dest, since we will do it ourselves."

Thanks to whoever left that note in there...

This command is undocumented (like most InformationFlag attributes) and appears to be used only by generators. It's not clear how much time this actually saves, but it can't hurt.

Hasfields tells generators to render fields. Without it generators render as if they had the fullframe attribute set.

Undocumented - found in Generator>More Bars & Signals.

Seems to suggest that it should not work if sequence is set to RGB rendering but this is not the case.

This seems to force a conversion to YUV space on entering the effect, as far as I can tell.

hasFields is having absolutely no effect on my generators that involve clips dropped into image wells. The output is still a horrendously muddy interlaced mess if the clip's scale is altered in any way.

Derek, check the first comment in getVideo. You need to send the GetVideo result into a full-height buffer, if you use the size of the interlaced clip FCP will smash the fields to fit into a half-height frame.

Undocumented as used on Color Corrector and Color Corrector 3-way.

Works on filters only and sets the default state of the filter's disclosure triangle so the parameters are hidden.