升级指南：粒子 从 v3.5.x 升级到 v3.6.0

CPU 粒子

v3.6.0 粒子系统新增了 instance 支持，粒子 shader particle-vs-legacy.chunk 需要做如下修改：

原来的 layout：

  1. in vec3 a_position; // center position
  2. in vec3 a_texCoord;  // xy:vertex index,z:frame index
  3. in vec3 a_texCoord1; // size
  4. in vec3 a_texCoord2; // rotation
  5. in vec4 a_color;
  7. #if CC_RENDER_MODE == RENDER_MODE_STRETCHED_BILLBOARD
  8.   in vec3 a_color1; // velocity.x, velocity.y, velocity.z, scale
  9. #endif
  11. #if CC_RENDER_MODE == RENDER_MODE_MESH
  12.   in vec3 a_texCoord3;  // mesh vertices
  13.   in vec3 a_normal;     // mesh normal
  14.   in vec4 a_color1;     // mesh color
  15. #endif

现在的 layout：

  1. in vec3 a_texCoord1;  // size
  2. in vec3 a_texCoord2;  // rotation
  3. in vec4 a_color;
  5. in vec3 a_texCoord;  // xy:vertex index,z:frame index
  6. #if !CC_INSTANCE_PARTICLE
  7.  in vec3 a_position;  // center position
  8. #endif
  9. #if CC_INSTANCE_PARTICLE
  10.  in vec4 a_texCoord4; // xyz:position,z:frame index
  11. #endif
  13. #if CC_RENDER_MODE == RENDER_MODE_STRETCHED_BILLBOARD
  14.   in vec3 a_color1; // velocity.x, velocity.y, velocity.z, scale
  15. #endif
  17. #if CC_RENDER_MODE == RENDER_MODE_MESH
  18.   in vec3 a_texCoord3;  // mesh vertices
  19.   in vec3 a_normal;     // mesh normal
  20.   in vec4 a_color1;     // mesh color
  21. #endif

其它 shader 代码需要参考 v3.6.0 的 particle-vs-legacy.chunk 进行修改。

GPU 粒子

GPU 粒子 shader particle-vs-gpu.chunk 需要做如下修改：

原来的 layout：

  1. in vec4 a_position_starttime; // center position,particle start time
  2. in vec4 a_size_uv;  // xyz:size, w:uv_0
  3. in vec4 a_rotation_uv;  // xyz:rotation, w:uv_1
  4. in vec4 a_color;
  5. in vec4 a_dir_life;  // xyz:particle start velocity,w:particle lifetime
  6. in float a_rndSeed;
  8. #if CC_RENDER_MODE == RENDER_MODE_MESH
  9.   in vec3 a_texCoord;  // mesh uv
  10.   in vec3 a_texCoord3;  // mesh vertices
  11.   in vec3 a_normal;     // mesh normal
  12.   in vec4 a_color1;     // mesh color
  13. #endif

现在的 layout

  1. in vec4 a_position_starttime; // center position,particle start time
  2. in vec4 a_color;
  3. in vec4 a_dir_life;  // xyz:particle start velocity,w:particle lifetime
  4. in float a_rndSeed;
  6. #if !CC_INSTANCE_PARTICLE
  7.   in vec4 a_size_uv;  // xyz:size, w:uv_0
  8.   in vec4 a_rotation_uv;  // xyz:rotation, w:uv_1
  9. #endif
  10. #if CC_INSTANCE_PARTICLE
  11.   in vec4 a_size_fid;  // xyz:size, w:fid
  12.   in vec3 a_rotation;  // xyz:rotation
  13.   in vec3 a_uv;
  14. #endif
  16. #if CC_RENDER_MODE == RENDER_MODE_MESH
  17.   in vec3 a_texCoord;   // mesh uv
  18.   in vec3 a_texCoord3;  // mesh vertices
  19.   in vec3 a_normal;     // mesh normal
  20.   in vec4 a_color1;     // mesh color
  21. #endif

其它 shader 代码需要参考 v3.6.0 的 particle-vs-gpu.chunk 进行修改。