Professional Documents
Culture Documents
Tinderbox3-2 1v1
Tinderbox3-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 3 T_BadTV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
T_BumpShade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
T_CircularBlur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
T_Condensation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
T_Deband. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
T_Defield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
T_DiffusionFilter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
T_EdgeDetect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
T_GradientBlur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
T_Lightning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
T_MatteTool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
T_Mosaic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
T_OldFilm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
T_Particles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
T_Plasma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
T_Silk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
T_Starfield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
T_Turner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
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 tinderbox3_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/Tinderbox3-2.1/ and on Windows
it is C:\Program Files\Adobe\Adobe After Effects 7.0\Support
Files\Plug-ins\Tinderbox3-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 3 license key that unlocks the plug-ins on a
license file go? machine with lmhostid = 000b957bfdf4 will look a lot like
this:
INCREMENT tinderbox3_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/
Tinderbox3-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\Tinderbox3-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 3 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 3
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 3
T_BadTV
Hints & Tips If you apply BadTV to a clip with the defaults and process
the clip the picture quality will randomly drift between
good and bad.
Type Effect.
Controls
Presets
the wave oscillates. A value of 100 will give one cycle per
second.
Ghosting These controls create the multiple offset images seen with
poor television reception.
Edge Distortion This controls the breakup of the picture at the edges. The
shape of the jagged edges are created using the seed value.
Snow These controls apply noise to the image common with poor
analogue signals. You should be aware that the snow can
Vertical Roll This controls the vertical displacement of the image when
the signal is very poor. You can set the vertical offset and
roll parameters to displace the picture vertically a fixed
Gun Alignment The red, green and blue guns in a cathode ray tube fire
streams of electrons at the phosphor coating on the
television screen to produce a picture. The electron streams
are bent using magnets through the shadow mask. If the
shadow mask is misaligned a colour shift in the image will
be produced.
Note Misaligned guns tend to be caused by defects in the television set or
interference by other electrical equipment rather than poor television
pixel.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Source Crops How to mix between the source image and the effect. See
“Source Crops” on page 53.
T_BumpShade
Controls
Diffuse Lighting Controls for the light reflected from objects with dull matte
surfaces. These objects scatter light equally in all
directions so that they appear to have the same brightness
from all viewing angles.
Specular Lighting Controls the light reflected from shiny objects that gives
bright 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.
Hints & Tips The example below shows the difference between the
outline and the bump mattes. The two layer composite is of
Figure 92. Two layer Composite. Figure 93. Outline On, Bump Off.
Figure 94. Outline Off, Bump On. Figure 95. Outline On, Bump On.
T_CircularBlur
Type Blur.
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_Condensation
Controls
Type
• None - no lights are used. Lighting parameters are
switched off.
• Infinite - simulates the parallel rays from a distant
light source, like the sun.
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_Deband
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 You should keep the amount of blurring as low as possible.
T_Defield
Type Tool.
Controls
Source Crops Cropping tools and edge methods. See “Source Crops” on
page 53.
T_DiffusionFilter
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.
Hints & Tips On some images it can produce a kind of dreamy quality.
T_EdgeDetect
Controls
page 101.
Colours Edge Colour - the colour used when the Colour Mode is
set to Single Colour.
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 Try animating the Upper and Lower Thresholds of the
Canny filter to write on the edges.
T_GradientBlur
Figure 122. Blurring along the Figure 123. Blurring across the
gradient. gradient.
Figure 122 and Figure 123, the blurring only takes place in
the grey areas where there is a gradient. In Figure 122 the
direction set to zero and the blurring is radial. In
Figure 123 the image has a direction set to ninety degrees
and the blurring is across the gradient vector direction.
Type Blur and Effect. It has an optional matte input that is used
to define the gradient vectors.
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_Lightning
Controls
Bias - shifts the bulge from the start (-100) to the end (100)
of the bolt.
Twist - the tension of the plasma bolts at the start and end
points. With a value of zero the bolts will always
approach the start and end points along the line that
connects them. In other words they are tightly clamped.
Increasing the Twist slackens off the tension allowing the
bolts to flop around more.
Fork After - the point along the line between the start
and end positions at which forking starts. If zero then
forking could begin at the start position. If set to 50 then
forking can only begin halfway along the line.
Fork Before - the point along the line between the start
Glow There are two glows that surround the bolts to give a subtle
inner and outer glow. The second glow is labelled Halo as
this is the effect it gives on our presets.
Luminance/Alpha.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
T_MatteTool
Type Tool.
Controls
Process
• RGBA
• Luminance
Halos Cut Blurs - this cuts into the inside or outside edges
of softened In/Out Halos.
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 Can be useful for tidying up mattes from keyers. Also if
you have an image and associated matte which when
composited into a scene has a rather harse line around it,
you can use T_MatteTool to extract a soft halo which can
then be used in T_BlurMasked to soften the edge.
T_Mosaic
Controls
Edges T_Mosaic uses the Canny edge detector to find edges and
draw along them. You can view the edge matte using the
Output parameter. The threshold controls are the same as
those for the Canny mode in T_EdgeDetect. They are used
in the last stage of the Canny edge detection algorithm,
after it has identified a set of pixels which have steep
gradients across them and are therefore likely to belong to
an edge. Pixels whose gradient is above the upper
threshold are automatically classified as edge pixels, and
pixels with gradients below the lower threshold are
classified as non-edge pixels. Those whose gradients fall
between the two thresholds will be classified as edge pixels
only if they are connected to a definite edge pixel by a path
through the pixels remaining in the set. The idea is to avoid
Light and Shade These controls affect the apparent thickness and depth
profile of the tiles under illumination.
Diffuse Lighting Controls for the light reflected from objects with dull matte
surfaces. These objects scatter light equally in all
directions so that they appear to have the same brightness
from all viewing angles.
Specular Lighting Controls the light reflected from shiny objects that gives
bright 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_OldFilm
Type Effect.
Controls
black & white, sepia, forties and techno colour. A few are
shown here with the source image for comparison.
Film Type - sets the base colour type before defects are
added.
• Colour - colour information is retained in the image.
• B & W - the image is converted to black and white.
• Tinted - the image is washed with the tint colour.
Dirt Type
• None - no dirt is drawn.
• Print - bright dirt marks on the print.
Dirt Size - the maximum size of the dirt. The actual size
will vary.
Hair These controls add the small number of hairs that are stuck
to the negative or print as a result of handling.
Hair Type
• None - no hairs are drawn.
• Print - bright hairs on the print.
• Negative - dark hairs on the film negative.
• Print and Negative - both types.
Camera Shake The shake parameters simulate the frame vibrations and
horizontal jumping from missing sprockets as the film is
drawn through the projector. For more comprehensive
camera shake parameters see Tinderbox 2 Wobble.
Film Burn If the film sticks in the gate when projected, the heat from
the light source may ignite and burn the film. These
parameters control this feature which can burn through
revealing the underlying layers of the composite.
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_Particles
Controls
Generator The controls that determine how the particles are emitted.
Figure 195. Narrow Beam and Figure 196. Wide Beam and
Emitter Size. Emitter Size.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Hints & Tips Don’t forget to switch off Show Guides before rendering
your final version.
T_Plasma
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_Silk
Type Blur.
Controls
Output
• Result - the silked image.
• Edge Map - the edges we’re avoiding.
• Detail - the source image we’re compositing back over.
Edges These parameters control the edges that are avoided by the
blur.
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 If there are large parts of the image that you don’t want
affected regardless of edge information, mask out the area
you want and composite it back over the image.
T_Starfield
Controls
Size - the size of the largest star. Large stars will have a
large glow. Actual star sizes will vary.
Motion Blur When animating the camera the results are improved with
motion blur on the stars.
blur.
Camera Controls for the built-in camera. See “Camera” on page 40.
Blending How to mix between the source image and the effect. See
“Blending” on page 44.
Hints & Tips Try adding a coloured glow to the highlights using
T_DiffusionFilter, and if want a slightly stylized look you
could add sparkles to the stars using T_Starburst from
Tinderbox 1.
T_Turner
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.
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.
Fixed Bugs
1. Tinderbox could not be licensed with a valid license file in the plug-
ins’ directory. This has been fixed.
2. The installer failed to create a /usr/local/foundry/FLEXlm or
c:\Program Files\The Foundry\FLEXlm directory. This has been
fixed.
3. On Windows the link to the documentation from the Start menu
was broken. This has been fixed.
4. Installation on Window XP64 failed to put the plug-ins in the
correct directory. This has been fixed.
5. Blend 0-1 (32bpc) option in the Blending groups failed to work.
This has been fixed and now defaults to off.
6. Process Grey - failed to work at 32bpc. All images were set to
black. This has been fixed.
7. T_Plasma - colours not working. This has been fixed.
8. T_MatteTool - erode failed to work. This has been fixed.
9. T_GradientBlur - crashes when gradient layer picked. 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. T_MatteTool - processing of individual colour channels now
possible.
4. T_Mosaic - entirely new plug-in replacing T_RomanMosaic that
mimics traditional tiling technique.
Improvements
1. The colour gradient tool has been improved and incorporates colour
picking with standard tools.
2. T_Lightning - revamped backend integrating lightning and plasma
types into single strike options. Auto animating strikes introduced
and presets revamped to take advantage of new functionality. Glows
improved with the addition of halos.
Changes
1. T_MeltTime, T_MinMax, TMotionDetect have been removed.
2. T_RomanMosaic has been rewritten and renamed to T_Mosaic.
Fixed Bugs
1. OpenGL bug causing intermittent crashes have been resolved.
Index