If you are not using Sapphire Plug-ins version 2, please visit the v3 support page or v1 support page instead. The effect category name is "Sapphire Plug-ins" for v1, "Sapphire2" for v2, and "Sapphire3" for v3.

If you have a technical support question that is not answered by the information below, please contact us at support@genarts.com. Be sure to include your company name and info about what Avid version and what Sapphire Plug-ins version you are running. If you have a license specific question, please email license@genarts.com.

Frequent issues:

• Why do I get a watermark over the plug-ins' outputs?
• On Windows, Sapphire becomes unlicensed when connecting to ISIS, Unity, or Interplay
• How do I access the online documentation?
• How can I process a title or key without affecting the background?
• Can Sapphire v1 and v2 be installed at the same time?
• Can I conform from Sapphire v1 to v2?
• Does Sapphire 2 work with Avid DS?
• Does Sapphire 2 work with Mac OS 9?
• Can I transfer my serial number to a new machine?
• How can I make Sapphire Plug-ins render even faster?
• On Mac, with Avid 2.7/5.7, Sapphire is not finding my Dongle ID.
• I have various issues with the AVX2 version of Sapphire 2, on Avid 2.5/5.5 or earlier.
• My transition keyframes don't adjust when the length is changed.
• The Sapphire2 plug-ins don't appear in my Effect Palette.
• I get out-of-memory errors such as "Insufficient memory" or "malloc returned null pointer"
• Loading or using a complex bin is very slow or runs out of memory.
• The Avid crashes while initializing AVX plug-ins.
• When rendering multiple tracks with Sapphire effects, the results look incorrect.
• On Mac OS before 10.2.8, the serial number installer doesn't run properly or I get a watermark.
• How can I delete precomputed clips?
• How can I un-install Sapphire Plug-ins?

This usually indicates your free trial period has ended, or the expiration date of your serial number has been reached. Go to the "Help" dialog while using any plug-in, and it should tell you when it expired. If you acquire and enter a new valid serial number, the results should return to normal. Otherwise, please review the following list.

• If you installed a Serial Number that requires a specific Avid dongle ID, make sure that dongle is connected to your machine. If it is connected and you are running an Avid version 2.5/5.6 or 2.7/5.7, please see the support item below to update your dongle driver.

• If the Ethernet (MAC) address of your computer has changed since you ran the installer or entered your serial number, you may get this watermark because the software thinks it is running on a different machine than the one that was licensed. If you are on Windows, make sure your Local Area Connection is enabled: go to Start -> Control Panel -> Network Connections, and right click on Local Area Connection. Running the Sapphire Plug-ins installer again may also help with this. If you need to change your Ethernet ID, you should uninstall the plug-ins before it changes, and select the option to register that uninstall, so the serial number can then be reinstalled with the new Ethernet ID.

• On Windows, if your license is lost when connecting to ISIS, Unity, or Interplay, please see the support item below to resolve this.

• If you are on Media Composer Software-Only version 2.5, please upgrade to MC version 2.7 or greater, or contact us for a temporary work-around until you are able to upgrade.

• Make sure you have run the Sapphire installer on your machine, rather than cloning, ghosting, or copying files from another workstation. If you installed by copying, just re-run the installer.

• If you are getting the watermark only on the DS side of a Symphony/DS dual-boot system, and your Serial Number requires an Avid Dongle ID, try reinstalling your dongle driver. Go to http://www.safenet-inc.com/support/tech/sentinel.asp. Click on Sentinel SuperPro, then download and install the Windows driver, restart DS, and see if that helps.

• Make sure the date on your computer is correct.

• Make sure you are not just looking at old frames rendered with the watermark before you installed your license. Change any parameter to rerender the image, or delete the precomputed clip.

• If you are on Windows, and Sapphire was installed while logged on as a different user, please make sure you are running Sapphire 2.041 or greater. There was an issue with multiple users in 2.04 and earlier, especially on DS.

• If you are on Mac and have a Serial Number that requires an Avid dongle ID, please make sure you are running Sapphire 2.01 or greater. There was an issue with version 2.0 properly reading Mac dongles.

• If you are on a Mac OS before 10.2.8, you should update to OS 10.2.8 or later, or install Safari via Software Update. Then reboot your machine, rerun the Sapphire Plug-ins installer, and reenter your serial number if you have one.

On Windows, Sapphire becomes unlicensed when connecting to ISIS, Unity, or Interplay

This issue can occur if your Sapphire serial number got licensed to one of the PCI network cards rather than the on-board NIC. Sapphire version 2.051 or greater includes improvements that will help with this. To resolve this issue:

1. Uninstall the current version, and select the option to register the uninstall over the web. (Go to Start->Control Panel->Add or Remove Programs. Find "GenArts Sapphire Plug-ins v2 for AVX" on the list, and press the Change/Remove button.)
2. Disable all Ethernets except the built-in motherboard. (Go to the Network Connections Control Panel, and click right on each to see its properties and selectively disable.)
3. Download and install the most recent version, and reinstall your serial number.
4. Re-enable the desired Ethernets. Always leave the built-in ethernet enabled, even if it's not connected to anything.

How do I access the online documentation?

Online documentation for Sapphire Plug-ins is normally installed on your machine along with the software and is available in HTML and PDF formats. It includes some general information about how to load and use plug-ins, and also includes a page for each effect with an example image, description of what each parameter does, and links to related effects.

You can access this documentation directly from your Avid workstation even if it is not connected to the internet. On Windows go to Start -> Programs -> GenArts Sapphire2 AVX -> Online Help (HTML) or (PDF). On Mac, go to Applications/GenArtsSapphire2AVX and select the online documentation.

A "Help" dialog is also provided when using a plug-in, which gives information about that plug-in currently being used. To view this on Avid AVX1 products, click on the small rectangular icon to the left of the effect name in the Effect Editor. On DS, click on the "Show Effect UI" checkbox that appears after the effect parameters. This dialog shows your license status, and provides links that bring up online documentation in your HTML browser.

How can I process a title or key without affecting the background?

Sapphire v2 allows you to easily process a title or key without affecting the background. To do this, drop a Sapphire Plug-in onto a title or key and then select the Apply To Title/Key checkbox in the Effect Editor. This causes the plug-in to process the fill and matte of the title together.

When you replace a title effect in this way, any animation curves in the title are lost, and only the matte and fill clips remain. If you want the title to move, you can instead use the Crop/Transform parameters to perform the moves within the Sapphire effect.

You can also apply more than one Sapphire Plug-in to a title or key without affecting the background. To do this, drop the first effect onto the title and select Apply To Title/Key as above. But then change its Background input to "None" to prevent it from compositing. Next, apply another Sapphire effect by alt-dropping it on the first effect, but leave Apply To Title/Key unselected this time. You can alt-drop any number of additional effects in this way. In the final effect, set the Background to "1 Track Below" to composite the final result. Note that only the first effect should have Apply To Title/Key selected, and only the last effect should have a Background selected. You should use only Sapphire2 effects between this first effect and the final composite, because other effects will probably not pass the alpha channel through in a compatible way.

The Wipe and Dissolve transition effects do not include an Apply To Title/Key option, because they are required by AVX to accept only 2 inputs, and therefore can not replace a title which requires 3 inputs.

To apply a transition between two titles without affecting the background, first apply S2_MakeRGBA to both titles, and add the transition effect between these titles. Then shift-select both sides of the transition (incoming and outgoing) and use the Collapse button on the timeline toolbar to nest them together. Finally, alt-drop S2_Layer on the nest and you should see the completed effect. If your Avid allows you to apply effects on filler, instead of collapsing the transition, you can add S2_Layer on a filler track on top of that (alt drop), and select Background: 2 tracks below to composite over the background. If you want to also apply other effects to each title such as distortions or blurs, use them instead of S2_MakeRGBA above, and select Apply to Title/Key. To wipe on or off a title, just use an all-black title for the other side.

If you are using Xpress DV and processing a title with multiple nested plug-ins, make sure you turn OFF real time mode, because real time mode will corrupt the alpha channel being passed from one plug-in to the next.

Can Sapphire v1 and v2 be installed at the same time?

You can have Sapphire v1, Sapphire v2 for AVX1, and/or Sapphire v2 for AVX2, all installed on your Avid at the same time, as long as your Avid product supports those versions. This allows sequences saved with older versions of plug-ins to still be loaded and rendered. However, we don't recommend mixing these different versions in the same sequence because there can be problems when AVX1 and AVX2 plug-ins are nested together.

On Mac, Avid has discontinued support for previous versions of AVX1 plug-ins with releases 2.5/5.5, so older plug-in versions do not appear in the Effect Palette. Avid's version 3.0 now allows conforming unsupported AVX1 plug-ins forward so previously saved settings are not lost. Please see below for info on how to conform from Sapphire v1 to v2.

On Windows, the Sapphire v1 plug-ins should continue working fine.

Sapphire v1 plug-ins are all together in one "Sapphire Plug-ins" category, but the Sapphire v2 plug-ins are split into multiple "Sapphire2" categories. The Sapphire2 AVX1 version is indicated with an "(avx1)" appended to the category name.

Sapphire Version	AVX Version	Effects Category Name(s)
v1	AVX1	Sapphire Plug-ins
v2	AVX1	Sapphire2 ... (avx1)
v2	AVX2	Sapphire2 ...

Can I conform from Sapphire v1 to v2?

Yes, but only with recent Avid versions...

• For Media Composer 3.0 or Symphony 3.0 or greater:
  • Make sure Sapphire v1 is not installed. (If v1 is installed this procedure will not work, and should not be necessary to conform as v1 will just continue to be used.)
  • Make sure Sapphire 2.06 or greater is installed.
  • In the Project window, go the Settings tab and double-click on Effect Editor. In the dialog that pops up, check the box labelled "Automatically Promote Missing AVX1 Effects".
  • Click OK, and restart your Avid.
  From then on, when you open a sequence with missing effects, a dialog will popup up with the following message: "This sequence contains missing AVX effects which will be promoted to Advanced Keyframe AVX 2.0 effects." Click OK. A backup copy of your sequence will be made, and the missing effects will be promoted to AVX2.

• For Media Composer 2.8 or Symphony 1.8:
  • Make sure Sapphire v1 is not installed. (If v1 is installed this procedure will not work, and should not be necessary to conform as v1 will just continue to be used.)
  • Make sure Sapphire 2.06 or greater is installed.
  • After opening a bin, but before opening a sequence, type the command: PromoteMissingAVXEffects in the Avid console.
  • Then open the sequence. If there are any missing promotable AVX1 effects a confirmation dialog will be displayed. Click OK.
  Note this must be done again each time you open another bin containing old effects.
  If you have trouble conforming with this method, we suggest upgrading to Media Composer 3.0.

• For older Avid versions:
  For Avid versions 2.7 or older, sequences saved with Sapphire v1 effects can not be converted automatically to use the Sapphire 2 version, and Sapphire2 for AVX1 is not automatically converted to Sapphire2 for AVX2, or vice versa.

  However, you can have Sapphire v1 and v2 (for AVX1 and/or AVX2) installed on your Avid at the same time, as long as your Avid supports those versions. This allows sequences saved with older versions of plug-ins to still be loaded and rendered. Sapphire v1 appears in the "Sapphire Plug-ins" effects category. Sapphire v2 for AVX1 appears in the "Sapphire2...(avx1)" effects categories, and Sapphire v2 for AVX2 appears in the "Sapphire2" categories. See the table above.

Note that these methods will not currently allow you to promote templates (presets) saved in the bin. Avid may fix this in a future version. For now a workaround is to make a sequence with the old templates (using older versions of Avid and Sapphire if necessary), promote that sequence as described above, and then create new templates from the promoted sequence.

If you intend to online using an Avid product such as DS that does not yet support AVX2, be sure to use the AVX1 version. On DS, temporal effects will also not conform because DS does not include support for alternate frame access (AVX1.5). See below for more details about DS support.

Does Sapphire 2 work with Avid DS?

Yes, the AVX1 version of Sapphire 2 will work with DS 8 on both Windows 32 and Windows 64. Here is a compatibility matrix for various Sapphire and DS versions:

	DS 6 or DS 7	DS 8  32bits	DS 8  64bits
Sapphire 1  AVX1	Yes	Yes (use 1.35)	No
Sapphire 2  AVX1	(with limitations)	Yes	Yes
Sapphire 2  AVX2	No	No	No

DS 7 and earlier versions do not allow the optional inputs used by Sapphire 2, so the plug-ins can not be used in the timeline. In tree-mode the input connections can also be confusing. We recommend using Sapphire version 1.35 with DS 7 or earlier, except for conform of sequences that have already been created on another Avid product.

No versions of DS include support for AVX1.5 or AVX2. The temporal effects in Sapphire 2 are not available on DS because it does not include support for alternate frame access (AVX1.5). If you intend to conform from another Avid product to DS 8, be sure to use the Sapphire 2 AVX1 version of the plug-ins, and also avoid using the effects in the "Time" category.

Note that while Sapphire 2 works with DS 8 on 64bits, Sapphire v1 does not. If you need to load sequences on DS 8 saved with Sapphire v1, you should run the 32bit version of DS 8 instead. Avid has made available a 32bit version of DS that will run on Windows 64 which may be helpful in cases like this. We are hoping Avid will provide a way to automatically convert saved Sapphire v1 effects to v2, so this is not necessary in the future.

Does Sapphire 2 work with Mac OS 9?

No, version 2 works with Mac OS 10.2 or greater. Sapphire version 1 can be used with Mac OS 9.

Can I transfer my serial number to a new machine?

It is possible to transfer your version 2 serial number to a new machine. To do this, first uninstall Sapphire Plug-ins on your old machine. During the uninstall, select the option to register that uninstall via the web. As long as the uninstall is successfully registered, you should then be able to install your serial number on the new machine. The license is cross-platform so you can transfer a serial number between Windows and Mac systems in this way.

If your serial number is for a specific Dongle ID, make sure that dongle is also moved to your new machine and connected.

How can I make Sapphire Plug-ins render even faster?

• Any increase in the number or speed of your computer's CPUs should speed up Sapphire Plug-ins. They do not use Avid boards or special hardware, but they will benefit from dual, quad, or even 8-CPU systems.
• Adding more RAM to your computer might also help, but if you have a recent standard Avid hardware configuration then you probably already have enough.
• For a temporary speed increase, you can lower the Resolution parameter found at the end of the parameter page for all plug-ins (except on DS where the resolution can be set in the DS interface itself). In addition, some effects such as Rays, EdgeRays, BlurMotion, and Glare have special resolution parameters (RaysRes, BlurRes, GlareRes) which lower the internal resolution to soften the effect.

On Mac, with Avid 2.7/5.7, Sapphire is not finding my Dongle ID

Avid has included an older dongle driver in their 2.6/5.6 and 2.7/5.7 releases for Mac which does not work with Sapphire Plug-ins. If your Sapphire serial number requires a dongle which is properly attached, but you still get a warning while installing it that says "Could not find the dongle required by your serial number", or you are getting a watermark when using the effects, you may need to install a more recent dongle driver.

To solve this, download the Sentinel Driver version 7.3.0 and save the file to your desktop. It should unzip automatically and create a folder called Sentinel System Driver 7.3.0. In there, double-click on SentinelSystemDriver.pkg to install the driver. Finally restart your Avid application, and the plug-ins should work.

I have various issues with the AVX2 version of Sapphire 2, on Avid 2.5/5.5 or earlier.

Avid versions prior to Media Composer 2.6 and Xpress Pro 5.6 included various AVX2 bugs that could make it difficult to use AVX2 plug-ins sucessfully. If you experience some of the problems listed below and are not able to upgrade your Avid version, you can instead rerun the Sapphire2 installer and select the AVX1 version of Sapphire2. Then replace the the AVX2 plug-ins in your sequence with the equivalent Sapphire2 AVX1 plug-ins.

Some known AVX2 issues with earlier Avid versions are as follows:

• Renders sometimes hang at the end, with the render dialog window open.
• Auto Start and End keyframes don't get created, even when that option is selected in the preferences.
• Transition keyframes are not elastic by default, and don't move when you change the transition duration. (See below for more info on this.)
• The Auto Keyframes don't appear when you replace one transition with another. They are invisible until you change a parameter value.
• Applying a 3-input effect as a transition can cause a crash.
• There is no way to multi-select keyframes and adjust them together.
• Keyframes sometimes don't appear, or can't be edited properly.
• The advanced Keyframe editor seems confusing.
• The vertical scale in Keyframe graphs is too large with no way to scale or shift, making it difficult to set up keyframe graphs with small ranges of values.

My transition keyframes don't adjust when the length is changed.

In some Avid versions the transition keyframes automatically made by AVX2 plug-ins are "fixed" instead of elastic as they should be. The workaround is to right-click in the keyframe graph of the Wipe Amount or Dissolve Amount parameter and select "Elastic". This should cause all the keyframes to adjust when the transition length changes.

This problem should be fixed as of Avid versions 2.7.4 / 5.7.4.

The Sapphire2 plug-ins don't appear in my Effect Palette.

On Mac, if you have a new Avid HD version 2.5/5.5, please make sure you are using Sapphire 2.03 or greater.

On Windows, if your Avid product does not support AVX2, please rerun the Sapphire Plug-ins installer and be sure to check the option for the AVX1 version of the Plug-ins. Some older Avid products include an AVX2 folder even thought they don't support it, and this caused the Sapphire 2.0 installer to install AVX2 instead of AVX1 by default. The Sapphire 2.02 and later installers are better at properly detecting AVX2 support, and should not have this problem.

I get out-of-memory errors such as "Insufficient memory" or "Sapphire ran out of memory"

This can occur if a plug-in fails to access the amount of memory it needs. The full message may say: "Insufficient memory: 1234 bytes requested" or "Sapphire ran out of memory trying to allocate 1234 bytes".

When AVX1 plug-ins are used in very complex bins, the Avid can create many more effect instances than you actually created. This happens when there are many short cuts in the sequences in the bin, combined with deep nesting of effects. The Avid makes a copy of each effect on each layer every time there's a cut anywhere on any layer. This can multiply to many copies of the effects, and so even though Sapphire doesn't allocate much memory for each effect, you can end up running out of memory. The recommended workarounds to this from Avid are:

• Prerender (mix down) some of the layers. Its usually best to do this in a separate sequence so you can easily go back and make changes.
• Cut the sequence up into shorter sub-sequences.
• Make sure you have at least 1GB of memory, or more if possible, and allocate most of it to the Avid.
• If possible, upgrade your Avid product to a version that supports AVX2 plug-ins, which should not have this problem.

Adding more RAM to your computer should also help with this.

Loading or using a complex bin is very slow or runs out of memory.

When AVX1 plug-ins are used in very complex bins, the Avid can create many more effect instances than you actually created. This happens when there are many short cuts in the sequences in the bin, combined with deep nesting of effects. The Avid makes a copy of each effect on each layer every time there's a cut anywhere on any layer. This can multiply to many copies of the effects, and so even though Sapphire doesn't allocate much memory for each effect, you can end up running out of memory. The recommended workarounds to this from Avid are:

• Prerender (mix down) some of the layers. Its usually best to do this in a separate sequence so you can easily go back and make changes.
• Cut the sequence up into shorter sub-sequences.
• Make sure you have at least 1GB of memory, or more if possible, and allocate most of it to the Avid.
• If possible, upgrade your Avid product to a version that supports AVX2 plug-ins, which should not have this problem.

The Avid crashes while initializing AVX plug-ins.

• Make sure the only files in your AVX_Plug-ins and AVX2_Plug-ins folders are plugin files. If there are extraneous files there, remove them and restart.

• If that doesn't help, remove all the files from the AVX_Plug-ins and AVX2_Plug-ins folders except Sapphire, and restart. If it now restarts ok, put the other files back one by one, restarting each time, to find out which one is failing.

When rendering multiple tracks with Sapphire effects, the results look incorrect.

This issue can sometimes occur when Sapphire plug-ins generate transparency (alpha) channels and combine them between multiple tracks. Processing titles or keys or using the crop/transform parameters can generate an alpha channel.

The solution is to render only the topmost track containing Sapphire effects. If you render any lower track first, or all tracks together, you may get incorrect results depending on the order Avid happens to process them. When you render only the topmost track, it should automatically render the lower tracks correctly as needed.

If you already have bad results, first delete the incorrect prerender clips for all the affected tracks (top and all lower ones) or just change a parameter in an effect in the lowest track which should cause the other tracks to become unrendered.

On Mac OS before 10.2.8, the serial number installer won't start, or I get a watermark.

The serial number installer will not run properly if you are missing the WebKit framework. To resolve this, update to OS 10.2.8 or later, or install Safari from http://docs.info.apple.com/article.html?artnum=120233. Then reboot your machine, rerun the Sapphire Plug-ins installer, and reenter your serial number if you have one.

If you still have trouble, please let us know.

How can I delete precomputed clips?

If you use Sapphire Plug-ins without a license beyond the free trial period, rendered frames will have a protective watermark on them. If you later receive a license, you may need to re-render some precomputed clips that have been saved on your system.

To delete your precomputed clips:

1. On your Avid, go to Tools -> Media Tool
2. Select "Precompute Clips" and pick the appropriate drives and projects.
3. Select all the precompute clips that have the watermark on them. Be careful NOT to select any title or key media. Normally the clips to delete will be called something like sequencename,S2_EffectName. You can check which clips have the watermark by looking at the Frame or Script view.
4. Once you have selected the appropriate clips, delete them by pressing Delete.

How can I uninstall Sapphire Plug-ins?

On Windows: go to Start->Control Panel->Add or Remove Programs. Find "GenArts Sapphire Plug-ins v2 for AVX" and/or "GenArts Sapphire Plug-ins 1.35 for AVX" in the list, and press the Change/Remove button.

On Mac: go to the Applications/GenArtsSapphire2AVX folder and double click on Uninstall Sapphire. Or to uninstall Sapphire Plug-ins version 1, go to the Applications folder, double click on GenArtsSapphireAVX, and select Uninstall Sapphire Plug-ins.