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

Chunks migration

v3.6.0 stores the chunk files from the chunks folder of the previous version into subfolders, please refer to the following table when writing #include for chunk.

1. Public function libraries

Origin PathNew Path
commoncommon/common-define
texture-lodcommon/texture/texture-lod
packingcommon/data/packing
unpackcommon/data/unpack
acescommon/color/aces
gammacommon/color/gamma
octahedron-transformcommon/math/octahedron-transform
transformcommon/math/transform
rect-area-lightcommon/lighting/rect-area-light

2. Uniform define

Origin PathNew Path
cc-globalbuiltin/uniforms/cc-global
cc-localbuiltin/uniforms/cc-local
cc-forward-lightbuiltin/uniforms/cc-forward-light
cc-environmentbuiltin/uniforms/cc-environment
cc-diffusemapbuiltin/uniforms/cc-diffusemap
cc-shadowbuiltin/uniforms/cc-shadow
cc-world-boundbuiltin/uniforms/cc-world-bound

3. Common shader main-functions for legacy shader

Origin PathNew Path
outline-vslegacy/main-functions/outline-vs
outline-fslegacy/main-functions/outline-fs
general-vslegacy/main-functions/general-vs

4. Engine functionality and miscellaneous for legacy shader

Origin PathNew Path
cc-fog-baselegacy/fog-base
cc-shadow-map-baselegacy/shadow-map-base
morphlegacy/morph
cc-skinninglegacy/skinning
cc-local-batchlegacy/local-batch
lightinglegacy/lighting
lightingmap-fslegacy/lightingmap-fs
cc-shadow-map-vslegacy/shadow-map-vs
cc-shadow-map-fslegacy/shadow-map-fs
cc-fog-vslegacy/fog-vs
cc-fog-fslegacy/fog-fs
lightingmap-vslegacy/lightingmap-vs
decodelegacy/decode
decode-baselegacy/decode-base
decode-standardlegacy/decode-standard
inputlegacy/input
input-standardlegacy/input-standard
outputlegacy/output
output-standardlegacy/output-standard
shading-standardlegacy/shading-standard
shading-standard-baselegacy/shading-standard-base
shading-standard-additivelegacy/shading-standard-additive
shading-cluster-additivelegacy/shading-cluster-additive
shading-toonlegacy/shading-toon
standard-surface-entrylegacy/standard-surface-entry

5. For internal use only

Origin PathNew Path
alpha-testbuiltin/internal/alpha-test
cc-sprite-commonbuiltin/internal/sprite-common
cc-sprite-texturebuiltin/internal/sprite-texture
embedded-alphabuiltin/internal/embedded-alpha
particle-commonbuiltin/internal/particle-common