了解 .mgJSON 文件

news2025/1/19 8:47:45

.mgJSON （Motion Graphics JSON）是一个基于标准 JSON 格式的文件扩展名，专门用于存储和交换与动态图形、动画和多媒体应用相关的数据。该格式支持静态和动态数据流，能够精确描述动画、物体变换、图形效果等。

.mgJSON 文件通过层级路径组织这些数据，能够精确定位到目标数据流，并允许对动态数据流进行详细描述和样本化。

一、静态与动态数据流

.mgJSON 文件中的数据可分为静态数据和动态数据两类。

1、静态数据流

静态数据流包含不随时间变化的数据，通常是对象的固定属性，如尺寸、位置、颜色、纹理等。

例如，在一个动画场景中，背景色、物体的初始位置和尺寸等可以存储为静态数据流。

2、动态数据流

动态数据流则表示随时间变化的数据，通常用于描述动画效果、物体的移动、旋转等。

动态数据流是.mgJSON 文件中的关键组成部分，它允许存储动画的关键帧数据、变换值、运动模糊、光照强度变化等信息。

二、层级路径和目标数据流

在.mgJSON 文件中，层级路径用于描述数据流的位置和嵌套关系。它类似于文件系统中的目录结构，指向目标数据流的特定位置。

1、层级路径

用于指定数据流的结构层级。

例如，文件中一个物体的位置信息可能通过路径 scene.objects[0].transform.position 来表示，指向场景中第一个物体的变换属性中的位置数据流。

2、目标数据流

层级路径最终指向的就是目标数据流。

它包含了该属性的实际值，例如 position 数据流中的坐标值 [x, y, z]，表示物体在 3D 空间中的位置。

三、指定数据流的值

在.mgJSON 文件中，数据流的值可以是静态的或动态的。

静态数据流的值通常为单一的常量，如 true, false, 数字、字符串等。

而动态数据流的值则通常由一系列的样本（samples）组成，每个样本表示在某一时刻或时间区间的值。

例如，在动画过程中，物体的旋转角度可能随时间变化，这时其旋转角度的数据流就包含多个样本，每个样本对应一个时间点的旋转角度值。

{
  "object": {
    "transform": {
      "rotation": [
        {"time": 0, "value": 0},
        {"time": 1, "value": 45},
        {"time": 2, "value": 90}
      ]
    }
  }
}

在此示例中，rotation 是一个动态数据流，包含了在时间点 0、1 和 2 时物体的旋转角度。

四、特定动态数据流的样本数量

动态数据流中的样本数量指的是该数据流记录的时间点数目。

样本数量是分析动态数据流时的重要指标，因为它决定了数据的精确度。

例如，一个平滑的动画可能需要较多的样本来表示物体的每一帧变化，而简短的动画则可能只需少量样本。

动态数据流的样本数量可能为 1 或多个样本。每个样本都有一个时间戳，表示该数据值在某个特定时间点的状态。

例如：

{
  "animation": {
    "position": [
      {"time": 0, "value": [0, 0, 0]},
      {"time": 1, "value": [10, 10, 10]},
      {"time": 2, "value": [20, 20, 20]}
    ]
  }
}

上述代码表示一个三维物体的位置信息，随着时间的推移，物体的位置从 [0, 0, 0] 变到 [10, 10, 10]，最终到达 [20, 20, 20]。这里的样本数量为 3。

五、特定动态数据流的样本时间

样本时间表示数据流的某个样本对应的时间点。

它通常以时间码或帧数的形式存在，标记该样本在动画时间线上的具体位置。样本时间对于动画制作至关重要，因为它确定了数据流在动画过程中发生变化的具体时刻。

例如：

{
  "object": {
    "transform": {
      "position": [
        {"time": 0.0, "value": [0, 0, 0]},
        {"time": 1.0, "value": [100, 50, 0]},
        {"time": 2.0, "value": [200, 100, 0]}
      ]
    }
  }
}

在此例中，物体的位置变化发生在 time: 0.0, time: 1.0, 和 time: 2.0 时刻。

六、样本的时间跨度（开始时间和结束时间）

时间跨度是指样本之间的时间间隔。

在动态数据流中，多个样本可能代表一个动作或事件的不同阶段。在这些样本之间的时间跨度决定了动画的流畅度和速度。

1、开始时间

动态数据流中第一个样本的时间戳，通常是动画或变换的开始时刻。

2、结束时间

动态数据流中最后一个样本的时间戳，通常是动画或变换的结束时刻。

例如：

{
  "object": {
    "transform": {
      "position": [
        {"time": 0.0, "value": [0, 0, 0]},
        {"time": 5.0, "value": [50, 50, 0]},
        {"time": 10.0, "value": [100, 100, 0]}
      ]
    }
  }
}

在此例中，位置数据流的时间跨度从 time: 0.0 到 time: 10.0，代表物体在这段时间内从 [0, 0, 0] 位置移动到 [100, 100, 0]。

七、特定动态数据流的样本值

每个样本值代表在该时间点的数据流的状态。在动画和物理模拟中，样本值通常是变量（如位置、旋转、缩放等）随时间变化的具体数值。

例如，物体的位置数据流样本值如下：

{
  "animation": {
    "position": [
      {"time": 0.0, "value": [0, 0, 0]},
      {"time": 1.0, "value": [10, 5, 0]},
      {"time": 2.0, "value": [20, 10, 0]}
    ]
  }
}

在这个例子中，position 数据流的样本值表示物体在不同时间点的 3D 坐标。