Settings and Macros

From VFXPedia

Jump to: navigation, search

Contents

Settings

Alexa Gamut Settings
This archive contains settings for the Gamut and Color Matrix tools that allow you to deal with ARRI's "wide RGB gamut" in earlier versions of Fusion (since 6.4 ARRI's color spaces are supported natively). The values are based on this whitepaper. The gamut conversion is supposed to be performed after the logC to linear conversion (see macro below), the film style matrix should be applied directly to the logC images. --Tilt


Background Gradients (Description)
Often used gradient settings. Simple but time saving presets useful when you create radial, vertical, spectrum and other gradients. It's not too hard to create a spectrum, but with a pre-generated setting it takes just one click instead of 19. --Gringo


Defaults (Description)
A collection of modified default settings for the most common tools. The tools are painted different colors according to their category and have more typical settings. Polyline isn't animated by default, Grain and ReelSmartMotionBlur correct their result according to the proxy mode, smoothing filter is Multy-box by default (faster than Gaussian and behaves better in the float point mode). Unpack the archive to your Fusion:\Defaults folder. --Gringo


Defocus Calculator
a defocs node with some additional user controls (filmback, fstop, focallength, focusdistance and object distance) which will calculate the circle of confusion in pixel for the given values according to the image size --michael_v


GamutFlasher
This saved group will flash any out-of-range colours, every second. Try saving it in your LUTS: folder, and use it as a View LUT!


Handheld Camera Shakes
Four real-life camera shake settings for the Transform tool (smooth, shaky and running motion) with matching Z rotation. Each track uses an XY Path so you can scale and shift the animation. --Tilt


HSV_View_LUT
This View LUT lets you easily display Hue, Saturation and Value of the image. Copy it to your Fusion:\LUTs, then select as the View LUT on the Display View toolbar. The LUT remaps HSV channels to RGB. You can also press Edit... to change the displayed channels set.--Gringo 11:44, 23 September 2009 (EDT)


InvertColor
You can put this setting file to the Fusion:\Macro folder to have fast access to the color inversion tool. --Gringo


LinearLight
This custom tool setting provides linear light blending mode like in Photo Shop.Handles alpha channel also.

Good example how to mimic blending modes from PS. --Ata 16:46, 24 November 2008 (CST)

note: it doesn't use transformations therefore it won't place your FG to the center of the BG


Polygon_Aspect
This setting lets you change polygon mask scale independently in X and Y direction. The new Aspect control works similarly to Transform's one: the less aspect, the less Y size. --Gringo 12:14, 26 October 2009 (EDT)


Rectangle_Frame_35mm
The mask which mimics 35 mm frame. Useful when you want to avoid CG objects overlap dark peripherals of a scanned frame. --Gringo 12:14, 26 October 2009 (EDT)


SE_Text_ShineOn03
A Text+ with some nice follower-animation on the letters. Enjoy.


Zebra LUT
A setting for a custom tool that will draw a zebra pattern in out-of-range areas (works for negative float values as well). Intended to be used as a View LUT.


Macros

AlphaEdgeCCv_v01-6 (Description)
Creates edges around objects based on the objects' Alpha. The macro gives you comprehensive control over the edges' shape, width, brightness, sharpness.

Useful for fixing keyed plates' problems and for creative tasks. --Gringo


diyAlphaEdgeFind
This is basically a "wrapper" for AlphaEdgeCCv (see above). I created it because that is my favorite method of finding edges and I wanted to make it more accessible to users who don't appreciate the unconvential UI of the original macro. However, if you want a more technical/detailed approach, go with AlphaEdgeCCv instead. --sh4dow


diyPremultiply
For premultiplying without having to change a single parameter anywhere. --sh4dow


diyUnpremultiply
For unpremultiplying without having to change a single parameter anywhere. --sh4dow


Grain
A grain macro to replace the grain tool. Works at all sizes of grain and has nice highlight and shadow correction options. Use this one in 5.3 b66. By Kasper Oerlemans nov. 2008.


Grain Fu5.3 b55 and below
A grain macro to replace the grain tool. Works at all sizes of grain and has nice highlight and shadow correction options. Use this one in 5.3 b55 and below. By Kasper Oerlemans nov. 2008.


ImageMixer_v03 (Description)
Mix a foreground image into a background using curves. This basically provides the functionality of a tool's "Blend" or "Dissolve" slider split into separate channels and based on a channel's brightness. It can be used to add the spread curves back to the new Film Grain node or to add grain from a scanned gray card. --Tilt


Mosaic Filter
A simple but effective Mosaic filter which also allows for individual X/Y Mosaicking. Along with a custom icon for your bins. --SirEdric


MultBG
Unpremultiples FG based on BG image, handy when you get CG passes thats been premultiplied with a background. (needs fg+alpha and rgb background)


Light Wrap
A Light Wrap Macro that only requires a foreground and a background image, with a few extras such as glow and blur for fine tuning of the effect, made in Fusion 5.3 --Linda


PG Light Wrap
A simple Lightwrap Macro. Requires an alpha source, a source to "light" and a source that is "to be lit".


+renderComplete (alternative sound notification)
Once render is finished, it will play specified WAV sound as notification to the user (including 7 royalty free high-quality sounds). For Fusion 5.3, RenderNode and above. --Ciril


Shake to Fusion macros by Shaily.
This macro collection contains some macros that mimic Shake nodes like AddMix, Clamp, ColorWheel, Compress, DepthSlice, Emboss, Expand, Fade, Invert, MMultiplyDivide, Orient, Pixelize, PlotCurve, Rand, RGrad, Set, ShearTaper, Solarize and Threshold (Pigsfly link)
Download for Fusion 5.2
Download for Fusion 5.3 and later


Smooth ErodeDilate (Download)
This macro uses two ErodeDilate tools to give a much smoother transition between settings.


Switch (Download)
A node that can switch between two inputs while preserving the DoD.


SwitchProxy (Download)
A node that can switch between Full resolution and Proxy inputs automatically or manually. Preserves DoD.


Switcher (Download)
This is a very simple macro to switch between background and foreground inputs. It renders only the branch that is selected.


Switch8er (Download)
This is a slightly fancier macro to switch between up to 8 different layers. It also renders only the branch that is selected.


UnMerge
A handy macro to "unmerge" a foreground from a background, if you have the foreground alpha. Works with solid colour backgrounds or a clean background image, but requires same-size images.


3D

AnimationGhosting3D_v03 (Description)
A tool to show animated objects' trajectories in 3D environment. --Gringo


Distance3D_v01-3 (Description)
Measures the distance between two 3D objects. --Gringo


Tube3D_v01-4 (Description)
3D tube primitive with thickness and a possibility to create a slice (sector) for Fusion 6.0 and above. --Gringo


Relighting

P_N_Light download (Description)
this macro lets you pick on position and normal passes to relight. It is a tiny predecessor of the volume tools. it works in versions prior to 6.2 though. --Nebukadhezer


WPPConverter_v02 (Description)
This macro converts world position passes rendered by 3D Studio Max (using a Z-up coordinate system) to Fusion's Y-up system. This is needed if you want to combine them with data from Fusion's 3D system or pick a 3D position from the WPP. --Tilt


WPPNoise_v02 (Description)
This macro creates a perlin noise texture based on the world position pass data of an image. This means that the noise will stay attached to your geometry while the camera is moving. Useful to roughen up the edges of a mask created by the Volume Mask tool. --Tilt


Analyze

GradientSlice (Download)
Image edge colour profiles can be easily viewed as histograms with this Gradient Slice macro.


ColorRange_v06-1 (Description)
Color Range Analyzer. Shows minimum and maximum color values of an image, graphically indicates out-of-range areas. Useful to detect color clipping: if minimum value = 0, black clipping occurs; if maximum value = 1, there is white clipping.
If you want to calculate the minimum or maximum of a whole sequence, connect the Trails tool after the sequence, set the Apply mode = Minimum or Maximum correspondingly, render the sequence and connect the macro after the Trails. --Gringo


ColorSampler_v04-3 (Description)
Lets you analyze color of any rectangular area or a point. The macro outputs Minimum, Maximum or Average RGB and Luminance values. Based on the Simple Color Picker macro by Stefan Ihringer.
To place several samplers on a single image just connect several nodes of the macro one by one. --Gringo


Analyzer_3d download (Description)
It is basically a particle system that represents all kinds of Values on the Z Axis. You can either display RGBA, Saturation or Luminosity. It helps to find high float values easily. --Nebukadhezer


TapeMeasure_v07 (Description)
Measures the distance between two points on an image in Fusion units and in pixels. Measures angles. Displays the image aspect. Converts distances from pixels to Fusion units. --Gringo


Blur

BlurWithinMask_v02-3 (Description)
Blurs an area of the image without color spill from outside of the mask. Useful to cleanup smoothly colored areas within contrasty borders --Gringo


DefocusGamma_v02-3
This macro allows to make correct defocus on sRGB (not true-linear) images. Note that it sets color depth to 32 bit by default to avoid banding. You can restore the color depth to initial state using the ColorDepth tool right after the macro's node. Tip: the higher "Image Gamma" you set the more visible "irises" are. --Gringo


DepthDefocus_v07-4 (Description)
Applies the depth of field effect using a depth map. For Fusion 5.3 and above --Gringo


DirectionalBlurGamma_v02
Similar to the macro above. Allows to make correct motion blur on sRGB (not true-linear) images. --Gringo


DirectionalBlurFromPath_v02-7 (Description)
Applies simplified motion blur, calculating its power and direction from a path animation. --Gringo


EllipticalBlur_v05-3 (Description)
Creates elliptical blur effect with adjustable aspect and angle. --Gringo


ExponentialGlow_v01 (Description)
This macro creates photorealistic glow with a nice exponential falloff. --Tilt


MotionVectorsCorrection_v01-3 (Description)
Lets you modify motion vector map in case the position of your 3D-object is animated in 2D with tracking or other kind of 2D-animation to achieve correct resulting power and direction of the motion blur. --Gringo


RefBlur
Creates motion blur based on the animation reference connected to the Center, Pivot, and Angle fields. --Kramester


SE_DarkGlow
SE_DarkGlow is so to say an 'inverted' softglow. It 'glows' the dark areas of an image, leading to blurred and deep shadows. Could be used to achieve some kind of 'special film look'.


SE_SpaceGlow
Another 'abused' SoftGlow. The image gets converted to a user-selectable colorspace,
and selected channels can be glowed. Really nice for glowing S in HLS only, for some fancy 'musicvideo effects'. Just give it a play....;-)


Color adjustments

AlexaV3LogC
Turns footage shot in Alexa's logC into any other color space and back. For conversion to and from linear, chose "No Change" in the gamut dropdowns. Created by Jaist (pigsfly forum). Also available as a viewshader fuse. Note: Fusion 6.4 has native support for logC in its CineonLog tool or dpx loader settings.


bfHDRView
fHDRView 0.9 visualizes floating point High Dynamic Range values above 1 and below 0 as map or normalized values. (Sep 2008 by Blazej Floch)


bfNormalize
fHDRView 0.1 Does the same as the Normalize Button/AutoGain but has a SourceTime slider. (Jan 2012 by Blazej Floch)


Clipper (Download)
Simple & fast macro to clip pixel values without affecting other pixels.


ColorFill_v03-0 (Description)
Fills the selected area of an image with a solid color, considering the source alpha. --Gringo


ContrastAroundColor_v03-2 (Description)
This macro lets you pick a color from the image and adjust the contrast, preserving the luminosity, hue and saturation of the sampled area. As an option, you can set different contrast for the color channels. --Gringo


Copy Aux Light
A channel boolean which uses channel sets instead of seperate channels. It was build similar to Dimension's CopyAux but it is less smart - no automatic depth conversion, no remapping, no fallback on missing channels: Short a shortcut channel boolean copy mode. (May 2012 by Blazej Floch)


diyClampRGBA_v2
Simple clamping macro with adjustable values (default 0-1 for RGBA). Alpha can be included or excluded. --sh4dow


diyNormalize
Normalizes RGB channels like viewports are able to (from whatever range to 0-1). With the difference that it respects premultiplication by default (can be switched off), meaning e.g. empty space will not be touched. Normalization of alpha (if one chooses to do that) is done separately from the color channels. --sh4dow


GradientMapper (Download)
Map colours from a gradient to an image, using various channels and with optional noise.


HueCCv_v1.1 (Description)
Hue Color Curves macro v1.1 - Adjust Hue/Luminance/Saturation with selective Hue curves.
v1.1 release notes (2009.08.14): - fixed effect masking; - fixed HUE offsetting to negative --Ata 19:26, 13 August 2009 (EDT)


InvertedBC_v01 (Description)
Reverts to original image color after the Brightness/Contrast tool applying. Just connect it's parameters to the corresponding parameter of your BC tool or enter the same values. For Fusion 5.21 and above. --Gringo


JoshPinesLogLin_v02 (Description)
A log-to-linear conversion (and vice-versa) that uses a formula developed by Josh Pines instead of the regular Cineon curve. It won't produce any negative numbers. The formula can be found on the OpenEXR list. Note: Fusion 6.4 has added native support for this formula to its CineonLog tool. --Tilt


LuminanceControl_v01 (Description)
Lets you modify the luminance of the image preserving it's saturation. This can be really important if you have approved colors in the image, but want to change the contrast. It can also help you bring a stylish look to a picture simulating the bleach bypass effect. --Gringo


LustrePrimaries_v02 (Description)
A macro that allows you to transfer a primary correction done in Lustre(R) to Fusion. Usually exported via merry.grade files, simple text files where red, green and blue corrections are expressed in percentage values (e.g. "BLUE: +9.77% (+0100 code values)" = add 0.0977 to blue channel in log space, the macro itself doesn't do any log2lin/lin2log conversion) --Tilt


OKShuffler_v1.1 (Description)
OpenKAK Shuffler, a helper tool for KAK. --SecondMan


Posterize
Create a Poster-Effect or Stepped output. (June 2012 by Blazej Floch)


PrimaryGrade_v06-6 (Description)
Allows you to set the Black and White point of an image simply by picking the colors from a reference or by using color wheels. Separate color wheels adjust Brightness and Gamma. There are also controls for Saturation, color range clipping and options allowing to work comfortably in linear space. --Gringo


ScaleZ
Is your depth buffer the wrong range? Rescale it to any range you like with ScaleZ.


SelectColorRange_v02-6 (Description)
SelectColorRangeGradient_v01-2 (Description)
Two macros for selecting a color range by Hue or Lightness, Saturation, R, G, B, A values. The same aim but different controls: ranges and sliders in the first case and a gradient control in the last (for more complicated cases). --Gringo


SigmoidalContrast_v02 (Description)
Applies a soft S-shaped ("sigmoidal") contrast curve to an image using just two parameters: a midpoint (0.0 - 1.0) and a contrast factor (0 = none, 20 = strong). This is similar to the Rolloff Contrast tools in Shake or Nuke. More information can also be found at [1] (the formula mentioned there is a bit incorrect though). --Tilt


SoftClip_v01-2 (Description)
A macro to gently clip superbright pixels to the 0..1 range. --Tilt


Soft Clip 3 (Description)
A macro that compress images above a certain threshold with a logarithmic function for each channel. There is a multiplier that allows you to compress more or less.


SubtractBGColor_v01-1 (Description)
Removes unwanted BG color from the edges and semi-transparent areas of CG images when they are rendered not against black. --Gringo


TMIColor_v02-2 (Description)
This macro allows you to adjust the color temperature and green/magenta tint of an image using the TMI system from Nuke's color picker. Only valid in a linear color space. --Tilt


Toe_v02 (Description)
This macro allows you to brighten the shadows of an image. Contrary to the lift operation that is found in the ColorCorrector, Toe only affects the bottom of the histogram. --Tilt


ASC CDL color correction
Provides a UI for ASC CDL 1.2 style color corrections --michael_v


Design, Adding New Elements

2d Deity
Creates an on-screen deity "effect" using polyshapes. Based on the research papers from Bobby Henderson.


BorderMaker (Download)
Quick and easy Border Maker macro for motion graphic projects. --Drswoboda


Dailies_mov_v16-1 (Description)
Allows to convert 2K or other hi-res compositing to PAL (or NTSC and others) for reviewing purposes, applies letterbox with additional info and zero-frame (slate). For Fusion 5.3 and above --Gringo


Ramp_v01-3 (Description)
Draws a simple gradient directly on top of an image without the need to create a BG tool and merge it. The macro also allows you to smooth the ramp as well as draw a "perceptively linear" gradient that only looks linear under an sRGB viewer LUT. --Tilt


SE_Spiral3D
Have you ever wanted to create a Spiral in Fusions 3D space? Easy. Here you go.


SimpleVignette (Download)
Just a simple Vignette effect


VoLight (Download)
A Volume Light macro akin to Shine and SimpleRays. Fast & customisable. Credits to Theodor Groeneboom.


Keying and Despilling

3D Keyer_v02 (Description)
The 3D Keyer treats an image as points located in a three-dimensional space and creates a matte based on the distance of each pixel from a reference color. This can be done in a variety of color spaces (RGB, HSV, YUV,...) and by using two different formulas for the distance calculation (the "Manhattan distance" or the Euclidean distance). --Tilt


BlurredEdgesRestoration_v04-2 (Description)
Lets you restore the color information lost in defocused or motion blurred areas, especially if the source has parasite edging around the objects. --Gringo


Despill Keep Luminance
This .setting file is a collection of nodes, not a full macro. It demonstrates how to restore the luminance that is lost during the despill operation. Use this technique if your foreground element has a dark fringe when placed over the background plate. --Tilt


KAK_v2.5 (Description)
The Kick Ass Keyer. Originally inspired by the IBK, but still sucks less. :) --SecondMan


SpillMerge_v01 (Description)
A despilling/keying macro that will save your butt in situations where a blue/green screen is heavily tainted by dirty, icy or highly reflective windows as well as smoke or glow around fire and explosions. --Tilt


Matte Editing

diyEdgeBlur
Simple edge blur with the option to fine-tune inwards/outwards dilation and how strong the edge inside of the matte should be blurred. --sh4dow


diyEdgeTool_v2
A collection of common edge manipulations, in the vein of matte tools contained in the Sapphire or Tinderbox plugin suites. --sh4dow


Texture Creators

SE_GridMaker
This one just creates a grid of lines with selectable width, height and number of lines. Nice when used as a map in 3D to fake 'wireframe rendering'.


Checkerboard (Download)
Creates a simple checkerboard.


diyCheckerBoard
In contrast to the macro "Checkerboard" above, which uses size/aspect to define field size, this one is controlled by defining the amount of X/Y-repetitions and whether the fields should be square or non-square. It also uses frame format settings by default. --sh4dow


CheckerSoft_v03-2 (Description)
There are several different ways to create the checker texture. This one lets you set softness of the checker. --Gringo


AdvancedGrid_v02-2 (Description)
A grid generator where the grid pattern can be defined using gradient controls. --Gringo


ColorBars_v02 (Description)
PAL and NTSC color bars generator. --Gringo


Transformations & Warps

AdvancedCameraShake_v05-2 (Description)
Produces more complex and natural-looking motion than the standard CameraShake. The tool performs automatic upscaling to avoid black edges and additionally offers all the controls of the Transform tool. --Gringo


CropAndReplace (Download)
Simple macro for animated crop. View upstream tool to set center and size. Always rounds to whole pixels. Option to set size to multiplies of 8 (some progs like it). If you need to paste cropped region back to original, just wire it to second input and check replace. Can be also used as poor mans DOD.


Nudge_v0.0.7 (Description)
A simple yet handy warp tool that displaces pixels from a source to a target point, within a user definable range. A series of them may be concatenated to avoid softness due to successive filtering. --SecondMan


Refraction_v06-7 (Description)
A macro to simulate the refraction effect. Unlike the Displace tool it doesn't need a center. Pixels are being shifted from the bright areas of the refraction map to the dark ones. --Gringo


Tiler (Download)
This macro tiles an image repeatedly into a larger image.


Turn_v03 (Description)
Rotates the input image by 90, 180 or 270 degrees. Useful if you bring in images from a stills camera that have been shot in portrait aspect. Updated 2011-04-28: Now works in proxy mode. --Tilt


UVLensDistortion_v02
Applies lens distortion or any other distortion to the image according to a UV map stored in an external file. --Gringo


UVPositioner_v04-3 (Description)
Works like the conventional Texture tool, but supports Alpha and different tiling options. It also offers the UV channels selection. --Gringo


Particles

pImageManipulate
A macro that gives you extra control over your particles. Uses RGB images to control the rotation, scaling, velocity and position of the particles with images. pImageManipulate image example and pImageManipulate example comp By theo (www.euqahuba.com)


SE_FastSmoke(macro) and SE_FastSmoke.comp
The macro FastSmoke is nothing but an easy-to-use smoke-particle-generator I used many times...
The attached FastSmoke.comp shows how to use it and how it was done.


pRandomizeInitialPosition
Randomizes particles' X, Y and Z initial position. --Gringo


Stereoscopic

Floating Window (Download)
Allows to manipulate with the stereoscopic floating windows.


Macro Tips

How to create a macro

Select a group of tools, right-click on one of them, and choose Macro -> Create Macro... from the context menu. A dialog will open allowing controls to be selectively exposed. Default values and control ranges can also be changed. Save the macro from the dialog's File menu.

More details are given in the Fusion manual, in the Advanced/Macros chapter.


Macro Tutorial

This video shows how to create a macro that allows to add 3D noise to an image with a World Position Pass. Also learn about how to add custom sliders to any tool in Fusion using the User Controls script. Watch it on YouTube.



How to install a downloaded macro

Simply put the downloaded .setting file to your Fusion:\Macros folder and access the new tool via Fusion's Tool menu > Macro. You can also drag and drop the .setting file directly to the Flow view to add it to the current composition. If you want the composition to be opened somewhere else, you don't need to install macros on other machines, the complete macro body is stored inside your composition.

How to examine a macro's internals

Remember, you can examine the internals of any macro by pasting or loading it into a text editor and trimming away everything except the inner "Tools = ordered() { .. }" table, then putting a pair of curly braces "{ }" around the lot. It should look something like this:

 {
    Tools = ordered() {
      ...                   -- all tools go here
    }
 }

It's now a standard Setting file. You can save it then drop the file on the flow, or copy all the text and paste it in directly (if you're using Fusion 5.1 or later).

Macro Groups

An easier method is to replace the first instance of "MacroOperator" in the .setting file with the text "GroupOperator" to change the Macro into a Group.

For example, changing the top three lines in the Checkerboard macro:

{
	Tools = ordered() {
		CheckerPlusPlus1 = MacroOperator {

to

{
	Tools = ordered() {
		CheckerPlusPlus1 = GroupOperator {

and dragging the macro file into the flow view would result in a macro (complete with exposed controls) that can now be opened up and edited like a group.

After that, a new version of the macro can be saved using RMB>Settings>Save as... to the Macros folder

This trick can also be useful if you want to make a macro with some basic controls exposed, but that can still be opened and edited by advanced users.

Custom Icons for Macros

You can add a custom icon to be displayed in the Bin window for your macro, saved settings or group, or any .setting file. Create a 160x120 BMP image file in the same directory as the .setting file, with the same name & .bmp extension. Other sizes are allowed, though 160x120 is recommended. [[Image:File:Example.jpg]]

Macro Structure

Have you ever tried to tune your macros in a text editor? You definitely should, because it gives you many extra capabilities, unavailable in the Create Macro dialogue. After the macro is created, find its .setting file in your Fusion:\Macros folder and open in SciTe or any other text editor. This example of internal macro structure can be helpful: Macro Structure

Tabs in Macros

You can create multiple tabs for macro controls to make the interface of complicated ones more readable and convenient. Open the macro in a text editor and add Page = 'Tab page' to one of the macro's inputs. That will put it and all the following inputs on that tab until you give it a new page. This example will create a "Common Controls" tab for the blend slider:

	Blend = InstanceInput {
		SourceOp = ...,
		Source = ...,
		Page = "Common Controls",
		Default = ...,
	},

Macro Help URLs

Starting with Fusion 6.31, you can add URLs (for example to a page here on Vfxpedia) that are launched when the user presses F1 while the macro is selected. In fact, this works with any tool. Open the macro in a text editor and add this CustomData subtable within the MacroOperator-table:

	CustomData = {
		HelpPage = "http://www.vfxpedia.com/",
	},

A help link like this can be added to any tool in your flow using the tool's SetData() scripting method.

User Controls in Macros

Usually, you create macros by publishing existing controls of tools inside your macro. The next step for spicing up a macro is the addition of user controls via the User Controls tool script. These controls can either be added to a single dummy tool inside your macro or scattered amongst the tools that are related to the user inputs in question. A comprehensive overview of user controls is available here.

There's a third solution: once you have added a macro to the comp you can use the User Controls script on it as well (or copy them from somewhere using a text editor). These controls can be accessed by tools inside your macro using simple expressions. The prefix to reference them is the macro's name. If you add multiple instances of your macro to a comp and they are being renamed (e.g. MyMacro_1, MyMacro_2, ...) Fusion will automatically adjust the expressions. This poses an obvious workflow problem: How can you test your comp before turning it into a macro when the expressions needed are referring to a macro that doesn't exist yet? The solution is to use a dummy tool for user controls that won't be included in your final macro. Or you can simply move user controls between tools using a text editor, adjusting the simple expressions inside the "source code" of your macro as you go. The KAK and SpillMerge macros employ this technique.

Creating Switches

Inside a macro, you can use Fusion's Dissolve node as a switch between two inputs. Add an expression to the Mix slider which connects to a checkbox or multibutton control (you can create them via the User Control script). An enabled checkbox has a value of 1, a disabled one returns zero. Just what you need to toggle between background (zero) or foreground (one). If a user control checkbox has been added to the dissolve tool itself - let's call it "Enabled" for example - just type "= Enabled" into the background-foreground mix input. This will create the required expression for you. You would then publish the checkbox in the macro creator dialog, not the slider.

If you want to have multiple choices, you need to chain multiple dissolve tools. The first one will get an expression like "= (Option == 1) and 1 or 0", the second one "= (Option == 2) and 1 or 0" and so on. Option is the name of a multibutton or combo control widget which returns the selected option as a number starting at zero for the first option.

External Links

http://vfxpedia.com/index.php?title=User:Gringo - macros by Gregory Chalenko aka Gringo

http://www.bildfehler.de/fx/fusion5.html - macros by Stefan Ihringer aka Tilt

http://www.svenneve.com/?page_id=383 - macros by Sven Neve aka Redoddity

http://www.euqahuba.com/tools.html - macros at Theodor Groeneboom's site aka Theotheo

Personal tools