Support for Sapphire for Final Cut Pro and FxPlug API products

Version 8

 

Sapphire 8 is not supported for Final Cut Pro and FxPlug API Products due to technical restrictions. GenArts is working with Apple to investigate future support for Final Cut Pro X. The most recent version of Sapphire that supports Final Cut Pro 7 is Sapphire v7.

 

 

 

 

Version 7

If you have a technical support question that is not answered by the information below, please contact us through our support form.

Be sure to include your company name, the host product name and version you are using, and the version of Sapphire plug-ins you have installed. You can find the Sapphire plug-ins version information in the "About" dialog which can be displayed while using any plugin.

 

 

Frequently Asked Questions

Installation and Uninstallation

Licensing

Watermarks and Trials

FX Central, Presets and Tutorials

System Requirements and Diagnostics

 

 

 

 

How do I uninstall Sapphire from my current machine?

To uninstall:

  • On Mac, go to: /Applications/GenArtsSapphireFXPLUG folder and double click on "Uninstall Sapphire".

If your machine is not connected to the web, then select "Display an uninstall code to register on another computer's web browser". Follow the instructions to register the uninstall via another machine.

 

How am I notified of complimentary software updates?

The software automatically checks for updated versions.  If you would like to check manually: 

  • On Mac, go to: /Applications/GenArtsSapphireFXPLUG/Check for Sapphire FXPLUG Updates.

Notifications are also made available through standard GenArts communications, i.e., newsletters or other email communication.

 

How do I access my complimentary software updates?

Updates to your software are published on our website as the latest version of the installer and can be found by going to http://www.genarts.com/support/downloads/sapphire/final-cut.

 

Where can I download the Sapphire installer?

You can find and download the installer from here: http://www.genarts.com/support/downloads/sapphire/final-cut.

 

Can different versions of Sapphire be installed at the same time?

No, the Sapphire v7 installer will replace Sapphire v2, v5 and v6. This prevents confusion from multiple copies of the same effects, and allows your saved projects to automatically use the new version. To use an older version of Sapphire on your machine, please uninstall the current version and install the older version.

 

Will projects saved with prior Sapphire versions continue to work with Sapphire v7?

On Final Cut Express, Final Cut Pro and Motion, you can load projects saved with Sapphire v6 effects and they should automatically convert to use Sapphire v7.

However, we do not advise trying to translate effects from v2 to v7.

 

Will projects saved with the AE version of Sapphire work with the FxPlug version?

No, FCP projects that use the AE version can not be converted to use the FxPlug version.

 

Can the FxPlug and AE versions of Sapphire be installed at the same time?

If you are on FCP or Motion we suggest using the FxPlug version unless you have previous projects saved using the AE version.
However, you can install both the FxPlug and AE versions of Sapphire on the same machine. The effect category names will include "(FxPlug)" for the FxPlug version, so you can identify which is which when selecting a plugin. 

 

I received a message that "the number of installations permitted with this serial number has been reached." How do I activate my license?

This message indicates that you have installed your serial number on the maximum number of machines permitted.  To free up your serial number, uninstall it from one of the machines where it is currently installed, and select the option to register the uninstall over the web.  Then, follow the instructions to activate the license.

 

Can I use the same serial number on multiple machines?

If you have a serial number for one machine, you can only use it on one machine.  In order to use it on a different machine, you will need to transfer your serial number.

 

How do I activate my serial number?

If the software is already on your machine,

  • On Mac, go to: /Applications/GenArtsSapphireFXPLUG folder and double click on "Install Serial Number".
    • Follow the instructions and choose the option to authorize over the web. Click here if your machine is not connected to the Internet. 

To install the software (if it is not on your machine), go to: http://www.genarts.com/support/downloads/sapphire/final-cut. Click on the link to download the installer.  Follow the instructions to install the software.  When prompted, choose the option to enter your serial number. Then choose the option to authorize over the Internet.

 

How do I activate my serial number if my machine is not connected to the Internet?

If the software is already on your machine:

  • On Mac, go to: /Applications/GenArtsSapphireFXPLUG folder and double click on "Install Sapphire".
    • Follow the instructions and select “Authorize manually ...".
    • Then, follow the instructions to register the install via another machine.

 

How do I transfer my serial number to a different machine?

First, you need to uninstall the plug-in software to remove the license from your current machine. Then, install the software on your new machine and follow the instructions to activate the license.

 

Which machines are my serial numbers currently installed on?

Go to http://www.genarts.com/authorize/sn-lookup. Then, paste your serial number and click "submit request".

 

On Mac, why do I get "Failed writing reg file" when entering a serial number?

This usually indicates you don't have the necessary permissions when a file is being saved. Please log in as administrator and try again.

 

Do my full Sapphire licenses need to be on the same version as my render nodes?

Yes, you will need to either update both your interactive license and render nodes to the most current version, or install an older version on your workstation and render nodes.

 

How do I remove the "Sapphire" watermark?

Go to the "Help" dialog while using any plug-in to determine if your trial or temporary license has expired. If so, then you need to acquire and enter a valid license. Once you receive the valid license and activate it, the results should return to normal.           
                                                                           
If you have a license that has not expired, review the following:

  1. Ensure you have run the GenArts installer on your machine, rather than cloning, ghosting, or copying files from another workstation. If you installed the software by copying, then download and re-run the installer;
  2. Ensure the date on your computer is correct;
  3. If the Ethernet address of your computer has changed since you ran the installer, then re-install the software and re-enter your serial number.

 

How do I remove the "Sapphire" watermark when using a floating license?

At any point, you can go to http://www.reprisesoftware.com/admin/software-licensing.php for troubleshooting guides and manuals, or go to  http://www.reprisesoftware.com/RLM_Troubleshooting_Tips.pdf for a troubleshooting checklist. 

Note that Sapphire v6 will only work with RLM version 9 and later. If you are running an earlier version, please update your server to use the RLM v9 or newer. You can download the latest version of RLM from here: http://www/genarts.com/support/downloads/rlm.

Check that the date on your computer is correct for both server and client.

Make sure the port numbers used in your server and client license files are the same. The port number is shown after the hostname and Ethernet ID in the HOST line of the license. You can change the port numbers without invalidating the license, but you will need to restart the license server after they are modified. Also make sure this port number doesn't conflict with other applications that might use the same port.

Check the status of your licenses using the RLM server's web interface. From the server machine go to http://localhost:5054 or from another machine use http://servername:5054, replacing server name as appropriate. See if any useful information is shown there. To reread the license file: on the left side of the main page select Reread/Restart Servers, and then on that page click on Reread Licenses.

Make sure the Ethernet ID in your license correctly matches that of your license server machine. Run the following command on your license server machine to find the Ethernet ID that RLM is expecting:

  • On Mac: "/Library/Application Support/GenArts/rlm/rlmutil" rlmhostid ether

Then make sure the Ethernet ID in your server license file matches. The Ethernet ID is just after the hostname in the HOST line of the license. If they differ, please let us know the correct Ethernet ID so we can regenerate your license.

Make sure the hostname in your license files correctly matches that of your license server machine. Run the following command on your license server machine to find the hostname that RLM is expecting:   

  • On Mac: "/Library/Application Support/genarts/rlm/rlmutil" rlmhostid host

Then make sure the hostname in your server license file matches that. If they differ, either correct the name in the license files, or use the license server IP address instead.  (If you instead need to change the host ID, then click here to submit a request to our Support team.)

If all looks OK in the web interface, and the license seems to be up, then make sure you can "ping" the server from the client using the hostname or IP address specified in the license file. (This ensures that the client can get the server's IP address from its hostname, and that there is a working connection between them.) If this doesn't work, try replacing the hostname with the IP address of the license server in the license files.

 

Why do my background renders show a "Sapphire" watermark?

Ensure you have run the Sapphire installer on each remote machine, rather than just ghosting the drive or copying files from another workstation.  Ensure Sapphire Plug-ins are working properly without a watermark on the machine you are initiating the network renders from.

 

Why does my project render only black with a "Sapphire" watermark?

This normally happens when your free trial and/or license have expired for some time.

  • If you think this machine should be licensed, check to see if your Network Connections are disabled or not.
    • If you want to work without a network connection for security reasons, you can unplug the network cable but still leave the network adapter enabled.

 

How do I return to my previous version of Sapphire after my v7 trial?

First, uninstall the plug-in from your machine. Then, install the plug-in using the older installer and re-enter your serial number.

 

How long does the trial last and does it watermark?

Your Sapphire trial is for two weeks. The trial will act as a full version and will not watermark until the trial period is over.

 

My complimentary trial expired -- How do I get additional time?

The trial is for two weeks. After this time you may purchase a license at: http://www.genarts.com/buy/sapphire/final-cut.

 

How do I access training materials?

Tutorials and other training material are available within our FX Central community site.  To view our existing tutorial collection, please visit: http://www.genarts.com/fx-central.

 

How do I access the documentation?

Documentation for Sapphire is installed on your machine with the software and is available in HTML and PDF formats.

  • On Mac, go to: /Applications/GenArts SapphireFXPLUG.  Select Online Help.html or Online Help.pdf

A "Help" button is also available at the bottom of the plug-in parameters, which provides information about the plug-in, your license status, and links that bring up online documentation in your HTML browser.

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 workstation even if it is not connected to the internet. 

 

How do I apply effects and use Sapphire parameters?

Instructional information can be found in the documentation. Additionally, we created a brief video that shows how the plug-ins work. This can be found by clicking http://www.genarts.com/fx-central/tutorials.

 

How do I install Sapphire Presets?

Note that a valid FX Central subscription is required for downloading the Sapphire Presets. 

Generally, When you download a Sapphire preset collection from FX Central (http://www.genarts.com/fx-central/look-collections), you get a .gpz file. For example, the February Collection file looks like this: “S_2013-February-Collection.gpz”

Note: Depending on your web browser download setting, you may download the file as a “.zip”. If that happens, you can rename the “.zip” extension to “.gpz”.

To install, double click on the .gpz file and the files will automatically be installed to your preset collection. A prompt will show:  "Installed ## new presets."  Then, click on "Ok". The next time you start your host application, the Sapphire presets should show up in your preset collection.

Other ways of installing presets would be to right click on the .gpz file:

  • Select “Open with” > select “Preset Browser” > click “Ok”
    OR
  • Select “Open with” > select “Other…” > select “preset_browser.exe” > click “Ok”

 

How do I delete a preset from my computer?

The directory below is the default location for where the presets are saved -- if you have moved the presets to a custom location, go there and then follow the instructions below.

To delete a preset:

  • On Mac, go to: /Library/Application Support/GenArts/Sapphire/presets/genarts/

Select the Preset Look you want to delete. (They are in this format: S_PluginName_PresetLookName.gp.)

Right click on the preset file and select "Delete."

 

How do I get the preset browser?

Navigate to the effects panel, click and drag an effect onto your footage, and click “Load Preset” to view the FX Central Preset Browser.

 

Why don't I see my footage when I preview a transition in the preset browser?

You need to ensure that your current time indicator is on a frame that contains the Sapphire transition in order to properly display a transition preview.

 

Can I create and save my own presets?

Yes, you can create your own presets as well as make customer lists of presets for specific projects or mark favorites.

 

Where do the presets and custom presets get saved to? And when working in a shared environment, how can I save the presets to a central location?

The default presets (.gp files) are located in the following location:

  • On Mac: /Library/Application Support/Genarts/Sapphire/Presets

To change the loacation of where the presets are saved, go to the preset browser, click on "Edit" and then "Browser Settings". A dialog to will appear and allow you to view or change the preset folder locations.

 

Where is the diagnostic log file and how do I email it?

The "Help" dialog now has an "email Support" button that takes you to a form. The s_log_extended.text file will automatically be included when using this form.

Or

The diagnostic log file can be found here:

  • On Mac, the file is in: /Applications/GenArtsSapphireFXPLUG/config/s_log.text

Please email the file (s_log.text) as an attachment.

 

How do I find my machine ID?

Your machine ID is your Ethernet ID/MAC address: 6 pairs of numbers and letters A-F. You may see the pairs un-separated (d312a930bc7f), separated by colons (d3:12:a9:30:bc:7f) or separated by dashes (d3-12-a9-30-bc-7f).

  • On Windows, go to the Start menu, then in the search box type "cmd" and hit Enter.
    • In the cmd window, type "ipconfig /all".
    • Find the line that reads "Physical Address".
  • On Mac, go to System Preferences -> Network -> Advanced -> Ethernet.
    • The machine ID is listed under "Ethernet".

 

What host product and operating system versions are supported?

The following are support:

  • Final Cut Pro 6.0 and 7.0 running on Mac OS X 10.6.8, 10.7 and 10.8.
  • Final Cut Express 4.0 running on Mac OS X 10.6.8 and 10.7.
  • Motion 3.0.2 and 4.0 running on Mac OS X S 10.6.8, 10.7 and 10.8.

 

What host applications will my license work on?

Your license works with Final Cut Express, Final Cut Pro, Motion, After Effects and Premiere Pro.  (Click here for a list of compatible host product versions.)

  • If you want to run Final Cut Express, Final Cut Pro or Motion, you need to download the software for "Final Cut Pro and compatible"
  • If you want to run After Effects and Premiere, you will need to download the software for "After Effects and compatible products"

If you install a new host application on your machine, you will probably need to re-install your plug-ins afterwards, so the new application can locate them.

 

Which CUDA capable video cards are supported by my plug-ins' GPU acceleration?

All NVIDIA CUDA GPUs with compute capability 1.3 or later (see https://developer.nvidia.com/cuda-gpus) are supported.  This should include all NVIDIA GPUs produced after 2010.  Newer cards with more compute cores and memory will in general give better performance.

 

Will Sapphire use multiple GPUs if I have more then one?

No, Sapphire will only utilize a single CUDA GPU.

 

Does the FxPlug version of LensFlare support 3D mode like the AE version?

No. 3D Lens flares only work in After Effect's 3D compositing environment.

 

Why does Sapphire sometimes take a really long time to start on my Mac running Final Cut Pro or Motion and a CUDA-capable GPU?

There is a bug in the NVIDIA driver that can cause it to take awhile to alert Sapphire that Final Cut is using all of the graphics memory. If you are experiencing this regularly, you can disable CUDA in the Sapphire s_config.text file [link] by setting the use_gpu flag to "no."

 

On FCP, the plugin effect is cut off at the edge of the layer.

If a plugin is applied to an FCP layer that is smaller than the final output, the plugin will still only affect the area within that layer's size, and sometimes appear to be cut off. To extend the effect beyond the edges, just make a nest from the layer and apply the plugin to the nest.
One way to make a nest is to create a new sequence, drag your footage into it, and then drag this new sequence into your Main sequence to nest it. Then apply the plugin to the nested sequence, and it should affect the area outside the original layer.

 

I have a virtual machine that I would like to use as a license server, is that possible?

Please contact our sales [at] genarts [dot] com (Sales team) for information.

 

How do I know if Sapphire is collecting usage data?

When you run the Sapphire v7 installer, you will be prompted "Would you like to help us improve Sapphire by sending us anonymous usage data periodically?", you can leave the question checked for "yes" or unchecked for "no".

If you would like to manually check whether Sapphire is collecting usage data, open the file usage-optin.txt in the Sapphire Applications folder. 

  • On Mac, the file is in: /Applications/GenArtsSapphireFXPLUG/usage-optin.txt

If the file contains the character 'y', then Sapphire is collecting usage data. If the file contains the character 'n' or the file is missing, Sapphire is not collecting usage data. You can change this at any time by re-running the installer or changing the contents of the usage-optin.txt file.

 

 

Version 6

If you have a technical support question that is not answered by the information below, please contact us through our support form.

Be sure to include your company name, the host product name and version you are using, and the version of Sapphire plug-ins you have installed. You can find the Sapphire plug-ins version information in the "About" dialog which can be displayed while using any plugin.

 

 

Frequently Asked Questions

Installation and Uninstallation

Licensing

Watermarks and Trials

FX Central, Presets and Tutorials

System Requirements and Diagnostics

 

 

 

 

How do I uninstall Sapphire from my current machine?

To uninstall:

  • On Mac, go to: /Applications/GenArtsSapphireFXPLUG folder and double click on "Uninstall Sapphire".

If your machine is not connected to the web, then select "Display an uninstall code to register on another computer's web browser". Follow the instructions to register the uninstall via another machine.

 

How am I notified of complimentary software updates?

The software automatically checks for updated versions.  If you would like to check manually: 

  • On Mac, go to: /Applications/GenArtsSapphireFXPLUG/Check for Sapphire FXPLUG Updates.

Notifications are also made available through standard GenArts communications, i.e., newsletters or other email communication.

 

How do I access my complimentary software updates?

Updates to your software are published on our website as the latest version of the installer and can be found by going to http://www.genarts.com/support/downloads/sapphire/final-cut-v6.

 

Where can I download the Sapphire installer?

You can find and download the installer from here: http://www.genarts.com/support/downloads/sapphire/final-cut-v6.

 

Can different versions of Sapphire be installed at the same time?

No, the Sapphire v6 installer will replace Sapphire v2 and v5. This prevents confusion from multiple copies of the same effects, and allows your saved projects to automatically use the new version.

 

Will projects saved with prior Sapphire versions continue to work with Sapphire v6?

On Final Cut Express, Final Cut Pro and Motion, you can load projects saved with Sapphire v5 effects and they should automatically convert to use Sapphire v6.

However, we do not advise trying to translate effects from v2 to v6.

 

Will projects saved with the AE version of Sapphire work with the FxPlug version?

No, FCP projects that use the AE version can not be converted to use the FxPlug version.

 

Can the FxPlug and AE versions of Sapphire be installed at the same time?

If you are on FCP or Motion we suggest using the FxPlug version unless you have previous projects saved using the AE version.
However, you can install both the FxPlug and AE versions of Sapphire on the same machine. The effect category names will include "(FxPlug)" for the FxPlug version, so you can identify which is which when selecting a plugin. 

 

I received a message that "the number of installations permitted with this serial number has been reached." How do I activate my license?

This message indicates that you have installed your serial number on the maximum number of machines permitted.  To free up your serial number, uninstall it from one of the machines where it is currently installed, and select the option to register the uninstall over the web.  Then, follow the instructions to activate the license.

 

Can I use the same serial number on multiple machines?

If you have a serial number for one machine, you can only use it on one machine.  In order to use it on a different machine, you will need to transfer your serial number.

 

How do I activate my serial number?

If the software is already on your machine,

  • On Mac, go to: /Applications/GenArtsSapphireFXPLUG folder and double click on "Install Serial Number".
    • Follow the instructions and choose the option to authorize over the web. Click here if your machine is not connected to the Internet. 

To install the software (if it is not on your machine), go to: http://www.genarts.com/support/downloads/sapphire/final-cut-v6. Click on the link to download the installer.  Follow the instructions to install the software.  When prompted, choose the option to enter your serial number. Then choose the option to authorize over the Internet.

 

How do I activate my serial number if my machine is not connected to the Internet?

If the software is already on your machine:

  • On Mac, go to: /Applications/GenArtsSapphireFXPLUG folder and double click on "Install Sapphire".
    • Follow the instructions and select “Authorize manually ...".
    • Then, follow the instructions to register the install via another machine.

 

How do I transfer my serial number to a different machine?

First, you need to uninstall the plug-in software to remove the license from your current machine. Then, install the software on your new machine and follow the instructions to activate the license.

 

Which machines are my serial numbers currently installed on?

Go to www.genarts.com/sn-lookup.html. Then, paste your serial number and click "submit request".

 

On Mac, why do I get "Failed writing reg file" when entering a serial number?

This usually indicates you don't have the necessary permissions when a file is being saved. Please log in as administrator and try again.

 

Do my full Sapphire licenses need to be on the same version as my Render licenses?

Yes, you will need to either update both your interactive and Render licenses to the most current version, or install an older version of both licenses on your workstation and Render nodes.

 

How do I remove the "Sapphire" watermark?

Go to the "Help" dialog while using any plug-in to determine if your trial or temporary license has expired. If so, then you need to acquire and enter a valid license. Once you receive the valid license and activate it, the results should return to normal.           
                                                                           
If you have a license that has not expired, review the following:

  1. Ensure you have run the GenArts installer on your machine, rather than cloning, ghosting, or copying files from another workstation. If you installed the software by copying, then download and re-run the installer;
  2. Ensure the date on your computer is correct;
  3. If the Ethernet address of your computer has changed since you ran the installer, then re-install the software and re-enter your serial number.

 

How do I remove the "Sapphire" watermark when using a floating license?

At any point, you can go to http://www.reprisesoftware.com/admin/software-licensing.php for troubleshooting guides and manuals, or go to  http://www.reprisesoftware.com/RLM_Troubleshooting_Tips.pdf for a troubleshooting checklist. 

Note that Sapphire v6 will only work with RLM version 9 and later. If you are running an earlier version, please update your server to use the RLM v9 or newer. You can download the latest version of RLM from here: http://www/genarts.com/support/downloads/rlm.

Check that the date on your computer is correct for both server and client.

Make sure the port numbers used in your server and client license files are the same. The port number is shown after the hostname and Ethernet ID in the HOST line of the license. You can change the port numbers without invalidating the license, but you will need to restart the license server after they are modified. Also make sure this port number doesn't conflict with other applications that might use the same port.

Check the status of your licenses using the RLM server's web interface. From the server machine go to http://localhost:5054 or from another machine use http://servername:5054, replacing server name as appropriate. See if any useful information is shown there. To reread the license file: on the left side of the main page select Reread/Restart Servers, and then on that page click on Reread Licenses.

Make sure the Ethernet ID in your license correctly matches that of your license server machine. Run the following command on your license server machine to find the Ethernet ID that RLM is expecting:

  • On Mac: "/Library/Application Support/GenArts/rlm/rlmutil" rlmhostid ether

Then make sure the Ethernet ID in your server license file matches. The Ethernet ID is just after the hostname in the HOST line of the license. If they differ, please let us know the correct Ethernet ID so we can regenerate your license.

Make sure the hostname in your license files correctly matches that of your license server machine. Run the following command on your license server machine to find the hostname that RLM is expecting:   

  • On Mac: "/Library/Application Support/genarts/rlm/rlmutil" rlmhostid host

Then make sure the hostname in your server license file matches that. If they differ, either correct the name in the license files, or use the license server IP address instead.  (If you instead need to change the host ID, then click here to submit a request to our Support team.)

If all looks OK in the web interface, and the license seems to be up, then make sure you can "ping" the server from the client using the hostname or IP address specified in the license file. (This ensures that the client can get the server's IP address from its hostname, and that there is a working connection between them.) If this doesn't work, try replacing the hostname with the IP address of the license server in the license files.

 

Why do my background renders show a "Sapphire" watermark?

Ensure you have run the Sapphire installer on each remote machine, rather than just ghosting the drive or copying files from another workstation.  Ensure Sapphire Plug-ins are working properly without a watermark on the machine you are initiating the network renders from.

 

Why does my project render only black with a "Sapphire" watermark?

This normally happens when your free trial and/or license have expired for some time.

  • If you think this machine should be licensed, check to see if your Network Connections are disabled or not.
    • If you want to work without a network connection for security reasons, you can unplug the network cable but still leave the network adapter enabled.

 

How do I return to my previous version of Sapphire after my v6 trial?

First, uninstall the plug-in from your machine. Then, install the plug-in using the older installer and re-enter your serial number.

 

How long does the trial last and does it watermark?

Your Sapphire trial is for two weeks. The trial will act as a full version and will not watermark until the trial period is over.

 

My complimentary trial expired -- How do I get additional time?

The trial is for two weeks. After this time you may purchase a license at: http://www.genarts.com/buy/sapphire/final-cut.

 

How do I access training materials?

Tutorials and other training material are available within our FX Central community site.  To view our existing tutorial collection, please visit: http://www.genarts.com/fx-central.

 

How do I access the documentation?

Documentation for Sapphire is installed on your machine with the software and is available in HTML and PDF formats.

  • On Mac, go to: /Applications/GenArts SapphireFXPLUG.  Select Online Help.html or Online Help.pdf

A "Help" button is also available at the bottom of the plug-in parameters, which provides information about the plug-in, your license status, and links that bring up online documentation in your HTML browser.

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 workstation even if it is not connected to the internet. 

 

How do I apply effects and use Sapphire parameters?

Instructional information can be found in the documentation. Additionally, we created a brief video that shows how the plug-ins work. This can be found by clicking http://www.genarts.com/fx-central/tutorials.

 

How do I install Sapphire Presets?

When you download a Sapphire preset collection from FX Central (http://www.genarts.com/fx-central/look-collections), you get a .gpz file. For example, the February Collection file looks like this: “S_2012-February-Collection.gpz”

Note: Depending on your web browser download setting, you may download the file as a “.zip”. If that happens, you can rename the “.zip” extension to “.gpz”.

To install, double click on the .gpz file and the files will automatically be installed to your preset collection. A prompt will show:  "Installed ## new presets."  Then, click on "Ok". The next time you start your host application, the Sapphire presets should show up in your preset collection.

Other ways of installing presets would be to right click on the .gpz file:

  • Select “Open with” > select “Preset Browser” > click “Ok”
    OR
  • Select “Open with” > select “Other…” > select “preset_browser.exe” > click “Ok”

 

How do I delete a preset from my computer?

To delete a preset:

  • On Mac, go to: /Library/Application Support/GenArts/Sapphire/presets/genarts/

Select the Preset Look you want to delete. (They are in this format: S_PluginName_PresetLookName.gp.)

Right click on the preset file and select "Delete."

 

I shortlisted a look on FX Central, but I don't see it in the preset browser?

The FX Central preset browser searches for shortlisted looks every time you click "Load Preset." If you have the browser open when you shortlist a look, you will need to close and reopen it for the look to appear.

 

How do I get the preset browser?

Navigate to the effects panel, click and drag an effect onto your footage, and click “Load Preset” to view the FX Central Preset Browser.

 

Why don't I see my footage when I preview a transition in the preset browser?

You need to ensure that your current time indicator is on a frame that contains the Sapphire transition in order to properly display a transition preview.

 

Can I create and save my own presets?

Yes, in Sapphire v6.1, you can create your own presets as well as make custom lists of presets for specific projects or to mark favorites.

 

Where do the presets and custom presets get saved to?

They are .gp files and are located in the following:

  • On Mac: /Library/Application Support/Genarts/Sapphire/Presets

 

When working in a shared environment, how do I author and read my presets & lensflares / glares to a central location?

 You'll need to edit the s_config.text file found in the Sapphire applications folder by adding the line (quotes are required). Replace "/usr/genarts" with the new location:

  • For Presets:  preset_directory: "/usr/genarts/sapphire/presets"
  • For Lensflares:  lensflare_directory: "/usr/genarts/lensflares"
  • For Glares:  glare_directory: "/usr/genarts/glares"

 

Where is the diagnostic log file and how do I email it?

The diagnostic log file can be found here:

  • On Mac, the file is in: /Applications/GenArtsSapphireFXPLUG/config/s_log.text

Please email the file (s_log.text) as an attachment.

 

How do I find my machine ID?

Your machine ID is your Ethernet ID/MAC address: 6 pairs of numbers and letters A-F. You may see the pairs un-separated (d312a930bc7f), separated by colons (d3:12:a9:30:bc:7f) or separated by dashes (d3-12-a9-30-bc-7f).

  • On Windows, go to the Start menu, then in the search box type "cmd" and hit Enter.
    • In the cmd window, type "ipconfig /all".
    • Find the line that reads "Physical Address".
  • On Mac, go to System Preferences -> Network -> Advanced -> Ethernet.
    • The machine ID is listed under "Ethernet".

 

What host product and operating system versions are supported?

The following are support:

  • Final Cut Pro 6.0 and 7.0 running on Mac OS X 10.5, 10.6 and 10.7.
  • Final Cut Express 4.0 running on Mac OS X 10.5, 10.6 and 10.7.
  • Motion 3.0.2 and 4.0 running on Mac OS X S 10.5, 10.6 and 10.7.

 

What host applications will my license work on?

Your license works with Final Cut Express, Final Cut Pro, Motion, After Effects and Premiere Pro.  (Click here for a list of compatible host product versions.)

  • If you want to run Final Cut Express, Final Cut Pro or Motion, you need to download the software for "Final Cut Pro and compatible"
  • If you want to run After Effects and Premiere, you will need to download the software for "After Effects and compatible products"

If you install a new host application on your machine, you will probably need to re-install your plug-ins afterwards, so the new application can locate them.

 

Which CUDA capable video cards are supported by my plug-ins' GPU acceleration?

All NVIDIA CUDA GPUs with compute capability 1.3 or later (see https://developer.nvidia.com/cuda-gpus) are supported.  This should include all NVIDIA GPUs produced after 2010.  Newer cards with more compute cores and memory will in general give better performance.

 

Does the FxPlug version of LensFlare support 3D mode like the AE version?

No. 3D Lens flares only work in After Effect's 3D compositing environment.

 

Why does Sapphire sometimes take a really long time to start on my Mac running Final Cut Pro or Motion and a CUDA-capable GPU?

There is a bug in the NVIDIA driver that can cause it to take awhile to alert Sapphire that Final Cut is using all of the graphics memory. If you are experiencing this regularly, you can disable CUDA in the Sapphire s_config.text file [link] by setting the use_gpu flag to "no."

 

On FCP, the plugin effect is cut off at the edge of the layer.

If a plugin is applied to an FCP layer that is smaller than the final output, the plugin will still only affect the area within that layer's size, and sometimes appear to be cut off. To extend the effect beyond the edges, just make a nest from the layer and apply the plugin to the nest.
One way to make a nest is to create a new sequence, drag your footage into it, and then drag this new sequence into your Main sequence to nest it. Then apply the plugin to the nested sequence, and it should affect the area outside the original layer.

 

 

Version 5

If you have a technical support question that is not answered by the information below, please contact us through our support form.

Be sure to include your company name, the host product name and version you are using, and the version of Sapphire plug-ins you have installed. You can find the Sapphire plug-ins version information in the "About" dialog which can be displayed while using any plugin.

 

 

Frequently Asked Questions

Installation and Uninstallation

Licensing

Watermarks and Trials

Tutorials

System Requirements and Diagnostics

 

 

 

 

How do I uninstall Sapphire from my current machine?

To uninstall:

  • On Mac, go to: /Applications/GenArtsSapphireFxPlug folder and double-click on Uninstall Sapphire.

If your machine is not connected to the web, than select "Display an uninstall code to register on another computer's web browser". Follow the instructions to register the uninstall via another machine.

 

How am I notified of complimentary software updates?

The software automatically checks for updated versions. If you would like to check manually:

  • On Mac, go to: /Applications/GenArtsSapphireAE/Check for Sapphire AE Updates.

Notifications are also made available through standard GenArts communications, (e.g., newsletters or other email communications).

 

How do I access my complimentary software updates?

Updates to your software are published on our website as the latest version of the installer and can be found by going to http://www.genarts.com/support/downloads/sapphire/final-cut-v5.

 

Where can I download the Sapphire installer?

You can find and download the installer from here: http://www.genarts.com/support/downloads/sapphire/final-cut-v5.

 

Can different versions of Sapphire be installed at the same time?

No, the Sapphire v5 installer will replace Sapphire v2. This prevents confusion from multiple copies of the same effects, and allows your saved projects to automatically use the new version.

 

Will projects saved with prior Sapphire versions continue to work with Sapphire v5?

Yes, you can load projects saved with Sapphire v2 effects and they should automatically convert to use Sapphire v5.

 

Will projects saved with the AE version of Sapphire work with the FxPlug version?

No, FCP projects that use the AE version can not currently be converted to use the FxPlug version. However, you can just keep the AE version installed on your workstation so old projects can continue to use that version if necessary.

 

Can the FxPlug and AE versions of Sapphire be installed at the same time?

Yes, you can install both the FxPlug and AE versions of Sapphire on the same machine. The effect category names will include "(FxPlug)" for the FxPlug version, so you can identify which is which when selecting a plugin.

If you are on FCP or Motion we suggest just using the FxPlug version unless you have previous projects saved using the AE version.

 

How can I tell if I'm using the FxPlug or AE version of a plugin?

The FxPlug version will have an "About" button and a "Mix" parameter at the bottom of its parameters. The AE version has an "About" button at the top of its parameters.

Also, in the category names where the plugin effects are selected, the FxPlug versions are named "Sapphire...(FxPlug)."

 

I received a message that "the number of installations permitted with this serial number has been reached." How do I activate my license?

This message indicates that you have installed your serial number on the maximum number of machines permitted. To free up your serial number, uninstall it from one of the machines where it is currently installed, and select the option to register the uninstall over the web. Then, follow the instructions to activate the license.

 

Can I use the same serial number on multiple machines?

Unless your serial number includes a "-r" value, your serial number can be used on only one machine at a time. You can transfer a serial number to a new machine by uninstalling the software on the old machine, selecting the option to register that uninstall, and then reinstalling on the new machine.

 

How do I activate my serial number?

If the software is already on your machine,

  • On Mac, go to: /Applications/GenArtsSapphireFXPLUG folder and double click on "Install Serial Number".
    • ​Follow the instructions and choose the option to authorize over the web. Click here if your machine is not connected to the Internet.

To install the software (if it is not on your machine), go to: http://www.genarts.com/support/downloads/sapphire/final-cut-v5. Click on the link to download the installer. Follow the instructions to install the software. When prompted, choose the option to enter your serial number. Then choose the option to authorize over the Internet.

 

How do I activate my serial number if my machine is not connected to the Internet?

If the software is already on your machine,

  • On Mac, go to: /Applications/GenArtsSapphireAE folder and double click on "Install Sapphire".
    • ​Follow the instructions and select “Authorize manually ...".
    • Then, follow the instructions to register the install via another machine.

 

How do I transfer my serial number to a different machine?

First, you need to uninstall the plug-in software to remove the license from your current machine. Then, install the software on your new machine and follow the instructions to activate the license.

 

Which machines are my serial numbers currently installed on?

Go to www.genarts.com/sn-lookup.html. Then, paste your serial number and click "submit request".

 

On Mac, why do I get "Failed writing reg file" when entering a serial number?

This usually indicates you don't have the necessary permissions when a file is being saved. Please log in as administrator and try again.

 

Do my full Sapphire licenses need to be on the same version as my Render licenses?

Yes, you will need to either update both your interactive and Render licenses to the most current version, or install an older version of both licenses on your workstation and Render nodes.

 

How do I remove the "Sapphire" watermark?

Go to the "Help" dialog while using any plug-in to determine if your trial or temporary license has expired. If so, then you need to acquire and enter a valid license. Once you receive the valid license and activate it, the results should return to normal.

If you have a license that has not expired, review the following: 

  1. Ensure you have run the GenArts installer on your machine, rather than cloning, ghosting, or copying files from another workstation. If you installed the software by copying, then download and re-run the installer;
  2. Ensure the date on your computer is correct;
  3. If the Ethernet address of your computer has changed since you ran the installer, then re-install the software and re-enter your serial number.

 

How do I remove the "Sapphire" watermark when using a floating license?

At any point, you can go to http://www.reprisesoftware.com/admin/software-licensing.php for troubleshooting guides and manuals, or go to  http://www.reprisesoftware.com/RLM_Troubleshooting_Tips.pdf for a troubleshooting checklist.

Check that the date on your computer is correct for both server and client.

Make sure the port numbers used in your server and client license files are the same. The port number is shown after the hostname and Ethernet ID in the HOST line of the license. You can change the port numbers without invalidating the license, but you will need to restart the license server after they are modified. Also make sure this port number doesn't conflict with other applications that might use the same port.

Check the status of your licenses using the RLM server's web interface. From the server machine go to http://localhost:5054 (RLM v5 http://localhost:9000) or from another machine use http://servername:5054 (RLM v5 http://servername:9000) replacing servername as appropriate. See if any useful information is shown there. To reread the license file: on the left side of the main page select Reread/Restart Servers, and then on that page click on Reread Licenses.

Make sure the Ethernet ID in your license correctly matches that of your license server machine. Run the following command on your license server machine to find the Ethernet ID that RLM is expecting:

  • On Mac: "/Library/Application Support/genarts/rlm/rlmutil" rlmhostid ether

Then make sure the Ethernet ID in your server license file is equal to that. The Ethernet ID is just after the hostname in the HOST line of the license. If they differ, please let us know the correct Ethernet ID so we can regenerate your license.

Make sure the hostname in your license files correctly matches that of your license server machine. Run the following command on your license server machine to find the hostname that RLM is expecting:

  • On Mac: "/Library/Application Support/genarts/rlm/rlmutil" rlmhostid host

Then make sure the hostname in your client and server license files are equal to that. If they differ, either correct the name in the license files, or use the license server IP address instead. (If you instead need to change the host ID, then click here to submit a request to our Support team.)

Make sure you can "ping" the server from the client using the hostname specified in the license file. This ensures that the client can get the server's IP address from its hostname, and that there is a working connection between them. If this doesn't work, you can try replacing the hostname with the IP address of the license server in the license files.

 

Why do my background renders show a "Sapphire" watermark?

Ensure you have run the Sapphire installer on each remote machine, rather than just ghosting the drive or copying files from another workstation.  Ensure Sapphire Plug-ins are working properly without a watermark on the machine you are initiating the network renders from.

 

Why do my plug-ins only output black with a "Sapphire Plug-ins" watermark?

This usually indicates your free trial period has ended, or the expiration date of your serial number has been reached. Go to the "About" dialog while using any plugin, 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.

  • 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 download and re-run the installer.
  • Make sure the date on your computer is correct.
  • If the Ethernet address of your computer has changed since you ran the installer, you may get this watermark. One solution for this is to re-install Sapphire plug-ins and re-enter your serial number.

 

How do I return to my previous version of Sapphire after my v5 trial?

First, uninstall the plug-in from your machine.  Then, install the plug-in using the older installer and re-enter your serial number.

 

My complimentary trial expired -- How do I get additional time?

The trial is for two weeks. After this time you may purchase a license at: http://www.genarts.com/buy/sapphire/final-cut.

 

How do I access the documentation?

Documentation for Sapphire is installed on your machine with the software and is available in HTML and PDF formats.

  • On Mac, go to: /Applications/GenArts SapphireFXPLUG. Select Online Help.html or Online Help.pdf

A "Help" button is also available at the bottom of the plug-in parameters, which provides information about the plug-in, your license status, and links that bring up online documentation in your HTML browser.

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 workstation even if it is not connected to the internet. 

 

How do I apply effects and use Sapphire parameters?

Instructional information can be found in the documentation. Additionally, we created a brief video that shows how the plug-ins work. This can be found by clicking http://www.genarts.com/fx-central/tutorials.

 

On FCP, how do I use the transition effects?

To apply a Sapphire transition plugin, just drag it onto the cut like any standard FCP transition. Make sure to use the version from the Video Transitions menu rather than the Video Filters menu.

Versions of all the transition effects are also available from the Video Filters menu, but these can't be applied directly between two clips. These are useful if you want to keyframe the transition amount or apply a transition as a filter to a single clip. See this tutorial for an example of how to do this.

 

Where is the diagnostic log file and how do I email it?

The diagnostic log file can be found here:

  • On Mac, the file is in: /Applications/GenArtsSapphireFXPLUG/config/s_log.text

Please email the file (s_log.text) as an attachment.

 

How do I find my machine ID?

Your machine ID is your Ethernet ID/MAC address: 6 pairs of numbers and letters A-F. You may see the pairs un-separated (d312a930bc7f), separated by colons (d3:12:a9:30:bc:7f) or separated by dashes (d3-12-a9-30-bc-7f).

  • On Mac, go to System Preferences -> Network -> Advanced -> Ethernet.
    • The machine ID is listed under "Ethernet".

 

What host product and operating system versions are supported?

The following are supported:

  • Final Cut Pro 6.0 and 7.0 running on Mac OS X 10.5, 10.6 and 10.7.
  • Final Cut Express 4.0 running on Mac OS X 10.5, 10.6 and 10.7.
  • Motion 3.0 and 4.0 running on Mac OS X 10.5, 10.6 and 10.7.

 

What host applications will my license work on?

Yes. Sapphire plug-ins for FxPlug is licensed per machine, so one serial number allows you to use them on Final Cut Pro, Final Cut Express, and/or Motion on the same computer. You may also be able to use the same license for the AE version of Sapphire on the same machine. However a separate license is required to run Sapphire plug-ins on other host products that do not accept FxPlug or AE plug-ins, such as Avid or Shake, even if they are on the same machine.

 

Which CUDA capable video cards are supported by my plug-ins' GPU acceleration?

All NVIDIA CUDA GPUs with compute capability 1.3 or later (see https://developer.nvidia.com/cuda-gpus) are supported.  This should include all NVIDIA GPUs produced after 2010.  Newer cards with more compute cores and memory will in general give better performance.

 

Why do the results of Sapphire Glow, Glint, Glare, or Convolve seem different?

In version 2.03, a problem with thresholds in Glow, Glint, Glare, and Convolve was fixed. This gives improved but slightly different results from 2.02, and it makes the results compatible with Sapphire on other host products.

If you noticed a change in the results between Sapphire v1 (AE) and v5 (FxPlug), please install 2.03 or greater to resolve this.

If you have projects saved with versions 2.0 to 2.02 that you still need to render with the same results, you can continue using 2.02.

 

Why does Sapphire sometimes take a really long time to start on my Mac running Final Cut Pro or Motion and a CUDA-capable GPU?

If Final Cut takes all the graphics memory so none is left for Sapphire, a bug in the NVIDIA driver can cause it to take a long time to tell Sapphire about this. If you are experiencing this regularly, you can disable CUDA in the Sapphire s_config.text file [link] by setting the use_gpu flag to "no."

 

On FCP, the plugin effect is cut off at the edge of the layer.

If a plugin is applied to an FCP layer that is smaller than the final output, the plugin will still only affect the area within that layer's size, and sometimes appear to be cut off. To extend the effect beyond the edges, just make a nest from the layer and apply the plugin to the nest.

One way to make a nest is to create a new sequence, drag your footage into it, and then drag this new sequence into your Main sequence to nest it. Then apply the plugin to the nested sequence, and it should affect the area outside the original layer.

 

 

Version 2

Unfortunately, GenArts no longer supports Sapphire v2 for Final Cut Pro, this version has been discontinued. Customers are recommended to upgrade to the latest version. Pleases contact sales [at] genarts [dot] com for more information.

Snow Leopard update: Please use Sapphire v2.06 or later for Snow Leopard support.

 

 

Frequently Asked Questions

Installation and Uninstallation

Licensing

Watermarks and Trials

Tutorials

System Requirements and Diagnostics

 

 

 

 

How do I uninstall Sapphire from my current machine?

To uninstall:

  • On Mac, go to: /Applications/GenArtsSapphireFxPlug folder and double-click on Uninstall Sapphire.

If your machine is not connected to the web, than select "Display an uninstall code to register on another computer's web browser". Follow the instructions to register the uninstall via another machine.

 

Where can I download the Sapphire installer?

You can find and download the installer from here: http://www.genarts.com/support/downloads/sapphire/final-cut-v2.

 

Will projects saved with the AE version of Sapphire work with the FxPlug version?

No, FCP projects that use the AE version can not currently be converted to use the FxPlug version. However, you can just keep the AE version installed on your workstation so old projects can continue to use that version if necessary.

 

Can the FxPlug and AE versions of Sapphire be installed at the same time?

Yes, you can install both the FxPlug and AE versions of Sapphire on the same machine. The effect category names will include "(FxPlug)" for the FxPlug version, so you can identify which is which when selecting a plugin.

If you are on FCP or Motion we suggest just using the FxPlug version unless you have previous projects saved using the AE version.

 

How can I tell if I'm using the FxPlug or AE version of a plugin?

The FxPlug version will have an "About" button and a "Mix" parameter at the bottom of its parameters. The AE version has an "About" button at the top of its parameters.

Also, in the category names where the plug-in effects are selected, the FxPlug versions are named "Sapphire...(FxPlug)."

 

I received a message that "the number of installations permitted with this serial number has been reached." How do I activate my license?

This message indicates that you have installed your serial number on the maximum number of machines permitted. To free up your serial number, uninstall it from one of the machines where it is currently installed, and select the option to register the uninstall over the web. Then, follow the instructions to activate the license.

 

Can I use the same serial number on multiple machines?

Unless your serial number includes a "-r" value, it can be used on only one machine at a time. You can transfer a serial number to a new machine by uninstalling the software on the old machine, selecting the option to register that uninstall, and then reinstalling on the new machine.

 

How do I activate my serial number?

If the software is already on your machine,

  • On Mac, go to: /Applications/GenArtsSapphireFXPLUG folder and double click on "Install Serial Number".
    • ​Follow the instructions and choose the option to authorize over the web. Click here if your machine is not connected to the Internet.

To install the software (if it is not on your machine), go to: http://www.genarts.com/support/downloads/sapphire/final-cut-v2. Click on the link to download the installer. Follow the instructions to install the software. When prompted, choose the option to enter your serial number. Then choose the option to authorize over the Internet.

 

How do I activate my serial number if my machine is not connected to the Internet?

If the software is already on your machine,

  • On Mac, go to: /Applications/GenArtsSapphireAE folder and double click on "Install Sapphire".
    • ​Follow the instructions and select “Authorize manually ...".
    • Then, follow the instructions to register the install via another machine.

 

How do I transfer my serial number to a different machine?

First, you need to uninstall the plug-in software to remove the license from your current machine. Then, install the software on your new machine and follow the instructions to activate the license.

 

Which machines are my serial numbers currently installed on?

Go to www.genarts.com/sn-lookup.html. Then, paste your serial number and click "submit request".

 

On Mac, why do I get "Failed writing reg file" when entering a serial number?

This usually indicates you don't have the necessary permissions when a file is being saved. Please log in as administrator and try again.

 

Do my full Sapphire licenses need to be on the same version as my Render licenses?

Yes, you will need to either update both your interactive and Render licenses to the most current version, or install an older version of both licenses on your workstation and Render nodes.

 

How do I remove the "Sapphire" watermark?

Go to the "Help" dialog while using any plug-in to determine if your trial or temporary license has expired. If so, then you need to acquire and enter a valid license. Once you receive the valid license and activate it, the results should return to normal.

If you have a license that has not expired, review the following: 

  1. Ensure you have run the GenArts installer on your machine, rather than cloning, ghosting, or copying files from another workstation. If you installed the software by copying, then download and re-run the installer;
  2. Ensure the date on your computer is correct;
  3. If the Ethernet address of your computer has changed since you ran the installer, then re-install the software and re-enter your serial number.

 

How do I remove the "Sapphire" watermark when using a floating license?

At any point, you can go to http://www.reprisesoftware.com/admin/software-licensing.php for troubleshooting guides and manuals, or go to  http://www.reprisesoftware.com/RLM_Troubleshooting_Tips.pdf for a troubleshooting checklist.

Check that the date on your computer is correct for both server and client.

Make sure the port numbers used in your server and client license files are the same. The port number is shown after the hostname and Ethernet ID in the HOST line of the license. You can change the port numbers without invalidating the license, but you will need to restart the license server after they are modified. Also make sure this port number doesn't conflict with other applications that might use the same port.

Check the status of your licenses using the RLM server's web interface. From the server machine go to http://localhost:5054 (RLM v5 http://localhost:9000) or from another machine use http://servername:5054 (RLM v5 http://servername:9000) replacing servername as appropriate. See if any useful information is shown there. To reread the license file: on the left side of the main page select Reread/Restart Servers, and then on that page click on Reread Licenses.

Make sure the Ethernet ID in your license correctly matches that of your license server machine. Run the following command on your license server machine to find the Ethernet ID that RLM is expecting:

  • On Mac: "/Library/Application Support/genarts/rlm/rlmutil" rlmhostid ether

Then make sure the Ethernet ID in your server license file is equal to that. The Ethernet ID is just after the hostname in the HOST line of the license. If they differ, please let us know the correct Ethernet ID so we can regenerate your license.

Make sure the hostname in your license files correctly matches that of your license server machine. Run the following command on your license server machine to find the hostname that RLM is expecting:

  • On Mac: "/Library/Application Support/genarts/rlm/rlmutil" rlmhostid host

Then make sure the hostname in your client and server license files are equal to that. If they differ, either correct the name in the license files, or use the license server IP address instead. (If you instead need to change the host ID, then click here to submit a request to our Support team.)

Make sure you can "ping" the server from the client using the hostname specified in the license file. This ensures that the client can get the server's IP address from its hostname, and that there is a working connection between them. If this doesn't work, you can try replacing the hostname with the IP address of the license server in the license files.

 

Why do my background renders show a "Sapphire" watermark?

Ensure you have run the Sapphire installer on each remote machine, rather than just ghosting the drive or copying files from another workstation.  Ensure Sapphire Plug-ins are working properly without a watermark on the machine you are initiating the network renders from.

 

Why do my plug-ins only output black with a "Sapphire Plug-ins" watermark?

This usually indicates your free trial period has ended, or the expiration date of your serial number has been reached. Go to the "About" dialog while using any plugin, 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.

  • 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 download and re-run the installer.
  • Make sure the date on your computer is correct.
  • If the Ethernet address of your computer has changed since you ran the installer, you may get this watermark. One solution for this is to re-install Sapphire plug-ins and re-enter your serial number.
  • If your serial number is only for a single box, make sure the plug-ins you are using are included in that box.

 

How do I return to my previous version of Sapphire after my v2 trial?

First, uninstall the plug-in from your machine.  Then, install the plug-in using the older installer and re-enter your serial number.

 

How do I access the documentation?

Documentation for Sapphire is installed on your machine along with the software and is available in HTML and PDF formats. 

  • On Mac, go to: /Applications/GenArts SapphireFXPLUG. Select Online Help.html or Online Help.pdf

A "Help" button is also available at the bottom of the plug-in parameters, which provides information about the plugin, your license status, and links that bring up online documentation in your HTML browser.

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 workstation even if it is not connected to the Internet. 

 

On FCP, how do I use the transition effects?

To apply a Sapphire transition plugin, just drag it onto the cut like any standard FCP transition. Make sure to use the version from the Video Transitions menu rather than the Video Filters menu.

Versions of all the transition effects are also available from the Video Filters menu, but these can't be applied directly between two clips. These are useful if you want to keyframe the transition amount or apply a transition as a filter to a single clip. See this tutorial for an example of how to do this.

 

Where is the diagnostic log file and how do I email it?

The diagnostics log file can be found here:

  • On Mac, the file is in: /Applications/GenArtsSapphireFXPLUG/config/s_log.text

Please email the file (s_log.text) as an attachment.

 

How do I find my machine ID?

Your machine ID is your Ethernet ID/MAC address: 6 pairs of numbers and letters A-F. You may see the pairs un-separated (d312a930bc7f), separated by colons (d3:12:a9:30:bc:7f) or separated by dashes (d3-12-a9-30-bc-7f).

  • On Mac, go to: System Preferences -> Network -> Advanced -> Ethernet.
    • The machine ID is listed under "Ethernet".

 

What host product and operating system versions are supported?

The following are supported:

  • Final Cut Pro 6.0 and 7.0 running on Mac OS X 10.5 and 10.6
  • Final Cut Express 4.0 running on Mac OS X 10.5 and 10.6
  • Motion 3.0 and 4.0 running on Mac OS X 10.5 and 10.6

 

What host applications will my license work on?

Yes. Sapphire Plug-ins for FxPlug is licensed per machine, so one serial number allows you to use them on Final Cut Pro, Final Cut Express, and/or Motion on the same computer. You may also be able to use the same license for the AE version of Sapphire on the same machine. However a separate license is required to run Sapphire Plug-ins on other host products that do not accept FxPlug or AE plug-ins, such as Avid or Shake, even if they are on the same machine.

 

Why do the results of Sapphire Glow, Glint, Glare, or Convolve seem different?

In version 2.03, a problem with thresholds in Glow, Glint, Glare, and Convolve was fixed. This gives improved but slightly different results from 2.02, and it makes the results compatible with Sapphire on other host products.

If you noticed a change in the results between Sapphire v1 (AE) and v2 (FxPlug), please install 2.03 or greater to resolve this.

If you have projects saved with versions 2.0 to 2.02 that you still need to render with the same results, you can continue using 2.02.

 

On FCP, the plugin effect is cut off at the edge of the layer.

If a plugin is applied to an FCP layer that is smaller than the final output, the plugin will still only affect the area within that layer's size, and sometimes appear to be cut off. To extend the effect beyond the edges, just make a nest from the layer and apply the plugin to the nest.

One way to make a nest is to create a new sequence, drag your footage into it, and then drag this new sequence into your Main sequence to nest it. Then apply the plugin to the nested sequence, and it should affect the area outside the original layer.

 

 

After Effects version of Sapphire

If you are using the After Effects version of Sapphire, please see the Support for Sapphire for After Effects page.