@anov/3d-ability 0.0.37 → 0.0.44

package/dist/animation/index.d.ts

@@ -0,0 +1,2 @@
+import AnimationMotion from './motion';
+export { AnimationMotion };

package/dist/animation/index.js

@@ -0,0 +1,3 @@
+import AnimationMotion from "./motion";
+export { AnimationMotion };
+//# sourceMappingURL=index.js.map

package/dist/animation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["AnimationMotion"],"sources":["../../src/animation/index.ts"],"sourcesContent":["import AnimationMotion from './motion'\n\nexport { AnimationMotion }"],"mappings":"AAAA,OAAOA,eAAe;AAEtB,SAASA,eAAe"}

package/dist/animation/motion/index.d.ts

@@ -0,0 +1,23 @@
+import type { Curve, Object3D } from '@anov/3d-core';
+import { CurvePath, Vector3 } from '@anov/3d-core';
+type Option = Partial<{
+    speed: number;
+    duration: number;
+    paused: boolean;
+    repeat: number;
+    yoyo: boolean;
+    ease: string;
+}>;
+type Points = [number, number, number];
+type Path = Points[] | Curve<Vector3>;
+declare class AnimationMotion {
+    moveManage: any;
+    constructor(object: Object3D, path: Path, option?: Option);
+    getPath(points?: Points[]): CurvePath<Vector3>;
+    setSpeed(speed: Number): void;
+    play(): void;
+    pause(): void;
+    restart(): void;
+    delete(): void;
+}
+export default AnimationMotion;

package/dist/animation/motion/index.js

@@ -0,0 +1,80 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { CurvePath, LineCurve3, Vector3, utils } from '@anov/3d-core';
+/**
+ * 默认参数值
+ * speed: 运行速度
+ * duration: 运行总时长，当存在总时长时，优先总时长，忽略speed值
+ */
+var defaultOption = {
+  speed: 2,
+  duration: null,
+  paused: false,
+  repeat: -1,
+  yoyo: false,
+  ease: 'power1.out'
+};
+var AnimationMotion = /*#__PURE__*/function () {
+  function AnimationMotion(object, path) {
+    var option = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+    _classCallCheck(this, AnimationMotion);
+    _defineProperty(this, "moveManage", void 0);
+    var curvePath;
+    if (Array.isArray(path)) curvePath = this.getPath(path);else curvePath = path;
+    this.moveManage = utils.moveWithLine(object, curvePath, _objectSpread(_objectSpread({}, defaultOption), option));
+  }
+  _createClass(AnimationMotion, [{
+    key: "getPath",
+    value: function getPath() {
+      var points = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+      var curvePath = new CurvePath();
+      if (points.length < 2) {
+        // 如果点数少于两个，返回空的 CurvePath
+        return curvePath;
+      }
+      points.forEach(function (point, index) {
+        var nextIndex = (index + 1) % points.length;
+        var startPoint = new Vector3().fromArray(point);
+        var endPoint = new Vector3().fromArray(points[nextIndex]);
+        var line = new LineCurve3(startPoint, endPoint);
+        curvePath.add(line);
+      });
+      return curvePath;
+    }
+  }, {
+    key: "setSpeed",
+    value: function setSpeed(speed) {
+      this.moveManage.setSpeed(speed);
+    }
+  }, {
+    key: "play",
+    value: function play() {
+      this.moveManage.continue();
+    }
+  }, {
+    key: "pause",
+    value: function pause() {
+      this.moveManage.stop();
+    }
+  }, {
+    key: "restart",
+    value: function restart() {
+      this.moveManage.restart();
+    }
+  }, {
+    key: "delete",
+    value: function _delete() {
+      this.moveManage.remove();
+    }
+  }]);
+  return AnimationMotion;
+}();
+export default AnimationMotion;
+//# sourceMappingURL=index.js.map

package/dist/animation/motion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CurvePath","LineCurve3","Vector3","utils","defaultOption","speed","duration","paused","repeat","yoyo","ease","AnimationMotion","object","path","option","arguments","length","undefined","_classCallCheck","_defineProperty","curvePath","Array","isArray","getPath","moveManage","moveWithLine","_objectSpread","_createClass","key","value","points","forEach","point","index","nextIndex","startPoint","fromArray","endPoint","line","add","setSpeed","play","continue","pause","stop","restart","_delete","remove"],"sources":["../../../src/animation/motion/index.ts"],"sourcesContent":["import type { Curve, Object3D } from '@anov/3d-core'\nimport { CurvePath, LineCurve3, Mesh, TubeGeometry, Vector3, utils } from '@anov/3d-core'\nimport type { LoopMode } from '../type'\n\ntype Option = Partial<{\n  speed: number\n  duration: number\n  paused: boolean\n  repeat: number\n  yoyo: boolean\n  ease: string\n}>\n\ntype Points = [number, number, number]\n\ntype Path = Points[] | Curve<Vector3>\n\n/**\n * 默认参数值\n * speed: 运行速度\n * duration: 运行总时长，当存在总时长时，优先总时长，忽略speed值\n */\nconst defaultOption: Option = {\n  speed: 2,\n  duration: null,\n  paused: false,\n  repeat: -1,\n  yoyo: false,\n  ease: 'power1.out',\n}\n\nclass AnimationMotion {\n  moveManage: any\n  constructor(object: Object3D, path: Path, option: Option = {}) {\n    let curvePath\n    if (Array.isArray(path))\n      curvePath = this.getPath(path as Points[])\n    else\n      curvePath = path as Curve<Vector3>\n\n    this.moveManage = utils.moveWithLine(object, curvePath, { ...defaultOption, ...option })\n  }\n\n  getPath(points: Points[] = []) {\n    const curvePath = new CurvePath<Vector3>()\n    if (points.length < 2) {\n      // 如果点数少于两个，返回空的 CurvePath\n      return curvePath\n    }\n\n    points.forEach((point, index) => {\n      const nextIndex = (index + 1) % points.length\n      const startPoint = new Vector3().fromArray(point)\n      const endPoint = new Vector3().fromArray(points[nextIndex])\n      const line = new LineCurve3(startPoint, endPoint)\n      curvePath.add(line)\n    })\n    return curvePath\n  }\n\n  setSpeed(speed: Number) {\n    this.moveManage.setSpeed(speed)\n  }\n\n  play() {\n    this.moveManage.continue()\n  }\n\n  pause() {\n    this.moveManage.stop()\n  }\n\n  restart() {\n    this.moveManage.restart()\n  }\n\n  delete() {\n    this.moveManage.remove()\n  }\n}\n\nexport default AnimationMotion"],"mappings":";;;;;;;;;AACA,SAASA,SAAS,EAAEC,UAAU,EAAsBC,OAAO,EAAEC,KAAK,QAAQ,eAAe;AAgBzF;AACA;AACA;AACA;AACA;AACA,IAAMC,aAAqB,GAAG;EAC5BC,KAAK,EAAE,CAAC;EACRC,QAAQ,EAAE,IAAI;EACdC,MAAM,EAAE,KAAK;EACbC,MAAM,EAAE,CAAC,CAAC;EACVC,IAAI,EAAE,KAAK;EACXC,IAAI,EAAE;AACR,CAAC;AAAA,IAEKC,eAAe;EAEnB,SAAAA,gBAAYC,MAAgB,EAAEC,IAAU,EAAuB;IAAA,IAArBC,MAAc,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;IAAAG,eAAA,OAAAP,eAAA;IAAAQ,eAAA;IAC3D,IAAIC,SAAS;IACb,IAAIC,KAAK,CAACC,OAAO,CAACT,IAAI,CAAC,EACrBO,SAAS,GAAG,IAAI,CAACG,OAAO,CAACV,IAAgB,CAAC,MAE1CO,SAAS,GAAGP,IAAsB;IAEpC,IAAI,CAACW,UAAU,GAAGrB,KAAK,CAACsB,YAAY,CAACb,MAAM,EAAEQ,SAAS,EAAAM,aAAA,CAAAA,aAAA,KAAOtB,aAAa,GAAKU,MAAM,CAAE,CAAC;EAC1F;EAACa,YAAA,CAAAhB,eAAA;IAAAiB,GAAA;IAAAC,KAAA,EAED,SAAAN,QAAA,EAA+B;MAAA,IAAvBO,MAAgB,GAAAf,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,EAAE;MAC3B,IAAMK,SAAS,GAAG,IAAIpB,SAAS,CAAU,CAAC;MAC1C,IAAI8B,MAAM,CAACd,MAAM,GAAG,CAAC,EAAE;QACrB;QACA,OAAOI,SAAS;MAClB;MAEAU,MAAM,CAACC,OAAO,CAAC,UAACC,KAAK,EAAEC,KAAK,EAAK;QAC/B,IAAMC,SAAS,GAAG,CAACD,KAAK,GAAG,CAAC,IAAIH,MAAM,CAACd,MAAM;QAC7C,IAAMmB,UAAU,GAAG,IAAIjC,OAAO,CAAC,CAAC,CAACkC,SAAS,CAACJ,KAAK,CAAC;QACjD,IAAMK,QAAQ,GAAG,IAAInC,OAAO,CAAC,CAAC,CAACkC,SAAS,CAACN,MAAM,CAACI,SAAS,CAAC,CAAC;QAC3D,IAAMI,IAAI,GAAG,IAAIrC,UAAU,CAACkC,UAAU,EAAEE,QAAQ,CAAC;QACjDjB,SAAS,CAACmB,GAAG,CAACD,IAAI,CAAC;MACrB,CAAC,CAAC;MACF,OAAOlB,SAAS;IAClB;EAAC;IAAAQ,GAAA;IAAAC,KAAA,EAED,SAAAW,SAASnC,KAAa,EAAE;MACtB,IAAI,CAACmB,UAAU,CAACgB,QAAQ,CAACnC,KAAK,CAAC;IACjC;EAAC;IAAAuB,GAAA;IAAAC,KAAA,EAED,SAAAY,KAAA,EAAO;MACL,IAAI,CAACjB,UAAU,CAACkB,QAAQ,CAAC,CAAC;IAC5B;EAAC;IAAAd,GAAA;IAAAC,KAAA,EAED,SAAAc,MAAA,EAAQ;MACN,IAAI,CAACnB,UAAU,CAACoB,IAAI,CAAC,CAAC;IACxB;EAAC;IAAAhB,GAAA;IAAAC,KAAA,EAED,SAAAgB,QAAA,EAAU;MACR,IAAI,CAACrB,UAAU,CAACqB,OAAO,CAAC,CAAC;IAC3B;EAAC;IAAAjB,GAAA;IAAAC,KAAA,EAED,SAAAiB,QAAA,EAAS;MACP,IAAI,CAACtB,UAAU,CAACuB,MAAM,CAAC,CAAC;IAC1B;EAAC;EAAA,OAAApC,eAAA;AAAA;AAGH,eAAeA,eAAe"}

package/dist/animation/type.d.ts

@@ -0,0 +1,10 @@
+export declare enum LoopMode {
+    none = "none",
+    yoyo = "yoyo",
+    repeat = "repeat"
+}
+export declare enum MotionState {
+    play = "play",
+    pause = "pause",
+    continue = "continue"
+}

package/dist/animation/type.js

@@ -0,0 +1,16 @@
+// 循环模式
+export var LoopMode = /*#__PURE__*/function (LoopMode) {
+  LoopMode["none"] = "none";
+  LoopMode["yoyo"] = "yoyo";
+  LoopMode["repeat"] = "repeat";
+  return LoopMode;
+}({});
+
+// 运行状态
+export var MotionState = /*#__PURE__*/function (MotionState) {
+  MotionState["play"] = "play";
+  MotionState["pause"] = "pause";
+  MotionState["continue"] = "continue";
+  return MotionState;
+}({});
+//# sourceMappingURL=type.js.map

package/dist/animation/type.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["LoopMode","MotionState"],"sources":["../../src/animation/type.ts"],"sourcesContent":["// 循环模式\nexport enum LoopMode {\n  none = 'none',\n  yoyo = 'yoyo',\n  repeat = 'repeat',\n}\n\n// 运行状态\nexport enum MotionState {\n  play = 'play',\n  pause = 'pause',\n  continue = 'continue',\n}"],"mappings":"AAAA;AACA,WAAYA,QAAQ,0BAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAARA,QAAQ;EAAA,OAARA,QAAQ;AAAA;;AAMpB;AACA,WAAYC,WAAW,0BAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA"}

package/dist/camera/FollowOrbitControls.d.ts

@@ -0,0 +1,28 @@
+import type { Camera } from '@anov/3d-core';
+import { EventDispatcher, Vector3 } from '@anov/3d-core';
+declare class FollowOrbitControls extends EventDispatcher {
+    radius: number;
+    target: Vector3;
+    private object;
+    private domElement;
+    private rotationH;
+    private rotationV;
+    private isMouseDown;
+    private isCurrentFirstMove;
+    private isGlobalFirstMove;
+    constructor(object: Camera, domElement: HTMLElement);
+    dispose(): void;
+    update(): void;
+    private getDistance;
+    private handleMouseup;
+    private handleMousedown;
+    /**
+     * handle Mousemove
+     * @param event
+     * @returns
+     */
+    private handleMousemove;
+    private handleWheelEvent;
+    private updateCameraPosition;
+}
+export default FollowOrbitControls;

package/dist/camera/FollowOrbitControls.js

@@ -0,0 +1,154 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { EventDispatcher, Vector3 } from '@anov/3d-core';
+import { gsap } from 'gsap';
+var FollowOrbitControls = /*#__PURE__*/function (_EventDispatcher) {
+  _inherits(FollowOrbitControls, _EventDispatcher);
+  var _super = _createSuper(FollowOrbitControls);
+  function FollowOrbitControls(object, domElement) {
+    var _this;
+    _classCallCheck(this, FollowOrbitControls);
+    _this = _super.call(this);
+    _defineProperty(_assertThisInitialized(_this), "radius", void 0);
+    _defineProperty(_assertThisInitialized(_this), "target", void 0);
+    _defineProperty(_assertThisInitialized(_this), "object", void 0);
+    _defineProperty(_assertThisInitialized(_this), "domElement", void 0);
+    _defineProperty(_assertThisInitialized(_this), "rotationH", void 0);
+    _defineProperty(_assertThisInitialized(_this), "rotationV", void 0);
+    _defineProperty(_assertThisInitialized(_this), "isMouseDown", void 0);
+    _defineProperty(_assertThisInitialized(_this), "isCurrentFirstMove", void 0);
+    _defineProperty(_assertThisInitialized(_this), "isGlobalFirstMove", void 0);
+    _this.object = object;
+    _this.domElement = domElement;
+    _this.target = new Vector3();
+    _this.radius = _this.getDistance();
+    _this.rotationH = Math.atan2(_this.object.position.x, _this.object.position.z);
+    _this.rotationV = Math.acos(_this.object.position.y / _this.radius);
+    _this.isMouseDown = false;
+    _this.isCurrentFirstMove = true;
+    _this.isGlobalFirstMove = true;
+    _this.domElement.addEventListener('mousedown', _this.handleMousedown.bind(_assertThisInitialized(_this)));
+    _this.domElement.addEventListener('mouseup', _this.handleMouseup.bind(_assertThisInitialized(_this)));
+    _this.domElement.addEventListener('mousemove', _this.handleMousemove.bind(_assertThisInitialized(_this)));
+    _this.domElement.addEventListener('wheel', _this.handleWheelEvent.bind(_assertThisInitialized(_this)));
+    return _this;
+  }
+  _createClass(FollowOrbitControls, [{
+    key: "dispose",
+    value: function dispose() {
+      this.domElement.removeEventListener('mousedown', this.handleMousedown.bind(this));
+      this.domElement.removeEventListener('mouseup', this.handleMouseup.bind(this));
+      this.domElement.removeEventListener('mousemove', this.handleMousemove.bind(this));
+      this.domElement.removeEventListener('wheel', this.handleWheelEvent.bind(this));
+    }
+  }, {
+    key: "update",
+    value: function update() {
+      this.object.lookAt(this.target);
+    }
+  }, {
+    key: "getDistance",
+    value: function getDistance() {
+      return this.object.position.distanceTo(this.target);
+    }
+  }, {
+    key: "handleMouseup",
+    value: function handleMouseup() {
+      this.isMouseDown = false;
+    }
+  }, {
+    key: "handleMousedown",
+    value: function handleMousedown() {
+      this.isMouseDown = true;
+      this.isCurrentFirstMove = true;
+    }
+
+    /**
+     * handle Mousemove
+     * @param event
+     * @returns
+     */
+  }, {
+    key: "handleMousemove",
+    value: function handleMousemove(event) {
+      if (!this.isMouseDown) return;
+      if (this.isGlobalFirstMove) {
+        this.isGlobalFirstMove = false;
+        this.dispatchEvent({
+          type: 'start'
+        });
+      }
+      if (this.isCurrentFirstMove) {
+        this.isCurrentFirstMove = false;
+        this.rotationH = Math.atan2(this.object.position.x, this.object.position.z);
+        this.rotationV = Math.acos(this.object.position.y / this.radius);
+        return;
+      }
+      this.rotationH -= event.movementX / 180 * Math.PI;
+      this.rotationV -= event.movementY / 180 * Math.PI;
+      if (this.rotationV < Math.PI / 180) this.rotationV = Math.PI / 180;
+      if (this.rotationV > Math.PI - Math.PI / 180) this.rotationV = Math.PI - Math.PI / 180;
+      this.updateCameraPosition();
+    }
+  }, {
+    key: "handleWheelEvent",
+    value: function handleWheelEvent(event) {
+      var _this2 = this;
+      event.preventDefault();
+      if (this.isGlobalFirstMove) {
+        this.isGlobalFirstMove = false;
+        this.dispatchEvent({
+          type: 'start'
+        });
+      }
+      if (this.isCurrentFirstMove) {
+        this.isCurrentFirstMove = false;
+        this.rotationH = Math.atan2(this.object.position.x, this.object.position.z);
+        this.rotationV = Math.acos(this.object.position.y / this.radius);
+        return;
+      }
+      var zoomSpeed = 0.3;
+      var minRadius = 0.1;
+      var maxRadius = 100000;
+      var targetRadius = this.radius + event.deltaY * zoomSpeed;
+      var clampedRadius = Math.max(minRadius, Math.min(maxRadius, targetRadius));
+
+      // TODO： 优化 统一在updateCameraPosition处理
+      gsap.to(this, {
+        duration: 0.2,
+        radius: clampedRadius,
+        ease: 'power3.out',
+        onUpdate: function onUpdate() {
+          _this2.updateCameraPosition();
+        }
+      });
+    }
+  }, {
+    key: "updateCameraPosition",
+    value: function updateCameraPosition() {
+      // TODO： 有些生硬，加些过度动画
+      this.object.position.set(this.radius * Math.sin(this.rotationV) * Math.sin(this.rotationH), this.radius * Math.cos(this.rotationV), this.radius * Math.sin(this.rotationV) * Math.cos(this.rotationH));
+      this.update();
+      this.dispatchEvent({
+        type: 'change',
+        position: this.object.position,
+        target: this.target
+      });
+    }
+  }]);
+  return FollowOrbitControls;
+}(EventDispatcher);
+export default FollowOrbitControls;
+//# sourceMappingURL=FollowOrbitControls.js.map

package/dist/camera/FollowOrbitControls.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EventDispatcher","Vector3","gsap","FollowOrbitControls","_EventDispatcher","_inherits","_super","_createSuper","object","domElement","_this","_classCallCheck","call","_defineProperty","_assertThisInitialized","target","radius","getDistance","rotationH","Math","atan2","position","x","z","rotationV","acos","y","isMouseDown","isCurrentFirstMove","isGlobalFirstMove","addEventListener","handleMousedown","bind","handleMouseup","handleMousemove","handleWheelEvent","_createClass","key","value","dispose","removeEventListener","update","lookAt","distanceTo","event","dispatchEvent","type","movementX","PI","movementY","updateCameraPosition","_this2","preventDefault","zoomSpeed","minRadius","maxRadius","targetRadius","deltaY","clampedRadius","max","min","to","duration","ease","onUpdate","set","sin","cos"],"sources":["../../src/camera/FollowOrbitControls.ts"],"sourcesContent":["import type { Camera } from '@anov/3d-core'\nimport { EventDispatcher, Vector3 } from '@anov/3d-core'\nimport { gsap } from 'gsap'\n\nclass FollowOrbitControls extends EventDispatcher {\n  radius: number\n  target: Vector3\n\n  private object: Camera\n  private domElement: HTMLElement\n\n  private rotationH: number\n  private rotationV: number\n  private isMouseDown: boolean\n  private isCurrentFirstMove: boolean\n  private isGlobalFirstMove: boolean\n\n  constructor(object: Camera, domElement: HTMLElement) {\n    super()\n\n    this.object = object\n    this.domElement = domElement\n    this.target = new Vector3()\n    this.radius = this.getDistance()\n    this.rotationH = Math.atan2(this.object.position.x, this.object.position.z)\n    this.rotationV = Math.acos(this.object.position.y / this.radius)\n\n    this.isMouseDown = false\n    this.isCurrentFirstMove = true\n    this.isGlobalFirstMove = true\n\n    this.domElement.addEventListener('mousedown', this.handleMousedown.bind(this))\n    this.domElement.addEventListener('mouseup', this.handleMouseup.bind(this))\n    this.domElement.addEventListener('mousemove', this.handleMousemove.bind(this))\n    this.domElement.addEventListener('wheel', this.handleWheelEvent.bind(this))\n  }\n\n  dispose() {\n    this.domElement.removeEventListener('mousedown', this.handleMousedown.bind(this))\n    this.domElement.removeEventListener('mouseup', this.handleMouseup.bind(this))\n    this.domElement.removeEventListener('mousemove', this.handleMousemove.bind(this))\n    this.domElement.removeEventListener('wheel', this.handleWheelEvent.bind(this))\n  }\n\n  update() {\n    this.object.lookAt(this.target)\n  }\n\n  private getDistance() {\n    return this.object.position.distanceTo(this.target)\n  }\n\n  private handleMouseup() {\n    this.isMouseDown = false\n  }\n\n  private handleMousedown() {\n    this.isMouseDown = true\n    this.isCurrentFirstMove = true\n  }\n\n  /**\n   * handle Mousemove\n   * @param event\n   * @returns\n   */\n  private handleMousemove(event: MouseEvent) {\n    if (!this.isMouseDown)\n      return\n\n    if (this.isGlobalFirstMove) {\n      this.isGlobalFirstMove = false\n      this.dispatchEvent({\n        type: 'start',\n      })\n    }\n\n    if (this.isCurrentFirstMove) {\n      this.isCurrentFirstMove = false\n      this.rotationH = Math.atan2(this.object.position.x, this.object.position.z)\n      this.rotationV = Math.acos(this.object.position.y / this.radius)\n\n      return\n    }\n\n    this.rotationH -= (event.movementX / 180) * Math.PI\n    this.rotationV -= (event.movementY / 180) * Math.PI\n\n    if (this.rotationV < Math.PI / 180)\n      this.rotationV = Math.PI / 180\n    if (this.rotationV > Math.PI - Math.PI / 180)\n      this.rotationV = Math.PI - Math.PI / 180\n\n    this.updateCameraPosition()\n  }\n\n  private handleWheelEvent(event: WheelEvent) {\n    event.preventDefault()\n\n    if (this.isGlobalFirstMove) {\n      this.isGlobalFirstMove = false\n      this.dispatchEvent({\n        type: 'start',\n      })\n    }\n\n    if (this.isCurrentFirstMove) {\n      this.isCurrentFirstMove = false\n      this.rotationH = Math.atan2(this.object.position.x, this.object.position.z)\n      this.rotationV = Math.acos(this.object.position.y / this.radius)\n\n      return\n    }\n\n    const zoomSpeed = 0.3\n    const minRadius = 0.1\n    const maxRadius = 100000\n    const targetRadius = this.radius + event.deltaY * zoomSpeed\n    const clampedRadius = Math.max(minRadius, Math.min(maxRadius, targetRadius))\n\n    // TODO： 优化 统一在updateCameraPosition处理\n    gsap.to(this, {\n      duration: 0.2,\n      radius: clampedRadius,\n      ease: 'power3.out',\n      onUpdate: () => {\n        this.updateCameraPosition()\n      },\n    })\n  }\n\n  private updateCameraPosition() {\n    // TODO： 有些生硬，加些过度动画\n    this.object.position.set(\n      this.radius * Math.sin(this.rotationV) * Math.sin(this.rotationH),\n      this.radius * Math.cos(this.rotationV),\n      this.radius * Math.sin(this.rotationV) * Math.cos(this.rotationH),\n    )\n\n    this.update()\n\n    this.dispatchEvent({\n      type: 'change',\n      position: this.object.position,\n      target: this.target,\n    })\n  }\n}\n\nexport default FollowOrbitControls\n"],"mappings":";;;;;;;;;;;;;;AACA,SAASA,eAAe,EAAEC,OAAO,QAAQ,eAAe;AACxD,SAASC,IAAI,QAAQ,MAAM;AAAA,IAErBC,mBAAmB,0BAAAC,gBAAA;EAAAC,SAAA,CAAAF,mBAAA,EAAAC,gBAAA;EAAA,IAAAE,MAAA,GAAAC,YAAA,CAAAJ,mBAAA;EAavB,SAAAA,oBAAYK,MAAc,EAAEC,UAAuB,EAAE;IAAA,IAAAC,KAAA;IAAAC,eAAA,OAAAR,mBAAA;IACnDO,KAAA,GAAAJ,MAAA,CAAAM,IAAA;IAAOC,eAAA,CAAAC,sBAAA,CAAAJ,KAAA;IAAAG,eAAA,CAAAC,sBAAA,CAAAJ,KAAA;IAAAG,eAAA,CAAAC,sBAAA,CAAAJ,KAAA;IAAAG,eAAA,CAAAC,sBAAA,CAAAJ,KAAA;IAAAG,eAAA,CAAAC,sBAAA,CAAAJ,KAAA;IAAAG,eAAA,CAAAC,sBAAA,CAAAJ,KAAA;IAAAG,eAAA,CAAAC,sBAAA,CAAAJ,KAAA;IAAAG,eAAA,CAAAC,sBAAA,CAAAJ,KAAA;IAAAG,eAAA,CAAAC,sBAAA,CAAAJ,KAAA;IAEPA,KAAA,CAAKF,MAAM,GAAGA,MAAM;IACpBE,KAAA,CAAKD,UAAU,GAAGA,UAAU;IAC5BC,KAAA,CAAKK,MAAM,GAAG,IAAId,OAAO,CAAC,CAAC;IAC3BS,KAAA,CAAKM,MAAM,GAAGN,KAAA,CAAKO,WAAW,CAAC,CAAC;IAChCP,KAAA,CAAKQ,SAAS,GAAGC,IAAI,CAACC,KAAK,CAACV,KAAA,CAAKF,MAAM,CAACa,QAAQ,CAACC,CAAC,EAAEZ,KAAA,CAAKF,MAAM,CAACa,QAAQ,CAACE,CAAC,CAAC;IAC3Eb,KAAA,CAAKc,SAAS,GAAGL,IAAI,CAACM,IAAI,CAACf,KAAA,CAAKF,MAAM,CAACa,QAAQ,CAACK,CAAC,GAAGhB,KAAA,CAAKM,MAAM,CAAC;IAEhEN,KAAA,CAAKiB,WAAW,GAAG,KAAK;IACxBjB,KAAA,CAAKkB,kBAAkB,GAAG,IAAI;IAC9BlB,KAAA,CAAKmB,iBAAiB,GAAG,IAAI;IAE7BnB,KAAA,CAAKD,UAAU,CAACqB,gBAAgB,CAAC,WAAW,EAAEpB,KAAA,CAAKqB,eAAe,CAACC,IAAI,CAAAlB,sBAAA,CAAAJ,KAAA,CAAK,CAAC,CAAC;IAC9EA,KAAA,CAAKD,UAAU,CAACqB,gBAAgB,CAAC,SAAS,EAAEpB,KAAA,CAAKuB,aAAa,CAACD,IAAI,CAAAlB,sBAAA,CAAAJ,KAAA,CAAK,CAAC,CAAC;IAC1EA,KAAA,CAAKD,UAAU,CAACqB,gBAAgB,CAAC,WAAW,EAAEpB,KAAA,CAAKwB,eAAe,CAACF,IAAI,CAAAlB,sBAAA,CAAAJ,KAAA,CAAK,CAAC,CAAC;IAC9EA,KAAA,CAAKD,UAAU,CAACqB,gBAAgB,CAAC,OAAO,EAAEpB,KAAA,CAAKyB,gBAAgB,CAACH,IAAI,CAAAlB,sBAAA,CAAAJ,KAAA,CAAK,CAAC,CAAC;IAAA,OAAAA,KAAA;EAC7E;EAAC0B,YAAA,CAAAjC,mBAAA;IAAAkC,GAAA;IAAAC,KAAA,EAED,SAAAC,QAAA,EAAU;MACR,IAAI,CAAC9B,UAAU,CAAC+B,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAACT,eAAe,CAACC,IAAI,CAAC,IAAI,CAAC,CAAC;MACjF,IAAI,CAACvB,UAAU,CAAC+B,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAACP,aAAa,CAACD,IAAI,CAAC,IAAI,CAAC,CAAC;MAC7E,IAAI,CAACvB,UAAU,CAAC+B,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAACN,eAAe,CAACF,IAAI,CAAC,IAAI,CAAC,CAAC;MACjF,IAAI,CAACvB,UAAU,CAAC+B,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAACL,gBAAgB,CAACH,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF;EAAC;IAAAK,GAAA;IAAAC,KAAA,EAED,SAAAG,OAAA,EAAS;MACP,IAAI,CAACjC,MAAM,CAACkC,MAAM,CAAC,IAAI,CAAC3B,MAAM,CAAC;IACjC;EAAC;IAAAsB,GAAA;IAAAC,KAAA,EAED,SAAArB,YAAA,EAAsB;MACpB,OAAO,IAAI,CAACT,MAAM,CAACa,QAAQ,CAACsB,UAAU,CAAC,IAAI,CAAC5B,MAAM,CAAC;IACrD;EAAC;IAAAsB,GAAA;IAAAC,KAAA,EAED,SAAAL,cAAA,EAAwB;MACtB,IAAI,CAACN,WAAW,GAAG,KAAK;IAC1B;EAAC;IAAAU,GAAA;IAAAC,KAAA,EAED,SAAAP,gBAAA,EAA0B;MACxB,IAAI,CAACJ,WAAW,GAAG,IAAI;MACvB,IAAI,CAACC,kBAAkB,GAAG,IAAI;IAChC;;IAEA;AACF;AACA;AACA;AACA;EAJE;IAAAS,GAAA;IAAAC,KAAA,EAKA,SAAAJ,gBAAwBU,KAAiB,EAAE;MACzC,IAAI,CAAC,IAAI,CAACjB,WAAW,EACnB;MAEF,IAAI,IAAI,CAACE,iBAAiB,EAAE;QAC1B,IAAI,CAACA,iBAAiB,GAAG,KAAK;QAC9B,IAAI,CAACgB,aAAa,CAAC;UACjBC,IAAI,EAAE;QACR,CAAC,CAAC;MACJ;MAEA,IAAI,IAAI,CAAClB,kBAAkB,EAAE;QAC3B,IAAI,CAACA,kBAAkB,GAAG,KAAK;QAC/B,IAAI,CAACV,SAAS,GAAGC,IAAI,CAACC,KAAK,CAAC,IAAI,CAACZ,MAAM,CAACa,QAAQ,CAACC,CAAC,EAAE,IAAI,CAACd,MAAM,CAACa,QAAQ,CAACE,CAAC,CAAC;QAC3E,IAAI,CAACC,SAAS,GAAGL,IAAI,CAACM,IAAI,CAAC,IAAI,CAACjB,MAAM,CAACa,QAAQ,CAACK,CAAC,GAAG,IAAI,CAACV,MAAM,CAAC;QAEhE;MACF;MAEA,IAAI,CAACE,SAAS,IAAK0B,KAAK,CAACG,SAAS,GAAG,GAAG,GAAI5B,IAAI,CAAC6B,EAAE;MACnD,IAAI,CAACxB,SAAS,IAAKoB,KAAK,CAACK,SAAS,GAAG,GAAG,GAAI9B,IAAI,CAAC6B,EAAE;MAEnD,IAAI,IAAI,CAACxB,SAAS,GAAGL,IAAI,CAAC6B,EAAE,GAAG,GAAG,EAChC,IAAI,CAACxB,SAAS,GAAGL,IAAI,CAAC6B,EAAE,GAAG,GAAG;MAChC,IAAI,IAAI,CAACxB,SAAS,GAAGL,IAAI,CAAC6B,EAAE,GAAG7B,IAAI,CAAC6B,EAAE,GAAG,GAAG,EAC1C,IAAI,CAACxB,SAAS,GAAGL,IAAI,CAAC6B,EAAE,GAAG7B,IAAI,CAAC6B,EAAE,GAAG,GAAG;MAE1C,IAAI,CAACE,oBAAoB,CAAC,CAAC;IAC7B;EAAC;IAAAb,GAAA;IAAAC,KAAA,EAED,SAAAH,iBAAyBS,KAAiB,EAAE;MAAA,IAAAO,MAAA;MAC1CP,KAAK,CAACQ,cAAc,CAAC,CAAC;MAEtB,IAAI,IAAI,CAACvB,iBAAiB,EAAE;QAC1B,IAAI,CAACA,iBAAiB,GAAG,KAAK;QAC9B,IAAI,CAACgB,aAAa,CAAC;UACjBC,IAAI,EAAE;QACR,CAAC,CAAC;MACJ;MAEA,IAAI,IAAI,CAAClB,kBAAkB,EAAE;QAC3B,IAAI,CAACA,kBAAkB,GAAG,KAAK;QAC/B,IAAI,CAACV,SAAS,GAAGC,IAAI,CAACC,KAAK,CAAC,IAAI,CAACZ,MAAM,CAACa,QAAQ,CAACC,CAAC,EAAE,IAAI,CAACd,MAAM,CAACa,QAAQ,CAACE,CAAC,CAAC;QAC3E,IAAI,CAACC,SAAS,GAAGL,IAAI,CAACM,IAAI,CAAC,IAAI,CAACjB,MAAM,CAACa,QAAQ,CAACK,CAAC,GAAG,IAAI,CAACV,MAAM,CAAC;QAEhE;MACF;MAEA,IAAMqC,SAAS,GAAG,GAAG;MACrB,IAAMC,SAAS,GAAG,GAAG;MACrB,IAAMC,SAAS,GAAG,MAAM;MACxB,IAAMC,YAAY,GAAG,IAAI,CAACxC,MAAM,GAAG4B,KAAK,CAACa,MAAM,GAAGJ,SAAS;MAC3D,IAAMK,aAAa,GAAGvC,IAAI,CAACwC,GAAG,CAACL,SAAS,EAAEnC,IAAI,CAACyC,GAAG,CAACL,SAAS,EAAEC,YAAY,CAAC,CAAC;;MAE5E;MACAtD,IAAI,CAAC2D,EAAE,CAAC,IAAI,EAAE;QACZC,QAAQ,EAAE,GAAG;QACb9C,MAAM,EAAE0C,aAAa;QACrBK,IAAI,EAAE,YAAY;QAClBC,QAAQ,EAAE,SAAAA,SAAA,EAAM;UACdb,MAAI,CAACD,oBAAoB,CAAC,CAAC;QAC7B;MACF,CAAC,CAAC;IACJ;EAAC;IAAAb,GAAA;IAAAC,KAAA,EAED,SAAAY,qBAAA,EAA+B;MAC7B;MACA,IAAI,CAAC1C,MAAM,CAACa,QAAQ,CAAC4C,GAAG,CACtB,IAAI,CAACjD,MAAM,GAAGG,IAAI,CAAC+C,GAAG,CAAC,IAAI,CAAC1C,SAAS,CAAC,GAAGL,IAAI,CAAC+C,GAAG,CAAC,IAAI,CAAChD,SAAS,CAAC,EACjE,IAAI,CAACF,MAAM,GAAGG,IAAI,CAACgD,GAAG,CAAC,IAAI,CAAC3C,SAAS,CAAC,EACtC,IAAI,CAACR,MAAM,GAAGG,IAAI,CAAC+C,GAAG,CAAC,IAAI,CAAC1C,SAAS,CAAC,GAAGL,IAAI,CAACgD,GAAG,CAAC,IAAI,CAACjD,SAAS,CAClE,CAAC;MAED,IAAI,CAACuB,MAAM,CAAC,CAAC;MAEb,IAAI,CAACI,aAAa,CAAC;QACjBC,IAAI,EAAE,QAAQ;QACdzB,QAAQ,EAAE,IAAI,CAACb,MAAM,CAACa,QAAQ;QAC9BN,MAAM,EAAE,IAAI,CAACA;MACf,CAAC,CAAC;IACJ;EAAC;EAAA,OAAAZ,mBAAA;AAAA,EA9I+BH,eAAe;AAiJjD,eAAeG,mBAAmB"}

package/dist/camera/controls.d.ts

@@ -0,0 +1,2 @@
+import CameraControls from 'camera-controls';
+export default CameraControls;

package/dist/camera/controls.js

@@ -0,0 +1,18 @@
+import { Box3, Matrix4, Quaternion, Raycaster, Sphere, Spherical, Vector2, Vector3, Vector4 } from '@anov/3d-core';
+import CameraControls from 'camera-controls';
+var subsetOfTHREE = {
+  Vector2: Vector2,
+  Vector3: Vector3,
+  Vector4: Vector4,
+  Quaternion: Quaternion,
+  Matrix4: Matrix4,
+  Spherical: Spherical,
+  Box3: Box3,
+  Sphere: Sphere,
+  Raycaster: Raycaster
+};
+CameraControls.install({
+  THREE: subsetOfTHREE
+});
+export default CameraControls;
+//# sourceMappingURL=controls.js.map

package/dist/camera/controls.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Box3","Matrix4","Quaternion","Raycaster","Sphere","Spherical","Vector2","Vector3","Vector4","CameraControls","subsetOfTHREE","install","THREE"],"sources":["../../src/camera/controls.ts"],"sourcesContent":["import { Box3, Matrix4, Quaternion, Raycaster, Sphere, Spherical, Vector2, Vector3, Vector4 } from '@anov/3d-core'\nimport CameraControls from 'camera-controls'\n\nconst subsetOfTHREE = {\n  Vector2,\n  Vector3,\n  Vector4,\n  Quaternion,\n  Matrix4,\n  Spherical,\n  Box3,\n  Sphere,\n  Raycaster,\n}\n\nCameraControls.install({ THREE: subsetOfTHREE })\n\nexport default CameraControls"],"mappings":"AAAA,SAASA,IAAI,EAAEC,OAAO,EAAEC,UAAU,EAAEC,SAAS,EAAEC,MAAM,EAAEC,SAAS,EAAEC,OAAO,EAAEC,OAAO,EAAEC,OAAO,QAAQ,eAAe;AAClH,OAAOC,cAAc,MAAM,iBAAiB;AAE5C,IAAMC,aAAa,GAAG;EACpBJ,OAAO,EAAPA,OAAO;EACPC,OAAO,EAAPA,OAAO;EACPC,OAAO,EAAPA,OAAO;EACPN,UAAU,EAAVA,UAAU;EACVD,OAAO,EAAPA,OAAO;EACPI,SAAS,EAATA,SAAS;EACTL,IAAI,EAAJA,IAAI;EACJI,MAAM,EAANA,MAAM;EACND,SAAS,EAATA;AACF,CAAC;AAEDM,cAAc,CAACE,OAAO,CAAC;EAAEC,KAAK,EAAEF;AAAc,CAAC,CAAC;AAEhD,eAAeD,cAAc"}

package/dist/camera/index.d.ts

@@ -1,4 +1,4 @@
-import type { OrbitControls, PerspectiveCamera, SceneControl } from '@anov/3d-core';
+import type { Object3D, OrbitControls, PerspectiveCamera, SceneControl } from '@anov/3d-core';
 import { EventDispatcher, Vector3 } from '@anov/3d-core';
 type vector3Array = number[];
 declare class CameraUtil extends EventDispatcher {
@@ -8,6 +8,10 @@ declare class CameraUtil extends EventDispatcher {
     private controls;
     private sceneControl;
     private tween;
+    private isCameraChange;
+    private isCameraChanged;
+    private followId;
+    private followCancelMap;
     constructor(camera: PerspectiveCamera, controls: OrbitControls, sceneControl: SceneControl);
     /**
      * calculate last position from position box
@@ -17,14 +21,6 @@ declare class CameraUtil extends EventDispatcher {
      * @returns
      */
     private caclCurrentPos;
-    /**
-     * get current camera pitch and yaw
-     * @param pitch
-     * @param target
-     * @param position
-     * @returns
-     */
-    private caclTargetByPitch;
     /**
      * caclSingleCoordinate, when use focus and target is single point
      * @param prevTarget
@@ -83,6 +79,37 @@ declare class CameraUtil extends EventDispatcher {
         position: number[];
         target: number[];
     };
+    getCurrentPitch(): number;
+    getCurrentYaw(): any;
+    setPitch(deg: number): void;
+    setYaw(deg: number): void;
+    /**
+     * cacl Position By Follow
+     * @param container
+     * @param pitch
+     * @param yaw
+     * @param distance
+     */
+    private caclPositionByFollow;
+    /**
+     * follow 3d object, not only use in camera
+     * @param target
+     */
+    follow(target: Object3D, camera: PerspectiveCamera, option?: Partial<{
+        relativeRotation: boolean;
+        pitch: number;
+        yaw: number;
+        distance: number;
+    }>): number;
+    /**
+     * cancel follow
+     * @param followId
+     */
+    cancelFollow(followId: number): void;
+    /**
+     * cancel all follow
+     */
+    cancelAllFollow(): void;
     /**
      * interpolation move camera
      * @param position