> For the complete documentation index, see [llms.txt](https://docs.loomai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.loomai.com/unity-voice2animation/basic-rig-spec.md). # Loom.ai Facial Rig Specification #### update 3.11.2020 | Refer to | Region | Shape Name | Description | | -------- | ------ | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Mouth | c\_CRUL | Chin Raiser Upper Lip: Moves the upper lip when c\_CR is engaged and touching the upper lip | | 2 | Mouth | c\_CR | Chin Raiser: Raises the chin up; moves the lower lip upwards | | 3 | Mouth | c\_FN | Funneler: Makes an 'O' shape with the mouth | | 4 | Mouth | c\_LPT | Lips Together: Brings the lips together relative to c\_JD, base shape is an empty target. Combination x2\_c\_JDxLPT brings the lips together. | | 5 | Mouth | c\_MR / c\_ML | Mouth Right/Left: Moves the mouth right/left | | 6 | Mouth | c\_PK | Pucker: Makes a kiss-like shape with the mouth | | 7 | Mouth | r\_LCD / l\_LCD | Right/Left Lip Corner Down: Lowers the corners of the mouth downwards in a frown | | 8 | Mouth | r\_LLD / l\_LLD | Right/Left Lower Lip Depressor: Lowers the lower lip down away from the upper lip revealing the lower teeth | | 9 | Mouth | r\_LCP / l\_LCP | Right/Left Lip Corner Puller: Raises the corners of the mouth upwards in a smile | | 10 | Mouth | r\_LS / l\_LS | Right/Left Lip Stretcher: Stretches the corners of the mouth apart | | 11 | Mouth | r\_ULR / l\_ULR | Right/Left Upper Lip Raiser: Raises the right/left upper lip away from the lower lip revealing the upper teeth | | 12 | Jaw | c\_JD | Jaw Drop: Lowers the jaw downward opening the mouth | | 13 | Jaw | c\_JR / c\_JL | Jaw Right/Left: Moves mouth and jaw to the right/left (character right/left) | | 14 | Tongue | c\_JD | Jaw Drop (for tongue geometry): Lowers the tongue downward as the jaw opens | | 15 | Tongue | c\_TO | Tongue out; moves the tongue straight out | | 16 | Tongue | c\_TU | Tongue up: moves the tongue up behind the teeth | ## Region: Mouth ### 1 **Shape Name:** `c_CRUL` **Description:** Chin Raiser Upper Lip: Moves the upper lip when c\_CR is engaged and touching the upper lip ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2eYiVcjwgZG51YQ0ql%2Fc_CRUL.png?alt=media\&token=7306db43-e287-4efc-99c1-6391874a08e9) ### 2 **Shape Name:** `c_CR` **Description:** Chin Raiser: Raise the chin up moving the lower lip upwards ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2eZmJ4CZ1YXhGw6jbr%2Fc_CR.png?alt=media\&token=1a2a6378-0ea6-431e-a347-e7e71250ef13) ### 3 **Shape Name:** `c_FN` **Description:** Funneler: Makes an 'O' shape with the mouth ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2eZyRvduD9It_G9t-S%2Fc_FN.png?alt=media\&token=bd423105-9deb-4e20-aebc-a00a453a6cc8) ### 4 **Shape Name:** `c_LPT` **Description:** Lips Together: Brings the lips together relative to c\_JD ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2e_I-x-LXjTh2lx42w%2Fc_LPT.png?alt=media\&token=5b6f7496-3e0c-4697-9430-3e3e7b3ad429) ### 5 **Shape Name:** `c_MR / c_ML` **Description:** Mouth Right/Left: Moves the mouth right/left ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2BCbqyTfHxZgBxjjKy%2F-M2BGEgYXSG7lDL_jBg1%2Fyangzi_c_MR_c_ML.png?alt=media\&token=0bd471dc-3ce9-48e8-8652-d5c69ff54ea4) ### 6 **Shape Name:** `c_PK` **Description:** Pucker: Makes a kiss like shape with the mouth ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2e_OCR3uthYlroaiuK%2Fc_PK.png?alt=media\&token=c9925770-145b-4090-9b14-5d53b7e52381) ### 7 **Shape Name:** `r_LCD / l_LCD` **Description:** Right/Left Lip Corner Down: Lowers the corners of the mouth downwards in a frown ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyUtZCeFfQKXewCk%2Ffacial_rig_img_13.png?generation=1583965275723489\&alt=media) ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2e_X3WhSqiWaD62sEs%2Ffred_r_LCD_l_LCD.png?alt=media\&token=fc434451-3cb6-4a08-8758-0098c4d3bc58) ### 8 **Shape Name:** `r_LLD / l_LLD` **Description:** Right/Left Lower Lip Depressor: Lowers the lower lip down away from the upper lip revealing the lower teeth ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyUxPf8Q3BeoJRVr%2Ffacial_rig_img_15.png?generation=1583965290186259\&alt=media) ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2e_enGPM6LMBifGfX_%2Ffred_r_LLD_l_LLD.png?alt=media\&token=5e487c82-2427-4a1f-b25d-da3b63a239ae) ### 9 **Shape Name:** `r_LCP / l_LCP` **Description:** Right/Left Lip Corner Puller: Raises the corners of the mouth upwards in a smile ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyV0szxc9awdIita%2Ffacial_rig_img_17.png?generation=1583965295576952\&alt=media) ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2e_kjKSISX8aNq0zHW%2Ffred_r_LCP_l_LCP.png?alt=media\&token=17612f07-ada8-48ba-8f76-ffbc3d5511d4) ### 10 **Shape Name:** `r_LS / l_LS` **Description:** Right/Left Lip Stretcher: Stretches the corners of the mouth apart ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyV44UG7fb_s5np4%2Ffacial_rig_img_19.png?generation=1583965299067543\&alt=media) ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2e_pz4fC4sUhZkgdlq%2Ffred_r_LS_l_LS.png?alt=media\&token=a2b8e76c-73a9-4903-98a1-3a684fb470f1) ### 11 **Shape Name:** `r_ULR / l_ULR` **Description:** Right/Left Upper Lip Raiser: Raises the right/left upper lip away from the lower lip revealing the upper teeth ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyV8xOwTCZNk56hU%2Ffacial_rig_img_21.png?generation=1583965298254130\&alt=media) ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2e_uz8E_B-7PflqaMv%2Ffred_r_ULR_l_ULR.png?alt=media\&token=cb93c2cf-ed7e-4b08-b26b-88935636fb1b) ## Region: Jaw ### 12 **Shape Name:** `c_JD` **Description:** Jaw Drop: Lowers the jaw downward opening the mouth ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2ea0xF4xmlhPrMquw8%2Fc_JD.png?alt=media\&token=2d16a536-d697-4412-9f03-4718f9b456b1) ### 13 **Shape Name:** `c_JR / c_JL` **Description:** Jaw Right/Left: Moves mouth and jaw to the right/left (character right/left) ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2BCbqyTfHxZgBxjjKy%2F-M2BGmqIo9aj0Cqc4UoF%2Fyangzi_c_JR_c_JL.png?alt=media\&token=1c7b50cf-3f63-4ac5-a2eb-8962085f499a) ## Region: Tongue ### 14 **Shape Name:** `c_JD` **Description:** Tongue corresponding to Jaw Drop: Lowers the tongue downward as the jaw opens ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyVK8vWvBJc6VCIe%2Ffacial_rig_img_27.png?generation=1583965297144215\&alt=media)![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyVM9_wd1E-unwhn%2Ffacial_rig_img_28.png?generation=1583965295926213\&alt=media) ### 15 **Shape Name:** `c_TO` **Description:** Tongue out, moves the tongue straight out ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyVOdPmJ9u_geV1q%2Ffacial_rig_img_29.png?generation=1583965296917222\&alt=media)![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyVQM_fpd3sMVm4H%2Ffacial_rig_img_30.png?generation=1583965297585928\&alt=media) ### 16 **Shape Name:** `c_TU` **Description:** Tongue up, moves the tongue up behind the teeth ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyVSkc1OF2yw97vz%2Ffacial_rig_img_31.png?generation=1583965292024572\&alt=media)![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyVUUm6ezmjuENNF%2Ffacial_rig_img_32.png?generation=1583965298738063\&alt=media) **Example of combinations** In facial animation, face blend targets can be used in combinations to create expressions such as happiness, sadness, anger and phonemes. At times, a combination of blend targets will require the implementation of a corrective shape. Corrective shapes are blend shapes which are created to fix unwanted problems or bad deformations when 2 or more shapes combine. The following images depict one such example of the end result of a combination of multiple shapes. This series illustrates what happens when a combination of shapes is applied to the base head **without** the addition of a corrective. ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyVWwh5cx_H80QPD%2Ffacial_rig_img_33.png?generation=1583965289191033\&alt=media) ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2ea7gVFslg9u5m16TR%2Ffred_JDxPK_no_corrective.png?alt=media\&token=6219a70e-cc2a-4545-9e39-ec941b8857a9) This series represents the same combination of shapes **with** the inclusion of a corrective shape to adjust unwanted deformations caused by the c\_JD and c\_PK shapes. ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2AfxBZmrl7gnbn95MM%2F-M2AfyV_pwAhWQLa7wXA%2Ffacial_rig_img_35.png?generation=1583965281161609\&alt=media) ![](https://122784304-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lo7yiwgvtEM7rgs7D0j%2F-M2eYG9AcsxWylZyBncx%2F-M2eaD8LtKKmQGj2zVOK%2Ffred_JDxPK_with_corrective.png?alt=media\&token=563a6ab6-b4fc-4c9f-bc51-64220a7297a5)