【Cubism】FACERIG可使用的參數

目前對於Facerig的Live 2D插件文件仍然相當缺乏，對於Cubism中設定的參數那些會被視為操控項，官方網站教學以及早期釋出的說明文件都沒有很完整的統一的說明，這裡試著列出一些目前測試出可用的參數。

(點標題看完整文章)


下表為目前測試出可用的參數，參考名稱可以隨意更改，參數名稱必須完全相同。
免費版中，一個檔案可使用的參數總數為30；PRO版沒有上限。
免費版中，一個物件最多可同時被兩個參數影響；PRO版為三個。
並非所有下表列出的參數都必須加入，可視需求自行刪減。

參數中的L對應到的是使用者的右邊，例如眨右眼會影響到的是PARAM_EYE_L_OPEN。

安排參數時，建議將正值都設定為向右，且所有標示L的參數都在畫面右邊，這樣做出來的模型動態會像照鏡子一樣。

2019/06/29更新
Cubism 3.0之後，參數名稱開始接受不含底線的連接版本，
例如PARAM_ANGLE_X可以改為ParamAngleX，同一個模型的參數命名規則不須統一。

臉部辨識相關參數

此表參數會根據使用者臉部辨識數據做出反應。
沒有特別說明時，正值均為靠向畫面右側(上側)

參考名稱	參數名稱	起始值	變化範圍	簡易說明
臉部左右	PARAM_ANGLE_X	0	-30~30	頭部的左右角度
臉部高低	PARAM_ANGLE_Y	0	-30~30	頭部的高低角度
歪頭	PARAM_ANGLE_Z	0	-30~30	頭部的歪斜角度 正值時頭頂靠向畫面右側
身體左右	PARAM_BODY_ANGLE_Z	0	-10~10	身體的傾斜角度 (實際上為抓取頭部於攝影機的左右位置)
左眼開闔	PARAM_EYE_L_OPEN	1	0~1	人物左眼開/閉  *註1
右眼開闔	PARAM_EYE_R_OPEN	1	0~1	人物右眼開/閉  *註1
雙眼變形	PARAM_EYE_FORM	0	-1~1	雙眼的表情  *註2
眼球左右	PARAM_EYE_BALL_X	0	-1~1	雙眼視線左右
眼球高低	PARAM_EYE_BALL_Y	0	-1~1	雙眼視線高低  *註3
左眉毛高低	PARAM_BROW_L_Y	0	-1~1	*註4
右眉毛高低	PARAM_BROW_R_Y	0	-1~1	*註4
左眉毛形狀	PARAM_BROW_L_FORM	0	-1~1	*註4
右眉毛形狀	PARAM_BROW_R_FORM	0	-1~1	*註4
左眉毛角度	PARAM_BROW_L_ANGLE	0	-1~1	負值時為生氣表情 *註4
右眉毛角度	PARAM_BROW_R_ANGLE	0	-1~1	負值時為生氣表情 *註4
嘴巴開闔	PARAM_MOUTH_OPEN_Y	0	0~1	嘴巴開關
嘴巴表情	PARAM_MOUTH_FORM	0	-1~1	嘴巴表情，負值時為生氣表情 *註5

註1：某些操作下，辨識結果可能會超過1，但是官方的文件中建議0.8左右代表眼睛全開即可。實際上這個部分可以事後從FACERIG中做細微調整，因此正常設定即可。

註2：應該是表現眼睛的特定表情，但是這邊測試很容易因為臉部角度而亂飄，建議不要使用。

註3：這邊測試視線高低的辨識效果不太好，不過同樣可以在FACERIG中做細微調整。

註4：雖然提供了三組眉毛相關的參數，實際上這些參數似乎都很容易因為臉部角度而飄移，難以獲得穩定的辨識結果，因此這邊建議只選用Y的高低，最多加上ANGLE來表現表情。

註5：FACERIG中微笑與生氣的嘴型算是兩種不同的辨識，不過生氣時的嘴角需要彎得很低才有辦法被辨識到，這邊測試的時候數值常常停在0無法再下降。

預設參數

此表參數即使沒有任何臉部辨識也會有效果。

參考名稱	參數名稱	起始值	變化範圍	簡易說明
呼吸	PARAM_BREATH	0	0~1	表現呼吸，隨時都會自動在0跟1之間移動。
表情1	PARAM_CHEEK	0	0~1	按Z對應的表情
表情2	PARAM_TEAR	0	0~1	按X對應的表情
表情3	PARAM_RAGE	0	0~1	按C對應的表情
表情4	PARAM_HAIR_FLUFFY	0	0~1	按V對應的表情
身體角度	PARAM_BODY_ANGLE_X	0	-15~15	*註1

註1：這是FaceRig中較特殊的一個參數，只能透過按著Alt不放並拖曳滑鼠左鍵來調整。

手部參數

此表參數可用滑鼠做一定程度控制，但是如果有Leap motion裝置時便可以直接操作。

Leap motion的場合

參考名稱	參數名稱	起始值	變化範圍	簡易說明
左臂	PARAM_ARM_L	-1	-1~1	對應至辨識手掌的高低，沒有辨識時-1，最高1。
右臂	PARAM_ARM_R	-1	-1~1	同上
左手	PARAM_HAND_L	0	-1~1	對應至辨識手掌的左右，沒有辨識時0，手放在使用者右側時，值為負值。
右手	PARAM_HAND_R	0	-1~1	同上

滑鼠的場合
(滑鼠操作的方法：按著Shift並按下左/右鍵，拖曳可調整數值。)

參考名稱	參數名稱	起始值	變化範圍	簡易說明
左臂	PARAM_ARM_L	-1	-1~1	按著Shift並按下右鍵時會定位至0，之後拖曳上下來調整數值。
右臂	PARAM_ARM_R	-1	-1~1	按著Shift並按下左鍵時會定位至0，之後拖曳上下來調整數值。
左手	PARAM_HAND_L	0.2	-0.6~0.2	按著Shift並按下右鍵時會定位至0，放開回復0.2。 此後追加按下Ctrl，左右拖曳調整數值，此時左臂數值會固定不動。
右手	PARAM_HAND_R	-0.2	-0.2~0.6	按著Shift並按下左鍵時會定位至0，放開回復-0.2。 此後追加按下Ctrl，左右拖曳調整數值，此時右臂數值會固定不動。