NULL OBJECTS REFERENCE

Naming Nulls
   
Because four different WaveFilter Image passes can be active in a single scene, you must prefix all Null Object names with the number of the WaveFilter pass you wish it to control.  You might want one set of Null Objects to work with WFImage-1 and affect only the background, while another set works with WFImage-2 and effects only objects.  For example:  WFImage-1 pass for the Bright% Null Object would be named "WF1Bright%", and control the Bright filter in the first pass of WaveFilter Image.  Any WaveFilter Null created in a scene must be named as listed, including case. See the NULL NAMES REFERENCE LIST below for name, control method and range.

Changing the Null Values
      By viewing your scene from the top with a 20x20 grid at a grid size of 10 you can control the Null Objects in a fashion similar to a mixing board. As you move a null across the screen, (greater X values) you get more of the selected effect. All Null Objects use the X axis value only and cannot be moved anywhere on the Z or Y axis without affecting the returned value of the null.

     When a Null Object is loaded, the associated value on the WaveFilter Image interface will be greyed and will not except changes. The value shown will be the position of the associated Null Object at frame zero. Deselecting “Animated Settings” under the "Preferences" menu will disable the use of Null Objects and once the interface is closed and reopened will except changes to all values.

     WaveFilter Null Objects are controlled by sliders.  Sliders move along the X axis and the X value is used for control.

Picture

NULL NAMES REFERENCE LIST

All references below display null names for the first pass of WaveFilter Image (WF1)
Null Names would be different with different passes.

Filter

Null Name

Control

Range

Blur

  WF1Blur%

 Slider

0-150*

Sharpen

WF1Sharpen%

Slider

0-150

Edge Blend

WF1EdgeBlend%

Slider

0-120

Edge Threshold

WF1EdgeBlendThreshold%

Slider

0-200

Saturation

WF1Saturation%

Slider

0-100

Negative

WF1Negative%

Slider

0-100

Palette

WF1Palette%

Slider

0-100

Grain

WF1Grain%

Slider

0-3000

Contrast

WF1Contrast%

Slider

0-5000

Contrast Center

WF1ContrastCenter%

Slider

0-255

Mid

WF1Mid%

Slider

0-500

Mid Center

WF1MidCenter%

Slider

0-255

Gamma

WF1Gamma%

Slider

0-250

Lum

WF1Lum%

Slider

-255-255

Bright

WF1Bright%

Slider

0-200

Red

WF1Red%

Slider

-255-255

Green

WF1Green%

Slider

-255-255

Blue

WF1Blue%

Slider

-255-255

*   The Blur% Null Object controls the amount of blur that will be applied.  With blur, often less is more.  Using low levels of blur also helps control rendering times. For this reason it is recommended to not apply a blur amount in excess of the range maximum, otherwise expect long render times.

     Special thanks go to Arnie Cachelin from NewTek for the idea of using Null Objects to add envelopes to plug-in parameters and Gary Baker for the idea of using a focal point null to control depth-of-field.