@realsee/vreo 0.2.0-alpha.13 → 0.2.0-alpha.16

package/lib/Player/modules/keyframes/PanoTextLabel/index.js

@@ -7,22 +7,24 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.PanoTextLabel = PanoTextLabel;
 
-var _classnames = _interopRequireDefault(require("classnames"));
-
 var React = _interopRequireWildcard(require("react"));
 
-var _three = require("three");
+var THREE = _interopRequireWildcard(require("three"));
 
-var _VreoUnit = require("../../../../typings/VreoUnit");
+var _reactDom = _interopRequireDefault(require("react-dom"));
 
 var _hooks = require("../../../hooks");
 
-function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+var _CSS3DRenderPlugin = require("../../../../fivePlugins/CSS3DRenderPlugin");
 
-function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+var _VreoUnit = require("../../../../typings/VreoUnit");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
@@ -35,15 +37,62 @@ function _iterableToArrayLimit(arr, i) { var _i = arr == null ? null : typeof Sy
 
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 
-function PanoTextLabel() {
-  var _React$useState = React.useState(null),
-      _React$useState2 = _slicedToArray(_React$useState, 2),
-      state = _React$useState2[0],
-      setState = _React$useState2[1];
+/**
+ * 通过传入中心点确定矩形框架容器的四个点：
+ *  1. 已知矩形长宽和中心点
+ *  2. 借助planeGeometry生成垂直相机视角的平面上的四个点
+ *  3. 通过向量相加，平行四边形法则获取到移动position后的面上四个点
+ */
+var calcPoints = function calcPoints(centerPoint, normal, wrapperLength, wrapperWidth) {
+  // 375px 对应 1m
+  var length = wrapperLength / 375;
+  var width = wrapperWidth / 375;
+  var geometry = new THREE.PlaneGeometry(length, width);
+
+  if (normal) {
+    var lookPoint = new THREE.Vector3(normal.x + centerPoint.x, normal.y + centerPoint.y, normal.z + centerPoint.z);
+    geometry.lookAt(lookPoint);
+  } // const pointgeometry = new THREE.Geometry()
+  // pointgeometry.vertices.push(cameraPosition)
+  // const pointmaterial = new THREE.PointsMaterial({
+  //   color: 0xffffff,
+  //   size: 0.4,
+  // })
+  // _point = new THREE.Points(pointgeometry, pointmaterial)
+  // console.log(cameraPosition)
+
+
+  var material = new THREE.MeshBasicMaterial({
+    color: 0xffff00,
+    side: THREE.DoubleSide
+  });
+  var plane = new THREE.Mesh(geometry, material);
+  var v0 = centerPoint.clone();
+  plane.position.copy(v0); // 计算传入的四个点的坐标
+
+  var _plane$geometry$verti = _slicedToArray(plane.geometry.vertices, 4),
+      v1 = _plane$geometry$verti[0],
+      v2 = _plane$geometry$verti[1],
+      v3 = _plane$geometry$verti[2],
+      v4 = _plane$geometry$verti[3];
+
+  var downLeft = v0.clone().add(v4);
+  var downRight = v0.clone().add(v3);
+  var upLeft = v0.clone().add(v2);
+  var upRight = v0.clone().add(v1); // 插件使用要求：矩形四个点位数据，顺序为**必须**为左下、右下、右上、左上
+
+  return [downLeft, downRight, upRight, upLeft];
+};
+/**
+ * 空间文本标签。
+ */
 
+
+function PanoTextLabel() {
   var timeoutRef = React.useRef();
   var controller = (0, _hooks.useController)();
-  var project2d = (0, _hooks.useFiveProject2d)();
+  var five = (0, _hooks.useFiveInstance)();
+  var ref = React.useRef();
   React.useEffect(function () {
     var _controller$configs;
 
@@ -52,32 +101,51 @@ function PanoTextLabel() {
     }
 
     var callback = function callback(keyframe) {
+      var _panoTextLabelData$no, _panoTextLabelData$no2, _panoTextLabelData$no3;
+
       var start = keyframe.start,
           end = keyframe.end,
           data = keyframe.data;
-      var panoTextLabelData = data;
+      var panoTextLabelData = data; // 增加无文本情况的判断
+
+      if (data.text === '') return;
       var _panoTextLabelData$ve = panoTextLabelData.vertex,
           x = _panoTextLabelData$ve.x,
           y = _panoTextLabelData$ve.y,
           z = _panoTextLabelData$ve.z;
-      var res = project2d(new _three.Vector3(x, y, z));
-      if (!res) return;
-      var left = res.x,
-          top = res.y; // Object.assign(window, { $PanoTextLabel: { setState } })
-
-      setState({
-        left: left,
-        top: top,
-        text: data.text || '',
-        fontSize: data.fontSize || 16
-      });
+      var centerPoint = new THREE.Vector3(x, y, z);
+      var normal = new THREE.Vector3((_panoTextLabelData$no = panoTextLabelData.normal) === null || _panoTextLabelData$no === void 0 ? void 0 : _panoTextLabelData$no.x, (_panoTextLabelData$no2 = panoTextLabelData.normal) === null || _panoTextLabelData$no2 === void 0 ? void 0 : _panoTextLabelData$no2.y, (_panoTextLabelData$no3 = panoTextLabelData.normal) === null || _panoTextLabelData$no3 === void 0 ? void 0 : _panoTextLabelData$no3.z); // 生成传入的四个点，将文本框最大宽度定在200px，最高高度在30px
+
+      var wrapperLength = 200;
+      var wrapperWidth = 30;
+      var points = calcPoints(centerPoint, panoTextLabelData.normal && normal, wrapperLength, wrapperWidth);
+      if (!ref.current) ref.current = (0, _CSS3DRenderPlugin.CSS3DRenderPlugin)(five);
+      var container = ref.current.create3DDomContainer(points);
+      var css3DObject = container === null || container === void 0 ? void 0 : container.css3DObject; // 将获取的mesh进行旋转操作，根据欧拉角去进行mesh的变换
+
+      if (data.quaternion) {
+        var quaternion = new THREE.Quaternion(data.quaternion.x, data.quaternion.y, data.quaternion.z, data.quaternion.w);
+        css3DObject === null || css3DObject === void 0 ? void 0 : css3DObject.quaternion.copy(quaternion);
+      }
+
+      if (container !== null && container !== void 0 && container.container) _reactDom["default"].render( /*#__PURE__*/React.createElement("div", {
+        className: "PanoTextLabel PanoTextLabel--notHidden"
+      }, /*#__PURE__*/React.createElement("div", {
+        className: "PanoTextLabel-wrapper"
+      }, /*#__PURE__*/React.createElement("div", {
+        style: {
+          fontSize: "".concat(data.fontSize || 16, "px")
+        },
+        className: "PanoText-innerText"
+      }, data.text || ''))), container === null || container === void 0 ? void 0 : container.container);
       timeoutRef.current = setTimeout(function () {
-        return setState(null);
+        var _ref$current;
+
+        (_ref$current = ref.current) === null || _ref$current === void 0 ? void 0 : _ref$current.disposeAll();
       }, end - start);
     };
 
-    controller.on(_VreoUnit.VreoKeyframeEnum.PanoTextLabel, callback); // Object.assign(window, { $panoTextLabel: { setState } })
-
+    controller.on(_VreoUnit.VreoKeyframeEnum.PanoTextLabel, callback);
     return function () {
       controller.off(_VreoUnit.VreoKeyframeEnum.PanoTextLabel, callback);
 
@@ -86,20 +154,5 @@ function PanoTextLabel() {
       }
     };
   }, [controller]);
-  return /*#__PURE__*/React.createElement("div", {
-    className: (0, _classnames["default"])('PanoTextLabel', {
-      'PanoTextLabel--notHidden': state
-    }),
-    style: {
-      left: ((state === null || state === void 0 ? void 0 : state.left) || 0) + 'px',
-      top: ((state === null || state === void 0 ? void 0 : state.top) || 0) + 'px'
-    }
-  }, /*#__PURE__*/React.createElement("div", {
-    className: "PanoTextLabel-wrapper"
-  }, /*#__PURE__*/React.createElement("div", {
-    style: {
-      fontSize: "".concat((state === null || state === void 0 ? void 0 : state.fontSize) || 16, "px")
-    },
-    className: "PanoText-innerText"
-  }, (state === null || state === void 0 ? void 0 : state.text) || '')));
+  return /*#__PURE__*/React.createElement(React.Fragment, null);
 }

package/lib/fivePlugins/CSS3DRenderPlugin/centerPoint.d.ts

@@ -0,0 +1,2 @@
+import { Vector3 } from 'three';
+export default function centerPoint(point1: Vector3, point2: Vector3): Vector3;

package/lib/fivePlugins/CSS3DRenderPlugin/centerPoint.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = centerPoint;
+
+var _three = require("three");
+
+function centerPoint(point1, point2) {
+  return new _three.Vector3((point1.x + point2.x) / 2, (point1.y + point2.y) / 2, (point1.z + point2.z) / 2);
+}

package/lib/fivePlugins/CSS3DRenderPlugin/createResizeObserver.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @description: 简陋的 ResizeObserver polyfill
+ */
+export default function createResizeObserver(func: () => any, element?: HTMLElement): {
+    observe: () => void;
+    unobserve: () => void;
+};

package/lib/fivePlugins/CSS3DRenderPlugin/createResizeObserver.js

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = createResizeObserver;
+
+/**
+ * @description: 简陋的 ResizeObserver polyfill
+ */
+function createResizeObserver(func, element) {
+  if (!element || typeof ResizeObserver === 'undefined') {
+    return {
+      observe: function observe() {
+        return window.addEventListener('resize', func);
+      },
+      unobserve: function unobserve() {
+        return window.removeEventListener('resize', func);
+      }
+    };
+  } else {
+    var observer = new ResizeObserver(func);
+    return {
+      observe: function observe() {
+        return observer.observe(element);
+      },
+      unobserve: function unobserve() {
+        return observer.unobserve(element);
+      }
+    };
+  }
+}

package/lib/fivePlugins/CSS3DRenderPlugin/evenNumber.d.ts

@@ -0,0 +1,3 @@
+export default function evenNumber(num: number, config?: {
+    smaller?: boolean;
+}): number;

package/lib/fivePlugins/CSS3DRenderPlugin/evenNumber.js

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = evenNumber;
+
+function evenNumber(num, config) {
+  var roundNum = Math.round(num);
+  return roundNum % 2 === 0 ? roundNum : roundNum + Number(config !== null && config !== void 0 && config.smaller ? -1 : 1);
+}

package/lib/fivePlugins/CSS3DRenderPlugin/index.d.ts

@@ -0,0 +1,56 @@
+import { FivePlugin } from '@realsee/five';
+import { Vector3 } from 'three';
+import { CSS3DObject } from 'three/examples/jsm/renderers/CSS3DRenderer';
+/**
+ * 三维向量
+ */
+export interface Vector3Position {
+    x: number;
+    y: number;
+    z: number;
+}
+export declare type CSS3DRenderPluginParameterType = undefined;
+export interface CSS3DRenderPluginExportType {
+    /**
+     * @description: 根据传入的四个点位创建一个3d dom容器，可以通过ReactDom.render()的方式将react组件放到容器中
+     * @param {Five} five
+     * @param {Vector3[] | Vector3Position[]} points: 矩形四个点坐标
+     * @param {number} config.ratio: 1px对应多少米，默认为 0.002，即1px对应2mm
+     * @param {number} config.dpr: dpr, 默认为1
+     * @param {HTMLElement} config.container: HTMLElement
+     * @param {number} config.autoRender: 默认为true，如果需要手动render则传false
+     * @param {'front' | 'behind'} config.mode: 两种模式
+     * @param {HTMLElement} config.behindFiveContainer: 如果config.mode为'behind'，需要传入容器，并确保此容器位five下方，且中间没有其他dom元素遮挡
+     * @return {{ container: HTMLElement; dispose: () => void }}: container: dom容器, dispose: 清理函数
+     */
+    create3DDomContainer: (points: Vector3[] | Vector3Position[], config?: {
+        ratio?: number;
+        dpr?: number;
+        autoRender?: boolean;
+        container?: HTMLElement;
+        [key: string]: any;
+    } & ({
+        mode?: 'front';
+    } | {
+        mode: 'behind';
+        behindFiveContainer: HTMLElement;
+    })) => {
+        container: HTMLElement;
+        dispose: () => void;
+        css3DObject: CSS3DObject;
+        render?: () => void;
+    } | void;
+    /**
+     * @description: 销毁所有的渲染内容
+     * @return {void}
+     */
+    disposeAll: () => void;
+}
+/**
+ * **CSS3DRenderPlugin** 提供矩形区域（三维空间四个坐标点），你可以在此矩形区域中渲染 DOM 内容。
+ * 实现原理参考[CSS3DRenderer](https://threejs.org/docs/index.html?q=CSS3D#examples/en/renderers/CSS3DRenderer)。
+ *
+ * @returns
+ */
+export declare const CSS3DRenderPlugin: FivePlugin<CSS3DRenderPluginParameterType, CSS3DRenderPluginExportType>;
+export default CSS3DRenderPlugin;

package/lib/fivePlugins/CSS3DRenderPlugin/index.js

@@ -0,0 +1,275 @@
+"use strict";
+
+function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.CSS3DRenderPlugin = void 0;
+
+var THREE = _interopRequireWildcard(require("three"));
+
+var _CSS3DRenderer = require("three/examples/jsm/renderers/CSS3DRenderer");
+
+var _evenNumber = _interopRequireDefault(require("./evenNumber"));
+
+var _centerPoint = _interopRequireDefault(require("./centerPoint"));
+
+var _transformPositionToVector = _interopRequireDefault(require("./transformPositionToVector3"));
+
+var _createResizeObserver = _interopRequireDefault(require("./createResizeObserver"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+/**
+ * **CSS3DRenderPlugin** 提供矩形区域（三维空间四个坐标点），你可以在此矩形区域中渲染 DOM 内容。
+ * 实现原理参考[CSS3DRenderer](https://threejs.org/docs/index.html?q=CSS3D#examples/en/renderers/CSS3DRenderer)。
+ *
+ * @returns
+ */
+var CSS3DRenderPlugin = function CSS3DRenderPlugin(five) {
+  var state = {
+    disposeCallbacks: []
+  };
+
+  var create3DDomContainer = function create3DDomContainer() {
+    var _five$model, _five$model2, _config$autoRender;
+
+    for (var _len = arguments.length, params = new Array(_len), _key = 0; _key < _len; _key++) {
+      params[_key] = arguments[_key];
+    }
+
+    var points = params[0].map(function (point) {
+      return point instanceof THREE.Vector3 ? point : (0, _transformPositionToVector["default"])(point);
+    });
+    var config = params[1];
+    if ((points === null || points === void 0 ? void 0 : points.length) < 4) return console.error('points must be equal or greater than than 4');
+    if (!(five !== null && five !== void 0 && (_five$model = five.model) !== null && _five$model !== void 0 && _five$model.loaded)) return console.error('five.model.loaded is: ', five === null || five === void 0 ? void 0 : (_five$model2 = five.model) === null || _five$model2 === void 0 ? void 0 : _five$model2.loaded);
+    var fiveElement = five.getElement();
+    if (!fiveElement) return console.error('five.getElement() is ' + fiveElement);
+    var disposers = [];
+    var ratio = (config === null || config === void 0 ? void 0 : config.ratio) || 0.00216;
+    if (ratio <= 0.00215) console.warn('if you need click css3DElement on safari, ratio must be greater than 0.00215');
+    var dpr = (config === null || config === void 0 ? void 0 : config.dpr) || 1;
+    var mode = (config === null || config === void 0 ? void 0 : config.mode) || 'front';
+    var autoRender = (_config$autoRender = config === null || config === void 0 ? void 0 : config.autoRender) !== null && _config$autoRender !== void 0 ? _config$autoRender : true;
+    var behindFiveContainer = (config === null || config === void 0 ? void 0 : config.behindFiveContainer) || fiveElement.parentElement || document.body;
+    var container = (config === null || config === void 0 ? void 0 : config.container) || document.createElement('div');
+    container.classList.add('__Dnalogel-plugin--CSS3DRenderPlugin'); // 获取css3DObject, 如果mode为behind的话，一起获取mesh
+
+    var _createObject = createObject(points, {
+      ratio: ratio,
+      dpr: dpr,
+      container: container,
+      mode: mode
+    }),
+        css3DObject = _createObject.css3DObject,
+        mesh = _createObject.mesh; // ======= INIT START =======
+
+
+    var resizeObserver;
+    var frontModeUnInited = mode === 'front' && !state.frontMode;
+    var behindModeUnInited = mode === 'behind' && !state.behindMode;
+    var inited = !(frontModeUnInited || behindModeUnInited);
+    var stopRenderFlag = false;
+    var requestAnimationFrameId = null;
+
+    if (behindModeUnInited) {
+      state.behindMode = {
+        scene: new THREE.Scene(),
+        css3DRenderer: new _CSS3DRenderer.CSS3DRenderer()
+      };
+    }
+
+    if (frontModeUnInited) {
+      state.frontMode = {
+        scene: new THREE.Scene(),
+        css3DRenderer: new _CSS3DRenderer.CSS3DRenderer()
+      };
+    }
+
+    var _ref = mode === 'behind' ? state.behindMode : state.frontMode,
+        scene = _ref.scene,
+        css3DRenderer = _ref.css3DRenderer;
+
+    var render = function () {
+      if (!inited) {
+        var css3DRendererSetSize = function css3DRendererSetSize() {
+          // 这里evenNumber策略是遇到奇数会加1，不知道为啥会触发滚动条显示，导致fiveElement变小，fiveElement变小又触发了这里的resize，宽高变小，滚动条消失，然后又触发resize。。。无限循环
+          // 为了规避上面这种情况，evenNumber设置了一个参数，遇到奇数可选择减一
+          var rendererWidth = (0, _evenNumber["default"])(fiveElement.clientWidth, {
+            smaller: true
+          });
+          var rendererHeight = (0, _evenNumber["default"])(fiveElement.clientHeight, {
+            smaller: true
+          });
+          css3DRenderer.setSize(rendererWidth, rendererHeight);
+        };
+
+        css3DRendererSetSize();
+        resizeObserver = (0, _createResizeObserver["default"])(css3DRendererSetSize, fiveElement);
+        css3DRenderer.domElement.style.position = 'absolute';
+        css3DRenderer.domElement.style.top = '0';
+        css3DRenderer.domElement.style.userSelect = 'none';
+        css3DRenderer.domElement.style.pointerEvents = 'none';
+
+        var renderEveryFrame = function renderEveryFrame() {
+          if (stopRenderFlag) return;
+          requestAnimationFrameId = requestAnimationFrame(renderEveryFrame);
+          css3DRenderer.render(scene, five.camera);
+        };
+
+        return function () {
+          var _resizeObserver, _resizeObserver$obser;
+
+          scene.add(css3DObject);
+          (_resizeObserver = resizeObserver) === null || _resizeObserver === void 0 ? void 0 : (_resizeObserver$obser = _resizeObserver.observe) === null || _resizeObserver$obser === void 0 ? void 0 : _resizeObserver$obser.call(_resizeObserver);
+          renderEveryFrame();
+
+          if (mode === 'behind' && mesh) {
+            five.scene.add(mesh);
+            disposers.push(function () {
+              return mesh && five.scene.remove(mesh);
+            });
+          }
+        };
+      } else {
+        return function () {
+          scene.add(css3DObject);
+        };
+      }
+    }();
+
+    if (frontModeUnInited) {
+      var wrapper = fiveElement.parentElement || document.body;
+      wrapper.appendChild(css3DRenderer.domElement);
+    }
+
+    if (behindModeUnInited) {
+      var _wrapper = behindFiveContainer;
+
+      _wrapper.appendChild(css3DRenderer.domElement);
+    } // ======= INIT END =======
+
+
+    var dispose = function dispose() {
+      stopRenderFlag = true;
+      disposers.forEach(function (d) {
+        return d === null || d === void 0 ? void 0 : d();
+      });
+      scene.remove(css3DObject);
+      if (typeof requestAnimationFrameId === 'number') cancelAnimationFrame(requestAnimationFrameId);
+
+      if (scene.children.length === 0) {
+        css3DRenderer.domElement.remove();
+        if (mode === 'front') state.frontMode = undefined;
+        if (mode === 'behind') state.behindMode = undefined;
+
+        if (!state.behindMode && !state.frontMode) {
+          var _resizeObserver2, _resizeObserver2$unob;
+
+          (_resizeObserver2 = resizeObserver) === null || _resizeObserver2 === void 0 ? void 0 : (_resizeObserver2$unob = _resizeObserver2.unobserve) === null || _resizeObserver2$unob === void 0 ? void 0 : _resizeObserver2$unob.call(_resizeObserver2);
+        }
+      }
+
+      return true;
+    };
+
+    var idx = state.disposeCallbacks.findIndex(function (item) {
+      return item === dispose;
+    });
+
+    if (idx !== -1) {
+      state.disposeCallbacks.splice(idx, 1);
+    } else {
+      state.disposeCallbacks.push(dispose);
+    }
+
+    if (autoRender) render();
+    return {
+      container: container,
+      dispose: dispose,
+      css3DObject: css3DObject,
+      render: autoRender ? undefined : render
+    };
+  };
+
+  var createObject = function createObject(points, config) {
+    var ratio = config.ratio,
+        dpr = config.dpr,
+        element = config.container,
+        mode = config.mode;
+    var planeWidth = points[0].distanceTo(points[1]);
+    var planeHeight = points[1].distanceTo(points[2]);
+    var domWidthPx = (0, _evenNumber["default"])(planeWidth / ratio * dpr);
+    var domHeightPx = (0, _evenNumber["default"])(planeHeight / ratio * dpr);
+    var css3DObject = new _CSS3DRenderer.CSS3DObject(element);
+    css3DObject.scale.set(ratio, ratio, ratio);
+    element.style.width = domWidthPx + 'px';
+    element.style.height = domHeightPx + 'px';
+    element.style.pointerEvents = 'none';
+    var centerPosition = (0, _centerPoint["default"])(points[0], points[2]);
+    var vector01 = points[1].clone().sub(points[0]); // 点0 -> 点1 的向量
+
+    var vector12 = points[2].clone().sub(points[1]); // 点1 -> 点2 的向量
+    // 旋转
+
+    var rotateXAngle = new THREE.Vector3(0, 1, 0).angleTo(new THREE.Vector3(0, vector12.y, vector12.z));
+    var rotateYAngle = new THREE.Vector3(1, 0, 0).angleTo(new THREE.Vector3(vector01.x, 0, vector01.z));
+    var rotateZAngle = vector01.angleTo(new THREE.Vector3(vector01.x, 0, vector01.z));
+    /**
+     * [0,1,0] => [0,0,1]  为rolate Worldx正方向
+     * [0,0,1] => [0,1,0]  为rolate Worldy正方向
+     * [0,1,1] => [-1,0,0] 为rolate Worldz正方向
+     */
+
+    var rotateX = (vector12.z > 0 ? -1 : 1) * rotateXAngle;
+    var rotateY = (vector01.z < 0 ? 1 : -1) * rotateYAngle;
+    var rotateZ = (vector01.x > 0 && vector01.y < 0 || vector01.x < 0 && vector01.y > 0 ? -1 : 1) * rotateZAngle;
+    css3DObject.rotateOnWorldAxis(new THREE.Vector3(1, 0, 0), rotateX); // x
+
+    css3DObject.rotateOnWorldAxis(new THREE.Vector3(0, 1, 0), rotateY); // y
+
+    css3DObject.rotateOnWorldAxis(new THREE.Vector3(0, 0, 1), rotateZ); // z
+
+    css3DObject.position.set(centerPosition.x, centerPosition.y, centerPosition.z);
+    var mesh;
+
+    if (mode === 'behind') {
+      var material = new THREE.MeshBasicMaterial({
+        opacity: 0,
+        transparent: false,
+        side: THREE.DoubleSide
+      });
+      var geometry = new THREE.PlaneGeometry(domWidthPx, domHeightPx);
+      mesh = new THREE.Mesh(geometry, material);
+      mesh.name = 'CSS3DRenderPlugin-mesh';
+      mesh.position.copy(css3DObject.position);
+      mesh.rotation.copy(css3DObject.rotation);
+      mesh.scale.copy(css3DObject.scale);
+    }
+
+    return {
+      css3DObject: css3DObject,
+      mesh: mesh
+    };
+  };
+
+  return {
+    create3DDomContainer: create3DDomContainer,
+    disposeAll: function disposeAll() {
+      state.disposeCallbacks.forEach(function (d) {
+        return d === null || d === void 0 ? void 0 : d();
+      });
+      state.disposeCallbacks = [];
+    }
+  };
+};
+
+exports.CSS3DRenderPlugin = CSS3DRenderPlugin;
+var _default = CSS3DRenderPlugin;
+exports["default"] = _default;

package/lib/fivePlugins/CSS3DRenderPlugin/transformPositionToVector3.d.ts

@@ -0,0 +1,7 @@
+import { Vector3 } from 'three';
+declare const transformPositionToVector3: ({ x, y, z }: {
+    x: number;
+    y: number;
+    z: number;
+}) => Vector3;
+export default transformPositionToVector3;

package/lib/fivePlugins/CSS3DRenderPlugin/transformPositionToVector3.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _three = require("three");
+
+var transformPositionToVector3 = function transformPositionToVector3(_ref) {
+  var x = _ref.x,
+      y = _ref.y,
+      z = _ref.z;
+  return new _three.Vector3(x, y, z);
+};
+
+var _default = transformPositionToVector3;
+exports["default"] = _default;

package/lib/typings/VreoUnit.d.ts

@@ -172,12 +172,23 @@ export declare type ModelVideoData = {
     vertexs: QuadrangleVertexs | Vertexs;
     matrixWorld?: number[];
 };
+/**
+ * 四元数
+ */
+export declare type Quaternion = {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+};
 /**
  * 全景文本标签
  */
 export declare type PanoTextLabelData = {
     text: string;
     vertex: Vertex;
+    normal?: Vertex;
+    quaternion?: Quaternion;
     fontSize?: number;
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@realsee/vreo",
-  "version": "0.2.0-alpha.13",
+  "version": "0.2.0-alpha.16",
   "description": "Vreo (VR Video 缩写) 是基于如视三维渲染引擎 Five 和 用户界面构建库 React 实现的如视 3D 空间剧本播放器。",
   "keywords": [
     "realsee",