s3m-three 0.4.21 → 0.4.23

package/src/tileset/S3MTileset.ts

@@ -32,6 +32,7 @@ import type {
 } from '../core/S3MBlockParser.js';
 import type { Anchor, ParsedTile, Stats, StyleUniforms } from '../core/types.js';
 import type { TileGeometryData } from '../core/TileGeometry.js';
+import type { TextureCreateOptions } from '../render/TextureFactory.js';
 import type { Group, Texture } from 'three';
 
 function dirOf(url: string): string {
@@ -246,6 +247,12 @@ export type BuildTileFn = (
     assembled?: TileGeometryData;
     /** 深度偏移配置（透传给 buildTileObjects），见 BuildTileOptions.polygonOffset */
     polygonOffset?: { factor: number; units: number };
+    /** 光照模型档位（透传给 buildTileObjects），见 BuildTileOptions.materialQuality */
+    materialQuality?: 'pbr' | 'lambert';
+    /** 颜色管线（透传给 buildTileObjects），见 BuildTileOptions.colorPipeline */
+    colorPipeline?: 'linear' | 'direct';
+    /** 纹理创建参数（透传给 buildTileObjects → createTexture） */
+    textureOptions?: TextureCreateOptions;
   }
 ) => Promise<{ group: Group; stats: Partial<Stats> }>;
 
@@ -258,6 +265,15 @@ export interface S3MTilesetOptions {
   buildTile?: BuildTileFn | null;
   /** 三角面材质深度偏移（共面摩尔纹 / 重合面归属），透传给 buildTileObjects */
   polygonOffset?: { factor: number; units: number };
+  /**
+   * 光照模型档位，透传给 buildTileObjects。不传 = 读模块级默认。
+   * 由 DatasetManager 从图层 / 数据集设置带下来。
+   */
+  materialQuality?: 'pbr' | 'lambert';
+  /** 颜色管线，透传给 buildTileObjects。不传 = 读模块级默认。由图层的渲染 profile 带下来 */
+  colorPipeline?: 'linear' | 'direct';
+  /** 纹理创建参数（sRGB 解码 / 尺寸上限 / 各向异性上限），透传给 createTexture */
+  textureOptions?: TextureCreateOptions;
   /**
    * 是否用 Web Worker 解析经典 `.s3mb` 瓦片（默认开）。
    *
@@ -471,6 +487,9 @@ export class S3MTileset {
   private isS3MV1 = false;
   private _buildTile: BuildTileFn | null;
   private readonly _polygonOffset: { factor: number; units: number } | undefined;
+  private _materialQuality: 'pbr' | 'lambert' | undefined;
+  private _colorPipeline: 'linear' | 'direct' | undefined;
+  private _textureOptions: TextureCreateOptions | undefined;
   private readonly _uniforms: StyleUniforms | null;
   /** 经典 .s3mb 的 Worker 解析客户端；undefined = 尚未尝试创建，null = 不可用/已降级 */
   private _workerClient: S3MWorkerClient | null | undefined;  private readonly _useWorker: boolean;
@@ -491,6 +510,9 @@ export class S3MTileset {
     // 渲染层可注入：Node 环境下不需要 three，也能跑 URL / 解析链路
     this._buildTile = options.buildTile ?? null;
     this._polygonOffset = options.polygonOffset;
+    this._materialQuality = options.materialQuality;
+    this._colorPipeline = options.colorPipeline;
+    this._textureOptions = options.textureOptions;
     // 着色器共享 uniform，由 S3MLayer 持有并传进来
     this._uniforms = options.uniforms ?? null;
     this._useWorker = options.useWorker !== false;
@@ -722,6 +744,24 @@ export class S3MTileset {
     this.maxMemory = Number.isFinite(bytes) && bytes > 0 ? bytes : Infinity;
   }
 
+  /**
+   * 运行时改本数据集的光照模型档位。只影响**之后**构建的瓦片材质；
+   * 场上已有材质由 `S3MViewer.setMaterialQuality` 原位重建。
+   * `undefined` = 跟随模块级默认。
+   */
+  setMaterialQuality(q: 'pbr' | 'lambert' | undefined): void {
+    this._materialQuality = q;
+  }
+
+  /**
+   * 运行时改本数据集的渲染 profile（颜色管线 / 纹理参数）。
+   * 只影响**之后**构建的瓦片材质与纹理；场上已有的由 `S3MViewer` 统一重建 / 重传。
+   */
+  setRenderProfile(p: { colorPipeline?: 'linear' | 'direct'; textureOptions?: TextureCreateOptions }): void {
+    if (p.colorPipeline !== undefined) this._colorPipeline = p.colorPipeline;
+    if (p.textureOptions !== undefined) this._textureOptions = p.textureOptions;
+  }
+
   /**
    * 当前数据集驻留的显存与内存总字节数（几何缓冲精确大小 + 纹理显存估计）
    */
@@ -1245,6 +1285,9 @@ export class S3MTileset {
         uniforms: this._uniforms,
         assembled,
         polygonOffset: this._polygonOffset,
+        materialQuality: this._materialQuality,
+        colorPipeline: this._colorPipeline,
+        textureOptions: this._textureOptions,
       });
       const { group, stats } = buildRes;
       const texKeys = (buildRes as any).textureKeys ?? (group.userData?.textureKeys as string[] | undefined) ?? Object.keys(tile.textures ?? {});