物理模拟

最終更新: 2022年12月8日

创建物理模拟设置

物理模拟设置由Editor创建并放在一个.physics3.json文件中。
关于物理模拟的设置,请参考“如何设置物理模拟”,关于物理模拟设置文件的输出,请参考“输出嵌入数据”

物理模拟类

CubismPhysics类用于计算物理模拟并将其应用于模型。
通过将.physics3.json文件的数据传递给Native(C++)的CubismPhysics::Create函数、Web(TypeScript)、Java的CubismPhysics.create函数,将生成反映物理模拟设置的CubismPhysics类副本。

// C++
csmString path = "example.physics3.json";
buffer = CreateBuffer(path.GetRawString(), &size);

CubismPhysics* _physics = CubismPhysics::Create(buffer, size);

DeleteBuffer(buffer, path.GetRawString());
// TypeScript
let path: string = "example.physics3.json";

fetch(path).then(
    (response) => 
    {
        return response.arrayBuffer();
    }
).then(
    (arrayBuffer) =>
    {
        let buffer: ArrayBuffer = arrayBuffer;
        let size: number = buffer.byteLength;

        _physics: CubismPhysics = CubismPhysics.create(buffer, size);
        deleteBuffer(buffer, path);
    }
);
// Java
String path = "example.physics3.json";
buffer = createBuffer(path);
CubismPhysics _physics = CubismPhysics.create(buffer);

此时,.physics3.json文件中描述的Gravity和Wind被Native(C++)的CubismPhysics::Options结构变量_options、Web(TypeScript)、Java的CubismPhysics.ts的Option类变量_options将被覆盖。

这个变量_options可以通过Native(C++)的CubismPhysics::GetOptions函数和CubismPhysics::SetOptions函数、
Web(TypeScript)、Java的CubismPhysics.getOptions函数及CubismPhysics.setOptions函数进行访问。

// C++
/**
 * @brief 选项
 * 
 * 物理模拟选项。
 */
struct Options
{
    CubismVector2 Gravity;          /// < 重力方向
    CubismVector2 Wind;             /// < 风向
};

Options     _options;               /// < 选项
// TypeScript
/**
 * 物理模拟选项
 */
export class Options
{
    constructor()
    {
        this.gravity = new CubismVector2(0, 0);
        this.wind = new CubismVector2(0, 0);
    }

    gravity: CubismVector2; // 重力方向
    wind: CubismVector2;    // 风向
}

_options: Options;  // 选项
//Java
/**
* 物理模拟选项。
*/
public static class Options {
    public final CubismVector2 gravity; // 重力方向
    public final CubismVector2 wind; // 风向
  
    public Options() {
        gravity = new CubismVector2();
        wind = new CubismVector2();
    }

    /**
     * 复制构造函数
     */
    public Options(Options options) {
        this.gravity = new CubismVector2(options.gravity);
        this.wind = new CubismVector2(options.wind);
    }
}

private Options _options; // 选项

此外,变量_options覆盖的Gravity和Wind值如下代码所示。

// C++
// set default options.
_options.Gravity.Y = -1.0f;
_options.Gravity.X = 0;
_options.Wind.X = 0;
_options.Wind.Y = 0;
// TypeScript
// set default options
this._options = new Options();
this._options.gravity.y = -1.0;
this._options.gravity.x = 0;
this._options.wind.x = 0;
this._options.wind.y = 0;
// Java
// set default options.
_options.gravity.x = 0.0f;
_options.gravity.y = -1.0f;
_options.wind.x = 0.0f;
_options.wind.y = 0.0f;

适用于模型

要将物理模拟的计算结果应用于模型的参数,请使用Native(C++)的CubismPhysics::Evaluate函数、Web(TypeScript)、Java的CubismPhysics.evaluate函数。
此时,物理模拟的计算也同时进行。

// C++
// 物理模拟设置
if (_physics != NULL)
{
    _physics->Evaluate(_model, deltaTimeSeconds);
}
// TypeScript
// 物理模拟设置
if(_physics != null)
{
    _physics.evaluate(_model, deltaTimeSeconds);
}
// Java
// 物理模拟设置
if (_physics != null) {
    _physics.evaluate(_model, deltaTimeSeconds);
}

放弃

您还需要在模型释放时放弃CubismPhysics类。

// C++
CubismPhysics::Delete(_physics);
// TypeScript
CubismPhysics.delete(_physics);

在Java中,由于垃圾回收负责释放,因此无需放弃。

关于本报道,敬请提出您的意见及要求。