参数操作
[最近更新时间：2019/01/18]
CubismIdHandle
为了最终识别Cubism中的一个参数，我们需要得到一个Index，它是一个参数列表。
用ID指定时，作为参数的字符串的ID将被核对。
该框架有一个名为 CubismIdHandle 的类型，用于降低排序规则的计算成本。
Native
CubismIdHandle类型的实际状态是CubismId类的指针类型，可以通过管理类的函数CubismIdManager::GetId函数获取。
由于 CubismIdManager :: GetId 函数如果是相同的字符串则返回相同的指针，
如果 CubismIdHandles 相互比较，并且指针地址相同，则可以保证它们是相同的字符串。
您可以使用静态 CubismFramework :: GetIdManager 函数访问 CubismIdManager 实例。
|
1 2 3 4 5 6 7 8 9 |
// C++ CubismIdHandle idA = CubismFramework::GetIdManager()->GetId("ParamAngleX") CubismIdHandle idB = CubismFramework::GetIdManager()->GetId("ParamAngleX") CubismIdHandle idC = CubismFramework::GetIdManager()->GetId("ParamAngleY") csmBool ab = (idA == idB); //true csmBool bc = (idB == idC); //false |
值操作函数有两种方法：通过 Index 访问和通过 CubismIdHandle 访问。
Web
CubismIdHandle 类型的实际状态是 CubismId 类的对象类型，可以通过管理类的函数 CubismIdManager.getId 函数获取。
由于 CubismIdManager.getId 函数返回相同的实例，如果它是相同的字符串，
如果 CubismIdHandles 相互比较，它们是同一个对象，则可以保证它们是同一个字符串。
您可以使用静态 CubismFramework.getIdManager 函数访问 CubismIdManager 实例。
|
1 2 3 4 5 6 7 8 9 |
// TypeScript let idA: CubismIdHandle = CubismFramework.getIdManager().getId("ParamAngleX"); let idB: CubismIdHandle = CubismFramework.getIdManager().getId("ParamAngleX"); let idC: CubismIdHandle = CubismFramework.getIdManager().getId("ParamAngleY"); let ab = idA.isEqual(idB); //true let bc = idB.isEqual(idC); //false |
值操作函数的访问方式有两种：索引访问和CubismIdHandle访问。
设定参数
参数通常从运动中播放，但您也可以直接指定值。
根据应用值的计算方法，有三种类型的参数操作函数，如下所示。
1.覆盖值
使用本机 (C++) CubismModel :: SetParameterValue 函数或 Web (TypeScript) CubismModel.setParameterValueById 函数。
在第一个参数中设定参数 ID 或索引，在第二个参数中设定值，在第三个参数中设定影响程度。
影响程度是可选的，在这种情况下它将是1。
例如，如果将其设定为 0.5，则会在保留前一个值的 50% 影响的同时进行设定。
例子
|
1 2 |
// C++ _model->SetParameterValue(CubismFramework::GetIdManager()->GetId("ParamAngleX"), 30.0f, 1.0f); |
|
1 2 |
// TypeScript _model.setParameterValueById(CubismFramework.getIdManager().getId("ParamAngleX"), 30.0, 1.0); |
2.添加到当前值
使用本机 (C ++) CubismModel :: AddParameterValue 函数或 Web (TypeScript) CubismModel.addParameterValueById 函数。
参数与 Native (C ++) CubismModel :: SetParameterValue 函数或 Web (TypeScript) CubismModel.setParameterValueById 函数相同。
此函数设定的值将添加到当前为该参数设定的值。
例子
|
1 2 |
// C++ _model->AddParameterValue(CubismFramework::GetIdManager()->GetId("ParamAngleX"), 1.0f, 1.0f); |
|
1 2 |
// TypeScript _model.addParameterValueById(CubismFramework.getIdManager().getId("ParamAngleX"), 1.0, 1.0); |
3.乘以当前值
使用本机 (C ++) CubismModel :: MultiplyParameterValue 函数或 Web (TypeScript) CubismModel.multiplyParameterValueById 函数。
参数与 Native (C ++) CubismModel :: SetParameterValue 函数或 Web (TypeScript) CubismModel.setParameterValueById 函数相同。
此函数设定的值乘以当前为该参数设定的值。
例子
|
1 2 |
// C++ _model->MultiplyParameterValue(CubismFramework::GetIdManager()->GetId("ParamAngleX"), 2.0f, 1.0f); |
|
1 2 |
// TypeScript _model.multiplyParameterValueById(CubismFramework.getIdManager().getId("ParamAngleX"), 2.0, 1.0); |
此外，使用 Native (C ++) CubismModel :: GetParameterValue 函数或 Web (TypeScript) CubismModel.getParameterValueById 函数来获取当前参数值。
参数指标规范
参数ID的指定方式有两种，一种是指定由字符串生成的ID类型，另一种是通过索引指定。
缓存后使用索引会更快，比如提前获取索引，所以建议在调用频率高的时候使用索引。
参数索引可以通过 Native (C++) CubismModel :: GetParameterIndex 函数或 Web (TypeScript) CubismModel.getParameterIndex 函数获取。
例子
|
1 2 3 4 5 6 7 |
// C++ // 初始化时 csmInt32 paramAngleX; paramAngleX = _model->GetParameterIndex(CubismFramework::GetIdManager()->GetId("ParamAngleX")); // 设定参数时 _model->SetParameterValue( paramAngleX, 30.0f , 1.0f); |
|
1 2 3 4 5 6 7 |
// TypeScript // 初始化时 let paramAngleX: number; paramAngleX = _model.getParameterIndex(CubismFramework.getIdManager().getId("ParamAngleX")); // 设定参数时 _model.setParameterValueByIndex(paramAngleX, 30.0, 1.0); |
保存和恢复参数值
要临时保存模型的当前参数值，可以使用 Native (C++) CubismModel::SaveParameters 函数或 Web (TypeScript) CubismModel.saveParameters 函数。
这样做会临时保存所有参数值，并在下次读取 Native (C++) CubismModel::LoadParameters 函数或 Web (TypeScript) CubismModel.loadParameters 函数时恢复。
例子
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
// C++ // 初始化时 csmInt32 paramAngleX; paramAngleX = _model->GetParameterIndex(CubismFramework::GetIdManager()->GetId("ParamAngleX")); // 设定参数为30 _model->SetParameterValue( paramAngleX, 30.0f ,1.0f ); // 临时保存所有当前参数值 _model->SaveParameters(); //设定为0 _model->SetParameterValue( paramAngleX, 0.0f ,1.0f ); //output: value = 0 printf("value = %f",_model->GetParameterValue( paramAngleX ) ); // 恢复上一次saveParam时的状态 _model->LoadParameters(); //output: value =30 printf("value = %f",_model->GetParameterValue( paramAngleX ) ); |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
// TypeScript // 初始化时 let paramAngleX: number; paramAngleX = _model.getParameterIndex(CubismFramework.getIdManager().getId("ParamAngleX")); // 设定参数为30 _model.setParameterValueByIndex(paramAngleX, 30.0, 1.0); // 临时保存所有当前参数值 _model.saveParameters(); //设定为0 _model.setParameterValue(paramAngleX, 0.0, 1.0); // output: value = 0 LAppPal.printLog("value = {0}", _model.getParameterValueByIndex(paramAngleX)); // 恢复上一次saveParam时的状态 _model.loadParameters(); // output: value =30 LAppPal.printLog("value = {0}", _model.getParameterValueByIndex(paramAngleX)); |
如何在 LAppModel 中使用 SaveParameters 和 LoadParameters :: 更新
SaveParameters 和 LoadParameters 作为 API 保存和调用值，
在实际的 LAppModel::Update 函数中，调用 LoadParameter 重置为之前的状态，并且
应用运动播放后，我正在运行保存参数。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 |
// C++ void LAppModel::Update() { const csmFloat32 deltaTimeSeconds = LAppPal::GetDeltaTime(); _userTimeSeconds += deltaTimeSeconds; _dragManager->Update(deltaTimeSeconds); _dragX = _dragManager->GetX(); _dragY = _dragManager->GetY(); csmBool motionUpdated = false; //----------------------------------------------------------------- _model->LoadParameters(); if (_motionManager->IsFinished()) { StartRandomMotion(MotionGroupIdle, PriorityIdle); } else { motionUpdated = _motionManager->UpdateMotion(_model, deltaTimeSeconds); } _model->SaveParameters(); //----------------------------------------------------------------- if (!motionUpdated) { if (_eyeBlink != NULL) { _eyeBlink->UpdateParameters(_model, deltaTimeSeconds); // Set } } if (_expressionManager != NULL) { _expressionManager->UpdateMotion(_model, deltaTimeSeconds); // Add Set Mult } _model->AddParameterValue(_idParamAngleX, _dragX * 30); _model->AddParameterValue(_idParamAngleY, _dragY * 30); _model->AddParameterValue(_idParamAngleZ, _dragX * _dragY * -30); _model->AddParameterValue(_idParamBodyAngleX, _dragX * 10); _model->AddParameterValue(_idParamEyeBallX, _dragX); _model->AddParameterValue(_idParamEyeBallY, _dragY); if (_breath != NULL) { _breath->UpdateParameters(_model, deltaTimeSeconds); // Add } if (_physics != NULL) { _physics->Evaluate(_model, deltaTimeSeconds); // Set } if (_lipSync) { csmFloat32 value = 0; for (csmUint32 i = 0; i < _lipSyncIds.GetSize(); ++i) { _model->AddParameterValue(_lipSyncIds[i], value, 0.8f); } } if (_pose != NULL) { _pose->UpdateParameters(_model, deltaTimeSeconds); // 不对参数进行操作 } _model->Update(); } |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 |
// TypeScript public update(): void { if(this._state != LoadStep.CompleteSetup) return; const deltaTimeSeconds: number = LAppPal.getDeltaTime(); this._userTimeSeconds += deltaTimeSeconds; this._dragManager.update(deltaTimeSeconds); this._dragX = this._dragManager.getX(); this._dragY = this._dragManager.getY(); let motionUpdated = false; //-------------------------------------------------------------------------- this._model.loadParameters(); if(this._motionManager.isFinished()) { this.startRandomMotion(LAppDefine.MotionGroupIdle, LAppDefine.PriorityIdle); } else { motionUpdated = this._motionManager.updateMotion(this._model, deltaTimeSeconds); } this._model.saveParameters(); //-------------------------------------------------------------------------- if(!motionUpdated) { if(this._eyeBlink != null) { this._eyeBlink.updateParameters(this._model, deltaTimeSeconds); // Set } } if(this._expressionManager != null) { this._expressionManager.updateMotion(this._model, deltaTimeSeconds); // Add Set Mult } this._model.addParameterValueById(this._idParamAngleX, this._dragX * 30); this._model.addParameterValueById(this._idParamAngleY, this._dragY * 30); this._model.addParameterValueById(this._idParamAngleZ, this._dragX * this._dragY * -30); this._model.addParameterValueById(this._idParamBodyAngleX, this._dragX * 10); this._model.addParameterValueById(this._idParamEyeBallX, this._dragX); this._model.addParameterValueById(this._idParamEyeBallY, this._dragY); if(this._breath != null) { this._breath.updateParameters(this._model, deltaTimeSeconds); // Add } if(this._physics != null) { this._physics.evaluate(this._model, deltaTimeSeconds); // Set } if(this._lipsync) { let value: number = 0; for(let i: number = 0; i < this._lipSyncIds.getSize(); ++i) { this._model.addParameterValueById(this._lipSyncIds.at(i), value, 0.8); } } if(this._pose != null) { this._pose.updateParameters(this._model, deltaTimeSeconds); // 不对参数进行任何操作 } this._model.update(); } |
此方法的目的是对不播放运动或运动播放未指定的参数。
通过在进入更新的其他操作之前的值覆盖，它是创建加法/正片叠底计算的基础。
如果此功能不可用，如果添加到运动中未指定的参数，则每次更新都会添加该值，并且该值将超出范围。
即使仅在动作播放前加载，您也可以为加法/正片叠底创建基础，
运动播放后进入保存，可以保留运动的最终状态。
获取和设定部件的不透明度
要设定部件的不透明度，请使用 Native (C ++) CubismModel :: SetPart不透明度 函数或 Web (TypeScript) CubismModel.setPart不透明度ById 函数。
要获取部件的不透明度，请使用 Native (C ++) CubismModel :: GetPart不透明度 函数或 Web (TypeScript) CubismModel.getPart不透明度ById 函数。
例子
|
1 2 3 |
// C++ // 设定人脸部件的不透明度为0.5 _model->SetPartOpacity( CubismFramework::GetIdManager()->GetId("PartArmLB001"),0.5f ); |
|
1 2 3 |
// TypeScript // 设定人脸部件的不透明度为0.5 _model.setPartOpacityById(CubismFramework.getIdManager().getId("PartArmLB001"), 0.5); |
参数应用时间和成本
设定参数时，只重写参数值，不计算顶点。
顶点由Native（C++）的CubismModel::Update函数在参数改变后或Web的CubismModel.update函数（TypeScript）计算。
之后，通过Native (C++) 的CubismRenderer :: DrawModel 函数或Web (TypeScript) 的CubismRenderer.drawModel 函数绘制应用参数后的模型。
参数计算顺序的重要性
参数操作分为三种类型：覆盖、加法和正片叠底。
第一次正片叠底计算不会影响以后的加法或覆盖。
如果最后执行覆盖，则到该点为止的所有计算结果都将被忽略。
应用覆盖、加法和正片叠底是很常见的。
在难以将计算内容作为程序组件等检查的情况下。
您需要知道哪个操作执行哪个计算并设定按顺序应用组件的顺序。
让我们看看是什么样的代码差异导致了上面 Gif 所示的眼睛张开差异。
这是将眨眼和面部表情应用于 SDK 中包含的模型范例 haru 的示例。
关于面部表情设定，是在播放f06.exp3.json的状态下睁眼闭眼两次。
只贴出 C++ 代码，因为计算顺序是唯一的问题。
覆盖操作自动眨眼后，设定正片叠底操作的面部表情A更新
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
// C++ // 眨眼 if (!motionUpdated) { if (_eyeBlink != NULL) { //j/ 没有主动作更新时 _eyeBlink->UpdateParameters(_model, deltaTimeSeconds); // 眼裂 } } if (_expressionManager != NULL) { _expressionManager->UpdateMotion(_model, deltaTimeSeconds); // 用面部表情更新参数（相对变化） } |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
// TypeScript // 眨眼 if (!motionUpdated) { if (this._eyeBlink != NULL) { //j/ 没有主动作更新时 this._eyeBlink->UpdateParameters(this._model, deltaTimeSeconds); // 眼裂 } } if (this._expressionManager != NULL) { this._expressionManager.updateMotion(this._model, deltaTimeSeconds); // 用面部表情更新参数（相对变化） } |
设定好正片叠底运算的面部表情后，自动眨眼覆盖运算的B的Update
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
// C++ if (_expressionManager != NULL) { _expressionManager->UpdateMotion(_model, deltaTimeSeconds); // 用面部表情更新参数（相对变化） } // 眨眼 if (!motionUpdated) { if (_eyeBlink != NULL) { //j/ 没有主动作更新时 _eyeBlink->UpdateParameters(_model, deltaTimeSeconds); // 眼裂 } } |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
// TypeScript if (this._expressionManager != NULL) { this._expressionManager.updateMotion(this._model, deltaTimeSeconds); // 用面部表情更新参数（相对变化） } // 眨眼 if (!motionUpdated) { if (this._eyeBlink != NULL) { //j/ 没有主动作更新时 this._eyeBlink.updateParameters(this._model, deltaTimeSeconds); // 眼裂 } } |
在 A 中，您可以看到由于眨眼后面部表情的影响，眼睛睁大了。
另一方面，在B的计算中，被眨眼覆盖，被抑制到标准的开闭眼。
由于计算顺序不同，模型所表达的细微差别很大。
与设计师分享动作、面部表情、功能的计算顺序。