@realsee/five 6.8.0-alpha.12 → 6.8.0-alpha.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ai_guides/README.md +1 -0
- package/ai_guides/features/gesture.md +1 -0
- package/ai_guides/features/material.md +2 -0
- package/ai_guides/features/pano-filter.md +148 -0
- package/ai_guides/release_notes/6.8.md +175 -57
- package/docs/assets/hierarchy.js +1 -1
- package/docs/assets/navigation.js +1 -1
- package/docs/assets/search.js +1 -1
- package/docs/classes/five.AdaptiveLuminancePass.html +1 -1
- package/docs/classes/five.BoundingMesh.html +2 -2
- package/docs/classes/five.Camera.html +1 -1
- package/docs/classes/five.EyeDomeLightingPass.html +1 -1
- package/docs/classes/five.Five.html +13 -13
- package/docs/classes/five.FivePass.html +1 -1
- package/docs/classes/five.Histogram.html +16 -0
- package/docs/classes/five.InternalWebGLRenderer.html +1 -1
- package/docs/classes/five.Model.html +1 -1
- package/docs/classes/five.ModelScene.html +1 -1
- package/docs/classes/five.NetworkSubscribe.html +1 -1
- package/docs/classes/five.PBMContainer.html +1 -1
- package/docs/classes/five.PBMCustomShader.html +42 -3
- package/docs/classes/five.PBMGSObject.html +1 -1
- package/docs/classes/five.PBMGroup.html +1 -1
- package/docs/classes/five.PBMMesh.html +1 -1
- package/docs/classes/five.PBMMeshMaterial.html +7 -7
- package/docs/classes/five.PBMPanoFilter.html +61 -0
- package/docs/classes/five.PBMPointCloud.html +1 -1
- package/docs/classes/five.PBMPointCloudMaterial.html +5 -6
- package/docs/classes/five.PBMSkinnedMesh.html +1 -1
- package/docs/classes/five.PBMUpdateable.html +41 -0
- package/docs/classes/five.PanoCircleMesh.html +1 -1
- package/docs/classes/five.PanoCircleMeshCustom.html +1 -1
- package/docs/classes/five.PanoCircleMeshSolid.html +1 -1
- package/docs/classes/five.Parameter.html +54 -52
- package/docs/classes/five.Scene.html +1 -1
- package/docs/classes/five.Subscribe.html +1 -1
- package/docs/classes/five.Tile3D.html +1 -1
- package/docs/classes/five.TileNode.html +1 -1
- package/docs/classes/five.TrajectoryNode.html +1 -1
- package/docs/classes/five.WorkResolvedObserver.html +1 -1
- package/docs/classes/gltf-loader.DDSLoader.html +1 -1
- package/docs/classes/gltf-loader.DRACOLoader.html +1 -1
- package/docs/classes/gltf-loader.GLTFLoader.html +1 -1
- package/docs/classes/gltf-loader.GLTFObject.html +1 -1
- package/docs/classes/gltf-loader.GLTFParser.html +1 -1
- package/docs/classes/gltf-loader.THREEGLTFLoader.html +1 -1
- package/docs/classes/line.Line.html +1 -1
- package/docs/classes/line.LineGeometry.html +1 -1
- package/docs/classes/line.LineMaterial.html +1 -1
- package/docs/classes/line.LineSegmentsGeometry.html +1 -1
- package/docs/classes/line.THREE_Line2.html +1 -1
- package/docs/classes/line.THREE_LineSegments2.html +1 -1
- package/docs/classes/plugins.BasePlugin.Controller.html +1 -1
- package/docs/classes/plugins.RoundedBoxGeometry.html +1 -1
- package/docs/classes/sticker.Sticker.html +1 -1
- package/docs/classes/vfx.Airflow.html +1 -1
- package/docs/classes/vfx.Flame.html +1 -1
- package/docs/classes/vfx.Particle.html +1 -1
- package/docs/classes/vfx.ParticleGPU.html +1 -1
- package/docs/classes/vfx.SpotLight.html +1 -1
- package/docs/documents/README.html +1 -0
- package/docs/documents/features_gesture.html +1 -0
- package/docs/documents/features_material.html +7 -0
- package/docs/documents/features_pano-filter.html +122 -0
- package/docs/documents/release_notes_6.8.html +151 -65
- package/docs/hierarchy.html +1 -1
- package/docs/index.html +1 -0
- package/docs/interfaces/five.AddableObject.html +1 -1
- package/docs/interfaces/five.AjaxOptions.html +1 -1
- package/docs/interfaces/five.BaseEvent.html +1 -1
- package/docs/interfaces/five.EventCallback.html +51 -49
- package/docs/interfaces/five.FloorplanControllerCustomInitArgs.html +9 -9
- package/docs/interfaces/five.GestureEvent.html +2 -2
- package/docs/interfaces/five.ImageOptions.html +1 -1
- package/docs/interfaces/five.IntersectEvent.html +1 -1
- package/docs/interfaces/five.IntersectMesh.html +1 -1
- package/docs/interfaces/five.IntersectMeshInterface.html +1 -1
- package/docs/interfaces/five.Intersection.html +1 -1
- package/docs/interfaces/five.LooseWorkWithExtrinsics.html +1 -1
- package/docs/interfaces/five.MapviewControllerCustomInitArgs.html +9 -9
- package/docs/interfaces/five.ModeChangeEvent.html +2 -2
- package/docs/interfaces/five.ModelControllerCustomInitArgs.html +1 -1
- package/docs/interfaces/five.ModelEvent.html +2 -2
- package/docs/interfaces/five.ModelSceneEvent.html +2 -2
- package/docs/interfaces/five.ModelTileEvent.html +2 -2
- package/docs/interfaces/five.MovePanoOptions.html +7 -7
- package/docs/interfaces/five.NetworkAbortError.html +1 -1
- package/docs/interfaces/five.NetworkFirbiddenError.html +1 -1
- package/docs/interfaces/five.NetworkOptions.html +1 -1
- package/docs/interfaces/five.NetworkProxyError.html +1 -1
- package/docs/interfaces/five.NetworkResourceEvent.html +2 -2
- package/docs/interfaces/five.NetworkResponseError.html +1 -1
- package/docs/interfaces/five.NetworkTimeoutError.html +1 -1
- package/docs/interfaces/five.ObjectEvent.html +2 -2
- package/docs/interfaces/five.PBMClipperParameter.html +2 -2
- package/docs/interfaces/five.PBMCustomShaderInitArgs.html +2 -2
- package/docs/interfaces/five.PBMCustomShaderSlots.html +2 -2
- package/docs/interfaces/five.PBMMaterial.html +1 -1
- package/docs/interfaces/five.PBMMeshMaterialParameters.html +5 -3
- package/docs/interfaces/five.PBMPanoDepth.html +5 -5
- package/docs/interfaces/five.PBMPanoFilterValue.html +5 -0
- package/docs/interfaces/five.PBMPanoPicture.html +8 -6
- package/docs/interfaces/five.PBMPointCloudMaterialParameters.html +2 -3
- package/docs/interfaces/five.PBMRefinedScreen.html +2 -2
- package/docs/interfaces/five.PanoCircleMeshInterface.html +1 -1
- package/docs/interfaces/five.PanoEvent.html +1 -1
- package/docs/interfaces/five.PanoTextureEvent.html +1 -1
- package/docs/interfaces/five.PanoramaControllerCustomInitArgs.html +1 -1
- package/docs/interfaces/five.PanoramaLikeControllerCustomInitArgs.html +1 -1
- package/docs/interfaces/five.ParameterMaterialValue.html +39 -37
- package/docs/interfaces/five.ParameterTilesetValue.html +15 -15
- package/docs/interfaces/five.ParameterValue.html +53 -51
- package/docs/interfaces/five.Pose.html +1 -1
- package/docs/interfaces/five.RenderEvent.html +2 -2
- package/docs/interfaces/five.ResolvedParameterValue.html +53 -51
- package/docs/interfaces/five.RgbaData.html +7 -0
- package/docs/interfaces/five.State.html +1 -1
- package/docs/interfaces/five.StateEvent.html +1 -1
- package/docs/interfaces/five.TextureOptions.html +1 -1
- package/docs/interfaces/five.TopviewControllerCustomInitArgs.html +7 -7
- package/docs/interfaces/five.VRPanoramaControllerCustomInitArgs.html +1 -1
- package/docs/interfaces/five.ViewLayer.html +1 -1
- package/docs/interfaces/five.WorkCubeImage.html +1 -1
- package/docs/interfaces/five.WorkImage.html +1 -1
- package/docs/interfaces/five.WorkObserver.html +1 -1
- package/docs/interfaces/five.WorkTile.html +1 -1
- package/docs/interfaces/five.WorksEvent.html +2 -2
- package/docs/interfaces/five.XRControllerEvent.html +2 -2
- package/docs/interfaces/five.XRGestureEvent.html +2 -2
- package/docs/interfaces/five.XRPanoramaControllerCustomInitArgs.html +1 -1
- package/docs/interfaces/five.XRSessionEvent.html +2 -2
- package/docs/interfaces/plugins.BackgroundPluginController.html +1 -1
- package/docs/interfaces/plugins.BackgroundPluginType.EventMap.html +1 -1
- package/docs/interfaces/plugins.BasePlugin.State.html +1 -1
- package/docs/interfaces/plugins.DynamicPathLinePluginController.html +1 -1
- package/docs/interfaces/plugins.DynamicPathLinePluginType.EventMap.html +1 -1
- package/docs/interfaces/plugins.DynamicPathLinePluginType.State.html +1 -1
- package/docs/interfaces/plugins.ItemMaskController.html +1 -1
- package/docs/interfaces/plugins.ItemMaskPluginType.EventMap.html +1 -1
- package/docs/interfaces/plugins.ItemMaskPluginType.State.html +1 -1
- package/docs/interfaces/plugins.OrientationPluginController.html +1 -1
- package/docs/interfaces/plugins.OrientationPluginType.EventMap.html +1 -1
- package/docs/interfaces/plugins.OrientationPluginType.State.html +1 -1
- package/docs/interfaces/plugins.PanoAnimeController.html +1 -1
- package/docs/interfaces/plugins.PanoAnimePluginType.EventMap.html +1 -1
- package/docs/interfaces/plugins.PanoAnimePluginType.State.html +1 -1
- package/docs/interfaces/plugins.PluginTemplateType.EventMap.html +1 -1
- package/docs/interfaces/plugins.PluginTemplateType.State.html +1 -1
- package/docs/interfaces/plugins.TrajectoryController.html +1 -1
- package/docs/interfaces/react.FiveInjectionTypes.html +13 -13
- package/docs/modules/five.html +1 -1
- package/docs/modules.html +1 -1
- package/docs/types/five.ControllerEventTypes.html +27 -25
- package/docs/types/five.EasingFunction.html +1 -0
- package/docs/types/five.EventTypes.html +26 -26
- package/docs/types/five.PBMAlphaMode.html +1 -1
- package/docs/types/five.PBMColorStyle.html +1 -1
- package/docs/types/five.PBMFloorStyle.html +1 -1
- package/docs/types/five.PBMMeshShaderType.html +1 -1
- package/docs/types/five.PBMPointBack.html +1 -1
- package/docs/types/five.PBMPointCloudShaderType.html +1 -1
- package/docs/types/five.PBMPointShape.html +1 -1
- package/docs/types/five.PBMPointSize.html +1 -1
- package/docs/types/five.PBMTransition.html +1 -1
- package/docs/types/five.ParseOptions.html +1 -1
- package/docs/types/plugins.BasePlugin.EventMap.html +1 -1
- package/docs/variables/five.PROXY_CONTROLLER_EVENT_NAMES.html +1 -1
- package/five/application/events.d.ts +1 -1
- package/five/controllers/events.d.ts +2 -0
- package/five/controllers/panorama.d.ts +1 -1
- package/five/index.d.ts +3 -0
- package/five/index.js +118 -91
- package/five/index.mjs +8502 -8234
- package/five/model/index.d.ts +1 -1
- package/five/model/materials/pbmMaterial.d.ts +60 -2
- package/five/model/materials/pbmMeshMaterial.d.ts +5 -3
- package/five/model/materials/pbmPointCloudMaterial.d.ts +0 -2
- package/five/model/parameter.d.ts +5 -1
- package/five/renderer/tools/render-cube-to-equirectangular.d.ts +7 -0
- package/five/texture/histogram.d.ts +47 -0
- package/five/texture/textureData.d.ts +10 -0
- package/five/types/movePanoOptions.d.ts +4 -3
- package/five/utils/event.d.ts +10 -0
- package/gltf-loader/index.js +3 -3
- package/gltf-loader/index.mjs +3 -3
- package/line/index.js +3 -3
- package/line/index.mjs +3 -3
- package/llms.txt +1 -0
- package/package.json +1 -1
- package/plugins/index.js +2 -2
- package/plugins/index.mjs +2 -2
- package/react/index.js +2 -2
- package/react/index.mjs +2 -2
- package/shader-lib/index.js +2 -2
- package/shader-lib/index.mjs +2 -2
- package/sticker/index.js +3 -3
- package/sticker/index.mjs +3 -3
- package/umd/five-gltf-loader.js +3 -3
- package/umd/five-line.js +3 -3
- package/umd/five-plugins.js +2 -2
- package/umd/five-react.js +2 -2
- package/umd/five-shader-lib.js +2 -2
- package/umd/five-sticker.js +3 -3
- package/umd/five-vfx.js +2 -2
- package/umd/five-vue.js +2 -2
- package/umd/five.js +118 -91
- package/vfx/index.js +2 -2
- package/vfx/index.mjs +2 -2
- package/vue/index.js +2 -2
- package/vue/index.mjs +2 -2
- package/work-downloader/index.js +2 -2
- package/work-downloader/index.mjs +2 -2
package/ai_guides/README.md
CHANGED
|
@@ -78,6 +78,7 @@
|
|
|
78
78
|
* [Flowing Light 3D Pass](./features/flowing-light-3d-pass.md): 3D 世界坐标流光特效(InstancedMesh 优化)。
|
|
79
79
|
* [Gaussian Blur Pass](./features/gaussian-blur-pass.md): 高斯模糊特效。
|
|
80
80
|
* [Material](./features/material.md): 材质参数配置 (透明度、点云大小、顶点标记)。
|
|
81
|
+
* [Pano Filter](./features/pano-filter.md): 全景图滤镜 (亮度、对比度、色温调节)。
|
|
81
82
|
* [Get Screen Pixels](./features/get-screen-pixels.md): 获取屏幕像素 (放大镜/截图)。
|
|
82
83
|
* [Move Pano Effect](./features/move-pano-effect.md): 全景点位切换的过渡效果。
|
|
83
84
|
* [Clipper](./features/clipper.md): 模型裁切功能 (房屋剖面)。
|
|
@@ -82,6 +82,7 @@ Five 支持高性能的点云渲染(PBM),并提供灵活的样式配置:
|
|
|
82
82
|
| `receiveShadow` | `boolean` | `false` | 模型是否接收阴影。 |
|
|
83
83
|
| `useAddBlend` | `boolean` | `false` | 是否使用半透明叠加渲染。 |
|
|
84
84
|
| `customShaders` | `PBMCustomShader[]` | `[]` | 自定义 Shader 配置。 |
|
|
85
|
+
| `panoFilter` | `PBMPanoFilter` | `null` | 全景图滤镜 (亮度、对比度、色温等)。详情见 [Pano Filter](./pano-filter.md)。 |
|
|
85
86
|
| `clippers` | `PBMClipperParameter[]` | `[]` | 模型裁切参数。 |
|
|
86
87
|
| `boundingBox` | `THREE.Box3` | `Infinity` | 模型包围盒。 |
|
|
87
88
|
|
|
@@ -142,6 +143,7 @@ five.model.set({
|
|
|
142
143
|
## Related
|
|
143
144
|
|
|
144
145
|
* [Parameter](./parameter.md): 配置系统入口与继承逻辑。
|
|
146
|
+
* [Pano Filter](./pano-filter.md): 了解全景图滤镜的详细用法。
|
|
145
147
|
* [3DTile Params](./3dtile.md): 性能与加载相关参数。
|
|
146
148
|
|
|
147
149
|
---
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
# Pano Filter (全景图滤镜)
|
|
2
|
+
|
|
3
|
+
- **Summary**: `PBMPanoFilter` 用于调整全景图的视觉效果,包括亮度、对比度、饱和度、色温、色调等。它作为参数传递给 `ModelScene`,可实时改变全景图的渲染表现。
|
|
4
|
+
- **Schema**: `PBMPanoFilter`, `PBMUpdateable`
|
|
5
|
+
- **Concepts**: Material Filter, Color Correction
|
|
6
|
+
- **Configuration**: Temperature, Tint, Brightness, Contrast, Saturation
|
|
7
|
+
- **Examples**: 滤镜开启与参数调整
|
|
8
|
+
|
|
9
|
+
## Schema
|
|
10
|
+
|
|
11
|
+
> **Definition**: [PBMPanoFilter](../../five/model/materials/pbmMaterial.d.ts)
|
|
12
|
+
|
|
13
|
+
`PBMPanoFilter` 类定义了全景图的滤镜参数。所有属性均为对象引用,直接修改其内部属性即可生效。
|
|
14
|
+
|
|
15
|
+
```typescript
|
|
16
|
+
import { PBMUpdateable } from "@realsee/five";
|
|
17
|
+
|
|
18
|
+
export class PBMPanoFilter extends PBMUpdateable {
|
|
19
|
+
/** 对比度控制 */
|
|
20
|
+
public readonly contrast: {
|
|
21
|
+
/** 对比度偏移 [-1, 1] (默认 0) */
|
|
22
|
+
contrastBias: number;
|
|
23
|
+
};
|
|
24
|
+
|
|
25
|
+
/** 饱和度控制 */
|
|
26
|
+
public readonly saturation: {
|
|
27
|
+
/** 饱和度偏移 [-1, 1] (默认 0) */
|
|
28
|
+
saturationBias: number;
|
|
29
|
+
};
|
|
30
|
+
|
|
31
|
+
/** 颜色控制 (色温与色调) */
|
|
32
|
+
public readonly color: {
|
|
33
|
+
/** 色温偏移 [-100, 100] (默认 0) */
|
|
34
|
+
temperatureBias: number;
|
|
35
|
+
/** 色调偏移 [-100, 100] (默认 0) */
|
|
36
|
+
tintBias: number
|
|
37
|
+
};
|
|
38
|
+
|
|
39
|
+
/** 高光与阴影控制 */
|
|
40
|
+
public readonly highlightShadow: {
|
|
41
|
+
/** 全局亮度偏移 [-255, 255] (默认 0) */
|
|
42
|
+
globalBias: number;
|
|
43
|
+
/** 高光偏移 [-255, 255] (默认 0) */
|
|
44
|
+
highlightBias: number;
|
|
45
|
+
/** 阴影偏移 [-255, 255] (默认 0) */
|
|
46
|
+
shadowBias: number;
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## Concepts
|
|
52
|
+
|
|
53
|
+
### Material Filter (材质滤镜)
|
|
54
|
+
与 [Postprocessing](./postprocessing.md) (后处理) 不同,`PBMPanoFilter` 是作用于全景图材质 (Material) 阶段的滤镜。这意味着它直接影响纹理的采样和着色计算,而不是对最终渲染图像进行二次处理。
|
|
55
|
+
|
|
56
|
+
### Parameter Binding (参数绑定)
|
|
57
|
+
滤镜实例需要通过 `five.modelScene.parameter.set('panoFilter', filter)` 绑定到场景中才能生效。
|
|
58
|
+
|
|
59
|
+
## Configuration
|
|
60
|
+
|
|
61
|
+
以下参数均通过修改 `PBMPanoFilter` 实例的属性进行配置。
|
|
62
|
+
|
|
63
|
+
### Color & Tone (色彩与色调)
|
|
64
|
+
|
|
65
|
+
| Property | Type | Range | Default | Description |
|
|
66
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
67
|
+
| `color.temperatureBias` | `number` | `[-100, 100]` | `0` | **色温**。正值偏暖 (黄),负值偏冷 (蓝)。 |
|
|
68
|
+
| `color.tintBias` | `number` | `[-100, 100]` | `0` | **色调**。正值偏洋红,负值偏绿。 |
|
|
69
|
+
| `saturation.saturationBias` | `number` | `[-1, 1]` | `0` | **饱和度**。`0` 为原色,`-1` 为黑白。 |
|
|
70
|
+
| `contrast.contrastBias` | `number` | `[-1, 1]` | `0` | **对比度**。正值增强对比,负值降低对比。 |
|
|
71
|
+
|
|
72
|
+
### Light & Shadow (光影)
|
|
73
|
+
|
|
74
|
+
| Property | Type | Range | Default | Description |
|
|
75
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
76
|
+
| `highlightShadow.globalBias` | `number` | `[-255, 255]` | `0` | **亮度 (Brightness)**。整体提升或降低画面亮度。 |
|
|
77
|
+
| `highlightShadow.highlightBias` | `number` | `[-255, 255]` | `0` | **高光 (Highlight)**。仅调整画面亮部的亮度。 |
|
|
78
|
+
| `highlightShadow.shadowBias` | `number` | `[-255, 255]` | `0` | **阴影 (Shadow)**。仅调整画面暗部的亮度。 |
|
|
79
|
+
|
|
80
|
+
## Examples
|
|
81
|
+
|
|
82
|
+
### Basic Usage (基础用法)
|
|
83
|
+
|
|
84
|
+
创建一个滤镜实例并应用到 Five 场景中。
|
|
85
|
+
|
|
86
|
+
```typescript
|
|
87
|
+
import { Five, PBMPanoFilter } from "@realsee/five";
|
|
88
|
+
|
|
89
|
+
const five = new Five();
|
|
90
|
+
// ... 初始化 five ...
|
|
91
|
+
|
|
92
|
+
// 1. 创建滤镜实例
|
|
93
|
+
const panoFilter = new PBMPanoFilter();
|
|
94
|
+
|
|
95
|
+
// 2. 配置参数 (例如:增加一点暖色调和亮度)
|
|
96
|
+
panoFilter.color.temperatureBias = 10; // 暖色
|
|
97
|
+
panoFilter.highlightShadow.globalBias = 20; // 提亮
|
|
98
|
+
|
|
99
|
+
// 3. 启用滤镜
|
|
100
|
+
five.modelScene.parameter.set('panoFilter', panoFilter);
|
|
101
|
+
|
|
102
|
+
// 4. (可选) 停用滤镜
|
|
103
|
+
// five.modelScene.parameter.reset('panoFilter');
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
### Interactive Adjustment (动态调整)
|
|
107
|
+
|
|
108
|
+
滤镜参数支持实时修改,适合制作调节面板。
|
|
109
|
+
|
|
110
|
+
```typescript
|
|
111
|
+
import { Five, PBMPanoFilter } from "@realsee/five";
|
|
112
|
+
|
|
113
|
+
// 假设已经有 five 实例
|
|
114
|
+
const panoFilter = new PBMPanoFilter();
|
|
115
|
+
five.modelScene.parameter.set('panoFilter', panoFilter);
|
|
116
|
+
|
|
117
|
+
// 模拟 UI 绑定的数据对象
|
|
118
|
+
const filterSettings = {
|
|
119
|
+
brightness: 0,
|
|
120
|
+
contrast: 0,
|
|
121
|
+
};
|
|
122
|
+
|
|
123
|
+
// 监听 UI 变化 (示例伪代码)
|
|
124
|
+
function onBrightnessChange(value: number) {
|
|
125
|
+
// value range: [-255, 255]
|
|
126
|
+
panoFilter.highlightShadow.globalBias = value;
|
|
127
|
+
// 如果 five 没有开启自动渲染 (play: false),需要手动触发重绘
|
|
128
|
+
five.needsRender = true;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
function onContrastChange(value: number) {
|
|
132
|
+
// value range: [-1, 1]
|
|
133
|
+
panoFilter.contrast.contrastBias = value;
|
|
134
|
+
five.needsRender = true;
|
|
135
|
+
}
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
## Related
|
|
139
|
+
|
|
140
|
+
* [Model](./model.md): 了解 ModelScene 及其参数系统。
|
|
141
|
+
* [Parameter](./parameter.md): 了解 Five 的全局初始化参数。
|
|
142
|
+
* [Postprocessing](./postprocessing.md): 了解屏幕空间的后处理效果。
|
|
143
|
+
|
|
144
|
+
---
|
|
145
|
+
|
|
146
|
+
```yaml
|
|
147
|
+
tags: [filter, material, visual, color, brightness, contrast]
|
|
148
|
+
```
|
|
@@ -7,21 +7,64 @@ npm install @realsee/five@6.8
|
|
|
7
7
|
|
|
8
8
|
## Gaussian Splatting (3DGS) 支持
|
|
9
9
|
> Five 现已支持 Gaussian Splatting (3DGS) 渲染管线。这是一种基于点的渲染技术,能够提供高质量的实时渲染效果。
|
|
10
|
+
> 仅在 WebGL2 环境下可用。
|
|
11
|
+
|
|
12
|
+
### 文件格式支持
|
|
13
|
+
1. `.splat` 文档及工具 [GitHub - antimatter15/splat: WebGL 3D Gaussian Splat Viewer](https://github.com/antimatter15/splat)
|
|
14
|
+
2. `.spz` 文档及工具 GitHub - [nianticlabs/spz: File format for 3D Gaussian splats. About 10x smaller than the PLY equival](https://github.com/nianticlabs/spz)
|
|
15
|
+
3. `.glb` `.gltf` 对应的 KHR_gaussian_splatting_compression_spz 扩展。
|
|
16
|
+
|
|
17
|
+
### 支持 3d-tile
|
|
18
|
+
> 通过 3d-tile 标准,使用 glb 作为模型格式。
|
|
19
|
+
|
|
20
|
+
```json
|
|
21
|
+
{
|
|
22
|
+
"asset": {
|
|
23
|
+
"version": "1.0",
|
|
24
|
+
},
|
|
25
|
+
"geometricError": 265.4529731527354,
|
|
26
|
+
"root": {
|
|
27
|
+
"boundingVolume": {
|
|
28
|
+
"box": [
|
|
29
|
+
0.9499778747558594, 3.5037269592285156, 17.48550033569336,
|
|
30
|
+
97.01779174804688, 0.0, 0.0,
|
|
31
|
+
0.0, 88.27268981933594, 0.0,
|
|
32
|
+
0.0, 0.0, 20.292869567871094
|
|
33
|
+
]
|
|
34
|
+
},
|
|
35
|
+
"content": {
|
|
36
|
+
"uri": "splat.glb"
|
|
37
|
+
},
|
|
38
|
+
"geometricError": 66.36324328818385,
|
|
39
|
+
"refine": "ADD"
|
|
40
|
+
},
|
|
41
|
+
"transform": [
|
|
42
|
+
1.0, 0.0, 0.0, 0.0,
|
|
43
|
+
0.0, 1.0, 0.0, 0.0,
|
|
44
|
+
0.0, 0.0, 1.0, 0.0,
|
|
45
|
+
0.0, 0.0, 0.0, 1.0
|
|
46
|
+
]
|
|
47
|
+
}
|
|
48
|
+
```
|
|
10
49
|
|
|
11
|
-
|
|
12
|
-
* **数据支持**:
|
|
13
|
-
* 支持 `3dtiles` 中包含 3DGS 数据。
|
|
14
|
-
* 支持加载 `.spz` (version 2) 或 `.splat` 格式的数据。
|
|
15
|
-
* 支持通过 glTF 扩展加载 content 为 `.spz` 的 glTF/glb 文件。
|
|
16
|
-
* **功能特性**:
|
|
17
|
-
* 支持透视相机与正交相机渲染。
|
|
18
|
-
* 支持 BVH 构建,支持射线检测 (Raycast)。
|
|
19
|
-
* `pbmGSObject` 继承自 `THREE.Points`。
|
|
50
|
+
### 通过 Work 加载
|
|
20
51
|
|
|
21
|
-
|
|
22
|
-
|
|
52
|
+
```json
|
|
53
|
+
{
|
|
54
|
+
"work_code": "",
|
|
55
|
+
"model": {
|
|
56
|
+
"layers": {
|
|
57
|
+
"tileset_url": "tileset.json",
|
|
58
|
+
"name": "poincare_3dgs",
|
|
59
|
+
"type": "gaussian_splatting"
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
```
|
|
23
64
|
|
|
24
|
-
|
|
65
|
+
### 配置球谐光照阶数 (SH Degree)
|
|
66
|
+
可以通过 five.parameter.gSHDegree 设置球谐光照阶数,支持 0, 1, 2 阶,默认为 0 阶。
|
|
67
|
+
```
|
|
25
68
|
const five = new Five({
|
|
26
69
|
parameters: {
|
|
27
70
|
gsSHDegree: 1 // 设置为 1 阶 SH
|
|
@@ -29,62 +72,137 @@ const five = new Five({
|
|
|
29
72
|
});
|
|
30
73
|
```
|
|
31
74
|
|
|
32
|
-
|
|
33
|
-
|
|
75
|
+
### 模型的射线检测
|
|
76
|
+
gaussian_splatting 的模型同时也支持 rayscast 射线检测。同点云的处理保持一致。但是因为 gaussian_splatting 的射线交点对应的法线方向是一个估算值,精度并不高。请酌情使用。
|
|
34
77
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
优先级顺序:`mesh` > `point_cloud` > 其他类型。
|
|
78
|
+
## glTF 模型支持增强
|
|
79
|
+
> 新增了对更多 glTF 扩展的支持,提升了模型的表现力和动画能力。
|
|
38
80
|
|
|
39
|
-
###
|
|
40
|
-
* **显示**: 当 `viewLayer.visible = true` 时,开始加载资源。
|
|
41
|
-
* **隐藏**: 当 `viewLayer.visible = false` 时,**释放该图层占用的所有内存资源**。
|
|
81
|
+
### 扩展新增及优化
|
|
42
82
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
新增 `tile.content.byteLength` 属性,可在加载过程中获取瓦片内容的字节长度。
|
|
46
|
-
同时,`model.tileLoad` 和 `model.tileUnload` 事件被添加,用于监控瓦片的生命周期。
|
|
83
|
+
#### KHR_animation_pointer
|
|
84
|
+
> KHR_animation_pointer 允许动画通道指向 glTF 资产中任何对象的任何属性。
|
|
47
85
|
|
|
48
|
-
|
|
49
|
-
外部模型加载函数(`loadGltf`, `loadPly` 等)现在支持 `onDownloadProgress` 回调,用于监控文件下载进度。
|
|
86
|
+
默认的 animtion 只能修改 node 的 transform 实现节点的平移、旋转和缩放
|
|
50
87
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
88
|
+
这个能力可以实现材质动画。比如:
|
|
89
|
+
- 通过 uv transform 实现 texture 的移动,变化贴图位置。
|
|
90
|
+
- 通过修改 material 上的材质属性,可以动态修改金属粗糙,透明度,自发光程度。
|
|
91
|
+
- 通过修改 node 的 KHR_node_visibility 的扩展值,显隐某个节点。
|
|
92
|
+
- 等等
|
|
54
93
|
|
|
55
|
-
|
|
56
|
-
>
|
|
94
|
+
#### KHR_node_visibility
|
|
95
|
+
> 允许设置节点的可见性属性。
|
|
96
|
+
用于 配合 KHR_animation_pointer 实现显隐效果。
|
|
57
97
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
* **KHR_node_visibility**: 允许设置节点的可见性属性。
|
|
61
|
-
* **KHR_materials_clearcoat** 用于在材质上添加一层透明涂层,模拟车漆、碳纤维、清漆木材等真实世界中的表面效果。
|
|
62
|
-
* **KHR_materials_sheen** 绒面 / 绒毛类表面效果。
|
|
63
|
-
* **KHR_materials_transmission** 物理透光材质扩展,用于实现光线真正穿过物体的透明 / 半透明效果。
|
|
98
|
+
#### KHR_materials_clearcoat
|
|
99
|
+
> 用于在材质上添加一层透明涂层,模拟车漆、碳纤维、清漆木材等真实世界中的表面效果。
|
|
64
100
|
|
|
65
|
-
|
|
66
|
-
|
|
101
|
+
这个能力可以实现材质动画。比如
|
|
102
|
+
- 漆面等光滑的表面
|
|
103
|
+
- 塑料薄膜
|
|
104
|
+
- 等等
|
|
67
105
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
* `equirectangularUvToVector`: 将全景图 uv 转化为方向向量。
|
|
71
|
-
* `vectorToCubemapUv`: 将方向向量转化为立方体贴图 uv。
|
|
72
|
-
* `cubemapUvToVector`: 将立方体贴图 uv 转化为方向向量。
|
|
106
|
+
#### KHR_materials_transmission
|
|
107
|
+
> 物理透光材质扩展,用于实现光线真正穿过物体的透明 / 半透明效果。
|
|
73
108
|
|
|
74
|
-
|
|
75
|
-
|
|
109
|
+
这个能力可以实现材质动画。比如
|
|
110
|
+
- 玻璃等即透光也反射的表面
|
|
111
|
+
- 等等
|
|
76
112
|
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
* **[GaussianBlurPass](../features/gaussian-blur-pass.md)**: 高斯模糊效果,可用于实现毛玻璃等视觉特效。
|
|
113
|
+
#### KHR_materials_emissive_strength
|
|
114
|
+
> 调整自发光强度
|
|
80
115
|
|
|
81
|
-
|
|
82
|
-
>
|
|
116
|
+
#### KHR_materials_unlit
|
|
117
|
+
> 不感光材质
|
|
118
|
+
正确解析 KHR_materials_unlit。是否感光作用到对应的 material 上,而不是 gltf 中的所有元素。
|
|
83
119
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
* 提供了更清晰的 API 定义和概念说明,例如新增了 [ViewLayer](../features/view-layer.md) 的详细文档。
|
|
120
|
+
### 动画优化
|
|
121
|
+
处理额外动画骨骼未绑定导致的错误, 出现的抖动。
|
|
87
122
|
|
|
88
|
-
##
|
|
89
|
-
|
|
90
|
-
|
|
123
|
+
## 模型 ViewLayer 加载策略优化
|
|
124
|
+
> 优化了 ViewLayer 的加载和显隐逻辑,以减少内存占用并提高性能。
|
|
125
|
+
|
|
126
|
+
#### 默认加载策略变更
|
|
127
|
+
默认情况下,Five 不再加载所有图层,而是根据优先级仅加载一个图层。
|
|
128
|
+
优先级顺序:mesh > point_cloud > gaussian_splatting > 其他类型。
|
|
129
|
+
|
|
130
|
+
#### 显隐与内存管理
|
|
131
|
+
- 显示: 当 viewLayer.visible = true 时,开始加载资源。
|
|
132
|
+
- 隐藏: 当 viewLayer.visible = false 时,释放该图层占用的所有内存资源。
|
|
133
|
+
|
|
134
|
+
#### 加载进度
|
|
135
|
+
- 新增 tile.content.loadProgress 属性,用于查看每个瓦片的加载进度 (0-1)。
|
|
136
|
+
- 新增 tile.content.byteLength 属性,可在加载过程中获取瓦片内容的字节长度。
|
|
137
|
+
- 同时,model.tileLoad 和 model.tileUnload 事件被添加,用于监控瓦片的生命周期。
|
|
138
|
+
- 加载函数(loadGltf, loadPly 等)现在支持 onDownloadProgress 回调,用于监控文件下载进度。
|
|
139
|
+
|
|
140
|
+
#### 射线检测增强
|
|
141
|
+
- 射线交点 Intersection 对象新增了 tile, model, viewLayer 字段,便于在射线检测时获取更详细的上下文信息。
|
|
142
|
+
- raycaster.hitFilter 回调函数的参数类型定义已更新,包含 model, viewLayer, tile 等上下文信息。
|
|
143
|
+
|
|
144
|
+
## Work 增强
|
|
145
|
+
### Observer 支持 uv 计算工具函数
|
|
146
|
+
为 WorkObserver 提供了更多实用的工具函数,便于进行坐标和 UV 转换。
|
|
147
|
+
UV 转换工具函数
|
|
148
|
+
- observer.vectorToEquirectangularUv: 将方向向量转化为全景图 uv。
|
|
149
|
+
- observer.equirectangularUvToVector: 将全景图 uv 转化为方向向量。
|
|
150
|
+
- observer.vectorToCubemapUv: 将方向向量转化为立方体贴图 uv。
|
|
151
|
+
- observer.cubemapUvToVector: 将立方体贴图 uv 转化为方向向量。
|
|
152
|
+
|
|
153
|
+
## 全景图滤镜
|
|
154
|
+
|
|
155
|
+
新增了全景图滤镜功能,支持实时调整全景图的亮度、对比度、饱和度、色温和色调等参数。
|
|
156
|
+
|
|
157
|
+
通过 `five.modelScene.parameter.set('panoFilter', filter)` 绑定。
|
|
158
|
+
支持的参数如下:
|
|
159
|
+
- color: 颜色调整,包含色温 (Temperature) 和色调 (Tint)。
|
|
160
|
+
- highlightShadow: 高光和阴影的独立调节。包括高光 (Highlight) 和阴影 (Shadow) 全局(Global)。
|
|
161
|
+
- contrast: 对比度调整。
|
|
162
|
+
- saturation: 饱和度调整。
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
## 新增后处理效果 (Post-Processing Passes)
|
|
166
|
+
新增了三个可选的内置后处理 Pass,用于增强视觉效果。
|
|
167
|
+
|
|
168
|
+
- FlowingLight2DPass: 2D 流光效果,通常用于在屏幕空间绘制流动的光线(如道路流光)。
|
|
169
|
+
- FlowingLight3DPass: 3D 流光效果,基于深度缓冲区在三维模型表面绘制流光。
|
|
170
|
+
- GaussianBlurPass: 高斯模糊效果,可用于实现毛玻璃等视觉特效。
|
|
171
|
+
|
|
172
|
+
## 工具优化
|
|
173
|
+
### Work Viewer
|
|
174
|
+
> https://vradmin.lianjia.com/project/
|
|
175
|
+
- 支持 debug -> stateSync。可以打开两个页面,均开启 stateSync。两边同步相机状态。
|
|
176
|
+
- 支持 work.json 拖拽加载加载。
|
|
177
|
+
|
|
178
|
+
### Model Viewer
|
|
179
|
+
> https://vradmin.lianjia.com/poincare/
|
|
180
|
+
- 支持 debug -> stateSync。可以打开两个页面,均开启 stateSync。两边同步相机状态。
|
|
181
|
+
- 支持 模型文件拖拽加载加载。
|
|
182
|
+
|
|
183
|
+
### glTF Viewer
|
|
184
|
+
> https://vradmin.lianjia.com/gltf/
|
|
185
|
+
- 支持 debug -> stateSync。可以打开两个页面,均开启 stateSync。两边同步相机状态。
|
|
186
|
+
- 支持 模型文件拖拽加载加载。
|
|
187
|
+
- 支持 额外绑定动画文件(仅读取 gltf 的 animations 的部分,并绑定到当前的模型上)。
|
|
188
|
+
- 支持 额外绑定动画的单独播放和暂停。
|
|
189
|
+
|
|
190
|
+
## 友好文档
|
|
191
|
+
全面重构了文档结构,使其更适合 AI 辅助编程工具 (如 Cursor, Copilot) 阅读和索引。
|
|
192
|
+
|
|
193
|
+
- 文档目录迁移至 ai_guides/,并在 package.json 中新增 ai 字段指向该目录。
|
|
194
|
+
- 文档内容包含源码链接 (source 字段),直接指向对应的 .ts 定义文件。
|
|
195
|
+
- 提供了更清晰的 API 定义和概念说明,例如新增了 ViewLayer 的详细文档。
|
|
196
|
+
- TypeScript 支持: 优化了 .d.ts 打包方式,声明文件现在与源码文件一一对应,提升了 IDE 的跳转体验。
|
|
197
|
+
|
|
198
|
+
## 其他
|
|
199
|
+
1. 优化 mapview 下滚动缩放。避免滚落所发有时会退回的问题。
|
|
200
|
+
2. 优化 floorplan 从下向上看时的交互的屏幕上下滑动反人类下意识的问题。
|
|
201
|
+
3. 优化 camera.autoNearFar 的计算结果。优化对于小物品的 near 过远以及 出现 z-fighting 的问题。
|
|
202
|
+
4. 添加了 gesture.create 事件,发生在所有事件创建时。
|
|
203
|
+
5. gestureEvent.center gestureEvent.pointers 中加入了 buttons button shiftKey ctrlKey metaKey altKey 字段。
|
|
204
|
+
|
|
205
|
+
## 内部机制改动
|
|
206
|
+
1. glTF 加载 mesh / points 都将直接使用 PBM 材质,而不是作为 PBM_Mesh 扩展形式去替换覆盖使用three内置材质的方式。
|
|
207
|
+
2. 应用 animation pointer 以及 动画优化的原因。目前会重写 hack THREE.PropertyBinding.findNode。
|
|
208
|
+
3. 打包不再合并 .d.ts 文件。便于文档可以更便于找到对应的类型声明。
|
package/docs/assets/hierarchy.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
window.hierarchyData = "
|
|
1
|
+
window.hierarchyData = "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"
|
|
@@ -1 +1 @@
|
|
|
1
|
-
window.navigationData = "
|
|
1
|
+
window.navigationData = "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"
|