Mesh（网格）文件格式

在Unigine中是按如下方式将归一化的浮点法线压缩成【unsigned short】格式的：

x = (unsigned short)(clamp((int)((normal.x * 0.5f + 0.5f) * 65535.0f),0,65535));
y = (unsigned short)(clamp((int)((normal.y * 0.5f + 0.5f) * 65535.0f),0,65535));
z = (unsigned short)(clamp((int)((normal.z * 0.5f + 0.5f) * 65535.0f),0,65535));

• normal 代表归一化的浮点法线。
• x, y 和 z 分别代表unsigned short类型的压缩法线。

被压缩成【unsigned short】格式的帧的变换和缩放，可以按如下方式实现解压缩：

• 帧变换的解压缩：
  源代码 (UnigineScript)

  x = xyz_min.x + xyz_size.x * (compressed_position.x / 65535.0f);
  y = xyz_min.y + xyz_size.y * (compressed_position.y / 65535.0f);
  z = xyz_min.z + xyz_size.z * (compressed_position.z / 65535.0f);

  在这里：
  • 【xyz_min】代表沿X，Y和Z轴方向上的Bounding Box（包围盒）的最小值点坐标。
  • 【xyz_size】代表Bounding Box（包围盒）的大小。
  • 【x】,【y】和【z】分别代表unsigned short类型的已压缩的帧变换。
• 帧缩放的解压缩：
  源代码 (UnigineScript)

  x = scale_min.x + scale_size.x * (compressed_scale.x / 65535.0f);
  y = scale_min.y + scale_size.y * (compressed_scale.y / 65535.0f);
  z = scale_min.z + scale_size.z * (compressed_scale.z / 65535.0f);

  在这里：
  • 【scale_min】代表沿X，Y和Z轴方向上的Bounding Box（包围盒）的最小值点坐标。
  • 【scale_size】代表Bounding Box（包围盒）的大小。
  • 【x】,【y】和z分别代表unsigned short类型的已压缩的帧缩放。

1. 文件格式标识符（int "ms10" ('m' | ('s' << 8) | ('1' << 16) | ('0' << 24))）
2. 整个mesh的包围体积：
   • Mesh包围盒（Bounding Box）的最小值点坐标（float[3]）
   • Mesh包围盒（Bounding Box）的最大值点坐标（float[3]）
   • Mesh包围球体（Bounding Sphere）的中心（float[3]）
   • Mesh包围球体（Bounding Sphere）的半径（float）
3. Bone（骨骼）的数量（int）
4. 每个bone的标头信息：
   • Bone名称。 它是以null空字符结尾的【string】类型的字符串，包含有如下信息：
     1. 包含有null空字符的字符串中的字符数量（int）。
     2. 指定长度的bone名称（char[length]）。
   • 父bone。 如果存在没有父bone的根骨骼（root bone），这里就要使用-1参数。（short）
5. Mesh animation（一般网格动画）的数量（int）
6. 每个animation的标头信息：
   • Animation名称。 它是以null空字符结尾的【string】类型的字符串，包含有如下信息：
     1. 包含有null空字符的字符串中的字符数量（int）。
     2. 指定长度的animation名称（char[length]）。
7. Surface（表面）的数量（int）
8. 每个surface的标头信息：
   • Surface名称。 它是以null空字符结尾的【string】类型的字符串，包含有如下信息：
     1. 包含有null空字符的字符串中的字符数量（int）。
     2. 指定长度的surface名称（char[length]）。
   • Surface包围盒（Bounding Box）的最小值点坐标 (float[3])
   • Surface包围盒（Bounding Box）的最大值点坐标 (float[3])
   • Surface包围球体（Bounding Sphere）的中心 (float[3])
   • Surface包围球体（Bounding Sphere）的半径 (float)
   • Surface变形目标（Morph Target）的数量 (int)
   • 每个morph target的标头信息：
     1. Morph Target名称。 它是以null空字符结尾的【string】类型的字符串，包含有如下信息：
        • 包含有null空字符的字符串中的字符数量 (int)。
        • 指定长度的morph target名称 (char[length])。
9. 文件格式标识符 (int "ms10" ('m' | ('s' << 8) | ('1' << 16) | ('0' << 24)))
10. 每个bone包含的信息：
    • 沿X，Y，Z轴方向上的bone坐标位置 (float[3])
    • Bone旋转四元数 (float[4])
    • 沿所有方向上的bone缩放 (float[3])
11. 每个animation包含的信息：
    • 涉及该animation的bone数量 (int)
    • 涉及该animation的bone索引 (short[length])
    • Flag(标志位)（unsigned char），每个8位标志位用来决定一般网格动画（Mesh Animations）是否应该对涉及它们本身的bones的平移分量，缩放分量或旋转分量进行存储
    • Animation帧（Frame）的数量 (int)
    • 每一帧中每个bone的变换数据：
      1. Flag(标志位)（unsigned char），每个8位标志位用来决定当前帧是否应该存储bone的新平移分量，新缩放分量或新旋转分量。 如果这些分量自上一帧以后就没发生过改变，那么就不需要存储新数据。 这种情况下当前帧反而会使用上一帧中的数据，如此一来内存的使用效率也就大大提高了。
      2. 如果有数据被标记为发生改变了，那么就要存储bone的每一组新分量，涉及的信息如下：
         • 沿X轴方向上的bone平移 (float)
         • 沿Y轴方向上的bone平移 (float)
         • 沿Z轴方向上的bone平移 (float)
         • 旋转四元数 (short[4])
         • Bone缩放的X轴分量 (float)
         • Bone缩放的Y轴分量 (float)
         • Bone缩放的Z轴分量 (float)
-->
12. 每个surface包含的geometry（几何）数据：
    • Surface的每个morph target（变形目标）上包含的数据：
      1. Morph target中的顶点数量 (int)
      2. Morph target的顶点 (float[3*length])
      3. 切线数量 (int)
      4. 对每条切线而言：
         • 其X，Y和Z轴分量都是【short】类型；W轴分量是【char】类型。
    • Surface权重的数量 (int)
    • 每个surface权重包含的信息：
      1. 影响顶点的bone数量（其最大值是4） (unsigned char)
      2. 影响顶点的每个bone所包含的信息：
         • Bone索引 (short)
         • Bone权重 (unsigned short)
    • 第一UV集中texture（纹理）坐标的数量 (int)
    • 每个texture坐标包含的信息：
      1. 第一UV的texture坐标(float[2])
    • N第二UV集中texture坐标的数量 (int)
    • 每个texture坐标包含的信息：
      1. 第二UV的texture坐标 (float[2])
    • 8位顶点colors（颜色）的数量 (int)
    • 每个color包含的信息：
      1. Color值 (char[4])
    • Coordinate index（坐标索引）的数量 (int)
    • 对surface的每个顶点的Coordinate index而言：
      1. 如果零号morph target包含的坐标顶点数少于256个，那么所有的index都应是【unsigned char[length]】类型
      2. 如果零号morph target包含的坐标顶点数少于65536个，那么所有的index都应是【short[length]】类型
      3. 对于其它的情况，所有的index都应是【int[length]】类型
    • Triangle index（三角形索引）的数量 (int)
    • 对surface的每个顶点的Triangle index而言：
      1. 如果零号morph target包含的三角形顶点数少于256个，那么所有的index都应是【unsigned char[length]】类型
      2. 如果零号morph target包含的三角形顶点数少于65536个，那么所有的index都应是【short[length]】类型
      3. 对于其它的情况，所有的index都应是【int[length]】类型
    • 文件格式标识符 (int "ms10" ('m' | ('s' << 8) | ('1' << 16) | ('0' << 24)))

1. 文件格式标识符 (int "an10" ('a' | ('n' << 8) | ('1' << 16) | ('0' << 24)))
2. 整个animation的包围体积：
   • Bounding Box（包围盒）的最小值点坐标 (float[3])
   • Bounding Box（包围盒）的最大值点坐标 (float[3])
   • Bounding Sphere（包围球体）的中心 (float[3])
   • Bounding Sphere（包围球体）的半径 (float)
3. Skinned Animation（蒙皮动画）中的bone数量 (int)
4. 每个bone的标头信息：
   • Bone名称。 它是以null空字符结尾的【string】类型的字符串，包含有如下信息：
     1. 包含有null空字符的字符串中的字符数量 (int)
     2. 指定长度的bone名称 (char[length])
   • 父bone (short)
5. Animation的数量 (int)
6. 每个animation的标头信息：
   • Animation名称。 它是以null空字符结尾的【string】类型的字符串，包含有如下信息：
     1. 包含有null空字符的字符串中的字符数量 (int)
     2. 指定长度的animation名称 (char[length])
7. 文件格式标识符 (int "an10" ('a' | ('n' << 8) | ('1' << 16) | ('0' << 24)))
8. 每个bone包含的信息：
   • 沿X，Y，Z轴方向上的bone坐标位置 (float[3])
   • Bone旋转四元数 (float[4])
   • 沿所有方向上的bone缩放 (float[3])
9. 每个animation包含的信息：
   • Animation bone（动画骨骼）的数量 (int)
   • 涉及该animation的bone索引 (short[length])
   • 在其内进行动画所用到的那个Bounding Box（包围盒）包含的信息：
     1. 在其内执行animation bones平移所用到的那个Bounding Box（包围盒）包含的信息：
        • 沿X，Y和Z轴方向上的Bounding Box（包围盒）的最小值点坐标 (float[3])
        • Bounding Box（包围盒）的大小 (float[3]).
     2. 在其内执行animation bones缩放所用到的那个Bounding Box（包围盒）包含的信息：
        • 沿X，Y和Z轴方向上的Bounding Box（包围盒）的最小值点坐标 (float[3])
        • Bounding Box（包围盒）的大小 (float[3]).
   • Flag(标志位)（unsigned char），每个8位标志位用来决定动画（ Animations）是否应该对涉及它们本身的bones的平移分量，缩放分量或旋转分量进行存储
   • Animation帧（Frame）的数量 (int)
   • 每一帧中每个骨骼的变换数据：
     • Flag(标志位)（unsigned char），每个8位标志位用来决定当前帧是否应该存储bone的新平移分量，新缩放分量或新旋转分量。 如果这些分量自上一帧以后就没发生过改变，那么就不需要存储新数据。 这种情况下当前帧反而会使用上一帧中的数据，如此一来内存的使用效率也就大大提高了
     • 如果有数据被标记为发生改变了，那么就要存储bone的每一组新分量，涉及的信息如下：
       1. 沿X轴方向上的bone平移 (unsigned short)
       2. 沿Y轴方向上的bone平移 (unsigned short)
       3. 沿Z轴方向上的bone平移 (unsigned short)
       4. 旋转四元数 (short[4])
       5. Bone缩放的X轴分量 (unsigned short)
       6. Bone缩放的Y轴分量 (unsigned short)
       7. Bone缩放的Z轴分量 (unsigned short)

       上述这些位置和旋转都被限定在计算所得的Bounding Box（包围盒）的内部取值：也就是说，它们的坐标值须从该包围盒的最小值点坐标和最大值点坐标之间的范围选择（其取值范围是从0到65535)。

10. 文件格式标识符 (int "an10" ('a' | ('n' << 8) | ('1' << 16) | ('0' << 24)))