Curve Text Tags
Text tagging is a way to insert expression curves in synchronization with the words spoken in an audio file. FaceFX technology figures out the timing of every word in the text file then uses the information in the tags to create curves based upon the position of the tags in the text.
Curve Types
FaceFX text tagging supports four types of curves: Leading Triplets, Centered Triplets, Trailing Triplets, and Quadruplets. Below is an example of all four curve types drawn on top of each other. Notice that the type= tag is not required for the Quadruplet below because quads are the default curve type. Also notice that the quotes around the name are only necessary when there are spaces in the name.
Text
["Yellow curve" type=lt]
[Orange type=ct]
[Green type=tt]
[White]
tagging
[/White][/Green][/Orange] [/"Yellow curve"]
is fun!
Parameter List
The following parameters come after the name of the curve to specify additional attributes: type, v1, v2, v3, v4, TimeShift, Easein, Easeout, and Duration. The parameters are case insensitive, so you can type “timeshift”, “TIMESHIFT”, or “TiMeShIfT” and it will have the same effect.
v1, v2, v3, v4
These parameters are used to change the value of the curve at the specified points. The default values are 1.0 at the apex of the curve and 0.0 at the bottom of the curve.
Timeshift
This function shifts the entire curve by a fixed amount of time in seconds. Negative values are permitted.
Easein
This parameter specifies the length of time before the starting word boundary that the curve begins. The first point in a curve is located before the starting word boundary because the curve needs time to ramp up. The exact amount of time is specified with the Easein parameter. The default value is 0.2 seconds.
Easeout
This parameter works exactly like Easein except that it modifies the speed at which the curve tapers off. It does this by adjusting the distance between the final point and the ending word boundary.
Duration
The duration parameter is only valid for quadruplet curves. The parameter specifies the time in between the V2 and V3 values. The duration parameter has the effect of shifting the V3 and V4 values and overriding the placement dictated by the closing tag.
Default Values for Curve Parameters
| type | type | v1 | v2 | v3 | v4 | timeshift | easein | easeout | duration |
| values | seconds | ||||||||
| quadruplet | quad | 0 | 1 | 1 | 0 | 0 | 0.2 | 0.2 | (from text) |
| leading triplet | lt | 0 | 1 | 0 | N/A | 0 | 0.2 | 0.2 | N/A |
| trailing triplet | tt | 0 | 1 | 0 | N/A | 0 | 0.2 | 0.2 | N/A |
| center triplet | ct | 0 | 1 | 0 | N/A | 0 | 0.2 | 0.2 | N/A |
Notes
- Text tags can be used even without text. In this case, all key times will be relative to time zero. Use of the timeshift parameter will be important in this case.
- Make sure there are no spaces between the parameters and the arguments. For example timeshift = 1 is incorrect and timeshift=1 is correct.
- Text tags can create multiple keys with different values at exactly the same time. This will be evaluated by FaceFX in an unpredictable way, so this scenario should be avoided.
