@galacean/engine-core 1.0.0 → 1.1.0-alpha.0

package/types/mesh/ModelMesh.d.ts

@@ -15,7 +15,7 @@ export declare class ModelMesh extends Mesh {
     private static _tempVec3;
     private static _tempVec4;
     private _vertexCount;
-    private _accessible;
+    private _readable;
     private _verticesFloat32;
     private _verticesUint8;
     private _indices;
@@ -42,9 +42,9 @@ export declare class ModelMesh extends Mesh {
     private _customVertexElements;
     private _vertexCountChanged;
     /**
-     * Whether to access data of the mesh.
+     * Whether to read data of the mesh.
      */
-    get accessible(): boolean;
+    get readable(): boolean;
     /**
      * Vertex count of current mesh.
      */
@@ -207,9 +207,9 @@ export declare class ModelMesh extends Mesh {
     getBlendShapeName(index: number): string;
     /**
      * Upload Mesh Data to GPU.
-     * @param noLongerAccessible - Whether to access data later. If true, you'll never access data anymore (free memory cache)
+     * @param noLongerReadable - Whether to read data later. If true, you'll never read data anymore (free memory cache)
      */
-    uploadData(noLongerAccessible: boolean): void;
+    uploadData(noLongerReadable: boolean): void;
     /**
      * Calculate mesh tangent.
      * @remark need to set positions(with or not with indices), normals, uv before calculation.

package/types/mesh/PrimitiveMesh.d.ts

@@ -63,8 +63,8 @@ export declare class PrimitiveMesh {
      * @param engine - Engine
      * @param radius - The radius of cap
      * @param height - The height of torso
-     * @param radialSegments - Cylinder radial segments
-     * @param heightSegments - Cylinder height segments
+     * @param radialSegments - Cone radial segments
+     * @param heightSegments - Cone height segments
      * @param noLongerAccessible - No longer access the vertices of the mesh after creation
      * @returns Cone model mesh
      */
@@ -80,6 +80,8 @@ export declare class PrimitiveMesh {
      * @returns Capsule model mesh
      */
     static createCapsule(engine: Engine, radius?: number, height?: number, radialSegments?: number, heightSegments?: number, noLongerAccessible?: boolean): ModelMesh;
+    static _setCylinderData(cylinderMesh: ModelMesh, radiusTop: number, radiusBottom: number, height: number, radialSegments: number, heightSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean): void;
+    static _setCapsuleData(capsuleMesh: ModelMesh, radius: number, height: number, radialSegments: number, heightSegments: number, noLongerAccessible: boolean, isRestoreMode: boolean): void;
     private static _initialize;
     private static _generateIndices;
     private static _createCapsuleCap;

package/types/mesh/PrimitiveMeshRestorer.d.ts

@@ -0,0 +1 @@
+export {};

package/types/mesh/SkinnedMeshRenderer.d.ts

@@ -1,13 +1,11 @@
 import { BoundingBox } from "@galacean/engine-math";
 import { Entity } from "../Entity";
-import { RenderContext } from "../RenderPipeline/RenderContext";
 import { MeshRenderer } from "./MeshRenderer";
 import { Skin } from "./Skin";
 /**
  * SkinnedMeshRenderer.
  */
 export declare class SkinnedMeshRenderer extends MeshRenderer {
-    private static _tempMatrix;
     private static _jointCountProperty;
     private static _jointSamplerProperty;
     private static _jointMatrixProperty;
@@ -42,18 +40,6 @@ export declare class SkinnedMeshRenderer extends MeshRenderer {
      */
     get rootBone(): Entity;
     set rootBone(value: Entity);
-    /**
-     * @override
-     */
-    protected _updateShaderData(context: RenderContext): void;
-    /**
-     * @override
-     */
-    protected _registerEntityTransformListener(): void;
-    /**
-     * @override
-     */
-    protected _updateBounds(worldBounds: BoundingBox): void;
     private _initSkin;
     private _computeApproximateBindMatrix;
     private _findByEntityName;

package/types/particle/ParticleRenderer.d.ts

@@ -1,6 +1,6 @@
-import { Vector3, Color } from "@galacean/engine-math";
-import { Texture } from "../texture";
+import { Color, Vector3 } from "@galacean/engine-math";
 import { MeshRenderer } from "../mesh/MeshRenderer";
+import { Texture } from "../texture";
 /**
  * Blend mode enums of the particle renderer's material.
  */

package/types/physics/CharacterController.d.ts

@@ -41,12 +41,10 @@ export declare class CharacterController extends Collider {
     /**
      * Add collider shape on this controller.
      * @param shape - Collider shape
-     * @override
      */
     addShape(shape: ColliderShape): void;
     /**
      * Remove all shape attached.
-     * @override
      */
     clearShapes(): void;
     private _setUpDirection;

package/types/physics/Collider.d.ts

@@ -3,7 +3,7 @@ import { Component } from "../Component";
 import { ColliderShape } from "./shape/ColliderShape";
 /**
  * Base class for all colliders.
- * @decorator `@dependentComponents(Transform)`
+ * @decorator `@dependentComponents(Transform, DependentMode.CheckOnly)`
  */
 export declare class Collider extends Component {
     protected _updateFlag: BoolUpdateFlag;

package/types/physics/Collision.d.ts

@@ -0,0 +1,4 @@
+import { ColliderShape } from "./shape";
+export declare class Collision {
+    shape: ColliderShape;
+}

package/types/physics/PhysicsManager.d.ts

@@ -1,4 +1,3 @@
-import { IPhysics } from "@galacean/engine-design";
 import { Ray, Vector3 } from "@galacean/engine-math";
 import { Engine } from "../Engine";
 import { Layer } from "../Layer";
@@ -7,6 +6,7 @@ import { HitResult } from "./HitResult";
  * A physics manager is a collection of colliders and constraints which can interact.
  */
 export declare class PhysicsManager {
+    private static _collision;
     private _engine;
     private _restTime;
     private _colliders;
@@ -21,31 +21,12 @@ export declare class PhysicsManager {
     private _onTriggerStay;
     /** The fixed time step in seconds at which physics are performed. */
     fixedTimeStep: number;
-    /**
-     * The max allowed time step in seconds one frame.
-     *
-     * @remarks
-     * When the frame rate is low or stutter occurs, the maximum execution time of physics will not exceed this value.
-     * So physics will slow down a bit when performance hitch occurs.
-     */
-    maxAllowedTimeStep: number;
     /**
      * The gravity of physics scene.
      */
     get gravity(): Vector3;
     set gravity(value: Vector3);
-    /**
-     * @deprecated
-     * Please use `maxAllowedTimeStep` instead.
-     */
-    get maxSumTimeStep(): number;
-    set maxSumTimeStep(value: number);
     constructor(engine: Engine);
-    /**
-     * initialize PhysicsManager.
-     * @param physics - Physics Engine
-     */
-    initialize(physics: IPhysics): void;
     /**
      * Casts a ray through the Scene and returns the first hit.
      * @param ray - The ray

package/types/physics/PhysicsScene.d.ts

@@ -0,0 +1,75 @@
+import { Ray, Vector3 } from "@galacean/engine-math";
+import { Layer } from "../Layer";
+import { Scene } from "../Scene";
+import { HitResult } from "./HitResult";
+/**
+ * A physics scene is a collection of colliders and constraints which can interact.
+ */
+export declare class PhysicsScene {
+    private static _collision;
+    private _scene;
+    private _restTime;
+    private _colliders;
+    private _gravity;
+    private _nativePhysicsScene;
+    private _onContactEnter;
+    private _onContactExit;
+    private _onContactStay;
+    private _onTriggerEnter;
+    private _onTriggerExit;
+    private _onTriggerStay;
+    /** The fixed time step in seconds at which physics are performed. */
+    fixedTimeStep: number;
+    /**
+     * The gravity of physics scene.
+     */
+    get gravity(): Vector3;
+    set gravity(value: Vector3);
+    constructor(scene: Scene);
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @returns Returns True if the ray intersects with a collider, otherwise false
+     */
+    raycast(ray: Ray): boolean;
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
+     * @returns Returns True if the ray intersects with a collider, otherwise false
+     */
+    raycast(ray: Ray, outHitResult: HitResult): boolean;
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @param distance - The max distance the ray should check
+     * @returns Returns True if the ray intersects with a collider, otherwise false
+     */
+    raycast(ray: Ray, distance: number): boolean;
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @param distance - The max distance the ray should check
+     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
+     * @returns Returns True if the ray intersects with a collider, otherwise false
+     */
+    raycast(ray: Ray, distance: number, outHitResult: HitResult): boolean;
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @param distance - The max distance the ray should check
+     * @param layerMask - Layer mask that is used to selectively ignore Colliders when casting
+     * @returns Returns True if the ray intersects with a collider, otherwise false
+     */
+    raycast(ray: Ray, distance: number, layerMask: Layer): boolean;
+    /**
+     * Casts a ray through the Scene and returns the first hit.
+     * @param ray - The ray
+     * @param distance - The max distance the ray should check
+     * @param layerMask - Layer mask that is used to selectively ignore Colliders when casting
+     * @param outHitResult - If true is returned, outHitResult will contain more detailed collision information
+     * @returns Returns True if the ray intersects with a collider, otherwise false.
+     */
+    raycast(ray: Ray, distance: number, layerMask: Layer, outHitResult: HitResult): boolean;
+    private _setGravity;
+}

package/types/physics/index.d.ts

@@ -1,10 +1,10 @@
-export { HitResult } from "./HitResult";
-export { PhysicsManager } from "./PhysicsManager";
-export { PhysicsMaterial } from "./PhysicsMaterial";
 export { CharacterController } from "./CharacterController";
-export * from "./shape";
-export * from "./joint";
-export * from "./enums";
 export { Collider } from "./Collider";
+export { CollisionDetectionMode, DynamicCollider, DynamicColliderConstraints } from "./DynamicCollider";
+export { HitResult } from "./HitResult";
+export { PhysicsMaterial } from "./PhysicsMaterial";
+export { PhysicsScene } from "./PhysicsScene";
 export { StaticCollider } from "./StaticCollider";
-export { DynamicCollider, CollisionDetectionMode, DynamicColliderConstraints } from "./DynamicCollider";
+export * from "./enums";
+export * from "./joint";
+export * from "./shape";

package/types/physics/joint/HingeJoint.d.ts

@@ -1,7 +1,7 @@
-import { Joint } from "./Joint";
 import { Vector3 } from "@galacean/engine-math";
-import { JointMotor } from "./JointMotor";
+import { Joint } from "./Joint";
 import { JointLimits } from "./JointLimits";
+import { JointMotor } from "./JointMotor";
 /**
  * A joint which behaves in a similar way to a hinge or axle.
  */

package/types/physics/joint/Joint.d.ts

@@ -1,11 +1,11 @@
 import { IJoint } from "@galacean/engine-design";
 import { Vector3 } from "@galacean/engine-math";
 import { Component } from "../../Component";
-import { Collider } from "../Collider";
 import { Entity } from "../../Entity";
+import { Collider } from "../Collider";
 /**
  * A base class providing common functionality for joints.
- * @decorator `@dependentComponents(Collider)`
+ * @decorator `@dependentComponents(Collider, DependentMode.CheckOnly)`
  */
 export declare class Joint extends Component {
     protected _connectedCollider: JointCollider;

package/types/physics/joint/SpringJoint.d.ts

@@ -1,5 +1,5 @@
-import { Joint } from "./Joint";
 import { Vector3 } from "@galacean/engine-math";
+import { Joint } from "./Joint";
 /**
  * A joint that maintains an upper or lower bound (or both) on the distance between two points on different objects.
  */

package/types/renderingHardwareInterface/IPlatformBuffer.d.ts

@@ -0,0 +1,8 @@
+import { SetDataOptions } from "../graphic";
+export interface IPlatformBuffer {
+    bind(): void;
+    setData(byteLength: number, data: ArrayBuffer | ArrayBufferView, bufferByteOffset?: number, dataOffset?: number, dataLength?: number, options?: SetDataOptions): void;
+    getData(data: ArrayBufferView, bufferByteOffset?: number, dataOffset?: number, dataLength?: number): void;
+    resize(byteLength: number): void;
+    destroy(): void;
+}

package/types/renderingHardwareInterface/index.d.ts

@@ -1,4 +1,5 @@
 export type { IHardwareRenderer } from "./IHardwareRenderer";
+export type { IPlatformBuffer } from "./IPlatformBuffer";
 export type { IPlatformRenderTarget } from "./IPlatformRenderTarget";
 export type { IPlatformTexture } from "./IPlatformTexture";
 export type { IPlatformTexture2D } from "./IPlatformTexture2D";

package/types/shader/Shader.d.ts

@@ -2,15 +2,13 @@ import { Engine } from "../Engine";
 import { ShaderMacro } from "./ShaderMacro";
 import { ShaderPass } from "./ShaderPass";
 import { ShaderProperty } from "./ShaderProperty";
+import { SubShader } from "./SubShader";
 /**
  * Shader for rendering.
  */
 export declare class Shader {
+    readonly name: string;
     private static _shaderMap;
-    private static _propertyNameMap;
-    private static _macroMaskMap;
-    private static _macroCounter;
-    private static _macroMap;
     /**
      * Create a shader.
      * @param name - Name of the shader
@@ -26,18 +24,46 @@ export declare class Shader {
      * @returns Shader
      */
     static create(name: string, shaderPasses: ShaderPass[]): Shader;
+    /**
+     * Create a shader.
+     * @param name - Name of the shader
+     * @param subShaders - Sub shaders
+     * @returns Shader
+     */
+    static create(name: string, subShaders: SubShader[]): Shader;
     /**
      * Find a shader by name.
      * @param name - Name of the shader
      */
     static find(name: string): Shader;
+    private _subShaders;
+    /**
+     * Sub shaders of the shader.
+     */
+    get subShaders(): ReadonlyArray<SubShader>;
+    private constructor();
+    /**
+     * Compile shader variant by macro name list.
+     *
+     * @remarks
+     * Usually a shader contains some macros,any combination of macros is called shader variant.
+     *
+     * @param engine - Engine to which the shader variant belongs
+     * @param macros - Macro name list
+     * @returns Is the compiled shader variant valid
+     */
+    compileVariant(engine: Engine, macros: string[]): boolean;
     /**
+     * @deprecated Please use `ShaderMacro.getByName` instead
+     *
      * Get shader macro by name.
      * @param name - Name of the shader macro
      * @returns Shader macro
      */
     static getMacroByName(name: string): ShaderMacro;
     /**
+     * @deprecated Please use `ShaderMacro.getByName` instead
+     *
      * Get shader macro by name.
      * @param name - Name of the shader macro
      * @param value - Value of the shader macro
@@ -45,28 +71,11 @@ export declare class Shader {
      */
     static getMacroByName(name: string, value: string): ShaderMacro;
     /**
+     * @deprecated Please use `ShaderProperty.getByName` instead
+     *
      * Get shader property by name.
      * @param name - Name of the shader property
      * @returns Shader property
      */
     static getPropertyByName(name: string): ShaderProperty;
-    /** The name of shader. */
-    readonly name: string;
-    /**
-     *  Shader passes.
-     */
-    get passes(): ReadonlyArray<ShaderPass>;
-    private _passes;
-    private constructor();
-    /**
-     * Compile shader variant by macro name list.
-     *
-     * @remarks
-     * Usually a shader contains some macros,any combination of macros is called shader variant.
-     *
-     * @param engine - Engine to which the shader variant belongs
-     * @param macros - Macro name list
-     * @returns Is the compiled shader variant valid
-     */
-    compileVariant(engine: Engine, macros: string[]): boolean;
 }

package/types/shader/ShaderData.d.ts

@@ -1,13 +1,13 @@
 import { IClone } from "@galacean/engine-design";
 import { Color, Matrix, Vector2, Vector3, Vector4 } from "@galacean/engine-math";
-import { IRefObject } from "../asset/IRefObject";
+import { IReferable } from "../asset/IReferable";
 import { Texture } from "../texture/Texture";
 import { ShaderMacro } from "./ShaderMacro";
 import { ShaderProperty } from "./ShaderProperty";
 /**
  * Shader data collection,Correspondence includes shader properties data and macros data.
  */
-export declare class ShaderData implements IRefObject, IClone {
+export declare class ShaderData implements IReferable, IClone {
     private _macroMap;
     private _refCount;
     /**
@@ -18,7 +18,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getFloat(propertyName: string): number;
     /**
      * Get float by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Float
      */
     getFloat(property: ShaderProperty): number;
@@ -32,7 +32,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set float by shader property.
      * @remarks Corresponding float shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Float
      */
     setFloat(property: ShaderProperty, value: number): void;
@@ -44,7 +44,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getInt(propertyName: string): number;
     /**
      * Get int by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Int
      */
     getInt(property: ShaderProperty): number;
@@ -58,7 +58,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set int by shader property.
      * @remarks Correspondence includes int and bool shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Int
      */
     setInt(property: ShaderProperty, value: number): void;
@@ -70,7 +70,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getFloatArray(propertyName: string): Float32Array;
     /**
      * Get float array by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Float array
      */
     getFloatArray(property: ShaderProperty): Float32Array;
@@ -84,7 +84,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set float array by shader property.
      * @remarks Correspondence includes float array、vec2 array、vec3 array、vec4 array and matrix array shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Float array
      */
     setFloatArray(property: ShaderProperty, value: Float32Array): void;
@@ -96,7 +96,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getIntArray(propertyName: string): Int32Array;
     /**
      * Get int array by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Int Array
      */
     getIntArray(property: ShaderProperty): Int32Array;
@@ -110,7 +110,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set int array by shader property.
      * @remarks Correspondence includes bool array、int array、bvec2 array、bvec3 array、bvec4 array、ivec2 array、ivec3 array and ivec4 array shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Int Array
      */
     setIntArray(property: ShaderProperty, value: Int32Array): void;
@@ -122,7 +122,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getVector2(propertyName: string): Vector2;
     /**
      * Get two-dimensional from shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Two-dimensional vector
      */
     getVector2(property: ShaderProperty): Vector2;
@@ -136,7 +136,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set two-dimensional vector from shader property.
      * @remarks Correspondence includes vec2、ivec2 and bvec2 shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Two-dimensional vector
      */
     setVector2(property: ShaderProperty, value: Vector2): void;
@@ -148,7 +148,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getVector3(propertyName: string): Vector3;
     /**
      * Get vector3 by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Three-dimensional vector
      */
     getVector3(property: ShaderProperty): Vector3;
@@ -162,7 +162,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set three dimensional vector by shader property.
      * @remarks Correspondence includes vec3、ivec3 and bvec3 shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Three-dimensional vector
      */
     setVector3(property: ShaderProperty, value: Vector3): void;
@@ -174,7 +174,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getVector4(propertyName: string): Vector4;
     /**
      * Get vector4 by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Four-dimensional vector
      */
     getVector4(property: ShaderProperty): Vector4;
@@ -188,7 +188,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set four-dimensional vector by shader property.
      * @remarks Correspondence includes vec4、ivec4 and bvec4 shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Four-dimensional vector
      */
     setVector4(property: ShaderProperty, value: Vector4): void;
@@ -200,7 +200,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getMatrix(propertyName: string): Matrix;
     /**
      * Get matrix by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Matrix
      */
     getMatrix(property: ShaderProperty): Matrix;
@@ -214,7 +214,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set matrix by shader property.
      * @remarks Correspondence includes matrix shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Matrix
      */
     setMatrix(property: ShaderProperty, value: Matrix): any;
@@ -226,7 +226,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getColor(propertyName: string): Color;
     /**
      * Get color by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Color
      */
     getColor(property: ShaderProperty): Color;
@@ -240,7 +240,7 @@ export declare class ShaderData implements IRefObject, IClone {
     /**
      * Set color by shader property.
      * @remarks Correspondence includes vec4 shader property type.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Color
      */
     setColor(property: ShaderProperty, value: Color): void;
@@ -252,7 +252,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getTexture(propertyName: string): Texture;
     /**
      * Get texture by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Texture
      */
     getTexture(property: ShaderProperty): Texture;
@@ -264,7 +264,7 @@ export declare class ShaderData implements IRefObject, IClone {
     setTexture(propertyName: string, value: Texture): void;
     /**
      * Set texture by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Texture
      */
     setTexture(property: ShaderProperty, value: Texture): void;
@@ -276,7 +276,7 @@ export declare class ShaderData implements IRefObject, IClone {
     getTextureArray(propertyName: string): Texture[];
     /**
      * Get texture array by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @returns Texture array
      */
     getTextureArray(property: ShaderProperty): Texture[];
@@ -288,7 +288,7 @@ export declare class ShaderData implements IRefObject, IClone {
     setTextureArray(propertyName: string, value: Texture[]): void;
     /**
      * Set texture array by shader property.
-     * @param property - Shader property, use `Shader.getPropertyByName` to get
+     * @param property - Shader property, use `ShaderProperty.getByName` to get
      * @param value - Texture array
      */
     setTextureArray(property: ShaderProperty, value: Texture[]): void;

package/types/shader/ShaderMacro.d.ts

@@ -3,8 +3,24 @@
  */
 export declare class ShaderMacro {
     private static _macroNameCounter;
+    private static _macroCounter;
+    private static _macroMap;
+    /**
+     * Get shader macro by name.
+     * @param name - Name of the shader macro
+     * @returns Shader macro
+     */
+    static getByName(name: string): ShaderMacro;
+    /**
+     * Get shader macro by name.
+     * @param name - Name of the shader macro
+     * @param value - Value of the shader macro
+     * @returns Shader macro
+     */
+    static getByName(name: string, value: string): ShaderMacro;
     /** Name. */
     readonly name: string;
     /** Value. */
     readonly value: string;
+    private constructor();
 }