Upgrade Guide: Particle from v3.5.x to v3.6.0

CPU Particle

The particle shader particle-vs-legacy.chunk should be modified to support instance particles added in v3.6.0.

layout before

  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 now

  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

Other shader code should be modified refer to particle-vs-legacy.chunk of v3.6.0

GPU Particle

GPU particle shader particle-vs-gpu.chunk should be modified.

layout before

  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 after

  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

Other shader code should be modified refer to particle-vs-gpu.chunk of v3.6.0.