OneClicks are the equivalent of presets for different (supported) model types. All OneClicks generally operate the same way and produce similar results (as much as is possible considering the differences between model/character systems). The application of a OneClick on a supported model will configure:
- A SALSA module with visemes corresponding to our current recommendations.
- One EmoteR instance with SALSA-linked emphasis emotes.
- An Eyes module with head, eyes, and eyelids configurations.
Using a OneClick should be considered a starting point for setting up a character model. We have spent a lot of time testing different settings and configurations and have come up with a current setup that we believe creates a great look-and-feel. Please feel free to tweak and adjust any aspect that better suits your needs.
For a quick overview of how OneClicks are applied to character models, please see Part 4 (OneClicks), of our video tutorial series.
Available OneClick Options
OneClicks are only available for specific 3D character model systems as indicated below. However, nearly any model that uses blendshapes or bones (or both) for animation may be configured to work with SALSA LipSync Suite v2. You can also create your own custom OneClick to use your own custom settings or create a new custom OneClick supporting a completely different model or model system.
NOTE: Due to the complexity of the Autodesk and UMA OneClicks, they each have their own document page, linked below.
- Autodesk Character Generator (ACG)
- DAZ 3D
- Mixamo Fuse
- Reallusion CC3 & iClone
- UMA DCS
- Creating a Custom OneClick
- Make sure SALSA LipSync Suite is installed.
- If upgrading from previously-installed OneClicks prior to v2.1.0, first remove the existing OneClick directory located here:
Assets > Plugins > Crazy Minnow Studio > SALSA LipSync > Editor > OneClicks
- Download and install the latest OneClick Base (REQUIRED for all OneClicks). Also ensure the appropriate version of the SALSA Suite is installed. Release notes for OneClickBase are located in the script itself.
- Download the appropriate model-specific OneClick unitypackage and install it. Release notes for all OneClicks are located in the OneClick Editor scripts.
NOTE: Installation of unitypackage files is quite simple. If you are new to the process, please see this page.
Applying the OneClick
- Select the model's root in your scene.
- Apply the OneClick -- GameObject menu: Crazy Minnow Studio > SALSA LipSync > One-Clicks
- Hit 'Play'.
NOTE: If you installed the core examples, the included Promo-male audio clip will be assigned -- otherwise, add an AudioClip of your choice to the SALSA-linked AudioSource.
Currently Available OneClicks
Adobe-specific models may not work due to inconsistent mesh/shape naming. They can certainly be setup manually within the SALSA Suite system; however, the available OneClick may not completely configure a character. As mentioned, you can manually setup a non-standard Fuse character and create your own OneClick for it (information on creating a custom OneClick solution).
Reallusion CC3 and iClone
Reallusion is a very flexible system with varying ways to import and export models. Generally speaking, if you are specifically using iClone models, use the iClone OneClick. For most other instances, use the CC3 OneClick. As new updates or use-cases evolve, we will assess the situation and attempt to update the OneClick to support models generated from the system when we are made aware and when possible or warranted.
Current supported situations: Standard/Game iClone/CC3 exported models should work. DAZ models imported with 3DExchange system and leveraging the CC3 animation system should work with the CC3 OneClick.
If you choose to create animations using blendshapes within the iClone/CC3 system, exported animations will interfere with SALSA, EmoteR, and Eyes. There are currently three options available to deal with this situation:
Do not export animations using blendshapes -- use the SALSA Suite to handle your character's facial animations.
Only use animations with blendshapes not being used by SALSA, EmoteR, or Eyes. This will require editing the animation and removing the conflicting blendshapes.
Try the experimental SALSA setting, enabling persistence mode. Also, Enable persistence on all conflicting emotes. Persistence does add overhead to the SALSA Suite; however, it may be negligible in most situations.
DAZ3D (for Genesis models)
For correct OneClick operation, it is necessary to export blendshapes from DAZ using the "head" search rule. This ensures blendshapes are prefixed with "head" and that the OneClick processor can find them. Please see our legacy DAZ article for more details on exporting.