@glowjs/core 2026.2.23 → 2026.3.2

package/dist/glow.core.d.ts

@@ -20,6 +20,7 @@ import { Gizmo } from '@babylonjs/core/Gizmos/gizmo';
 import { GizmoManager } from '@babylonjs/core/Gizmos/gizmoManager';
 import { EngineInstrumentation } from '@babylonjs/core/Instrumentation/engineInstrumentation';
 import { SceneInstrumentation } from '@babylonjs/core/Instrumentation/sceneInstrumentation';
+import { EffectLayer, IEffectLayerOptions } from '@babylonjs/core/Layers/effectlayer';
 import { GlowLayer } from '@babylonjs/core/Layers/glowLayer';
 import { HighlightLayer } from '@babylonjs/core/Layers/highlightLayer';
 import { DirectionalLight } from '@babylonjs/core/Lights/directionalLight';
@@ -34,6 +35,7 @@ import { Material } from '@babylonjs/core/Materials/material';
 import { NodeMaterial } from '@babylonjs/core/Materials/Node/nodeMaterial';
 import { PBRMaterial } from '@babylonjs/core/Materials/PBR/pbrMaterial';
 import { StandardMaterial } from '@babylonjs/core/Materials/standardMaterial';
+import { BaseTexture } from '@babylonjs/core/Materials/Textures/baseTexture';
 import { CubeTexture } from '@babylonjs/core/Materials/Textures/cubeTexture';
 import { EquiRectangularCubeTexture } from '@babylonjs/core/Materials/Textures/equiRectangularCubeTexture';
 import { Texture } from '@babylonjs/core/Materials/Textures/texture';
@@ -55,6 +57,7 @@ import { InstancedMesh } from '@babylonjs/core/Meshes/instancedMesh';
 import { LinesMesh } from '@babylonjs/core/Meshes/linesMesh';
 import { Mesh } from '@babylonjs/core/Meshes/mesh';
 import { VertexData } from '@babylonjs/core/Meshes/mesh.vertexData';
+import { SubMesh } from '@babylonjs/core/Meshes/subMesh';
 import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
 import { EnvironmentTextureTools } from '@babylonjs/core/Misc/environmentTextureTools';
 import { Observer } from '@babylonjs/core/Misc/observable';
@@ -63,7 +66,7 @@ import { Node as Node$1 } from '@babylonjs/core/node';
 import { ParticleHelper } from '@babylonjs/core/Particles/particleHelper';
 import { ParticleSystem } from '@babylonjs/core/Particles/particleSystem';
 import { Scene } from '@babylonjs/core/scene';
-import { FloatArray } from '@babylonjs/core/types';
+import { FloatArray, Nullable } from '@babylonjs/core/types';
 import { AdvancedDynamicTexture } from '@babylonjs/gui/2D/advancedDynamicTexture';
 import { Button } from '@babylonjs/gui/2D/controls/button';
 import { Container } from '@babylonjs/gui/2D/controls/container';
@@ -216,6 +219,48 @@ declare class Glow extends Base {
 	 */
 	dispose(): void;
 }
+declare class HighLight extends Base {
+	_layer: SelectionOutlineLayer;
+	private _entites;
+	/**
+	 * 实例化一个高亮层对象
+	 * @param app 应用
+	 */
+	constructor(app: App);
+	/**
+	 * 轮廓颜色，默认为绿色#00ff00
+	 */
+	get outlineColor(): string;
+	set outlineColor(value: string);
+	/**
+	 * 添加实体
+	 * @param entites 实体
+	 */
+	add(...entites: Entity[]): void;
+	/**
+	 * 是否包含指定的实体
+	 * @param item 实体
+	 */
+	includes(item: Entity): boolean;
+	/**
+	 * 移除实体
+	 * @param entites 实体
+	 */
+	remove(...entites: Entity[]): void;
+	/**
+	 * 清理
+	 */
+	clean(): void;
+	/**
+	 * 获取或设置启用
+	 */
+	get enable(): boolean;
+	set enable(value: boolean);
+	/**
+	 * 释放
+	 */
+	dispose(): void;
+}
 declare class ImageProcessing extends Base {
 	private _config;
 	/**
@@ -518,55 +563,6 @@ declare class ManualWallBuilder {
 	 */
 	computeCornerPoints(): void;
 }
-declare class OutlineEffect extends Base {
-	private _scene;
-	private _postProcess;
-	private _highlightedMeshes;
-	private _highlightColor;
-	private _width;
-	private _depthRenderer;
-	private _highlightRenderer;
-	private _entites;
-	private _resizeEventId;
-	constructor(app: App);
-	private _registerShaders;
-	private _initPostProcess;
-	/**
-	 * 获取或设置轮廓颜色（十六进制）
-	 */
-	get color(): string;
-	set color(value: string);
-	/** 获取或设置轮廓线宽度 */
-	get width(): number;
-	set width(value: number);
-	/**
-	 * 添加实体
-	 * @param entites 实体
-	 */
-	add(...entites: Entity[]): void;
-	/**
-	 * 是否包含指定的实体
-	 * @param item 实体
-	 */
-	includes(item: Entity): boolean;
-	/**
-	 * 移除实体
-	 * @param entites 实体
-	 */
-	remove(...entites: Entity[]): void;
-	/**
-	 * 清理
-	 */
-	clean(): void;
-	/**
-	 * 重置
-	 */
-	reset(): void;
-	/**
-	 * 销毁
-	 */
-	dispose(): void;
-}
 declare class Particle extends Base {
 	private _levelId;
 	private _particles;
@@ -613,14 +609,6 @@ declare class PerformancePanel extends StackPanel {
 	set visible(value: boolean);
 	private _update;
 }
-declare class PostProcessMgr extends Base {
-	outlineEffect: OutlineEffect;
-	constructor(app: App);
-	/** 是否启用轮廓效果 */
-	get enableOutline(): boolean;
-	set enableOutline(value: boolean);
-	dispose(): void;
-}
 declare class ToolTip extends Rectangle {
 	static _root: AdvancedDynamicTexture;
 	private _textBlock;
@@ -875,10 +863,6 @@ export declare class App extends EventDispatcher {
 	 * 管线管理器
 	 */
 	pipelineMgr: PipelineMgr;
-	/**
-	 * 后处理管理器
-	 */
-	postProcessMgr: PostProcessMgr;
 	/**
 	 * 跟踪器
 	 */
@@ -2574,6 +2558,10 @@ export declare class EffectMgr extends Base {
 	 * 发光层
 	 */
 	glow: Glow;
+	/**
+	 * 高亮
+	 */
+	highlight: HighLight;
 	/**
 	 * 灯光
 	 */
@@ -3198,6 +3186,82 @@ export declare class FPSBar extends TextBlock {
 	 */
 	dispose(): void;
 }
+/**
+ * 电子围栏
+ */
+export declare class Fence extends Entity {
+	/** 高度 */
+	static height: number;
+	static animationSpeed: number;
+	/** 点集 */
+	points: Point3D[];
+	private _mesh;
+	private _material;
+	/**
+	 * 实例化一个电子围栏对象
+	 * @param app 应用
+	 */
+	constructor(app: App);
+	/**
+	 * 获取实例类型
+	 */
+	get instanceClass(): typeof Fence;
+	toJson(): any;
+	fromJson(json: any): void; /**
+	 * 创建（仅当前层级可见对象）
+	 * @param {boolean} force 是否强制
+	 */
+	build(force?: boolean): Promise<void>;
+	/**
+	 * 拆毁
+	 */
+	unbuild(): void;
+}
+/**
+ * 围栏管理器组件
+ */
+export declare class FenceMgr extends Component {
+	private _edit;
+	private _curPoints;
+	private _curMeshes;
+	/**
+	 * 线颜色
+	 */
+	private _lineColor;
+	private _curRoot;
+	private _lastLineMesh;
+	private _appEvents;
+	/** 结束编辑时触发的回调函数 */
+	onEndEdit: (face: Fence) => void;
+	/** 围栏列表 */
+	get fenceList(): Fence[];
+	/**
+	 * 添加一个围栏
+	 * @param json 围栏JSON
+	 */
+	addOne(json: any): Fence;
+	/**
+	 * 创建所有围栏
+	 */
+	build(): Promise<void>;
+	/**
+	 * 实例化一个围栏管理器组件
+	 * @param entity 实体
+	 */
+	constructor(entity: Entity);
+	/**
+	 * 开始编辑
+	 */
+	startEdit(): void;
+	private _setAppEvents;
+	private _onLeftClick;
+	private _addLineMesh;
+	private _onAfterFrame;
+	/**
+	 * 结束编辑
+	 */
+	endEdit(): Promise<void>;
+}
 /**
  * 楼层
  */
@@ -5051,6 +5115,304 @@ export declare class RunTime implements IDisposable {
 	 */
 	dispose(): void;
 }
+/**
+ * SelectionOutlineLayer 类
+ *
+ * 选择轮廓渲染层，继承自 Babylon.js 的 EffectLayer。
+ * 为选中的网格渲染高亮轮廓效果。
+ *
+ * @example
+ * ```typescript
+ * // 创建轮廓层
+ * const outlineLayer = new SelectionOutlineLayer('selection', scene);
+ *
+ * // 设置轮廓颜色和厚度
+ * outlineLayer.outlineColor = new Color3(1, 0, 0);  // 红色
+ * outlineLayer.outlineThickness = 3.0;
+ *
+ * // 添加网格到选择
+ * outlineLayer.addSelection(mesh);
+ *
+ * // 移除网格
+ * outlineLayer.removeSelection(mesh);
+ * ```
+ */
+export declare class SelectionOutlineLayer extends EffectLayer {
+	/**
+	 * 效果名称常量
+	 * 用于在 Babylon.js 效果系统中标识此效果
+	 */
+	static readonly EffectName = "SelectionOutlineLayer";
+	/**
+	 * 实例选择ID属性名称常量
+	 * 用于实例化网格的选择ID属性
+	 */
+	static readonly InstanceSelectionIdAttributeName = "instanceSelectionId";
+	/**
+	 * 配置选项
+	 */
+	private _options;
+	/**
+	 * 选中网格信息数组
+	 */
+	private _selection;
+	/**
+	 * 网格唯一ID到选择ID的映射
+	 * 用于非实例化网格快速查找选择ID
+	 */
+	private _meshUniqueIdToSelectionId;
+	/**
+	 * 下一个可用的选择ID
+	 * 选择ID从1开始，0表示无选择
+	 */
+	private _nextSelectionId;
+	/**
+	 * 合并效果
+	 * 用于将选择遮罩渲染为最终轮廓
+	 */
+	private _mergeEffect;
+	/**
+	 * 纹理宽度
+	 */
+	private _textureWidth;
+	/**
+	 * 纹理高度
+	 */
+	private _textureHeight;
+	/**
+	 * 轮廓颜色
+	 * 默认为橙色 (1, 0.5, 0)
+	 */
+	outlineColor: Color3;
+	/**
+	 * 轮廓厚度
+	 * 以像素为单位，默认为 2.0
+	 */
+	outlineThickness: number;
+	/**
+	 * 遮挡强度
+	 * 控制被遮挡区域轮廓的透明度，范围 [0, 1]
+	 * 默认为 0.8，表示遮挡时轮廓透明度降低80%
+	 */
+	occlusionStrength: number;
+	/**
+	 * 遮挡检测阈值
+	 * 用于判断深度差异是否构成遮挡
+	 * 默认为 0.0001
+	 */
+	occlusionThreshold: number;
+	/**
+	 * 构造函数
+	 *
+	 * @param name 层名称
+	 * @param scene 目标场景（可选，默认使用当前场景）
+	 * @param options 配置选项（可选）
+	 */
+	constructor(name: string, scene?: Scene, options?: Partial<ISelectionOutlineLayerOptions>);
+	/**
+	 * 获取效果名称
+	 *
+	 * @returns 效果名称字符串
+	 */
+	getEffectName(): string;
+	/**
+	 * 获取内部绘制次数
+	 *
+	 * 选择轮廓只需要一次内部绘制（渲染选择遮罩）
+	 *
+	 * @returns 绘制次数（1）
+	 */
+	protected _numInternalDraws(): number;
+	/**
+	 * 创建合并效果
+	 *
+	 * 创建用于将选择遮罩渲染为最终轮廓的效果。
+	 * 使用全屏四边形渲染边缘检测结果。
+	 *
+	 * @returns 创建的 Effect 对象
+	 */
+	protected _createMergeEffect(): Effect;
+	/**
+	 * 创建纹理和后处理
+	 *
+	 * 初始化效果层所需的纹理和后处理效果。
+	 * 选择轮廓层不需要额外的后处理，只需设置主纹理采样数。
+	 */
+	protected _createTextureAndPostProcesses(): void;
+	/**
+	 * 创建主纹理（重写）
+	 *
+	 * 在父类创建主纹理后，设置渲染列表为当前选中的网格。
+	 */
+	protected _createMainTexture(): void;
+	/**
+	 * 是否需要模板缓冲区
+	 *
+	 * 选择轮廓效果不需要模板缓冲区。
+	 *
+	 * @returns false
+	 */
+	needStencil(): boolean;
+	/**
+	 * 检查子网格是否准备好渲染
+	 *
+	 * 公共接口，调用内部的 _isReady 方法。
+	 *
+	 * @param subMesh 子网格
+	 * @param useInstances 是否使用实例化
+	 * @returns 是否准备好
+	 */
+	isReady(subMesh: SubMesh, useInstances: boolean): boolean;
+	/**
+	 * 检查子网格是否准备好渲染（内部方法）
+	 *
+	 * 检查并创建选择遮罩渲染所需的着色器效果。
+	 * 根据网格特性（骨骼动画、实例化、透明度测试等）生成着色器定义。
+	 *
+	 * @param subMesh 子网格
+	 * @param useInstances 是否使用实例化
+	 * @param _emissiveTexture 自发光纹理（未使用）
+	 * @returns 是否准备好渲染
+	 */
+	protected _isReady(subMesh: SubMesh, useInstances: boolean, _emissiveTexture: Nullable<BaseTexture>): boolean;
+	/**
+	 * 内部渲染方法
+	 *
+	 * 执行选择轮廓的最终渲染。
+	 * 将选择遮罩纹理通过边缘检测着色器渲染为轮廓。
+	 *
+	 * @param effect 合并效果
+	 * @param _renderIndex 渲染索引（未使用）
+	 */
+	protected _internalRender(effect: Effect, _renderIndex: number): void;
+	/**
+	 * 是否应该渲染
+	 *
+	 * 只有当存在选中的网格时才渲染轮廓。
+	 *
+	 * @returns 是否应该渲染
+	 */
+	shouldRender(): boolean;
+	/**
+	 * 是否应该渲染指定网格
+	 *
+	 * @param mesh 网格
+	 * @returns 是否应该渲染
+	 */
+	protected _shouldRenderMesh(mesh: Mesh): boolean;
+	/**
+	 * 是否可以渲染指定网格
+	 *
+	 * 选择轮廓层可以渲染所有类型的网格。
+	 *
+	 * @param _mesh 网格（未使用）
+	 * @param _material 材质（未使用）
+	 * @returns true
+	 */
+	protected _canRenderMesh(_mesh: AbstractMesh, _material: Material): boolean;
+	/**
+	 * 添加自定义效果定义
+	 *
+	 * 子类可以重写此方法添加额外的着色器定义。
+	 *
+	 * @param defines 定义数组
+	 */
+	protected _addCustomEffectDefines(defines: string[]): void;
+	/**
+	 * 设置自发光纹理和颜色
+	 *
+	 * 选择轮廓层不使用自发光纹理，设置为默认值。
+	 *
+	 * @param _mesh 网格（未使用）
+	 * @param _subMesh 子网格（未使用）
+	 * @param _material 材质（未使用）
+	 */
+	protected _setEmissiveTextureAndColor(_mesh: Mesh, _subMesh: SubMesh, _material: Material): void;
+	/**
+	 * 渲染子网格（重写）
+	 *
+	 * 完整重写子网格渲染逻辑，确保正确设置选择ID和其他着色器参数。
+	 *
+	 * @param subMesh 子网格
+	 * @param enableAlphaMode 是否启用Alpha模式
+	 */
+	protected _renderSubMesh(subMesh: SubMesh, enableAlphaMode?: boolean): void;
+	/**
+	 * 检查网格是否在选择列表中
+	 *
+	 * 精确匹配，用于检查是否已添加到选择列表。
+	 *
+	 * @param mesh 要检查的网格
+	 * @returns 是否在选择列表中
+	 */
+	hasMesh(mesh: AbstractMesh): boolean;
+	/**
+	 * 检查网格是否应该被渲染（包括源网格关联检查）
+	 *
+	 * 对于实例化网格，会同时检查源网格和实例网格。
+	 *
+	 * @param mesh 要检查的网格
+	 * @returns 是否应该渲染
+	 */
+	private _shouldRenderMeshOrRelated;
+	/**
+	 * 移除网格的销毁观察者
+	 *
+	 * @param info 选择网格信息
+	 */
+	private _removeObserver;
+	/**
+	 * 清空所有选择
+	 *
+	 * 移除所有选中的网格，清理相关资源。
+	 */
+	clearSelection(): void;
+	/**
+	 * 添加网格到选择
+	 *
+	 * 将一个或多个网格添加到选择列表，为其渲染轮廓效果。
+	 * 同一组网格共享相同的选择ID，渲染相同颜色的轮廓。
+	 *
+	 * @param meshOrGroup 单个网格或网格数组
+	 */
+	addSelection(meshOrGroup: AbstractMesh | AbstractMesh[]): void;
+	/**
+	 * 从选择中移除网格
+	 *
+	 * 从选择列表中移除一个或多个网格，停止为其渲染轮廓。
+	 *
+	 * @param meshOrGroup 单个网格或网格数组
+	 */
+	removeSelection(meshOrGroup: AbstractMesh | AbstractMesh[]): void;
+	/**
+	 * 处理网格销毁
+	 *
+	 * 当网格被销毁时，自动从选择中移除。
+	 *
+	 * @param mesh 被销毁的网格
+	 */
+	_disposeMesh(mesh: Mesh): void;
+	/**
+	 * 释放资源
+	 *
+	 * 清理所有资源并释放效果层。
+	 */
+	dispose(): void;
+	/**
+	 * 获取类名
+	 *
+	 * @returns 类名字符串
+	 */
+	getClassName(): string;
+	/**
+	 * 序列化
+	 *
+	 * 将效果层配置序列化为JSON对象。
+	 *
+	 * @returns 序列化后的配置对象
+	 */
+	serialize(): any;
+}
 /**
  * 天空盒子
  */
@@ -5542,6 +5904,16 @@ export declare class Wall extends Entity {
  * 默认精度
  */
 export declare const EPSILON: number;
+/**
+ * 轮廓采样模式常量 - 八向采样
+ * 使用八个方向的采样点进行边缘检测（更精确但性能开销更大）
+ */
+export declare const OUTLINELAYER_SAMPLING_OCTADIRECTIONAL = 1;
+/**
+ * 轮廓采样模式常量 - 三向采样
+ * 使用三个方向的采样点进行边缘检测（上方、右侧、右上角）
+ */
+export declare const OUTLINELAYER_SAMPLING_TRIDIRECTIONAL = 0;
 /**
  * 默认效果数值
  */
@@ -5713,7 +6085,11 @@ export declare enum EntityType {
 	/**
 	 * 联合体
 	 */
-	Union = 524288
+	Union = 524288,
+	/**
+	 * 电子围栏
+	 */
+	Fence = 1048576
 }
 /**
  * 环境贴图资源枚举
@@ -6151,7 +6527,11 @@ export declare enum SystemResId {
 	/**
 	 * 视频融合透明度贴图
 	 */
-	VideoFusionOpacityTexture = "f29a93b7c7a413ddbd8e5afe18c5afcf"
+	VideoFusionOpacityTexture = "f29a93b7c7a413ddbd8e5afe18c5afcf",
+	/**
+	 * 电子围栏贴图
+	 */
+	FenceTexuture = "0ce6fc68f64afa03bcf7b913071a48cb"
 }
 /** 文本对齐方式 */
 export declare enum TxtAlign {
@@ -6513,6 +6893,30 @@ export interface IDisposable {
 	 */
 	dispose(): void;
 }
+/**
+ * SelectionOutlineLayer 配置选项接口
+ *
+ * 继承自 IEffectLayerOptions，添加了选择轮廓特有的配置项。
+ */
+export interface ISelectionOutlineLayerOptions extends IEffectLayerOptions {
+	/**
+	 * 主纹理采样数
+	 * 用于多重采样抗锯齿，默认为1（无抗锯齿）
+	 */
+	mainTextureSamples?: number;
+	/**
+	 * 是否存储相机空间Z值
+	 * true: 使用相机空间Z值进行深度计算（更精确）
+	 * false: 使用归一化深度值（默认）
+	 */
+	storeCameraSpaceZ?: boolean;
+	/**
+	 * 轮廓检测方法
+	 * OUTLINELAYER_SAMPLING_TRIDIRECTIONAL: 三向采样（默认）
+	 * OUTLINELAYER_SAMPLING_OCTADIRECTIONAL: 八向采样
+	 */
+	outlineMethod?: number;
+}
 /**
  * 资源项
  */