Tinderbox4-2 1v1
Tinderbox4-2 1v1
tinderbox
User Guide
No part of this manual may be reproduced, stored in a retrieval system, or transmitted in any form without the prior
written permission of The Foundry.
The Foundry logo is a trademark of The Foundry Visionmongers Ltd. After Effects® is a registered trademark of
Adobe Systems, Inc. All other products or brands are trademarks or registered trademarks of their respective
companies or organisations.
Software engineering Andy Whitmore, Lucy Hallpike, Bruno Nicoletti, Ralph McEntagart, Phil Parsonage.
Contents
Attenuation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Source Crops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Matte Layer Crops. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Tinderbox 4 T_Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
T_BleachBypass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
T_Cartoon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
T_Channels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
T_Colourist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
T_Convolve. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
T_Fire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
T_Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
T_InfiniteZoom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
T_Kaleid. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
T_LightWrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
T_LineDrawing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
T_Median . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
T_MuzzleFlash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
T_Quantise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
T_Rain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
T_Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
T_Snow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
T_SoftGlow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
T_Water . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Introduction
About this User This User Guide tells you how to install the plug-ins and
Guide remove the watermark with a license key. It gives
information on each of the plug-ins in this set with hints
and tips at the end of most plug-ins to suggest creative or
practical uses of the effect.
Activation via Once you have installed Tinderbox from the CD you will
Internet need to activate the product. Successful activation gives
you a license key that unlocks the software. Activation can
be done automatically via the internet or by telephone.
1. Start After Effects.
2. Apply a Tinderbox plug-in to a layer in a composition.
3. Press the About button (Figure 2) and make a note of your
Figure 2. About.
Figure 4. Options...
5. This launches a web browser. Check that the lmhostid shown on the
web page is correct. If it is not, or you wish to activate for a
different computer, follow the on-screen instructions.
6. Type your serial number into the box provided. You can find your
serial number on a sticker in the DVD case. Make sure you type it
in exactly as shown.
7. If successful, you will be given a license key. It’ll look a bit like
this:
INCREMENT tinderbox4_ae_i foundry 2.1 permanent \
uncounted HOSTID=000b957bfdf4 START=13-aug-2006 \
SIGN="0170 13D4 3659 2FC0 CCA4 1B88 0799 5D27 \
A73A ECE0 DE03 EAA3 1AF8 D98C EC7A 972A 19E3 \
7E20 AE1F 4D3B 3623"
8. The license key is put in a text file for you. Save this file in the same
directory as your plug-ins. On Mac this is usually /Applications/
Adobe After Effects 7.0/Plug-ins/Tinderbox4-2.1/ and on Windows
it is C:\Program Files\Adobe\Adobe After Effects 7.0\Support
Files\Plug-ins\Tinderbox4-2.1\
Note There are other places you can put your license file. See “Alternative
license directories” on page 12.
9. That’s it!
Figure 5. Help.
Where does the A Tinderbox 4 license key that unlocks the plug-ins on a
license file go? machine with lmhostid = 000b957bfdf4 will look a lot like
this:
INCREMENT tinderbox4_ae_i foundry 2.1 permanent \
uncounted HOSTID=000b957bfdf4 START=13-aug-2006 \
SIGN="0170 13D4 3659 2FC0 CCA4 1B88 0799 5D27 \
A73A ECE0 DE03 EAA3 1AF8 D98C EC7A 972A 19E3 \
7E20 AE1F 4D3B 3623"
This license key should be put in a text file. You can type
the key into a blank file using TextEdit (Mac) or Notepad
(Windows). If you have been emailed a license key you can
cut & paste it into a text file or you may have downloaded
your license key file from the web site after activation. Any
of these methods will work. The really important bit is that
it should be called foundry.lic and saved in the same
directory as your Tinderbox plug-ins as a plain text file (not
rich text).
Mac
If you’re on a Mac this is where the license file should go.
/Applications/Adobe After Effects 7.0/Plug-ins/
Tinderbox4-2.1/foundry.lic
Windows
If you’re on Windows this is where the license file should
go.
C:\Program Files\Adobe\Adobe After Effects 7.0\Support
Files\Plug-ins\Tinderbox4-2.1\foundry.lic
Alternative license There are other directories that are scanned for license
directories files. This can be useful for large post houses that have
centrally managed license servers but will not be necessary
for most customers. These directories are:
On Windows:
C:\Program Files\The Foundry\FLEXlm
Can I install Tinderbox You can install Tinderbox on as many machines as you
on more than one like, but a watermark will be drawn over the image if there
computer? isn’t a valid license key for that machine.
Figure 12. Don’t put the foundry.lic license file in the After
Effects Plug-in Directory.
Error Log Files If a plug-in fails to get a license the incident is recorded in
an error log file. The time, date and nature of the problem
are appended to the end of the file. The error file on Mac
OS X is:
/usr/local/foundry/FLEXlm/license.log
Tip On a Mac you can’t use the file browser to directly navigate to the log
file. Instead use a Terminal or the Go to Folder... (Shift-Apple-G)
button.
Buy a License Key Contact The Foundry and buy a Tinderbox 4 floating
license for 5 machines that will run on a server with
lmhostid = 000EA641D7A1.
Configure the Server On the server (whose machine name is Red), download and
install the Foundry FLEXlm Tools.
Take the license key you bought and put it in a text file
called foundry.lic in the directory /usr/local/foundry/
FLEXlm. Here’s that license key.
SERVER Red 000EA641D7A1 300001
VENDOR foundry
Configure the Clients On each of the 5 render engines, install the Tinderbox 4
plug-ins. Then create a license file called foundry.lic in the
directory /usr/local/foundry/FLEXlm that has the first 2
Tinderbox Controls
values.
Options... Options will launch a web browser to get a license key for
the plug-ins. See “Activation via Internet” on page 7.
Type Each of the plug-ins listed in the next chapter has a type
description of blur, effect, tool, generator or warper. This is
to help you quickly understand the general nature of the
filter.
Figure 21. T_Blur Aspect = 100. Figure 22. T_Blur Aspect = -100.
Pixel Aspect Ratio Tinderbox plug-ins will automatically compensate for the
Pixel Aspect Ratio set under Composition Settings and in
the Viewer Options.
Ignore Transparent If you’re wondering what this handy switch does then read
Pixels on.
Changing a Colour Select a tag by clicking on it. Click on the colour box
(labelled Edit in Figure 33) to launch the After Effects
colour dialog.
Deleting a Colour Click and drag a tag into the colour gradient.
After Effects Model Has four light types, parallel, point, spot, ambient.
Type
• None - no lights are used. Lighting parameters are
switched off.
• Host - uses the After Effects light. If more than one light
is in the composition, the top layer light is used.
between the image plane and a line from light source to the
image centre.
Diffuse Lighting Dull surfaces scatter light equally in all directions so that
the surfaces appear to have the same brightness from all
viewing angles. These surfaces exhibit diffuse reflection.
Method - sets how to blend the output image effect with its
original source image by the amount set in the blend
control.
• None - no blending is applied, only the output image is
returned as in Figure 52. Blend, Effect Gain and Source
Gain have no affect when in this mode.
• Mix - blends the source and output images.
• Add - adds the source and output image pixel values.
• Difference - the absolute value of the source image
minus the output image. Similar colours will return
black pixels.
Matte The way the Matte and Matte Layer parameters work are
common to many plug-ins and are described here.
So the important bit is that if you pick Source you get the
current layer with any effects applied, and if you pick
Matte Layer you get the image specified below with no
effects applied.
Matte Layer Matte Layer - the layer used if Matte is set to Matte Layer
Luminance, Matte Layer Inverse Luminance, Matte Layer
Alpha or Matte Layer Inverse Alpha.
• None - no layer is specified and none used.
• 1. Layer - this layer is used as the Matte Layer.
• 2. Layer - his layer is used as the Matte Layer.
Source Crops Many Tinderbox plug-ins require access to pixels that lie
off the edge of the source image. For example, T_Blur
needs to use pixels off the sides when blurring at the edges.
Figure 62 shows black pixels being dragged in from the
Figure 62. Look at the border. Here the Edge Method = Colour.
Edge Methods The edge methods control the behaviour of the image at the
crop boundaries. This is usually at the edge of the
composition but can be brought into the picture with the
Left, Right, Top and Bottom crop tools. The left and right
edges can have a different edge method from the top and
bottom.
Matte Layer Crops This is only available where there is the option of selecting
a Matte within a Tinderbox plug-in. Matte Crops work in
Tinderbox 4
T_Bars
Type Generator.
Controls
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
T_BleachBypass
Type Effect.
Controls
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
Examples Here are two more images showing the look you get with
T_BleachBypass.
T_Cartoon
Type Effect.
Controls
Figure 76. Min. Region Size = 1. Figure 77. Min. Region Size = 10.
Figure 79.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
T_Channels
Type Tool.
Controls
• Multiply
• Divide
• Difference
• And
• Or
• Xor
• Lighter
• Darker
• Minimum
• Maximum
• Screen
• Overlay
• Hard Light
Colour Space It’s worth noting that After Effects always displays the
Controls three channels natively as RGB, so the immediate look of
your image may be somewhat odd. But it allows you to
operate on the image in a particular colour space, then
return back to RGB. For example, to desaturate an image
you could apply T_Channels to convert from RGB to HSV,
then decrease the value of the second (green) channel, then
convert from HSV back to RGB. T_Channels can be used
to decrease the value of a single channel and clamp the
result. One workflow for operating in a comp of a different
colour space is to apply a guide adjustment layer to the top
Rewire Channels Set Red to Source’s - drop down menu which allows you
Controls to specify what should go into the output image's red
channel from a list of prime and derivative channels taken
from the input image.
Set Channels Layer 1 - drop down menu to select the source for the
Controls: output image's red channel.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
HSV Colour Space The H(ue) S(aturation) V(alue) model was described by
Alvy Ray Smith in 1978 to represent colours more
intuitively than by the selection of red, green and blue. It is
sometimes known as HSB (Hue, Saturation and
Brightness).
HLS Colour Space This is the H(ue) L(uminance) S(aturation) model. You
should note that HLS is symmetrical to lightness and
darkness which is not the case with HSV.
YUV Colour Space The YUV model defines a colour space using a luminance
channel (Y) and two chrominance channels (UV). The
luminance is formed from a weighted average of the red,
green and blue components as shown in Equation 1.
Y = 0.299 R + 0.587 G + 0.114 B (EQ 1)
T_Colourist
You may need to fix an image whose black levels are not
neutral or white levels that are slightly tinted. This plug-in
has been designed to help with these kinds of problems.
Type Tool.
Controls
Analysis Mode
• Always - this will consider the pixels of each frame
before applying corrections. This will smooth out
(deflicker) luminance fluctuations in a clip.
• Specified - this will colour balance frames but preserve
any luma variations in the clip.
Figure 90. Source Image. Figure 91. Auto White Grade and
Auto Dark Grade.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
T_Convolve
Type Effect.
Controls
Show
• Result - renders the convolution.
• Kernel - displays the kernel used.
Scale - the size of the kernel. For your own pictures keep
the image small. Switch Show to Kernel so you can see
what you’re doing.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
Hints & Tips See Tinderbox 4 T_Snow if you want to try the examples
above. Small kernels will give sharper results.
T_Fire
Type Generator.
Controls
Particle Size - the size of the particles that form the flames.
Glow Size - the size of the bright glow around the flame.
Wind Two wind fields are supplied that interact with the flames.
to uniform.
Breaking Allows for smaller flames to break away from the main
flame.
Colours Controls for the flame colours. The flames are coloured
with a colour gradient made from three colours (bright,
mid and dark) as well as a glow colour.
Glow Colour/Alpha
Bright Colour/Alpha
Mid Colour/Alpha
Dark Colour/Alpha
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Hints & Tips Have a look at Tinderbox 4 T_Rain if this fire gets out of
hand.
T_Flow
Type Effect.
Controls
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
T_InfiniteZoom
Controls
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
Hints & Tips See also Tinderbox 1 T_Pattern for more conventional
transition effects.
T_Kaleid
Use the prism group controls to position the prism for the
final output, then from the Image group, switch on Show
Source Image and move the image under the prism until
you’re looking at the bit you want. Switch off the Show
Source Image.
Type Effect.
Controls
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
Hint & Tips It’s worth repeating this. Use the prism group controls to
position the prism for the final output, then from the Image
group, switch on Show Source Image and move the image
under the prism until you’re looking at the bit you want.
Switch off the Show Source Image.
T_LightWrap
Description You may have noticed that objects filmed in front of very
bright backgrounds have the appearance of softened edges
as the light spills round from the background. When adding
foreground layers onto a background plate, introducing
light wrap can dramatically improve the quality of your
composite.
Type Effect.
Controls
Output
• Wrap Only - renders just the light wrap.
• Wrap On Black - renders the light wrap composited on
black. This can be a useful tool to see what’s going on
before switching to Blend with Source. See Figure 119.
• Blend with Source - composites the light wrap over the
foreground.
Blending How to mix between the source image and the effect. You
can use this to further boost the brightness of the light spill.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
Hints & Tips If you find that the light wrap does not line up with the
foreground as expected, then you should pre-compose the
foreground and/or background layers.
T_LineDrawing
Description Creates line drawings from images. Edges are detected and
splines drawn along them.
Type Effect.
Controls
Figure 131. White lines on grey. Figure 132. Red lines on blue.
lines.
Zigzag The lines can be made to turn alternately from right to left.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
Hints & Tips See also Tinderbox 1 Etch and Tinderbox 2 T_Contour.
T_Median
Type Tool.
Controls
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
Hints & Tips Large radius values in T_Median remove detail giving a
smooth painterly look. It’s a bit hard to see but Figure 153
and Figure 154 show the effect. Figure 155 shows the
T_MuzzleFlash
Quick Start Switch your project settings to frames. It’ll be easier if you
do. Shuttle through your clip until the point at which the
gun is supposed to fire. Select the Muzzle Position tool and
click on the end of the gun. Set the Trigger Frame to the
frame you’re on. Choose a Gun Type that most closely
matches the gun fired. Tune the look with the Flash group
parameters. Now use the Muzzle Elevation and Rotation
parameters and align the flash along the gun barrel. Render
the sequence.
Controls
Muzzle Flash Offset - moves the flash away from the end
of the gun in the direction of the muzzle flash.
Flash Controls for the shape and colour of the muzzle flash.
Flash Noise - the image noise in the flash (not the sound
of the gun firing). This breaks up the edges giving a more
smoky look. This essentially scales the Noise Detail
parameter.
Suppressor Flashes Some rifles, like the M16, have angled flashes from the
barrel. These suppressor flashes are controlled here.
Trigger Controls for firing the gun. All gun types, except the M16,
are single fire guns controlled by the Trigger Frame
parameter. The M16, which fires a burst of bullets, is
controlled by the Rapid Fire parameters.
Noise Detail - the base level noise that breaks up the light
flash. You do not normally need to adjust this.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Hints & Tips Here’s a picture of the engineering team doing some
“research”.
T_Quantise
Type Effect.
Controls
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Hints & Tips T_Quantise is similar to After Effects Posterize filter but
more faithfully replicates the source image’s colours at low
level values. T_Quantise also works on 32bpc images.
T_Rain
Type Effect.
Controls
Figure 164. Diffusion Min = 100. Figure 165. Diffusion Min = 80.
Note the blown highlights.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
T_Security
Type Effect.
Controls
Fisheye Lens Controls for the distortion of the image due to the very
wide angle lenses used on security cameras.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
T_Snow
Type Generator.
Controls
Figure 186. Soft Matte. Figure 187. Hard edged matte used
with high Threshold value.
Clip Far - the position along the z axis behind which snow
is not drawn.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
T_SoftGlow
Type Effect.
Controls
into the glow. Figure 191 on page 140 shows just the white
Breakup The breakup parameters scatter pixels in the image that are
then blurred. This can give a subtle shimmer to the glow.
effect.
Clip Levels Controls the extent of the glow. The glow is phased in
between the min and max values. Above the Max value
there is full glow.
Figure 194. Min = 0, Max = 100. Figure 195. Min = 50, Max = 75.
• After Glow - cuts out the glow using the Mask Layer.
Only the parts of the glow that overlap with full alpha in
the mask input are displayed.
• Before & After - performs the Before Glow operation
followed by the after Glow.
Blending How to mix between the source image and the effect. See
“Blending” on page 44. The blending function controls
how the glow is added back onto the image. Screen is the
default but other methods give good results too.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
T_Water
Controls
over time.
Figure 202 shows the “S” shaped drip layer over a grey
background and Figure 203 and Figure 204 shows two
Rain Width - the size of the rain drop when it hits the
water surface.
Rain Power - the amount the drip bends the water surface
on impact corresponding to the amount of image distortion.
Type
• None - no lights are used. Lighting parameters are
switched off.
• Infinite - simulates the parallel rays from a distant
light source, like the sun.
• Local - point light.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
Appendix A
Release Date
2 October 2006.
Requirements
After Effects 7.0 for Mac OS X or Windows XP. Previous
versions of After Effects, Combustion, Final Cut Pro and
other hosts implementing the After Effects API are not
supported.
New Features
There are no new features.
Improvements
1. Numerous improvements to this User Guide have been made in this
release.
2. All plug-ins using host lighting can now access any light in the
composition, rather than just the first light in the layer.
3. T_Kaleid - this is a free plug-in. No license key is required to use
this plug-in.
Fixed Bugs
1. T_Flow - random drips option was broken. This has been fixed.
Release Date
22 September 2006.
Requirements
After Effects 7.0 for Mac OS X or Windows XP. Previous
versions of After Effects, Combustion, Final Cut Pro and
other hosts implementing the After Effects API are not
supported.
New Features
1. All plug-ins support rendering in 32 bpc via the After Effects
SmartFX API.
2. Support for native After Effects tools including cameras and lights
in plug-ins, including T_BumpShade, T_Condensation, T_Mosaic,
T_Particles and T_Starfield.
3. 20 plug-ins are included.
Improvements
Improvements to existing features will be documented here
in future releases.
Fixed Bugs
Fixed bugs will be documented here in future releases.
Index
A-Z F M
FFT 18 Macrovision 18
A Filter Sharpness 43 Matte 50
Filtering 42 Attenuating an effect 51
About... 21
High 42 Matte Layer 51
Activation 7, 9
Ambient Lighting 35 Low 42 Matte Layer Crops 55
Aspect 25 Medium 42 Motion Tracker 19
Attenuation 51 Foundry FLEXlm Tools User
Guide 18 O
B Foundry, The 19 On-line Help 21
Web Site 20 Options... 23
Background Rendering 16
Blending 44
G P
Blend 48
Effect Gain 48 Gradient 30 Pixel Aspect Ratio 25
Method 44 Adding a Colour 30 Process 26
Source Gain 48 Changing a Colour 30
Bug Fixes Deleting a Colour 30 R
See Release Notes 151 Moving a Colour 30 Refractive index 148
Release Notes 151
C H Reset 22
Camera 40 Help 21
Clamp 0-1 (32bpc) 49 S
Crops I Serial Number 9
Colour 54 Ignore Transparent Pixels 28 Source Crops 53
Reflect 54 Installation on Mac 6 Specular Lighting 37
Repeat 54 Installation on Windows 6 System Requirements 5
Wrap 55
L T
D license file 10 T_BadTV 57, 91
Diffuse Lighting 36 Lighting 31 The Foundry 19
Ambient 35 Web Site 20
E Diffuse 36 Tinder 19
Edge Methods 54 Specular 37 Tracking 19
Error Log Files 16 lmhostid 9 Type 24
W
watch folders 16
Watermark 13