@galacean/engine-core 1.1.0-beta.9 → 1.2.0-alpha.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-core",
-  "version": "1.1.0-beta.9",
+  "version": "1.2.0-alpha.1",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -15,10 +15,10 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-math": "1.1.0-beta.9"
+    "@galacean/engine-math": "1.2.0-alpha.1"
   },
   "devDependencies": {
-    "@galacean/engine-design": "1.1.0-beta.9"
+    "@galacean/engine-design": "1.2.0-alpha.1"
   },
   "scripts": {
     "b:types": "tsc"

package/types/2d/atlas/types.d.ts

@@ -1,3 +1,4 @@
+import { AssetType } from "../../asset/AssetType";
 import { TextureFilterMode, TextureFormat, TextureWrapMode } from "../../texture";
 /**
  * The original data type of the atlas.
@@ -16,6 +17,8 @@ export interface AtlasConfig {
     atlasItems: {
         /** The url of the sub atlas. */
         img: string;
+        /** Image type. */
+        type: AssetType;
         /** Sprites contained in the sub atlas. */
         sprites: AtlasSprite[];
     }[];
@@ -61,4 +64,6 @@ export interface AtlasSprite {
         w: number;
     };
     pixelsPerUnit: number;
+    width: number;
+    height: number;
 }

package/types/2d/enums/SpriteModifyFlags.d.ts

@@ -9,5 +9,6 @@ export declare enum SpriteModifyFlags {
     atlasRegionOffset = 16,
     region = 32,
     pivot = 64,
-    border = 128
+    border = 128,
+    destroy = 256
 }

package/types/2d/text/TextRenderer.d.ts

@@ -108,4 +108,5 @@ export declare class TextRenderer extends Renderer {
     private _resetSubFont;
     private _updatePosition;
     private _updateLocalData;
+    private _isTextNoVisible;
 }

package/types/Camera.d.ts

@@ -55,7 +55,6 @@ export declare class Camera extends Component {
     private _viewport;
     private _pixelViewport;
     private _inverseProjectionMatrix;
-    private _lastAspectSize;
     private _invViewProjMat;
     /**
      * Shader data.
@@ -249,4 +248,5 @@ export declare class Camera extends Component {
      * The inverse of the projection matrix.
      */
     private _getInverseProjectionMatrix;
+    private _onPixelViewportChanged;
 }

package/types/Canvas.d.ts

@@ -1,9 +1,18 @@
 /**
  * Canvas.
  */
-export interface Canvas {
-    /** The width of the canvas. */
-    width: number;
-    /** The height of the canvas. */
-    height: number;
+export declare abstract class Canvas {
+    private _width;
+    private _height;
+    /**
+     * The width of the canvas.
+     */
+    get width(): number;
+    set width(value: number);
+    /**
+     *The height of the canvas.
+     */
+    get height(): number;
+    set height(value: number);
+    protected abstract _onSizeChanged(width: number, height: number): void;
 }

package/types/Component.d.ts

@@ -1,3 +1,4 @@
+import { IReferable } from "./asset/IReferable";
 import { EngineObject } from "./base";
 import { Entity } from "./Entity";
 import { Scene } from "./Scene";
@@ -22,4 +23,5 @@ export declare class Component extends EngineObject {
      */
     get scene(): Scene;
     constructor(entity: Entity);
+    protected _addResourceReferCount(resource: IReferable, count: number): void;
 }

package/types/ComponentsManager.d.ts

@@ -16,6 +16,9 @@ export declare class ComponentsManager {
     private _onUpdateAnimations;
     private _onUpdateRenderers;
     private _componentsContainerPool;
+    addCamera(camera: Camera): void;
+    removeCamera(camera: Camera): void;
+    sortCameras(): void;
     addRenderer(renderer: Renderer): void;
     removeRenderer(renderer: Renderer): void;
     addOnStartScript(script: Script): void;

package/types/DisorderedArray.d.ts

@@ -19,6 +19,7 @@ export declare class DisorderedArray<T> {
     deleteByIndex(index: number): T;
     forEach(callbackFn: (element: T) => void, swapFn: (element: T, index: number) => void): void;
     forEachAndClean(callbackFn: (e: T) => void): void;
+    sort(compareFn: (a: T, b: T) => number): void;
     garbageCollection(): void;
     private _startLoop;
     private _endLoop;

package/types/Engine.d.ts

@@ -1,4 +1,4 @@
-import { IPhysics, IShaderLab } from "@galacean/engine-design";
+import { IHardwareRenderer, IPhysics, IShaderLab, IXRDevice } from "@galacean/engine-design";
 import { Canvas } from "./Canvas";
 import { EngineSettings } from "./EngineSettings";
 import { Entity } from "./Entity";
@@ -8,13 +8,15 @@ import { EventDispatcher, Time } from "./base";
 import { ColorSpace } from "./enums/ColorSpace";
 import { InputManager } from "./input";
 import { PhysicsScene } from "./physics/PhysicsScene";
-import { IHardwareRenderer } from "./renderingHardwareInterface";
+import { XRManager } from "./xr/XRManager";
 /**
  * Engine.
  */
 export declare class Engine extends EventDispatcher {
     /** Input manager of Engine. */
     readonly inputManager: InputManager;
+    /** XR manager of Engine. */
+    readonly xrManager: XRManager;
     private _settings;
     private _resourceManager;
     private _sceneManager;
@@ -130,6 +132,8 @@ export declare class Engine extends EventDispatcher {
 export interface EngineConfiguration {
     /** Physics. */
     physics?: IPhysics;
+    /** XR Device. */
+    xrDevice?: IXRDevice;
     /** Color space. */
     colorSpace?: ColorSpace;
     /** Shader lab */

package/types/Entity.d.ts

@@ -15,6 +15,7 @@ export declare class Entity extends EngineObject {
     layer: Layer;
     /** Transform component. */
     readonly transform: Transform;
+    private _templateResource;
     private _parent;
     private _activeChangedComponents;
     /**

package/types/RenderPipeline/BasicRenderPipeline.d.ts

@@ -1,5 +1,6 @@
 import { Camera } from "../Camera";
 import { Layer } from "../Layer";
+import { CameraClearFlags } from "../enums/CameraClearFlags";
 import { Material } from "../material";
 import { RenderTarget, TextureCubeFace } from "../texture";
 import { RenderContext } from "./RenderContext";
@@ -52,8 +53,9 @@ export declare class BasicRenderPipeline {
      * @param context - Render context
      * @param cubeFace - Render surface of cube texture
      * @param mipLevel - Set mip level the data want to write
+     * @param ignoreClear - Ignore clear flag
      */
-    render(context: RenderContext, cubeFace?: TextureCubeFace, mipLevel?: number): void;
+    render(context: RenderContext, cubeFace?: TextureCubeFace, mipLevel?: number, ignoreClear?: CameraClearFlags): void;
     private _drawRenderPass;
     /**
      * Push render data to render queue.

package/types/RenderPipeline/RenderQueue.d.ts

@@ -28,11 +28,4 @@ export declare class RenderQueue {
      * Sort the elements.
      */
     sort(compareFunc: Function): void;
-    /**
-     * @remarks
-     * Modified based on v8.
-     * https://github.com/v8/v8/blob/7.2-lkgr/src/js/array.js
-     */
-    private _quickSort;
-    private _insertionSort;
 }

package/types/Scene.d.ts

@@ -4,6 +4,7 @@ import { Engine } from "./Engine";
 import { Entity } from "./Entity";
 import { EngineObject } from "./base";
 import { FogMode } from "./enums/FogMode";
+import { DirectLight } from "./lighting";
 import { AmbientLight } from "./lighting/AmbientLight";
 import { PhysicsScene } from "./physics/PhysicsScene";
 import { ShaderData } from "./shader/ShaderData";
@@ -15,8 +16,6 @@ import { ShadowResolution } from "./shadow/enum/ShadowResolution";
 export declare class Scene extends EngineObject {
     private static _fogColorProperty;
     private static _fogParamsProperty;
-    private static _sunlightColorProperty;
-    private static _sunlightDirectionProperty;
     /** Scene name. */
     name: string;
     /** Physics. */
@@ -42,6 +41,7 @@ export declare class Scene extends EngineObject {
     private _fogDensity;
     private _fogParams;
     private _isActive;
+    private _sun;
     /**
      * Whether the scene is active.
      */
@@ -103,6 +103,12 @@ export declare class Scene extends EngineObject {
      * Root entity collection.
      */
     get rootEntities(): Readonly<Entity[]>;
+    /**
+     * Sun light source.
+     * @remarks If set this to null, scene will use the brightest directional light.
+     */
+    get sun(): DirectLight | null;
+    set sun(light: DirectLight | null);
     /**
      * Create scene.
      * @param engine - Engine
@@ -152,4 +158,5 @@ export declare class Scene extends EngineObject {
     private _addToRootEntityList;
     private _computeLinearFogParams;
     private _computeExponentialFogParams;
+    private _getSunlight;
 }

package/types/SystemInfo.d.ts

@@ -7,6 +7,8 @@ export declare class SystemInfo {
     static platform: Platform;
     /** The operating system is running on. */
     static operatingSystem: string;
+    /** Whether the system support SIMD. */
+    private static _simdSupported;
     /**
      * The pixel ratio of the device.
      */

package/types/Utils.d.ts

@@ -28,4 +28,5 @@ export declare class Utils {
     static resolveAbsoluteUrl(baseUrl: string, relativeUrl: string): string;
     private static _stringToPath;
     private static _formatRelativePath;
+    private static _insertionSort;
 }

package/types/animation/AnimationClip.d.ts

@@ -46,12 +46,40 @@ export declare class AnimationClip extends EngineObject {
     clearEvents(): void;
     /**
      * Add curve binding for the clip.
-     * @param relativePath - Path to the game object this curve applies to. The relativePath is formatted similar to a pathname, e.g. "/root/spine/leftArm"
-     * @param type- The class type of the component that is animated
-     * @param propertyName - The name or path to the property being animated
+     * @param entityPath - Path to the game object this curve applies to. The entityPath is formatted similar to a pathname, e.g. "/root/spine/leftArm"
+     * @param componentType - The class type of the component that is animated
+     * @param propertyPath - The path to the property being animated, support "a.b" and "a.b[x]" description mode
      * @param curve - The animation curve
      */
-    addCurveBinding<T extends Component>(relativePath: string, type: new (entity: Entity) => T, propertyName: string, curve: AnimationCurve<KeyframeValueType>): void;
+    addCurveBinding<T extends Component>(entityPath: string, componentType: new (entity: Entity) => T, propertyPath: string, curve: AnimationCurve<KeyframeValueType>): void;
+    /**
+     * Add curve binding for the clip.
+     * @param entityPath - Path to the game object this curve applies to. The entityPath is formatted similar to a pathname, e.g. "/root/spine/leftArm"
+     * @param componentType - The class type of the component that is animated
+     * @param setPropertyPath - The path to set the property being animated, support "a.b", "a.b[x]" and "a.b('c', 0, $value)" description mode
+     * @param getPropertyPath - The path to get the value when being animated, support "a.b", "a.b[x]" and "a.b('c', 0, $value)" description mode
+     * @param curve - The animation curve
+     */
+    addCurveBinding<T extends Component>(entityPath: string, componentType: new (entity: Entity) => T, setPropertyPath: string, getPropertyPath: string, curve: AnimationCurve<KeyframeValueType>): void;
+    /**
+     * Add curve binding for the clip.
+     * @param entityPath - Path to the game object this curve applies to. The entityPath is formatted similar to a pathname, e.g. "/root/spine/leftArm"
+     * @param componentType - The type index of the component that is animated
+     * @param componentIndex - The class type of the component that is animated
+     * @param propertyPath - The path to the property being animated, support "a.b" and "a.b[x]" description mode
+     * @param curve - The animation curve
+     */
+    addCurveBinding<T extends Component>(entityPath: string, componentType: new (entity: Entity) => T, componentIndex: number, propertyPath: string, curve: AnimationCurve<KeyframeValueType>): void;
+    /**
+     * Add curve binding for the clip.
+     * @param entityPath - Path to the game object this curve applies to. The entityPath is formatted similar to a pathname, e.g. "/root/spine/leftArm"
+     * @param componentType - The class type of the component that is animated
+     * @param componentIndex - The class type of the component that is animated
+     * @param setPropertyPath - The path to set the property being animated, support "a.b", "a.b[x]" and "a.b('c', 0, $value)" description mode
+     * @param getPropertyPath - The path to get the value when being animated, support "a.b", "a.b[x]" and "a.b('c', 0, $value)" description mode
+     * @param curve - The animation curve
+     */
+    addCurveBinding<T extends Component>(entityPath: string, componentType: new (entity: Entity) => T, componentIndex: number, setPropertyPath: string, getPropertyPath: string, curve: AnimationCurve<KeyframeValueType>): void;
     /**
      * Clears all curve bindings from the clip.
      */

package/types/animation/AnimationClipCurveBinding.d.ts

@@ -1,7 +1,7 @@
 import { Component } from "../Component";
 import { Entity } from "../Entity";
-import { AnimationCurve } from "./animationCurve";
 import { KeyframeValueType } from "./Keyframe";
+import { AnimationCurve } from "./animationCurve";
 /**
  * Associate AnimationCurve and the Entity
  */
@@ -13,8 +13,18 @@ export declare class AnimationClipCurveBinding {
     relativePath: string;
     /** The class type of the component that is animated. */
     type: new (entity: Entity) => Component;
-    /** The name or path to the property being animated. */
+    /** The index of the component that is animated. */
+    typeIndex: number;
+    /**
+     * The name or path to the property being animated.
+     * @remarks support property:"a.b", array: "a.b[0]", method: "a.b('c', 0, $value)"
+     */
     property: string;
+    /**
+     * The name or path to get the value when being animated.
+     * @remarks support property:"a.b", array: "a.b[0]", method: "a.b('c', 0)"
+     */
+    getProperty?: string;
     /** The animation curve. */
     curve: AnimationCurve<KeyframeValueType>;
     private _tempCurveOwner;

package/types/animation/AnimatorControllerLayer.d.ts

@@ -1,5 +1,6 @@
 import { AnimatorStateMachine } from "./AnimatorStateMachine";
 import { AnimatorLayerBlendingMode } from "./enums/AnimatorLayerBlendingMode";
+import { AnimatorLayerMask } from "./AnimatorLayerMask";
 /**
  * The Animation Layer contains a state machine that controls animations of a model or part of it.
  */
@@ -11,6 +12,8 @@ export declare class AnimatorControllerLayer {
     blendingMode: AnimatorLayerBlendingMode;
     /** The state machine for the layer. */
     stateMachine: AnimatorStateMachine;
+    /** The AnimatorLayerMask is used to mask out certain entities from being animated by an AnimatorLayer. */
+    mask: AnimatorLayerMask;
     /**
      * @param name - The layer's name
      */

package/types/animation/AnimatorLayerMask.d.ts

@@ -0,0 +1,45 @@
+import { Entity } from "../Entity";
+import { LayerPathMask } from "./LayerPathMask";
+/**
+ * AnimatorLayerMask is used to mask out certain entities from being animated by an AnimatorLayer.
+ */
+export declare class AnimatorLayerMask {
+    /**
+     * Creates an AnimatorLayerMask instance by specifying an entity.
+     * This will automatically add path masks for the entity and all its children.
+     * @param entity - The root entity to create path masks for
+     */
+    static createByEntity(entity: Entity): AnimatorLayerMask;
+    private static _addPathMaskWithChildren;
+    private _pathMasks;
+    private _pathMaskMap;
+    /**
+     * The list of path masks.
+     */
+    get pathMasks(): Readonly<LayerPathMask[]>;
+    /**
+     * Adds a path mask to the AnimatorLayerMask, the root path is "".
+     * @param path - The path to add a mask for
+     * @returns The created or existing LayerPathMask
+     */
+    addPathMask(path: string): LayerPathMask;
+    /**
+     * Removes a path mask from the AnimatorLayerMask.
+     * @param path - The path of the mask to remove
+     */
+    removePathMask(path: any): void;
+    /**
+     * Get a path mask based on the given path.
+     * @param path - The path of the mask to get
+     * @returns The LayerPathMask for the given path
+     */
+    getPathMask(path: string): LayerPathMask;
+    /**
+     * Sets the active state of a path mask.
+     * If recursive is true, it also sets the active state of all child path masks.
+     * @param path - The path of the mask to modify
+     * @param active - The active state to set
+     * @param withChildren - Whether to apply the active state recursively to child paths
+     */
+    setPathMaskActive(path: string, active: boolean, withChildren?: boolean): void;
+}

package/types/animation/Keyframe.d.ts

@@ -17,4 +17,4 @@ export declare class Keyframe<V extends KeyframeValueType, T = V extends number
 /**
  * Type of Keyframe value.
  */
-export type KeyframeValueType = number | Vector2 | Vector3 | Vector4 | number[] | Float32Array | Quaternion | Color | Rect | boolean | ReferResource;
+export type KeyframeValueType = number | Vector2 | Vector3 | Vector4 | number[] | Float32Array | Quaternion | Color | Rect | string | boolean | ReferResource;

package/types/animation/LayerPathMask.d.ts

@@ -0,0 +1,16 @@
+/**
+ * LayerPathMask represents a mask for a specific entity in an animation layer.
+ * It is used to control the animation whether to be applied to the entity or not.
+ */
+export declare class LayerPathMask {
+    /**
+     * It identifies a particular entity in the hierarchy.
+     * Example: "arm/left/hand" could be a path to the left hand of a character.
+     */
+    path: string;
+    /**
+     * The active property is indicating whether the animation at this path is active or not.
+     * When true, the animation for this path is applied; when false, the animation for this path is ignored.
+     */
+    active: boolean;
+}

package/types/animation/animationCurve/AnimationStringCurve.d.ts

@@ -0,0 +1,7 @@
+import { AnimationCurve } from "./AnimationCurve";
+/**
+ * Store a collection of Keyframes that can be evaluated over time.
+ */
+export declare class AnimationStringCurve extends AnimationCurve<string> {
+    constructor();
+}

package/types/animation/animationCurve/index.d.ts

@@ -10,3 +10,4 @@ export { AnimationVector3Curve } from "./AnimationVector3Curve";
 export { AnimationVector4Curve } from "./AnimationVector4Curve";
 export { AnimationRefCurve } from "./AnimationRefCurve";
 export { AnimationRectCurve } from "./AnimationRectCurve";
+export { AnimationStringCurve } from "./AnimationStringCurve";

package/types/animation/index.d.ts

@@ -18,4 +18,5 @@ export { AnimatorCullingMode } from "./enums/AnimatorCullingMode";
 export { InterpolationType } from "./enums/InterpolationType";
 export { WrapMode } from "./enums/WrapMode";
 export * from "./Keyframe";
+export * from "./AnimatorLayerMask";
 export { StateMachineScript } from "./StateMachineScript";

package/types/asset/AssetPromise.d.ts

@@ -13,7 +13,10 @@ export declare class AssetPromise<T> implements PromiseLike<T> {
     get [Symbol.toStringTag](): string;
     private _promise;
     private _state;
-    private _onProgressCallback;
+    private _taskCompleteProgress;
+    private _taskDetailProgress;
+    private _onTaskCompleteCallbacks;
+    private _onTaskDetailCallbacks;
     private _onCancelHandler;
     private _reject;
     /**
@@ -26,10 +29,11 @@ export declare class AssetPromise<T> implements PromiseLike<T> {
     constructor(executor: AssetPromiseExecutor<T>);
     /**
      * Progress callback.
-     * @param callback
+     * @param onTaskComplete - This callback function provides information about the overall progress of the task. For example, in batch processing tasks, you can use the loaded and total parameters to calculate the percentage of task completion or display a progress bar
+     * @param onTaskDetail - This callback function provides detailed progress information about the task. For instance, in file downloading scenarios, you can use the loaded and total parameters to calculate the download progress percentage and utilize the url parameter to provide additional details such as download speed and estimated remaining time
      * @returns AssetPromise
      */
-    onProgress(callback: (progress: number) => void): AssetPromise<T>;
+    onProgress(onTaskComplete: (loaded: number, total: number) => void, onTaskDetail?: (identifier: string, loaded: number, total: number) => void): AssetPromise<T>;
     then<TResult1 = T, TResult2 = never>(onfulfilled?: (value: T) => TResult1 | PromiseLike<TResult1>, onrejected?: (reason: any) => TResult2 | PromiseLike<TResult2>): AssetPromise<TResult1 | TResult2>;
     /**
      * Attaches a callback for only the rejection of the Promise.
@@ -51,6 +55,8 @@ export declare class AssetPromise<T> implements PromiseLike<T> {
     cancel(): AssetPromise<T>;
 }
 interface AssetPromiseExecutor<T> {
-    (resolve: (value?: T | PromiseLike<T>) => void, reject?: (reason?: any) => void, setProgress?: (progress: number) => void, onCancel?: (callback: () => void) => void): void;
+    (resolve: (value?: T | PromiseLike<T>) => void, reject?: (reason?: any) => void, setTaskCompleteProgress?: TaskCompleteCallback, setTaskDetailProgress?: TaskDetailCallback, onCancel?: (callback: () => void) => void): void;
 }
+type TaskCompleteCallback = (loaded: number, total: number) => void;
+type TaskDetailCallback = (url: string, loaded: number, total: number) => void;
 export {};

package/types/asset/ReferResource.d.ts

@@ -8,6 +8,7 @@ export declare abstract class ReferResource extends EngineObject implements IRef
     /** Whether to ignore the garbage collection check, if it is true, it will not be affected by ResourceManager.gc(). */
     isGCIgnored: boolean;
     private _refCount;
+    private _superResources;
     /**
      * Counted by valid references.
      */
@@ -15,8 +16,8 @@ export declare abstract class ReferResource extends EngineObject implements IRef
     protected constructor(engine: Engine);
     /**
      * Destroy self.
-     * @param force - Whether to force the destruction, if it is false, refCount = 0 can be released successfully.
-     * @returns Whether the release was successful.
+     * @param force - Whether to force the destruction, if it is false, refCount = 0 can be released successfully
+     * @returns Whether the release was successful
      */
     destroy(force?: boolean): boolean;
 }

package/types/asset/ResourceManager.d.ts

@@ -104,7 +104,6 @@ export declare class ResourceManager {
     private _gc;
     private _getResolveResource;
     private _parseURL;
-    private _getParameterByName;
     private _parseQueryPath;
 }
 /**

package/types/index.d.ts

@@ -1,7 +1,7 @@
 export { Platform } from "./Platform";
 export { Engine } from "./Engine";
 export { SystemInfo } from "./SystemInfo";
-export type { Canvas } from "./Canvas";
+export { Canvas } from "./Canvas";
 export { Scene } from "./Scene";
 export { SceneManager } from "./SceneManager";
 export { Entity } from "./Entity";
@@ -29,8 +29,10 @@ export { BackgroundMode } from "./enums/BackgroundMode";
 export { DepthTextureMode } from "./enums/DepthTextureMode";
 export { FogMode } from "./enums/FogMode";
 export { CameraClearFlags } from "./enums/CameraClearFlags";
+export { CameraType } from "./enums/CameraType";
 export { ColorSpace } from "./enums/ColorSpace";
 export { BackgroundTextureFillMode } from "./enums/BackgroundTextureFillMode";
+export { XRManager } from "./xr/XRManager";
 export * from "./input/index";
 export * from "./lighting/index";
 export * from "./shadow/index";

package/types/lighting/Light.d.ts

@@ -26,7 +26,6 @@ export declare abstract class Light extends Component {
     private _color;
     private _viewMat;
     private _inverseViewMat;
-    private _lightColor;
     /**
      * Light Color.
      */

package/types/lighting/LightManager.d.ts

@@ -9,5 +9,4 @@ export declare class LightManager {
     private _directData;
     private _pointData;
     private _spotData;
-    private _getSunLightIndex;
 }

package/types/material/PBRMaterial.d.ts

@@ -9,6 +9,9 @@ export declare class PBRMaterial extends PBRBaseMaterial {
     private static _roughnessProp;
     private static _roughnessMetallicTextureProp;
     private static _iorProp;
+    private static _anisotropyInfoProp;
+    private static _anisotropyTextureProp;
+    private _anisotropyRotation;
     /**
      * Index Of Refraction.
      * @defaultValue `1.5`
@@ -33,6 +36,26 @@ export declare class PBRMaterial extends PBRBaseMaterial {
      */
     get roughnessMetallicTexture(): Texture2D;
     set roughnessMetallicTexture(value: Texture2D);
+    /**
+     * The strength of anisotropy, when anisotropyTexture is present, this value is multiplied by the blue channel.
+     * @defaultValue `0`
+     */
+    get anisotropy(): number;
+    set anisotropy(value: number);
+    /**
+     * The rotation of the anisotropy in tangent, bitangent space, value in degrees.
+     * @defaultValue `0`
+     */
+    get anisotropyRotation(): number;
+    set anisotropyRotation(value: number);
+    /**
+     * The anisotropy texture.
+     * @remarks
+     * Red and green channels represent the anisotropy direction in [-1, 1] tangent, bitangent space, to be rotated by anisotropyRotation.
+     * The blue channel contains strength as [0, 1] to be multiplied by anisotropy.
+     */
+    get anisotropyTexture(): Texture2D;
+    set anisotropyTexture(value: Texture2D);
     /**
      * Create a pbr metallic-roughness workflow material instance.
      * @param engine - Engine to which the material belongs

package/types/mesh/PrimitiveMesh.d.ts

@@ -6,6 +6,10 @@ import { ModelMesh } from "./ModelMesh";
  */
 export declare class PrimitiveMesh {
     private static _tempVec30;
+    private static readonly _sphereSeedPositions;
+    private static readonly _sphereSeedCells;
+    private static _sphereEdgeIdx;
+    private static _spherePoleIdx;
     /**
      * Create a sphere mesh.
      * @param engine - Engine
@@ -15,6 +19,16 @@ export declare class PrimitiveMesh {
      * @returns Sphere model mesh
      */
     static createSphere(engine: Engine, radius?: number, segments?: number, noLongerAccessible?: boolean): ModelMesh;
+    /**
+     * Create a sphere mesh by implementing Catmull-Clark Surface Subdivision Algorithm.
+     * Max step is limited to 6.
+     * @param engine - Engine
+     * @param radius - Sphere radius
+     * @param step - Number of subdiv steps
+     * @param noLongerAccessible - No longer access the vertices of the mesh after creation
+     * @returns Sphere model mesh
+     */
+    static createSubdivisionSurfaceSphere(engine: Engine, radius?: number, step?: number, noLongerAccessible?: boolean): ModelMesh;
     /**
      * Create a cuboid mesh.
      * @param engine - Engine
@@ -82,6 +96,14 @@ export declare class PrimitiveMesh {
      * @returns Capsule model mesh
      */
     static createCapsule(engine: Engine, radius?: number, height?: number, radialSegments?: number, heightSegments?: number, noLongerAccessible?: boolean): ModelMesh;
+    /**
+     * Duplicate vertices at the poles and adjust their UV coordinates.
+     */
+    private static _generateAndReplacePoleUV;
+    /**
+     * Get edge point index for subdivision surface sphere.
+     */
+    private static _calculateEdgeIndex;
     static _setCylinderData(cylinderMesh: ModelMesh, radiusTop: number, radiusBottom: number, height: number, radialSegments: number, heightSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean, restoreVertexBuffer?: Buffer): void;
     static _setCapsuleData(capsuleMesh: ModelMesh, radius: number, height: number, radialSegments: number, heightSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean, restoreVertexBuffer?: Buffer): void;
     private static _initialize;

package/types/mesh/SkinnedMeshRenderer.d.ts

@@ -9,11 +9,11 @@ export declare class SkinnedMeshRenderer extends MeshRenderer {
     private static _jointCountProperty;
     private static _jointSamplerProperty;
     private static _jointMatrixProperty;
+    private _localBounds;
     private _jointDataCreateCache;
     private _blendShapeWeights;
     private _maxVertexUniformVectors;
     private _rootBone;
-    private _localBounds;
     private _jointMatrices;
     private _jointTexture;
     private _bones;