soonspacejs 2.5.28 → 2.5.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soonspacejs",
-  "version": "2.5.28",
+  "version": "2.5.29",
   "homepage": "http://www.xwbuilders.com:8800/",
   "description": "soonspacejs 2.x",
   "module": "./dist/index.esm.js",
@@ -26,5 +26,5 @@
     "@tweenjs/tween.js": "^18.6.4",
     "@types/three": "0.141.0"
   },
-  "gitHead": "96bd42ee5258c343c59f1259edc734b4c3ac9007"
+  "gitHead": "4fa46d1ba47e974dc02e97db2712c243187cd3d0"
 }

package/types/Interface/viewport.d.ts

@@ -106,16 +106,15 @@ interface IntersectsOptions {
 }
 export interface BloomOptions {
     enabled?: boolean;
-    strength?: number;
     radius?: number;
+    intensity?: number;
     threshold?: number;
-}
-export interface SobelOptions {
-    enabled?: boolean;
+    smoothing?: number;
+    selection?: Object3D[];
+    opacity?: number;
 }
 export interface SSAOOptions {
     enabled?: boolean;
-    distanceScaling?: boolean;
     depthAwareUpsampling?: boolean;
     samples?: number;
     rings?: number;
@@ -136,6 +135,33 @@ export interface SSAOOptions {
     color?: IColor;
     resolutionScale?: number;
 }
+export interface SSROptions {
+    enabled?: boolean;
+    intensity?: number;
+    exponent?: number;
+    distance?: number;
+    fade?: number;
+    roughnessFade?: number;
+    thickness?: number;
+    ior?: number;
+    maxRoughness?: number;
+    maxDepthDifference?: number;
+    blend?: number;
+    correction?: number;
+    correctionRadius?: number;
+    blur?: number;
+    blurKernel?: number;
+    blurSharpness?: number;
+    jitter?: number;
+    jitterRoughness?: number;
+    steps?: number;
+    refineSteps?: number;
+    missedRays?: boolean;
+    useNormalMap?: boolean;
+    useRoughnessMap?: boolean;
+    resolutionScale?: number;
+    velocityResolutionScale?: number;
+}
 export interface ToneMappingOptions {
     type?: 'None' | 'Linear' | 'Reinhard' | 'Cineon' | 'ACESFilmic';
     exposure?: number;

package/types/Viewport/EffectManager.d.ts

@@ -11,11 +11,12 @@ declare class EffectManager {
     static CONSTANTS: {
         renderPass: string;
         normalPass: string;
-        depthDownsamplingPass: string;
         effectPass: string;
         smaaEffect: string;
         ssaoEffect: string;
         outlineEffect: string;
+        ssrEffect: string;
+        bloomEffect: string;
     };
     effectComposer: EffectComposer;
     passesMap: Map<string, Pass>;
@@ -35,11 +36,12 @@ declare class EffectManager {
     private _initPasses;
     private _initRenderPass;
     private _initNormalPass;
-    private _initDownSamplingPass;
     private _initEffectPass;
     private _initEffects;
     private _initSMAAEffect;
-    private _initSSAOEffect;
+    private _initSSREffect;
+    private _initBloomEffect;
     private _initOutlineEffect;
+    private _initSSAOEffect;
 }
 export default EffectManager;

package/types/Viewport/index.d.ts

@@ -9,7 +9,7 @@ import CameraManager from './CameraManager';
 import EffectManager from './EffectManager';
 import { Controls } from '../Controls';
 import { Model } from '../Library';
-import { IColorSpace, SkyOptions, IColor, OffsetPoint, SceneEventType, Position, ViewportOptions, ViewportState, ModelAnimationFindFunc, SignalsState, ToneMappingOptions, SSAOOptions, IntersectsOptions } from '../Interface';
+import { IColorSpace, SkyOptions, IColor, OffsetPoint, SceneEventType, Position, ViewportOptions, ViewportState, ModelAnimationFindFunc, SignalsState, ToneMappingOptions, SSAOOptions, SSROptions, BloomOptions, IntersectsOptions } from '../Interface';
 import Info from './Info';
 import { ViewHelper } from './ViewHelper';
 export declare const innerRenderState: {
@@ -57,8 +57,8 @@ declare class Viewport {
     /**
      ***************************** post-processing ***************************
      */
-    setSobel(): void;
-    setBloom(): void;
+    setSSR(options?: SSROptions): void;
+    setBloom(options?: BloomOptions): void;
     setSSAO(options?: SSAOOptions): void;
     /**
      ***************************** renderer ***************************

package/types/index.d.ts

@@ -7,6 +7,7 @@
                                |_|                   |__/
 */
 import { TransformControls } from 'three/examples/jsm/controls/TransformControls.js';
+import { Reflector } from 'three/examples/jsm/objects/Reflector.js';
 import { Object3D, Vector3, Euler, Box3, AnimationClip, AnimationAction, Light, AmbientLight, DirectionalLight, HemisphereLight, SpotLight, PointLight, RectAreaLight } from 'three';
 import * as shared from './Shared';
 import Animation from './Animation';
@@ -14,7 +15,7 @@ import * as library from './Library';
 import { BaseObject3D, BaseObject3DInfo, Model, ModelInfo, Poi, PoiInfo, PoiNode, PoiNodeInfo, Topology, TopologyInfo, Group, GroupInfo, Canvas3D, Canvas3DInfo, PluginObject, PluginObjectInfo } from './Library';
 import Viewport from './Viewport';
 import Manager from './Manager';
-import { ViewportOptions, SceneGlobalEvents, PluginsConstructor, IColor, Position, Rotation, OffsetPoint, AnimationOptions, ModelAnimationFindFunc, TopologyNodeInfo, CameraViewpointData, CameraTargetViewData, FlyToViewpoint, FlyToObjOptions, SurroundOptions, LabelOptions, EdgeSelectOptions, StrokeSelectOptions, OpacitySelectOptions, HighlightSelectOptions, EmissiveSelectOptions, FogOptions, UserDataPropertyFindFunc, AmbientLightOptions, DirectionalLightOptions, HemisphereLightOptions, SpotLightOptions, PointLightOptions, CloneModelInfo, ClonePoiInfo, ShortestPathInfo, ShortestPathByMultipleStartPoints, ShortestPathByMultipleEndPoints, TopologyInfoForGml, GridHelperOptions, AxesHelperOptions, BoxHelperOptions, PlaneHelperOptions, GroundHelperOptions, DirectionalLightHelperOptions, HemisphereLightHelperOptions, SpotLightHelperOptions, PointLightHelperOptions, SignalsState, ControlsOptions, RectAreaLightOptions, RectAreaLightHelperOptions, SkyOptions, IColorSpace, ToneMappingOptions, SSAOOptions } from './Interface';
+import { ViewportOptions, SceneGlobalEvents, PluginsConstructor, IColor, Position, Rotation, OffsetPoint, AnimationOptions, ModelAnimationFindFunc, TopologyNodeInfo, CameraViewpointData, CameraTargetViewData, FlyToViewpoint, FlyToObjOptions, SurroundOptions, LabelOptions, EdgeSelectOptions, StrokeSelectOptions, OpacitySelectOptions, HighlightSelectOptions, EmissiveSelectOptions, FogOptions, UserDataPropertyFindFunc, AmbientLightOptions, DirectionalLightOptions, HemisphereLightOptions, SpotLightOptions, PointLightOptions, CloneModelInfo, ClonePoiInfo, ShortestPathInfo, ShortestPathByMultipleStartPoints, ShortestPathByMultipleEndPoints, TopologyInfoForGml, GridHelperOptions, AxesHelperOptions, BoxHelperOptions, PlaneHelperOptions, GroundHelperOptions, DirectionalLightHelperOptions, HemisphereLightHelperOptions, SpotLightHelperOptions, PointLightHelperOptions, SignalsState, ControlsOptions, RectAreaLightOptions, RectAreaLightHelperOptions, SkyOptions, IColorSpace, ToneMappingOptions, SSROptions, SSAOOptions, BloomOptions } from './Interface';
 export declare type InitOptions = ViewportOptions;
 export declare type InitEvents = SceneGlobalEvents;
 export interface SoonSpaceConstructor {
@@ -25,7 +26,9 @@ export interface SoonSpaceConstructor {
 import * as THREE from 'three';
 export * from 'three';
 export * from './Interface';
-import { BoxSpace, FindObjectsNearPosition, FindNearbyObjects } from './tools/index';
+import { BoxSpace, FindObjectsNearPosition, FindNearbyObjects } from './tools/find-objects';
+import { CreatePoiMeshOptions, CreatePolygonPoiMeshOptions } from './tools/poi-mesh';
+export * from './tools/units';
 declare global {
     interface Window {
         THREE: typeof THREE;
@@ -196,6 +199,7 @@ export declare class SoonSpace {
     readonly utils: typeof shared;
     readonly THREE_PLUGINS: {
         TransformControls: typeof TransformControls;
+        Reflector: typeof Reflector;
     };
     readonly version: string;
     readonly options: InitOptions;
@@ -265,15 +269,19 @@ export declare class SoonSpace {
     /******/
     /******/
     /**
-     * 设置边缘检测
+     * 设置空间反射
      * @param options
      */
-    setSobel(): void;
+    setSSR(options?: SSROptions): void;
     /**
      * 设置泛光
      * @param bloom
      */
-    setBloom(): void;
+    setBloom(options?: BloomOptions): void;
+    /**
+     * 环境光遮蔽
+     * @param options
+     */
     setSSAO(options?: SSAOOptions): void;
     /**
      * 设置场景的颜色空间
@@ -943,6 +951,18 @@ export declare class SoonSpace {
      * 隐藏所有 PoiNode
      */
     hideAllPoiNode(): void;
+    /**
+     * 创建 poi mesh
+     * @param options
+     * @returns
+     */
+    createPoiMesh(options: CreatePoiMeshOptions): library.BaseMesh;
+    /**
+     * 创建多边形 poi mesh
+     * @param options
+     * @returns
+     */
+    createPolygonPoiMesh(options: CreatePolygonPoiMeshOptions): library.BaseMesh;
     /******/
     /******/
     /******* Canvas3D methods */

package/types/tools/poi-mesh.d.ts

@@ -0,0 +1,41 @@
+import { Texture, VideoTexture, CanvasTexture, MeshPhongMaterialParameters, MeshBasicMaterialParameters } from 'three';
+import { IVector3, Level } from '../Interface';
+import { BaseMesh } from '../Library';
+export declare type TextureImage = string | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement;
+export interface PoiMeshOptions extends MeshBasicMaterialParameters, MeshPhongMaterialParameters {
+    /**
+     * 图片的url 或者是  HTMLImageElement | HTMLCanvasElement | HTMLVideoElement
+     */
+    image: TextureImage;
+    /**
+     * 是否需要有灯光才能显示
+     */
+    needLight?: boolean;
+    id: string | number;
+    name?: string;
+    userData?: any;
+    level?: Level;
+    visible?: boolean;
+}
+export interface CreatePoiMeshOptions extends PoiMeshOptions {
+    position?: IVector3;
+    rotation?: IVector3;
+    width?: number;
+    height?: number;
+}
+/**
+ * 创建 poi mesh
+ * @param options
+ * @returns
+ */
+export declare function createPoiMesh(options: CreatePoiMeshOptions): BaseMesh;
+export declare function createTexture(image: string | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement): Texture | CanvasTexture | VideoTexture;
+export interface CreatePolygonPoiMeshOptions extends PoiMeshOptions {
+    points: IVector3[];
+}
+/**
+ * 创建多边形 poi mesh
+ * @param options
+ * @returns
+ */
+export declare function createPolygonPoiMesh(options: CreatePolygonPoiMeshOptions): BaseMesh;

package/types/tools/units.d.ts

@@ -0,0 +1,22 @@
+import { Vector3, Box2, Matrix3, Matrix4, ShapeGeometry } from 'three';
+export declare function getPolygonGeometryInfo(points: Vector3[]): {
+    geometry: ShapeGeometry;
+    polygonBox: Box2;
+    modelMatrix: Matrix4;
+    planeMatrix: Matrix4;
+    projectionMatrix: Matrix4;
+    position: Vector3;
+};
+/**
+ * 创建平面投影矩阵
+ * @param points
+ */
+export declare function createPlaneMatrix(points: Vector3[]): Matrix3;
+/**
+ * 创建 uv 变换矩阵
+ * @remarks
+ * 需要对热力图数据进行y值翻转
+ * @param points
+ * @returns
+ */
+export declare function createUVMatrix(box: Box2): Matrix3;