Welcome to Boris Grafﬁti 4.0.2. These Release Notes contain information regarding supported hosts, hardware and operating systems, known limitations, and other important information about the product.
For information on installing Boris Grafﬁti 4.0.2 into your host application, see the Installation Guide pdf ﬁle.
Version 4.0.2 is a maintenance release that ﬁxes a number of bugs that appeared in previous versions of Boris Grafﬁti. These Release Notes contain important information regarding supported system requirements, ﬁxed bugs, and known limitations.
Adobe® Premiere® 6.5 Adobe® After Effects® 6.0
Apple® Final Cut Pro® 3.0, 4.0 or later
Avid® Media Composer®, Avid Symphony® 4.7, 4.8, Avid XpressMac®, Avid Xpress DV® 3.0, 3.5.4, 4.8. Avid Xpress Pro®4.0 or later
Media 100 i® 8.1 and later, Media 100 HD 10.0
Adobe® Premiere Pro® 1.5
Avid® Media Composer®, Avid Symphony®, Avid Xpress®, Avid Xpress DV® 3.0, 3.5.4, Avid Xpress Pro® 4.0 or later, Avid Xpress Studio, Avid|DS 6.0 and later
Canopus® Edius® 2.5, Edius Pro® 3.0
DPS® Velocity® 8.2
Incite® Media Producer 3.0 and later, Remote Producer 3.0 and later
In:Sync® Blade® 2.2, In:Sync Speed~Razor® 5.5
Media 100® iFinish 4.6
Pinnacle purple®, Pinnacle silver® 4.01, Pinna- cle Liquid Edition® 6.0
Sony® Vegas® 4.0
Ulead Media Studio Pro® 6.5, 7.0
Supported Operating Systems
Grafﬁti 4.0.2 supports the following operating systems.
Macintosh OS X v10.2.6 and above (see note below). Grafﬁti 4.0.2 is the ﬁrst version to add support for Macintosh OS X 10.4.2 (Tiger).
To take advantage of the OpenGL features in Grafﬁti, you must install Macintosh OS 10.2.6 or later. Final Cut Pro 4.x users must install Macintosh OS 10.3 or later.
Windows 2K®, Windows XP®
We recommend at least 512 MB of memory assigned to the host application for both Macintosh and Windows users using Grafﬁti.
To run Boris Grafﬁti 4.0.2, QuickTime version 6.0 or later must be installed on your system. Boris Grafﬁti supports dual processors, Hyper Threading, and Altivec acceleration.
Grafﬁti is localized in several languages – English, French, German, Spanish, Italian, Japanese, Chinese and Korean. Grafﬁti installs a Boris Language Pack ﬁle which reads the system language speciﬁed on your system and translates its menus into that language, if it is supported. Localization should be automatic and requires no work on the part of users. The Boris Language Pack ﬁle is located in the following location.
Library/Application Support/BorisFX/Boris Language Pack.ecs
<Drive>\Program Files\Boris FX, Inc.\Boris Language Pack.ecs
The Boris Localizer is a standalone Mac OS X application that can be used to update the translation of Grafﬁti in any of its eight supported languages. Use the Boris Localizer to edit Boris Language Pack ﬁles which contain translations of Grafﬁti menus and parameters into various languages. The Boris Localizer is available through your local Boris reseller.
Contact your reseller for more information on using the Boris Localizer to edit the default Grafﬁti translations.
You need the following hardware and system requirements to use the hardware dependent features in Grafﬁti 4.0.2. For detailed information on the OpenGL feature in Grafﬁti 4.0.2. See the Understanding OpenGL pdf on your Grafﬁti CD or in the Grafﬁti User Guide.
Due to the fast rate at which OpenGL card manufacturers release drivers, Grafﬁti may disqualify your OpenGL hardware erroneously. If this happens, you should try to enable OpenGL to see if you beneﬁt from OpenGL acceleration. If you have troubles with slowness, or render inconsistencies, please disable OpenGL. For information on enabling OpenGL, see “Enabling OpenGL” on page 7.
While OpenGL may work in the Grafﬁti KeyFramer, that does not necessarily mean it will work inside your host application. This is due to the fact that some hosts use OpenGL memory, leaving it unavailable for Grafﬁti when you work inside the host.
If your host crashes when trying to apply Grafﬁti, and you cannot disable OpenGL in your host, please contact our technical support staff. They will send you a preferences ﬁle that will start Boris Grafﬁti with OpenGL disabled.
BorisFX will make every effort to continue to qualify OpenGL cards and driver versions. However, it is important to note that it is impossible to qualify all combinations of OpenGL cards, operating system, drivers and host applications. In general you should run the latest driver available for your OpenGL card. If you have problems with the latest driver, visit the Boris website to see a list of the latest supported driver versions.
The following graphics cards and drivers are supported for Grafﬁti’s OpenGL features. This list is current as of the initial Grafﬁti 4.0.2 release. Boris FX maintains an updated list of tested video cards on our web site: www.Borisfx.com. In general you should download and install the latest driver for your GL card.
OpenGL is a cross-platform standard that accelerates the rendering of 2D and 3D graphics. Most newer video cards have hardware-based OpenGL acceleration. If your system does not include the recommended minimum requirements, Grafﬁti initially defaults OpenGL to Off. You can re-enable OpenGL in the Grafﬁti Preferences window. You can still use Grafﬁti without OpenGL or with an older card, you just won’t gain as much acceleration while working. For details on how to use OpenGL, see the Grafﬁti User Guide.
Final Cut Pro 4.x users must have a minimum of Macintosh OS 10.3 installed to support Grafﬁti’s OpenGL feature.
ATI Radeon 8500 (and up), Radeon Rage 128 (Macintosh only).
NVidia GeForceFX (all), GeForce 3 and GeForce4 (all)
ATI FireGL series, Radeon X300 (and up), Radeon 8500 (and up)
NVidia Quadro FX (all), Quadro4 900 (and up), GeForce 6800, GeForce PCX, and GeForce 3 and GeForce4 (all)
As a general rule, you should install and run the latest driver available for your GL card. ATI users should not use driver versions previous to 63.68. NVidia users should not use driver versions previous to 65.00.
The ﬁrst time you launch Boris Grafﬁti, an internal test is run on your system to determine whether your hardware meets the minimum requirements necessary for OpenGL Hardware acceleration. If your hardware does not meet the minimum requirements, OpenGL is disabled by default on your system.
To perform the OpenGL Hardware test manually, click the Test OpenGL Hardware button in the Preferences window’s Render tab.
This test may take a few seconds. After the test is run, a window displays speciﬁcs of the hardware and drivers on your system. If any test results show your system may have problems running OpenGL, the errors are detailed in this window.
The test stresses your OpenGL hardware, so you should run the test with a typical workload. Before you run the OpenGL hardware test, launch any applications that you usually run while you edit (any graphics intensive applications you are running at the time may affect the results).
If you want, click the Copy to Clipboard button to copy this information to your system clipboard. This allows you to print or email this information. When you ﬁnish, click OK to close this window.
Grafﬁti uses the following guidelines for optimal OpenGL performance. Some of this information does not affect Grafﬁti’s hardware testing but is useful for technical support if you are having OpenGL problems:
10.2.6 installed to support OpenGL; Final Cut Pro 4.x users, must have at least Macintosh OS 10.3 installed to support OpenGL.
When the OpenGL Hardware Test is run, error messages may display if your system fails. These errors display as Hardware Status errors or Critical Testing errors.
Hardware Status errors can include messages such as insufﬁcient texture memory or reports that your card was not recognized by Grafﬁti’s internal hardware testing. When you receive a Hardware Status error, OpenGL is automatically disabled when you launch Grafﬁti.
However, you can manually enable OpenGL in the Grafﬁti Preferences window.
Critical Testing errors report errors that will not allow you to use OpenGL in Grafﬁti. When you receive a Critical Testing error, OpenGL is automatically disabled when you launch Grafﬁti. If you receive a Critical Testing error, you should not enable OpenGL or you may crash.
Final Cut Pro 4.x users must have at least Macintosh OS version 10.3 installed in order to support Grafﬁti’s OpenGL feature.
Certain errors are inﬂuenced by your video card’s display properties, which are card-driver speciﬁc. As a general rule, set the display properties to 32 bits of color, with the depth buffer set to at least 16 bits. On many cards OpenGL capabilities are reduced for higher display resolution and refresh rates.
You can enable OpenGL in the Preview menu or in the Preferences window.
To enable OpenGL in the Preference window, choose Edit > Preferences (Windows) or Boris Grafﬁti > Preferences (Macintosh). Click the Render Tab and select the Accelerated Draft Preview checkbox . Choose the appropriate choice from the OGL Acceleration menu . On, Max. texture caching provides the best performance and is the recommended setting.
To enable OpenGL in the Preview menu, choose Preview > Open GL Mode. Choose the appropriate choice from the submenu. On, Max. texture caching provides the best performance and is the recommended setting.
To toggle OpenGL off, use the keyboard shortcut Command or Control-[. To turn it back on, the keyboard shortcut Command-] (Macintosh) or Control-] (Windows). Menu choices also appear in the Preview menu and in the Preferences window. You can still use Grafﬁti without OpenGL or with an older card, you just won’t gain as much acceleration.
Display problems such as white, rainbow or garbage images in the Composite window may be related to OpenGL. If this occurs, open the Preference window. In the Render tab, change the OpenGL Acceleration menu to use less texture caching. Texture caching is used for textures (layer images) and is related to the amount of Texture memory on the video card. Display problems related to OpenGL will not affect your rendered effects.
If you experience OpenGL problems, setting the OpenGL Acceleration menu to use less texture caching improves OpenGL reliability, but lessens performance.
You can output video to an external monitor through a FireWire converter box or through supported video hardware connected to your system. You can output media at any project size and immediately view your working frame without rendering the timeline.
Some hosts have native Preview to Monitor (PTM) where Grafﬁti passes a frame and the host displays it, for example Meridien-based Avid systems. However, if a host does not have native PTM ability, then you can use the Preview to Monitor feature. The user does not have hardware choices in the Preferences window if Grafﬁti uses native host PTM (since the host controls the hardware connection).
As a plugin, Grafﬁti does not ofﬁcially support connecting to hardware that is already in use by the host NLE for direct Video Out purposes. Grafﬁti can only use the FireWire output if the NLE releases it while Grafﬁti runs. A number of hosts (for example Premiere and FCP) will not release control of the primary display hardware. This prevents Grafﬁti's Preview to Monitor feature from working until the NLE releases control of the FireWire hardware.
However, Grafﬁti looks for all possible output devices upon installation, and lists the results in the Device menu in the Preview tab of the Boris Grafﬁti preferences. As a result, users may be able to use a different output device for Grafﬁti than the one that the host application uses. The host application may use its own capture hardware for display, leaving the FireWire port available.
Video-out capabilities are also available in the Boris Grafﬁti KeyFramer. This enables anyone with supported video hardware, whether built into their computers, included with their NLEs, or provided through third parties, to see the work they create in Boris Grafﬁti immediately on television monitors.
Grafﬁti supports the following video cards for the new Preview to Monitor (PTM) feature in both the Grafﬁti KeyFramer and while using Grafﬁti in your host. For detailed information on the new PTM feature, see the User Guide.
Make sure you have the latest drivers installed for the supported video cards.
Canopus® RT® (See note below.)
Note for Macintosh Users: Most cards supporting standard QuickTime video out capabilities and drivers should work.
Note for Windows Users: Although the previous cards were internally tested and approved, other cards may work as well. We also support standard FireWire out. Many Canopus RT boards work, although we cannot guarantee they all will.
Note for Final Cut Pro version 3.0 Users only: FCP 3 users running Grafﬁti as a plug-in with FireWire for Grafﬁti's Preview to Monitor feature, must disconnect before clicking the Apply button or FCP will crash. To disconnect, choose Preview
> Disconnect External Monitor.
Note for Final Cut Pro version 4.x Users only: In order to use the Preview to Monitor feature, you must turn off the external video in Final Cut Pro before launching Grafﬁti. Choose View > External Video > Off then enable Grafﬁti’s Preview to Monitor feature when Grafﬁti is launched. After leaving Grafﬁti, reenable the external video (View > External Video > All Frames) to see Final Cut Pro video in the external monitor.
Once the hardware is connected, choose Connect to Monitor from the Preview menu . Commands in the Preview menu allow you to set the video display. You can output media at any project size and immediately view the working frame without rendering the timeline.
When you choose Display Frame on Monitor from the Preview menu or click the Display Frame to Monitor button in the upper-right corner of the Composite window, the image displays on the external monitor, using the Resolution and Quality settings speciﬁed in the Composite window.
When you choose Display HQ on Monitor from the Preview menu, the image displays on the external monitor, using the Full Resolution and High Quality settings, regardless of the Resolution and Quality settings in the Composite window. When you choose Auto-Update Monitor from the Preview menu, every frame of your effect previews to the external video monitor connected This allows you to drag the CTI in the timeline and view updating frames. This option is not available in some host applications or system conﬁgurations.
Once the hardware is connected, conﬁgure the Grafﬁti Preferences to use this feature. See the next section for details.
Final Cut Pro version 3.0 Users only: FCP 3 users running Grafﬁti as a plug-in with FireWire for Grafﬁti's Preview to Monitor feature, must disconnect before clicking the Apply button or FCP will crash. To disconnect, choose Preview > Disconnect External Monitor.
Final Cut Pro version 4.x Users only: To use the Preview to Monitor feature, you must turn off the external video in Final Cut Pro before launching Grafﬁti. Choose View > External Video > Off before launching Grafﬁti, then enable Preview to
Monitor when Grafﬁti is launched. After exiting Grafﬁti, reenable the external video (View > External Video > All Frames) to see FCP video in the external monitor.
Choose File > Preferences (Windows), or Boris Grafﬁti > Preferences (Macintosh).
Click to select the Preview tab
In the External Monitor Output section, choose your Firewire Converter box or Video hardware board from the Device menu .
The Device menu displays all the supported hardware connected to your system.
Choose an option from the Mode menu if applicable. For example, if you are using a Firewire Converter box, you can choose PAL and NTSC formats from the Mode menu .
Click OK to save your settings and exit the Preferences window.
The Preview to Monitor preferences save and apply to all Grafﬁti projects unless your Grafﬁti preference ﬁle is rebuilt.
Commands in the Preview menu allow you to set the video display:
When Connect to External Monitor is chosen in the Preview menu , Preview to Monitor is enabled and the following three options in the menu become available:
When you choose Auto-Update Monitor from the Preview menu, every frame of your effect previews to the external video monitor. This allows you to drag the CTI in the timeline and view updating frames. The image displays on the external monitor, using the Resolution and Quality settings speciﬁed in the Composite window.
Enabling Auto-Update Monitor slows Grafﬁti since every frame updates in the external monitor.
When you choose Display Frame on Monitor from the Preview menu or click the
window, the current frame displays on the external monitor, using the Resolution
and Quality settings speciﬁed in the Composite window.
When you choose Display HQ Frame to Monitor from the Preview menu, the image displays on the external monitor, using Full Resolution and High Quality settings, regardless of the Resolution and Quality settings in the Composite window.
To disconnect Preview to Monitor (for example if you want to connect another device to your video board), exit Grafﬁti. When you relaunch Grafﬁti, the external monitor is not connected until you choose Connect to External Monitor in the Preview menu .
Preview to Monitor automatically disconnects when you exit Grafﬁti. This means each time you launch Grafﬁti, you need to choose Preview > Connect to External Monitor in order to reconnect and see your image on the external monitor.
To change the Preview to Monitor device or mode, disconnect by choosing Disconnect External Monitor from the Preview menu . Open the Preference window’s Preview tab to choose a new device or driver from the External Monitor Output menus . You can also reconnect via the Preview menu with those new settings in the same session.
Displaying images on an external monitor requires compressing and resizing the images. Grafﬁti may run slower if Auto Update is enabled. Deselect Auto-Update Monitor in the Preview menu to remain connected to the external monitor but not automatically update frames.
Manually update frames to your external monitor by choosing Preview > Display Frame to Monitor, or Preview > Display HQ Frame to Monitor, or by pressing the Display Frame to Monitor button on the upper-right corner of the
Composite window. Display Frame to
Several BCC ﬁlters (BCC Spiral Blur, BCC Light Zoom and BCC Twirl) are not included with the Boris Grafﬁti installation.
You must register Boris Grafﬁti to download these ﬁlters. See the Installation Guide PDF for details on registering.
Avid users can now apply Boris Grafﬁti as a ﬁlter to titles created with the Avid Title tool.
You can apply Boris Grafﬁti directly to titles created in the Avid timeline. For example, if you have a bin with saved titles, you could apply a ﬁlter to the titles in Grafﬁti.
Edit an Avid title or matte key into the Avid timeline.
Open the Avid Effect Palette and select Boris Grafﬁti from the Effect categories. From the list of available Grafﬁti effects, drag the Boris Grafﬁti Title-Matte Effect to the title or matte key in the Avid timeline.
The Title-Matte effect is a destructive process which replaces the title or matte key. Removing a Title-Matte effect removes the title’s nested alpha channel. To remove a Title-Matte effect and preserve the alpha, use the Undo command instead of the Remove Effect command.
Click the Other Options button in the Avid Effect Editor to launch Grafﬁti.
If the title or matte key looks blocky when Grafﬁti opens, select its Face track in the timeline. In the Host Media tab, choose Straight Alpha from the Key menu . This usually happens automatically.
Since a title is replaced by applying the Title-Matte effect, to re-edit a title with a Title-Matte Effect (for example to change the text or a font) you must save the Title-Matte effect while you are in Grafﬁti (in the File menu). Recreate the Avid title and overwrite the older title in the Avid timeline. Drag a Grafﬁti Title-Matte Effect to the new title. In Grafﬁti, open the saved effect and apply it to the new title.
Grafﬁti’s Preview to Monitor feature works for Xpress DV, Xpress Pro, and Adrenaline and Mojo models only. All other Avid products can use the existing AVX Preview to Monitor feature within Grafﬁti. The AVX Preview to Monitor allows you to see video in an external monitor without the extra step of selecting your hardware in Grafﬁti’s Preference window.
Due to limitations in the Edius architecture, you need to be aware of the following limitations when using Grafﬁti inside Edius.
To launch the Grafﬁti user interface after applying a Boris effect to a clip, the Edius timeline cursor must be placed over the effect and the track containing the effect must be selected.
When using Boris Grafﬁti as a Transition effect in Edius, the Edius Palettes remain above the Boris windows. BorisFX has reported this issue to Canopus and is working with them to resolve it in a future release of Edius. Currently, to work around this issue, position the Edius Palettes and Boris windows so they don't overlap.
In Edius, when a clip is rendered, that clip is locked. Any changes to a Grafﬁti effect will not display in the Edius Preview window until Edius is closed and reopened. To work around this limitation, complete the following steps:
In the Edius settings, click the Render tab.
In the Delete invalid rendering ﬁles section, choose When the Rendered File is Invalid .
Unrender the clip by making a change, such as toggling the checkbox to disable/reenable the effect in the Edius Information Palette.
If Edius crashes when trying to apply Grafﬁti it may be because OpenGL is enabled. If you cannot disable OpenGL, launch the standalone Grafﬁti KeyFramer to disable OpenGL, then you should be able to apply Grafﬁti within Edius as a plug-in. You can also contact our technical support staff. They will send you a preferences ﬁle that starts Grafﬁti with OpenGL disabled.
You should be aware of some issues when applying multiple Grafﬁti ﬁlters to a clip.
We do not recommend adding multiple Grafﬁti effects to an Edius clip or stacking clips containing Grafﬁti effects on multiple layers in the Edius timeline. Depending on your system speciﬁcs, multiple Boris effects (>2) on a clip may not render properly. Instead, apply a single Grafﬁti effect to an Edius clip and add multiple effects to the clip within Grafﬁti.
This limitation only applies to effects that overlap exactly. For example, a track containing both an in and an out transition would not fall under this suggestion (since they can not overlap).
If there is more than one Boris effect applied to a clip, the effect of preceding ﬁlters will not display in the subsequent ﬁlters in the Grafﬁti user interface. For example, if ﬁrst a blur ﬁlter and then a twirl ﬁlter are applied to the same Edius clip, the blur ﬁlter effect will not show in the effected track when the ripple effect is launched. However, all effects display during render in the Edius Preview window.
Edius timeline playback stops when trying to play through a Boris effect. To ﬁx this, in the Edius settings deselect the Stop Playback at Frame Drop in the Playback tab .
When Grafﬁti is launched, Edius is unable to perform other actions (such as closing). It is possible to get Edius into a state where it thinks Grafﬁti is launched, but the Grafﬁti user interface does not appear. This will functionally lock Edius. To resolve this, delete the Grafﬁti .ini ﬁle in the root:\\WINDOWS folder, and launch Grafﬁti again. If this doesn't work, save the Edius project, force a manual close of Edius (Control- Alt-Delete), delete the Grafﬁti .ini ﬁle, then launch Edius again.
At this time Boris products do not support being launched from inside other Edius ﬁlters (for example, the Combine or Region Edius ﬁlters).
Final Cut Pro 4.x users must have at least Macintosh OS version 10.3 installed in order to support Grafﬁti’s OpenGL feature.
To use Grafﬁti’s Preview to Monitor feature, you must turn off the external video in Final Cut Pro before launching Grafﬁti. Choose View > External Video > Off before launching Grafﬁti, then enable Grafﬁti’s Preview to Monitor feature when Grafﬁti is launched. After leaving Grafﬁti, reenable the external video (View > External Video > All Frames) to see Final Cut Pro video in the external monitor.
Final Cut Pro 3 users running Grafﬁti as a plug-in with FireWire for Grafﬁti's Preview to Monitor feature, must disconnect before clicking the Apply button or FCP will crash. To disconnect, choose Preview > Disconnect External Monitor.
Grafﬁti includes a Static Generator for Final Cut Pro . The Static Generator allows you to create a static slate which takes advantage of Final Cut Pro’s real-time capabilities. When you apply the Static Generator, the Boris timeline opens with a duration of one frame which can then be applied to Final Cut Pro as a static slate.
Grafﬁti now correctly ﬁeld renders video in the wells when using a Grafﬁti FCP Generator. However, media placed in the input wells for a Grafﬁti Generator should match the FCP sequence size. Both the Grafﬁti project size and the size of the well video appear in Grafﬁti at the FCP sequence size. If the well media is not the same as the FCP sequence size, ﬁelds won't render correctly.
Additionally, any video in the input wells should be the same size as the clip with Grafﬁti applied. In the case of Grafﬁti applied as a ﬁlter, the Grafﬁti project size is determined by the size of the ﬁltered media. Once again the size of the ﬁltered media needs to match any video in the wells. This will maintain the integrity of ﬁelds since Grafﬁti doesn't allow host video inputs of various sizes within the same effect.
To use media whose size doesn’t match the FCP sequence size (Generator) or the Filter media size, the best approach is to import that media directly into the Boris timeline from disk (rather than from the wells in FCP). This will provide you with full ﬂexibility for dealing with non-standard size images, ﬁeld interpretation, and oversize images.
To edit an existing Grafﬁti effect, make sure the playhead is positioned on the effect you want to edit before launching Grafﬁti. Otherwise, the Boris interface will not appear.
To export from Grafﬁti, set the FCP resolution to 100%. Otherwise, you get reduced image quality, since FCP does not provide full-size frames. Likewise, if Final Cut Pro is at less than full resolution (100%), previews at full size appear in reduced quality.
In some instances the Grafﬁti plug-in crashes due to an apparent conﬂict with MacsBug v6.6.3. If you have MacsBug 6.6.3 installed and experience crashing, try disabling or running an earlier version of MacsBug when using Grafﬁti.
If more than one version of Grafﬁti is installed, the Effects menu lists both versions with the same name: Boris Grafﬁti. The top item in the list is Grafﬁti 4.0.2 and the second item is the earlier version. We recommend uninstalling earlier versions.
Due to changes made in the Liquid Edition plug-in architecture in version 6.1, rendered Boris effects may display jagged edges or reversed ﬁelds. If your system shows this problem, you can install an .ini ﬁle to reverse the video ﬁelds.
If your system exhibits these problems, simply drag the BorisGRAFFTI4Plug 1.ini ﬁle into the same folder as the Liquid Edition .exe ﬁle. This is usually found in the following location: <Drive>\Program Files\Liquid.6\Program folder .
The .ini ﬁle includes the following two parameters:
ReverseSrcFieldOrder reverses the ﬁeld order when it is set to 1 (the default); at a value of 0 this is disabled and the original ﬁeld order is used.
BottomFieldDominant sets the ﬁeld dominance. A value of 1 sets lower ﬁeld dominance, 0 sets upper ﬁeld dominance and 3 does not change the dominance.
Once Liquid Edition releases a patch that ﬁxes this problem, this action can be undone by deleting this ﬁle.
In most host applications, when you use Boris Grafﬁti as a plug-in, the effect size is taken from the host application. However, due to changes made in the Liquid Edition plug-in architecture in version 6.1, you must manually set the size to match your Pinnacle Liquid Edition project. To do this, open the Preferences window by choosing Edit > Preferences (Windows) or Boris Grafﬁti > Preferences (Macintosh). In the General tab, use the Project Size menu to set the width and height (in pixels) for your project. This menu provides project dimensions and FPS for the most common video formats. The Project Size options includes 720 x 486 NTSC D1, 720 x 480 NTSC DV, 640 x 480 NTSC Square Pixels, 640 x 486 NTSC Square Pixels, 720 x 540 PAL D1 Square Pixels, 720 x 576 PAL D1 DV, 720 x 576 PAL D1 DV Square Pixels, 1380 x 720 HDTV, 1920 x 1080 HDTV, 320 x 240 Medium Size and 160 x 120 Small Size .
When you create an effect in Grafﬁti that will output an alpha channel to Vegas (for example a title which does not include the background video), when you apply the effect to the Vegas timeline you will notice the edges appear rough and contain white fringes. You need to reenter Grafﬁti and in the Grafﬁti Preferences set the Local Preferences’ Alpha Type menu to Premultiplied with Black . The effect will display correctly when you apply back to Vegas. You need to set this preference every time you create an effect that outputs alpha.
Projects in certain versions of ULead Media Studio Pro may display jagged edges or reversed ﬁelds in rendered Boris effects. If your system shows this problem, you can use a utility to reverse ULead’s video ﬁelds.
Using Grafﬁti in Ulead with the Matrox Parhelia board, may cause crashing. We do not recommend using the Matrox Parhelia board with Grafﬁti plugged into Ulead.
Boris FX provides a supported list of AE ﬁlters for use inside Boris Grafﬁti. For best results, use only supported AE ﬁlters inside Boris Grafﬁti.
Supported ﬁlters were tested on single-processor machines. While these ﬁlters should also work in multi-processor machines, it is possible you will experience unexpected results or your machine may crash. If you have problems with supported ﬁlters in multi-processor machines, try disabling your MP functionality and recreating your ﬁlter effect.
Tinder Users: Tinder’s Effect Viewer only works properly with the Grafﬁti Composite window set to Full Resolution. Additionally the Effect Viewer may disappear after dragging tracks. Use the regular controls if you experience this problem.
Checkboxes and menus cannot be animated.
Time remapping ﬁlters do not work in Boris Grafﬁti.
After Effects ﬁlters may take longer to render than most Boris Grafﬁti effects.
None of Adobe's built-in After Effects ﬁlters work inside Boris Grafﬁti.
If renders appear noisy or jittery, deselect the Better Quality Field Rendering checkbox
in the Boris Preferences window and re-render the effect.
If you have more than 900 ﬁlters, you will not see some ﬁlters inside Grafﬁti. If you reach the ﬁlter limit, when you launch Grafﬁti a warning asks you to remove some ﬁles from the BorisPlugins folder. You can ignore the warning but you will not have access to all ﬁlters in the BorisPlugins folder. Use the Plugin Filter Manager to hide ﬁlters you don’t need. See the User Guide for details on using the Plugin Filter Manager.
Macintosh users should place supported After Effects ﬁlters or an alias in the following folder. The ﬁlters appear in the Filters menu within Boris Grafﬁti.
System Folder (or Library)/Application Support/BorisFX/BorisPlugins
Windows users should place supported After Effects ﬁlters or an alias in the following folder. The ﬁlters appear in the Filters menu within Boris Grafﬁti.
C:\Program Files\Boris FX, Inc.\BorisPlugins
Boris Grafﬁti allows you to export ﬁles in the Macromedia Flash (SWF) format. This allows you to export compositions as compact, vector-based ﬁles optimized for web viewing. For example, you could export a Type On effect to include on a web page.
Grafﬁti exports Flash .swf ﬁles that are compliant with the Flash 5 architecture. If you are using QuickTime to preview your exported .swf ﬁles, you need a version of QuickTime that supports the Flash 5 format. The following effects are supported for exporting to Flash.
2D Charts (which consist of text and spline shapes)
Other bitmap elements such as video or still graphics can be included in the exported Flash ﬁle and will be JPEG-compressed. In the Export preferences you can set the quality of the JPEG compression.
When you export text to Flash, any texture that was applied to the text is ignored. When you export text with a gradient ﬁll to Flash, the resulting .swf ﬁle is blank.
The SWF format was designed primarily for animated 3D Line Art objects, so it works well when exporting settings that contain spline and text animations. Settings that contain video or animated bitmaps, however, generate rather large ﬁles. You might want to consider exporting such animations as a QuickTime or AVI ﬁle. See “Exporting Effects as Movies” on page 297 in the Grafﬁti User Guide for details.
The Flash export feature has some limitations. You cannot export 3D Extrusion tracks as Flash. Settings that contain 3D Extrusion tracks export as a blank track. The Flash export feature does not support shadows or gradients used as Texture tracks. However, you can export a static gradient as a bitmap background.
To prepare to export to Flash, you should change any shape track containing text or Spline media to the 3D Line Art shape. Because you cannot use the 3D Line Art shape with the Brush tool, you cannot export brush strokes as Flash.
Select the appropriate track in the timeline.
Choose File > Export > Flash.
A dialog box appears that allows you to name and save the ﬁle.
Name the track and click Save .
The composition is exported using the Flash Export settings, which are controlled by the Preferences window’s Export tab.
The ﬁrst time you browse the KeyFrame Library effects within the Library Browser you must generate thumbnail images for the effects.
Open the Boris Library Browser, by choosing Window > Library Browser, clicking the Open Library Browser button in the timeline or pressing
Command-9 (Macintosh) or Control-9 (Windows).
Select an effect or effect folder and click the Generate Thumbnails button . For more information on using the KeyFrame Library, see the Grafﬁti User Guide.
We recommend that you build thumbnail previews for the KeyFrame Library in the Grafﬁti KeyFramer rather than within your host application. Because building previews actually renders your effect, this process can take as much as 25-30% longer in the plug-in than in the Grafﬁti KeyFramer.
Grafﬁti 4.0.2 includes many bug ﬁxes from the initial version 4.0 of Grafﬁti. Fixed bugs include the following. Some of the following bugs were ﬁxed in earlier versions of Grafﬁti.
Grafﬁti now correctly supports Macintosh OS X 10.4.2 (Tiger).
Grafﬁti 4.0.2 settings now correctly open in Red 3.0.4.
Avid only: Grafﬁti now correctly installs into Avid Xpress Pro 4.8 and Adrenaline 1.8 systems.
An issue with QuickTime export movies has been ﬁxed, which previously caused a crash in certain hosts plug-ins (primarily on Windows AVX hosts). This crash could also occur when selecting the QT codec.
German umlaut fonts now correctly display in Grafﬁti.
Third-party Asian fonts now appear correctly when typing in the Text window.
Final Cut Pro users only: Grafﬁti version 4.02 now correctly ﬁeld renders synthetic media (titles and splines) when you apply as a generator. However, this ﬁx will not work for legacy projects from FCP version 3.0. A previously version corrected a related problem so that other media types would ﬁeld render video in the wells when using an FCP Generator. However, the media placed in the input wells for a Generator should match the FCP sequence size. Both the Grafﬁti size and the size of the well video will appear in Grafﬁti at the FCP sequence size. If the well media is not the same as the FCP sequence size, ﬁelds won't render correctly.
Additionally, any video in the input wells should be the same size as the ﬁltered clip. When applied as a ﬁlter, the Grafﬁti project size is determined by the size of the ﬁltered media which needs to match any video in the wells. This will maintain the integrity of ﬁelds since Grafﬁti doesn't allow host video inputs of various sizes within the same effect.
In a case that requires media sources whose size will not match the FCP sequence size (Generator) or the ﬁlter media size, the best approach is to import that media into the Grafﬁti timeline from disk (rather than from the wells in FCP). This provides ﬂexibility for dealing with non-standard size images, ﬁeld interpretation, and oversize images.
In Grafﬁti 3.0 the Preview To Monitor for Avid feature was disabled even when running in Meridien-based Avid versions. This was corrected in Grafﬁti 3.0.1.
Final Cut Pro 4.0 only: The Grafﬁti banner in the Effect Control tab no longer disappears after you apply an effect.
Final Cut Pro 4.0 only: In earlier versions, Grafﬁti could crash when applied as a ﬁlter or static generator in a setup that included a custom screen layout, such as color correction. This problem would occur when relaunching the Grafﬁti user interface. This problem has been corrected.
The 1-2-1 Deﬂicker preference is now correctly saved with your Preferences ﬁle.
Premiere Pro only: Transitions and presets no longer appear vertically stretched when applied in Premiere Pro 1.5.
Premiere Pro only: Shapes no longer appear and render stretched when previewing a Premiere Pro timeline at High Quality.
Pinnacle Liquid Edition 6.1 only: Fields are no longer reversed when rendering a Grafﬁti effect in Pinnacle Liquid version 6.1.
Dragging an animated spline track into the mask track of another track now correctly preserve the keyframe animation.
Spline track keyframe timing information is now properly preserved when tracks are copied.
Windows only: Crashes that occurred in certain situations when duplicating ﬁlter sets in the Plugin Filter Manager have been corrected.
Windows only: Font styles are now stored with a .B2F extension instead of .B2D. This prevents the Text Styles and Font Styles from overlapping and appearing in the same tab in the Style Palette.
Grafﬁti 4.0.1 ﬁxed situations where the Render thermometer did not update when you worked with either OpenGL enabled, or on an MP system in High Quality mode.
Switching vertically from track to track in the timeline using the keyboard now properly synchronizes the OpenGL interactors shown in the Composition and Preview windows.
Deleting the last used Library Browser folder and then launching Grafﬁti no longer causes Grafﬁti to hang when trying to restore that folder as the current one.
The Render Thermometer now updates more consistently.
Windows only: Old tool tips no longer randomly display in the Controls window when you hover over unrelated areas.
The Delete key now deletes selected items in the Style Palette.
The display of multiple selected items in the Style Palette now indicates the current selection when you Shift-select.
You can now select contiguous items in a table using by pressing Shift and scrolling the mouse wheel.
Position X and Position Y no longer act as if they are locked together in the Fire Filter.
Macintosh only: Repeatedly pressing Page Up or Page Down now works properly when a non-Timeline window is active, except when a text editing ﬁeld is open.
Using the Mouse Wheel to switch a track selection no longer causes the last adjusted parameter in the Controls window to copy to the newly selected track.
Windows only: You can now successfully apply styles to text in the Text window.
The Create Cross Platform Movie checkbox has been removed from the Movie Export Settings dialog. Movies are now automatically created crossplatform.
The BCC Fast Blur ﬁlter no longer crashes if the height of the source is greater than its width. This was previously a problem when the ﬁlter was applied upstream (on the face track) to media, or with a vertically oriented project.
Windows only: Grafﬁti improved low-memory handling in the BCC Fast Blur ﬁlter.
Missing font names are now properly remembered, so you no longer see multiple messages complaining that the same font is missing.
Macintosh only: Occasions where the scroll bars at the edges of windows disappeared have been ﬁxed.
Macintosh only: OpenGL performance has been improved when working with scaling down large textures (for example, 2K+ wide images).
If you open a movie ﬁle as an audio track then open that same ﬁle as a movie ﬁle, when you change the start time of either track, it no longer affects both.
Instances where the Caps Lock feature didn’t work correctly in the Composite window have been ﬁxed.
The Toggle Face/Shape Track Selection button now works correctly for containers.
Windows only: When using Title Containers and switching between the animation styles, the keyframes now reset so the container animates correctly.
The V key in the Color Preview feature now works to commit to a color. Use the C key to dynamically preview colors, and then use the V key to commit to them.
The Title Container Position Y (Roll) and Position X (Crawl) parameters no longer reset when certain other values are changed.
Installing a large number of presets for BCC ﬁlters no longer increases the rendering time. The parameters in these ﬁlters no longer become less responsive.
The Position X and Position Y parameters no longer act as if their interpolation is linked when changing from an interpolation other than Ease In/Out, to Ease In/Out .
Windows only: 3D Sphere effects with Motion Blur enabled no longer render opaque, or crash in speciﬁc instances.
You no longer crash with OpenGL enabled if you nest a track ﬁve times and adjust the ﬁrst shape in the nest.
Final Cut Pro 4.0 only: When you use Grafﬁti as a Transition in Final Cut Pro 4.x, the Grafﬁti Preferences are now respected. This means that when you relaunch Grafﬁti as a Transition, changes you make to Quality, Resolution and other Grafﬁti Preferences no longer need to be reset each time.
Windows only: Many keyboard shortcuts that displayed incorrectly have been ﬁxed.
When you create spline effects using the Add Extruded Pencil button with animated borders, the effect no longer exhibits frames that appear different after rendering than they did when previewing the effect.
Windows only: The BCC Film Damage ﬁlter Hair parameter now functions correctly.
Checkboxes and menus from the Controls window no longer display as Option Change in the History Palette.
Preview to RAM now plays just the rendered section, rather than the entire timeline.
Preview to RAM at Half Rate and Preview to RAM at Quarter Rate now preview the entire duration at their given rate.
Windows only: If you press the Boris logo at the top of the Tools window, you no longer receive a memory error.
Media 100 iFinish only: iFinish now passes the 16:9 ratio to Grafﬁti in transition mode only. The Composite window no longer reﬂects 4:3.
Changing font size on Chart Legends now changes the size of the squares accordingly and the circles remain the same size.
If you change a Fade Animated Chart from Flat to Extruded, the animation now works correctly.
Enabling values and a legend on an Area Chart no longer causes their values to display underneath the chart.
Resetting a chart now fully resets any color changes you made.
Windows only: Oversized images used as media for a background track now show up correctly when OpenGL enabled.
Windows only: Keyframes now display correctly in the timeline when you create them by moving OpenGL interactors if one of the position’s interpolation is set to Constant.
When you map media with an alpha channel to a Cube with multiple faces, you no longer see different media for the sides of the cube in OpenGL vs. Non-OpenGL modes.
Spline shapes no longer shift if you draw a shape with the Brush tool then select the Arrow tool.
If you have multiple tracks selected in the timeline and move them, the timeline now correctly displays the moved tracks.
All settings from the Keyframe Library Backgrounds category now render correctly when you apply them with OpenGL enabled.
Grafﬁti 4.0.2 includes the following known limitations.
If you tumble an object that has an image bump map, you may see a moire pattern as it tumbles.
When you save a style to the Materials tab in the Style Palette, it does not correctly save the Source type that was used in the Bump Map tab.
When you open settings created in previous versions of Grafﬁti, Grafﬁti 4.0.2 ignores controls that were initially enabled in the Lights 2 and 3 tabs.
When you search for a missing media ﬁle using the Search button in the Media Files window, it may not ﬁnd ﬁles that were moved to another local drive. Manually browse to the new location of the ﬁle and press the Replace button .
Tracks containing PSD ﬁles that are converted to containers do not correctly update if you modify them (for example in Photoshop) and then use the Reload Files command.
When you choose Targa Sequence as a ﬁle type when exporting a movie ﬁle, clicking the Compression Settings button erroneously displays QuickTime codec selections.
Files exported to Flash from Grafﬁti cannot be used in Macromedia Flash authoring applications such as Flash MX.
If you use the Keyframe Time ﬁeld in the timeline to move keyframes, all keyframes that a moving keyframe passes are merged to it. Instead, move keyframes past one another by dragging the mouse.
Photoshop (.psd) ﬁles with adjustment layers display incorrectly in Grafﬁti if you convert their track to a container. Turn off any adjustment layers in Photoshop before importing .psd ﬁles if you plan on converting them to containers.
Microsoft DV Type 1 ﬁlters do not work in Grafﬁti as audio tracks.
You cannot adjust Volume and Balance for Grafﬁti audio ﬁles do not update after you have changed them once.
Previewing with audio while you Preview to RAM to Monitor will disconnect Preview to an external monitor.
Audio waveforms do not update when you adjust the global timeline. This is only a display issue and can be corrected by moving something slightly in the Composite window.
Resuming a partial render of an exported QuickTime ﬁle may have some undesirable results. In particular, video compressed with codecs that use frame-differencing and data-rate-limiting (such as Sorenson or Cinepak) may exhibit the following behavior.
Some frames following the resume point may be corrupted. The data rate may be slightly larger than expected. Also, if the ﬁle includes an audio track, a slight blip may be heard at the resume point. This may occur with any codec.
If you apply a title container to the timeline and add text into the container, you cannot successfully change the Background Color (in the Render tab). However, if you disable OpenGL, you can change the color if you view in High Quality.
If you use Frame-Differenced movies (including movies compressed with Apple’s QuickTime Animation codec and some movies compressed with Sorenson), you will see reduced performance. The use of Frame-Differenced movies is not recommended within Grafﬁti.
When host ﬁeld media is exported or previewed as frames, only the ﬁrst ﬁeld is used.
When an image is full size in the Composite window, you must deselect the Shape control in the Composite window’s Controls menu to directly manipulate an object’s Mask or Crop controls.
Avid 24p media renders with an image quality problem that seems to indicate Grafﬁti is treating it as ﬁelded media. We are working with Avid to quickly correct this problem.
Titles created in Avid display garbage in Grafﬁti when viewed at Full Quality and if the visibility for the lower timeline track(s) in Grafﬁti are disabled.
Rendered Grafﬁti or AvidFX effects on tracks in the Avid timeline above Boris effects aren’t unrendered when a change is made to the Boris effect - even in cases where they should become unrendered.
In Edius, when a clip is rendered, that clip is locked. Any changes to a Grafﬁti effect will not display in the Edius Preview window until Edius is closed and reopened. To work around this limitation, complete the following steps:
In the Edius settings, click the Render tab. In the Delete invalid rendering ﬁles section, choose When the Rendered File is Invalid . Unrender the clip by making a change, such as toggling the checkbox to disable/reenable the effect in the Edius Information Palette.
At this time Boris products do not support being launched from inside other Edius ﬁlters (for example, the Combine or Region Edius ﬁlters).
Create the transition in Grafﬁti as if your clips are correct. When you ﬁnish, apply the effect to Liquid and render your transition. The ﬁnal render will be correct.
Alternatively you can press the Media icon in each Grafﬁti track and swap Video 1 and Video 2. When you create your transition it will look correct in Grafﬁti. Remember to swap them back before applying to Liquid.
When Grafﬁti is applied to a segment that also has a transition (including a native Liquid Transition) applied, the effect previews correctly, but renders as if the effect was applied twice (once on the video segment and again during the duration of the transition).
Although choices appear for accessing video tracks 1 - 32, you can only successfully access tracks 1 and 2. Tracks higher than two display as black. This is a limitation of the Pinnacle plug-in architecture.
When you create an effect in Grafﬁti that will output an alpha channel to Vegas (for example a title which does not include the background video), when you apply the effect back to the vegas timeline you will notice the edges appear rough and contain white fringes. You need to reenter Grafﬁti on the effect and in the Grafﬁti Preferences set the Local Preferences’ Alpha Type menu to Premultiplied with Black . The effect will display correctly when you apply back to Vegas. You will need to do this every time you create an effect that outputs alpha.
If a Boris effect is prerendered in the Vegas timeline, future changes to that effect in Boris will be saved but do not appear in the Vegas Preview window until you remove the prerender in Vegas (Tools > Clean up Prerendered Video).
Vegas only previews a single frame of host video in Boris Grafﬁti. The preview frame is taken from the current position of the Vegas cursor. To preview your effect with updating source media, exit Grafﬁti and preview the effect in the Vegas Video timeline or import the video directly into the Grafﬁti timeline.
Motion Blur does not display in a rendered effect if you apply Grafﬁti directly to a clip in Vegas. Instead, import the media directly into the Grafﬁti timeline and you will see motion blur after you render your effect.
When using Grafﬁti as a transition in Ulead, the image quality for host media in the Composite window is very poor. This is because Ulead does not pass a full size image. However, this does not affect rendering. The effect renders in high quality.
When using Grafﬁti within Ulead with the Matrox Parhelia board, you may run into crashing problems. We do not recommend using the Matrox Parhelia board with Grafﬁti.
Projects in certain versions of ULead Media Studio Pro may display jagged edges or reversed ﬁelds in rendered Boris effects. If your system shows this problem, you can install a registry key that indicates that ULead’s video ﬁelds should be reversed. This is found on the top level of the Boris CD in the Ulead Field Change folder.
Final Cut Pro 4.x users must install a minimum Macintosh OX 10.3 installed in order to support Grafﬁti’s OpenGL feature.
If you select a group of splines in the Composite window and adjust one of the Path track’s control parameters, the changes are not applied to any of the splines. The Path controls can only adjust one spline at a time.
The Reverse Keyframes command (Track > Reverse Keyframes) does not work in Spline effects.
If you apply a spline style from the Style Palette to a spline primitive shape, the shape resets back to the default shape values.
When the Text window is open, changes made in the Controls window (such as Margin, Wrap, or Font) will not update to the Composite window.
The Date format Day/Month/Year in the Date/Time generator displays a comma at the end if you have suppressed the time display.
Tracking behaves differently depending on whether the text was created with the Text tool or in the Text window. When you create text with the Text tool, the tracking honors the justiﬁcation that is set in the Transform tab. When you create text in the Text window, the tracking is applied with center justiﬁcation. If you want to track to the right or left using text that was created in the Text window, select the text with the Text tool and move it slightly. Then set the justiﬁcation in the Transform tab. The Tracking now uses the justiﬁcation. For details, see “Working with the Transform Tab” in the User Guide.
Importing RTF documents using the Insert Text feature in the timeline’s contextual menu will cause all tab delimited text to appear on the ﬁrst line in Grafﬁti, rather than in multiple lines. You will need to manually insert line breaks.
Text on a Path moving from right to left will display upside down. To correct this, manually reverse the path, or click the Reverse Path checkbox in the Path tab.
If you ﬂip an image vertically and then render it through the host, the rendered video appears jittery. Enable the Better Quality Field Rendering checkbox to render correctly.
Accented letters such as é are not passed from the Chart Editor to the Chart Container correctly. Therefore, a Chart Legend or Grid label that uses accented characters must be entered directly into the text track, using the Text tool or Text window. If this is necessary, it must be done as a ﬁnal step when building the chart. This is because editing the chart data or enabling/disabling the Legend or Grid updates this text using Chart Editor text; as a result, the accented characters will be lost.
When both the Reveal and Remove checkboxes are enabled in the Animation tab, Position X no longer animates when you work with extruded Bar and Pie Charts.
Removing an extruded Bar Chart by selecting the Reveal Shape checkbox in the Animation tab does not work correctly. Instead of animating the height of the bars sequentially, they are simply removed individually. In addition, when this checkbox is selected, the Overlap Time parameter is not respected.
For the most reliable results, the Animate button should not be in static mode when working with charts. For more information, see the Grafﬁti User Guide.
On certain systems, extruded pie charts pieces may incorrectly display their corners. Reduce the Bevel to 0 to ﬁx this.
If you have long names for the X axis (defaults: South, East, West, and North), and you are animating the chart (if you have animation turned on) the names will not line up with the actual chart.
Selecting the Apply Current Spline Style checkbox can create unintended changes if the setting is modiﬁed after another spline style is selected. For example, you create a static Line chart with the Apply Current Spline Style checkbox selected. You apply another spline style from the Style Palette to a different track. If you then animate the chart, the chart will update with the latest spline style, rather than the style originally saved with the effect. The only workaround necessary is to reapply the original spline style from the Style Palette.
Depending on the scale you set for a Line Chart, you may see small nicks or indentations in the lines when you work in Full Resolution. Slightly increase or decrease the scale of the line chart to ﬁx this.
Any effect that uses a ﬁlter involving edge detection (for example, RGB Edges) should be rendered with the Better Quality Field Rendering checkbox selected. Otherwise, the rendered effect will jitter.
In the 2D Particles ﬁlters, increasing the particle size scale can cause some custom shapes to truncate. You can avoid this by looking at the initial, unscattered particle grid. If some particles are cut off by the frame when you increase their size, then they will remain cut off throughout the duration of the effect. To avoid this, adjust the size parameters so that no particles are initially cut off.
The ﬁrst rendered frame of effects using the 2D Particles Advanced ﬁlter will display particles, although you will not see particles in the ﬁrst frame of a preview.