@galacean/engine-loader 2.0.0-alpha.24 → 2.0.0-alpha.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-loader",
-  "version": "2.0.0-alpha.24",
+  "version": "2.0.0-alpha.25",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -19,9 +19,9 @@
     "libs/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-core": "2.0.0-alpha.24",
-    "@galacean/engine-math": "2.0.0-alpha.24",
-    "@galacean/engine-rhi-webgl": "2.0.0-alpha.24"
+    "@galacean/engine-core": "2.0.0-alpha.25",
+    "@galacean/engine-math": "2.0.0-alpha.25",
+    "@galacean/engine-rhi-webgl": "2.0.0-alpha.25"
   },
   "scripts": {
     "b:types": "tsc"

package/types/HDRDecoder.d.ts

@@ -1,22 +1,41 @@
 /**
- * HDR panorama to cubemap decoder.
+ * HDR (Radiance RGBE) image decoder.
+ *
+ * Decodes .hdr files into pixel data. Supports parsing the header
+ * and decoding RLE-compressed RGBE scanlines into R16G16B16A16 half-float pixels.
  */
 export declare class HDRDecoder {
     private static _float2HalfTables;
     private static _floatView;
     private static _uint32View;
-    private static _one;
-    private static _faces;
+    /**
+     * Parse the header of an HDR file.
+     * @returns Header info including width, height, and data start position.
+     */
     static parseHeader(uint8array: Uint8Array): IHDRHeader;
-    static decodeFaces(bufferArray: Uint8Array, header: IHDRHeader, onFace: (faceIndex: number, data: Uint16Array) => void): void;
+    /**
+     * Decode an HDR file buffer into R16G16B16A16 half-float pixel data.
+     * @param buffer - The full HDR file as Uint8Array.
+     * @returns Object with width, height, and half-float pixel data.
+     */
+    static decode(buffer: Uint8Array): {
+        width: number;
+        height: number;
+        pixels: Uint16Array;
+    };
+    /**
+     * Convert RGBE pixel data to R16G16B16A16 half-float.
+     */
+    static _rgbeToHalfFloat(rgbe: Uint8Array, width: number, height: number): Uint16Array;
+    /**
+     * Decode RLE-compressed RGBE scanlines into raw RGBE pixel data.
+     */
+    static _readPixels(buffer: Uint8Array, width: number, height: number): Uint8Array;
     private static _generateFloat2HalfTables;
-    private static _createCubemapData;
     private static _readStringLine;
-    private static _readPixels;
 }
-interface IHDRHeader {
+export interface IHDRHeader {
     width: number;
     height: number;
     dataPosition: number;
 }
-export {};

package/types/{Texture2DLoader.d.ts → TextureLoader.d.ts}

@@ -1,9 +1,9 @@
 import { TextureFilterMode, TextureFormat, TextureWrapMode } from "@galacean/engine-core";
 /**
- * Texture2D loader params interface.
+ * Texture loader params interface.
  */
-export interface Texture2DParams {
-    /** Texture format. default  `TextureFormat.R8G8B8A8` */
+export interface TextureParams {
+    /** Texture format. default `TextureFormat.R8G8B8A8` */
     format: TextureFormat;
     /** Whether to use multi-level texture, default is true. */
     mipmap: boolean;
@@ -15,6 +15,6 @@ export interface Texture2DParams {
     filterMode: TextureFilterMode;
     /** Anisotropic level for texture. */
     anisoLevel: number;
-    /** Whether the texture data is in sRGB color space, otherwise is linear color space. @defaultValue `true` */
+    /** Whether the texture data is in sRGB color space. @defaultValue `true` */
     isSRGBColorSpace: boolean;
 }

package/types/index.d.ts

@@ -16,8 +16,7 @@ import "./SourceFontLoader";
 import "./SpriteAtlasLoader";
 import "./SpriteLoader";
 import "./TextLoader";
-import "./Texture2DLoader";
-import "./TextureCubeLoader";
+import "./TextureLoader";
 import "./AudioLoader";
 import "./ktx2/KTX2Loader";
 import "./ShaderLoader";
@@ -27,7 +26,7 @@ import "./RenderTargetLoader";
 export { GLTFLoader } from "./GLTFLoader";
 export type { GLTFParams } from "./GLTFLoader";
 export * from "./SceneLoader";
-export type { Texture2DParams } from "./Texture2DLoader";
+export type { TextureParams } from "./TextureLoader";
 export { parseSingleKTX } from "./compressed-texture";
 export * from "./gltf";
 export { KTX2Loader } from "./ktx2/KTX2Loader";

package/types/resource-deserialize/index.d.ts

@@ -3,7 +3,8 @@ export * from "./resources/animationClip/AnimationClipDecoder";
 export type { IModelMesh } from "./resources/mesh/IModelMesh";
 export { MeshDecoder } from "./resources/mesh/MeshDecoder";
 export { ReflectionParser } from "./resources/parser/ReflectionParser";
-export { Texture2DDecoder } from "./resources/texture2D/TextureDecoder";
+import "./resources/texture2D/Texture2DDecoder";
+import "./resources/textureCube/TextureCubeDecoder";
 /**
  * Decode engine binary resource.
  * @param arrayBuffer - array buffer of decode binary file

package/types/resource-deserialize/resources/textureCube/TextureCubeDecoder.d.ts

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

package/types/resource-deserialize/resources/texture2D/TextureDecoder.d.ts

@@ -1,9 +0,0 @@
-import { AssetPromise, Engine, Texture2D } from "@galacean/engine-core";
-import { BufferReader } from "../../utils/BufferReader";
-/**
- * Data format: [url] [mipmap(1B)] [filterMode(1B)] [anisoLevel(1B)] [wrapModeU(1B)] [wrapModeV(1B)]
- * [format(1B)] [width(2B)] [height(2B)] [isPixelBuffer(1B)] [isSRGBColorSpace(1B)] [mipCount(1B)] [imageData...]
- */
-export declare class Texture2DDecoder {
-    static decode(engine: Engine, bufferReader: BufferReader, restoredTexture?: Texture2D): AssetPromise<Texture2D>;
-}