FaceFX Support

FaceFX Documentation and support

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