mx3d 2024.5.28 → 2024.6.2-8.1

package/docs/js/search.min.js

@@ -0,0 +1 @@
+!function(){var e={},n="docsify.search.expires",t="docsify.search.index";function a(e){var n={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"};return String(e).replace(/[&<>"']/g,(function(e){return n[e]}))}function i(e){return e.text||"table"!==e.type||(e.cells.unshift(e.header),e.text=e.cells.map((function(e){return e.join(" | ")})).join(" |\n ")),e.text}function r(e){return e.text||"list"!==e.type||(e.text=e.raw),e.text}function o(e,n,t,o){void 0===n&&(n="");n=window.marked.lexer(n);var s,c=window.Docsify.slugify,d={},l="";return n.forEach((function(n,p){if("heading"===n.type&&n.depth<=o){var h=function(e){void 0===e&&(e="");var n={};return{str:e=e&&e.replace(/^('|")/,"").replace(/('|")$/,"").replace(/(?:^|\s):([\w-]+:?)=?([\w-%]+)?/g,(function(e,t,a){return-1===t.indexOf(":")?(n[t]=a&&a.replace(/&quot;/g,"")||!0,""):e})).trim(),config:n}}(n.text),f=h.str;h=h.config;s=h.id?t.toURL(e,{id:c(h.id)}):t.toURL(e,{id:c(a(n.text))}),f&&(l=f.replace(/<!-- {docsify-ignore} -->/,"").replace(/{docsify-ignore}/,"").replace(/<!-- {docsify-ignore-all} -->/,"").replace(/{docsify-ignore-all}/,"").trim()),d[s]={slug:s,title:l,body:""}}else{if(0===p&&(s=t.toURL(e),d[s]={slug:s,title:"/"!==e?e.slice(1):"Home Page",body:n.text||""}),!s)return;d[s]?d[s].body?(n.text=i(n),n.text=r(n),d[s].body+="\n"+(n.text||"")):(n.text=i(n),n.text=r(n),d[s].body=d[s].body?d[s].body+n.text:n.text):d[s]={slug:s,title:"",body:""}}})),c.clear(),d}function s(e){return e&&e.normalize?e.normalize("NFD").replace(/[\u0300-\u036f]/g,""):e}function c(a,i){var r,s,c,d,l="auto"===a.paths,p=l?(r=i.router,s=[],Docsify.dom.findAll(".sidebar-nav a:not(.section-link):not([data-nosearch])").forEach((function(e){var n=e.href;e=e.getAttribute("href");(n=r.parse(n).path)&&-1===s.indexOf(n)&&!Docsify.util.isAbsolutePath(e)&&s.push(n)})),s):a.paths,h="";p.length&&l&&a.pathNamespaces?(c=p[0],Array.isArray(a.pathNamespaces)?h=a.pathNamespaces.filter((function(e){return c.slice(0,e.length)===e}))[0]||h:a.pathNamespaces instanceof RegExp&&(f=c.match(a.pathNamespaces))&&(h=f[0]),d=-1===p.indexOf(h+"/"),f=-1===p.indexOf(h+"/README"),d&&f&&p.unshift(h+"/")):-1===p.indexOf("/")&&-1===p.indexOf("/README")&&p.unshift("/");var f,u=((f=a.namespace)?n+"/"+f:n)+h,m=((f=a.namespace)?t+"/"+f:t)+h;h=localStorage.getItem(u)<Date.now();if(e=JSON.parse(localStorage.getItem(m)),h)e={};else if(!l)return;var g=p.length,y=0;p.forEach((function(n){return e[n]?y++:void Docsify.get(i.router.getFile(n),!1,i.config.requestHeaders).then((function(t){var r,s;e[n]=o(n,t,i.router,a.depth),g===++y&&(r=a.maxAge,s=u,t=m,localStorage.setItem(s,Date.now()+r),localStorage.setItem(t,JSON.stringify(e)))}))}))}var d,l="";function p(n){var t=Docsify.dom.find("div.search"),i=Docsify.dom.find(t,".results-panel"),r=Docsify.dom.find(t,".clear-button"),o=Docsify.dom.find(".sidebar-nav");t=Docsify.dom.find(".app-name");if(!n)return i.classList.remove("show"),r.classList.remove("show"),i.innerHTML="",void(d.hideOtherSidebarContent&&(o&&o.classList.remove("hide"),t&&t.classList.remove("hide")));n=function(n){var t=[],i=[];Object.keys(e).forEach((function(n){i=i.concat(Object.keys(e[n]).map((function(t){return e[n][t]})))}));var r=(n=n.trim()).split(/[\s\-，\\/]+/);1!==r.length&&(r=[].concat(n,r));for(var o=0;o<i.length;o++)!function(e){e=i[e];var n=0,o="",c="",d="",l=e.title&&e.title.trim(),p=e.body&&e.body.trim();e=e.slug||"";l&&(r.forEach((function(e){var t,i=new RegExp(a(s(e)).replace(/[|\\{}()[\]^$+*?.]/g,"\\$&"),"gi"),r=-1,h=-1;c=l?a(s(l)):l,d=p?a(s(p)):p,r=l?c.search(i):-1,h=p?d.search(i):-1,(0<=r||0<=h)&&(n+=0<=r?3:0<=h?2:0,h<0&&(h=0),r=(r=0)==(t=h<11?0:h-10)?70:h+e.length+60,p&&r>p.length&&(r=p.length),i="..."+d.substring(t,r).replace(i,(function(e){return'<em class="search-keyword">'+e+"</em>"}))+"...",o+=i)})),0<n&&(e={title:c,content:p?o:"",url:e,score:n},t.push(e)))}(o);return t.sort((function(e,n){return n.score-e.score}))}(n);var c="";n.forEach((function(e){c+='<div class="matching-post">\n<a href="'+e.url+'">\n<h2>'+e.title+"</h2>\n<p>"+e.content+"</p>\n</a>\n</div>"})),i.classList.add("show"),r.classList.add("show"),i.innerHTML=c||'<p class="empty">'+l+"</p>",d.hideOtherSidebarContent&&(o&&o.classList.add("hide"),t&&t.classList.add("hide"))}function h(e){d=e}var f={placeholder:"Type to search",noData:"No Results!",paths:"auto",depth:2,maxAge:864e5,hideOtherSidebarContent:!1,namespace:void 0,pathNamespaces:void 0};$docsify.plugins=[].concat((function(e,n){var t=Docsify.util,a=n.config.search||f;Array.isArray(a)?f.paths=a:"object"==typeof a&&(f.paths=Array.isArray(a.paths)?a.paths:"auto",f.maxAge=(t.isPrimitive(a.maxAge)?a:f).maxAge,f.placeholder=a.placeholder||f.placeholder,f.noData=a.noData||f.noData,f.depth=a.depth||f.depth,f.hideOtherSidebarContent=a.hideOtherSidebarContent||f.hideOtherSidebarContent,f.namespace=a.namespace||f.namespace,f.pathNamespaces=a.pathNamespaces||f.pathNamespaces);var i="auto"===f.paths;e.mounted((function(e){(function(e,n){var t,a,i=n.router.parse().query.s;h(e),Docsify.dom.style("\n.sidebar {\n  padding-top: 0;\n}\n\n.search {\n  margin-bottom: 20px;\n  padding: 6px;\n  border-bottom: 1px solid #eee;\n}\n\n.search .input-wrap {\n  display: flex;\n  align-items: center;\n}\n\n.search .results-panel {\n  display: none;\n}\n\n.search .results-panel.show {\n  display: block;\n}\n\n.search input {\n  outline: none;\n  border: none;\n  width: 100%;\n  padding: 0 7px;\n  line-height: 36px;\n  font-size: 14px;\n  border: 1px solid transparent;\n}\n\n.search input:focus {\n  box-shadow: 0 0 5px var(--theme-color, #42b983);\n  border: 1px solid var(--theme-color, #42b983);\n}\n\n.search input::-webkit-search-decoration,\n.search input::-webkit-search-cancel-button,\n.search input {\n  -webkit-appearance: none;\n  -moz-appearance: none;\n  appearance: none;\n}\n.search .clear-button {\n  cursor: pointer;\n  width: 36px;\n  text-align: right;\n  display: none;\n}\n\n.search .clear-button.show {\n  display: block;\n}\n\n.search .clear-button svg {\n  transform: scale(.5);\n}\n\n.search h2 {\n  font-size: 17px;\n  margin: 10px 0;\n}\n\n.search a {\n  text-decoration: none;\n  color: inherit;\n}\n\n.search .matching-post {\n  border-bottom: 1px solid #eee;\n}\n\n.search .matching-post:last-child {\n  border-bottom: 0;\n}\n\n.search p {\n  font-size: 14px;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  display: -webkit-box;\n  -webkit-line-clamp: 2;\n  -webkit-box-orient: vertical;\n}\n\n.search p.empty {\n  text-align: center;\n}\n\n.app-name.hide, .sidebar-nav.hide {\n  display: none;\n}"),function(e){void 0===e&&(e="");var n='<div class="input-wrap">\n      <input type="search" value="'+e+'" aria-label="Search text" />\n      <div class="clear-button">\n        <svg width="26" height="24">\n          <circle cx="12" cy="12" r="11" fill="#ccc" />\n          <path stroke="white" stroke-width="2" d="M8.25,8.25,15.75,15.75" />\n          <path stroke="white" stroke-width="2"d="M8.25,15.75,15.75,8.25" />\n        </svg>\n      </div>\n    </div>\n    <div class="results-panel"></div>\n    </div>';e=Docsify.dom.create("div",n),n=Docsify.dom.find("aside"),Docsify.dom.toggleClass(e,"search"),Docsify.dom.before(n,e)}(i),n=Docsify.dom.find("div.search"),a=Docsify.dom.find(n,"input"),e=Docsify.dom.find(n,".input-wrap"),Docsify.dom.on(n,"click",(function(e){return-1===["A","H2","P","EM"].indexOf(e.target.tagName)&&e.stopPropagation()})),Docsify.dom.on(a,"input",(function(e){clearTimeout(t),t=setTimeout((function(n){return p(e.target.value.trim())}),100)})),Docsify.dom.on(e,"click",(function(e){"INPUT"!==e.target.tagName&&(a.value="",p())})),i&&setTimeout((function(e){return p(i)}),500)})(f,n),i||c(f,n)})),e.doneEach((function(e){(function(e,n){var t,a,i,r,o;h(e),t=e.placeholder,a=n.route.path,(r=Docsify.dom.getNode('.search input[type="search"]'))&&("string"==typeof t?r.placeholder=t:(i=Object.keys(t).filter((function(e){return-1<a.indexOf(e)}))[0],r.placeholder=t[i])),e=e.noData,o=n.route.path,l="string"==typeof e?e:e[Object.keys(e).filter((function(e){return-1<o.indexOf(e)}))[0]]})(f,n),i&&c(f,n)}))}),$docsify.plugins)}();

package/docs/models/capacity.md

@@ -0,0 +1,88 @@
+## 创建容量效果
+
+```javascript
+  /// <summary>
+  /// 创建容量效果
+  /// </summary>
+  /// <param name="anchor">挂载的物体(非空)</param>
+  /// <param name="RATIO">容量占比；0-1（非空）></param>
+  /// <param name="_text">显示的文字（可空）</param>
+  /// <param name="_fontSize">字体的大小（可空），默认200px</param>
+  var map= MX3D.Builder.createCapacity(obj: IObject, RATIO: number, _text: string, _fontSize: string = "200px")
+```
+
+## 示例
+
+### 代码
+
+```javascript
+//创建的容量
+var maps=[];
+//创建
+//获取当前界面机柜
+var _objs = app.project.findObjectsByCustomType('Cabinet',{ isCurrent: false, isEnabled: true });
+for (let i = 0; i < _objs.length; i++) {
+  //将机柜设为透明
+  _objs[i].setTransparent();
+  let value=Math.random();
+  //创建容量效果
+  let map = MX3D.Builder.createCapacity(_objs[i],value,(value*100).toFixed(1)+"%","100px");
+  maps.push(map);
+}  
+
+//销毁
+for (let i = 0; i < maps.length; i++) {
+  maps[i].dispose();
+  maps[i].anchor.setOpaque();
+}
+maps=[];
+```
+
+<div id="container" style="width: 100%;height: 500px;position: relative;">
+<div style="position: absolute;top: 20px;left: 20px;width: 120px;z-index: 5;" class="btn-group-vertical" role="group">
+  <button type="button" id="but_createMatrixHeatMap" class="btn btn-default">创建</button>
+  <button type="button" id="but_detele" class="btn btn-default">销毁</button>
+</div>
+</div>
+
+<script>
+   MX3D.accessToken = "0498A36E67B5ED17E7A7B23D0AC4ACB2E1D6DE1209A0C0894BA0B6973C606201DDCEF2EACFE268AB31FBE04616680A3F453EA85544AE248BA2B115141E029B13C3C90718BA0F15AE6A78BA9F3D70C41650FA4EDDC64D1DEFE5CBA2767EC3A52B347393871ACAC3FF01DF62EAF2F0AEB93578E90EB1F3B7B0793949E88BB4AF1EBB9AA0B0635B93738EC96287638F8716DD6FAC6087C8C8BE4F674F3853042BC60E391D9F5D54";
+   app = new MX3D.App({
+     container: document.getElementById("container")
+    });
+   app.load({
+        pk: "9a0b0f36-f283-49b5-b964-9a3bc630abda",
+        progress: (_x) => { //加载进度
+          console.log(_x)
+        },
+        complete:()=>{ ///加载完成
+          console.log("加载完成");
+          // console.log(app.project.getSceneTree());
+        }
+  });
+
+
+  var maps=[];
+
+
+  $("#but_createMatrixHeatMap").click(function(){
+    
+   var _objs = app.project.findObjectsByCustomType('Cabinet',{ isCurrent: false, isEnabled: true });
+   for (let i = 0; i < _objs.length; i++) {
+     _objs[i].setTransparent();
+     //_objs[i].setEnabled(false);
+     let value=Math.random();
+     let map = MX3D.Builder.createCapacity(_objs[i],value,(value*100).toFixed(1)+"%","100px");
+     maps.push(map);
+   }  
+
+  });
+
+   $("#but_detele").click(function(){
+    for (let i = 0; i < maps.length; i++) {
+        maps[i].dispose();
+        maps[i].anchor.setOpaque();
+    }
+    maps=[];
+  });
+</script>

package/docs/models/effect.md

@@ -0,0 +1,73 @@
+## 添加特效
+
+```javascript
+/// <summary>
+/// 添加特效
+/// </summary>
+/// <param name="Thunder">特效枚举</param>
+/// <param name="_objs">3D实例</param>
+MX3D.Effect.add('Thunder', app)
+```
+
+## 去除特效
+
+```javascript
+/// <summary>
+/// 去除特效
+/// </summary>
+/// <param name="Thunder">特效枚举</param>
+MX3D.Effect.remove('Thunder')
+```
+
+## 现支持的特效
+
+```javascript
+//雷电
+'Thunder'
+//下雨
+'Rain'
+//乌云
+'Cloud'
+```
+
+## 示例
+
+<div id="container" style="width: 100%;height: 500px;position: relative;">
+<div style="position: absolute;top: 20px;left: 20px;width: 120px;z-index: 5;" class="btn-group-vertical" role="group">
+  <button type="button" id="Thunder" class="btn btn-default">雷电</button>
+  <button type="button" id="Rain" class="btn btn-default">下雨</button>
+  <button type="button" id="Cloud" class="btn btn-default">乌云</button>
+  <button type="button" id="close" class="btn btn-default">清除</button>
+</div>
+</div>
+
+<script>
+   MX3D.accessToken = "0498A36E67B5ED17E7A7B23D0AC4ACB2E1D6DE1209A0C0894BA0B6973C606201DDCEF2EACFE268AB31FBE04616680A3F453EA85544AE248BA2B115141E029B13C3C90718BA0F15AE6A78BA9F3D70C41650FA4EDDC64D1DEFE5CBA2767EC3A52B347393871ACAC3FF01DF62EAF2F0AEB93578E90EB1F3B7B0793949E88BB4AF1EBB9AA0B0635B93738EC96287638F8716DD6FAC6087C8C8BE4F674F3853042BC60E391D9F5D54";
+   app = new MX3D.App({
+     container: document.getElementById("container")
+    });
+   app.load({
+        pk: "9a0b0f36-f283-49b5-b964-9a3bc630abda",
+        progress: (_x) => { //加载进度
+          console.log(_x)
+        },
+        complete:()=>{ ///加载完成
+          console.log("加载完成");
+        }
+  });
+
+  $("#Thunder").click(function(){
+     MX3D.Effect.add('Thunder', app);
+  });
+  $("#Rain").click(function(){
+     MX3D.Effect.add('Rain', app);
+  });
+  $("#Cloud").click(function(){
+     MX3D.Effect.add('Cloud', app);
+  });
+  $("#close").click(function(){
+    MX3D.Effect.remove('Thunder')
+    MX3D.Effect.remove('Cloud')
+    MX3D.Effect.remove('Rain')
+  });
+</script>

package/docs/models/event.md

@@ -0,0 +1,100 @@
+## 注册事件
+
+```javascript
+/// <summary>
+/// 添加对象事件
+/// </summary>
+/// <param name="MX3D.EventType">事件类型，查看事件类型选项</param>
+/// <param name="function">事件回调</param>
+obj.addEventListener(MX3D.EventType, function);
+```
+
+## 事件类型
+
+```javascript
+/// <summary>
+/// 左键单击
+/// </summary>
+leftClick
+/// <summary>
+/// 右键单击
+/// </summary>
+rightClick
+/// <summary>
+/// 双击
+/// </summary>
+doubleClick
+/// <summary>
+/// 移入
+/// </summary>
+eover
+/// <summary>
+/// 长按
+/// </summary>
+longPress
+/// <summary>
+/// 移出
+/// </summary>
+out = 'out'
+```
+
+### 事件实例
+
+当用户左键点击某个对象时浏览器控制台输出此对象：
+
+```javascript
+var obj = app.project.findObjectById('O8z6oQcz6SV3') //获取指定编号对象
+obj.addEventListener(MX3D.EventType.leftClick, function (e) {
+  console.log(e)
+})
+```
+
+## 事件删除
+
+```javascript
+obj.removeEventListener(MX3D.EventType.leftClick)
+```
+
+## 示例
+
+<div id="container" style="width: 100%;height: 500px;position: relative;">
+<div style="position: absolute;top: 20px;left: 20px;width: 120px;z-index: 5;" class="btn-group-vertical" role="group">
+  <button type="button" id="but_setFlash" class="btn btn-default">事件监听</button>
+  <button type="button" id="but_setTransparent" class="btn btn-default">事件取消</button>
+</div>
+</div>
+
+<script>
+   MX3D.accessToken = "0498A36E67B5ED17E7A7B23D0AC4ACB2E1D6DE1209A0C0894BA0B6973C606201DDCEF2EACFE268AB31FBE04616680A3F453EA85544AE248BA2B115141E029B13C3C90718BA0F15AE6A78BA9F3D70C41650FA4EDDC64D1DEFE5CBA2767EC3A52B347393871ACAC3FF01DF62EAF2F0AEB93578E90EB1F3B7B0793949E88BB4AF1EBB9AA0B0635B93738EC96287638F8716DD6FAC6087C8C8BE4F674F3853042BC60E391D9F5D54";
+   app = new MX3D.App({
+     container: document.getElementById("container")
+    });
+   app.load({
+        pk: "9a0b0f36-f283-49b5-b964-9a3bc630abda",
+        progress: (_x) => { //加载进度
+          console.log(_x)
+        },
+        complete:()=>{ ///加载完成
+          console.log("加载完成");
+          // console.log(app.Project.getSceneTree());
+          // console.log(parseInt(new Date().getTime() - _t) / 1000);
+        }
+  });
+
+  $("#but_setFlash").click(function(){
+      var _objs = app.project.findObjectsByCustomType("Cabinet");
+       for (let i = 0; i < _objs.length; i++) {
+        _objs[i].addEventListener(MX3D.EventType.leftClick, function (e) {
+         console.log(e);
+         alert("你点击了机柜："+e.customNumber)
+        })
+       }
+  });
+
+  $("#but_setTransparent").click(function(){
+     var _objs = app.project.findObjectsByCustomType("Cabinet");
+       for (let i = 0; i < _objs.length; i++) {
+        _objs[i].removeEventListener(MX3D.EventType.leftClick)
+       }
+  });
+</script>

package/docs/models/line.md

@@ -0,0 +1,97 @@
+## 2d 连线
+
+```javascript
+  /// <summary>
+  /// 创建2d连线效果
+  /// </summary>
+  /// <param name="_id">线编号自定义（非空）</param>
+  /// <param name="_objs">需要相连的对象数组（非空，且大于2）></param>
+  /// <param name="_options">线的样式配置（可空）
+  ////// <param name="width">宽度</param>
+  ////// <param name="color">颜色</param>
+  ////// <param name="isDotted">是否是虚线</param>
+  /// </param>
+  var line = MX3D.Builder.create2DLine(_id: string, _objs: Array<IObject>, _options?: { width: number, color: string, isDotted: boolean });
+```
+
+## 3d 连线
+
+```javascript
+  /// <summary>
+  /// 创建3d连线效果
+  /// </summary>
+  /// <param name="_id">线编号自定义（非空）</param>
+  /// <param name="_objs">需要相连的对象数组（非空，且大于2）></param>
+  /// <param name="_options">线的样式配置（可空）
+  ////// <param name="width">宽度</param>
+  ////// <param name="color">颜色</param>
+  /// </param>
+  var line = MX3D.Builder.create2DLine(_id: string, _objs: Array<IObject>, _options?: { width: number, color: string });
+```
+
+## 线属性
+
+## 点击事件
+
+```javascript
+/// <param name="_action">回调方法</param>
+line.addEventListener(_action: Function)
+```
+
+## 示例
+
+### 代码
+
+```javascript
+/// 线实例
+var line;
+///创建2d连线
+var _objs = app.project.findObjectsByCustomType('Humiture', { isCurrent: false, isEnabled: true,});
+line = MX3D.Builder.create2DLine('line_5498797', _objs);
+line.update();
+///创建3d连线
+var _objs = app.project.findObjectsByCustomType('Humiture', { isCurrent: false, isEnabled: true,});
+line = MX3D.Builder.create3DLine('line_5498797', _objs);
+line.update();
+
+```
+
+### 效果
+
+<div id="container" style="width: 100%;height: 500px;position: relative;">
+<div style="position: absolute;top: 20px;left: 20px;width: 120px;z-index: 5;" class="btn-group-vertical" role="group">
+  <button type="button" id="but_2d" class="btn btn-default">2d连线</button>
+  <button type="button" id="but_3d" class="btn btn-default">3d连线</button>
+</div>
+</div>
+
+<script>
+   MX3D.accessToken = "0498A36E67B5ED17E7A7B23D0AC4ACB2E1D6DE1209A0C0894BA0B6973C606201DDCEF2EACFE268AB31FBE04616680A3F453EA85544AE248BA2B115141E029B13C3C90718BA0F15AE6A78BA9F3D70C41650FA4EDDC64D1DEFE5CBA2767EC3A52B347393871ACAC3FF01DF62EAF2F0AEB93578E90EB1F3B7B0793949E88BB4AF1EBB9AA0B0635B93738EC96287638F8716DD6FAC6087C8C8BE4F674F3853042BC60E391D9F5D54";
+   app = new MX3D.App({
+     container: document.getElementById("container")
+    });
+   app.load({
+        pk: "9a0b0f36-f283-49b5-b964-9a3bc630abda",
+        progress: (_x) => { //加载进度
+          console.log(_x)
+        },
+        complete:()=>{ ///加载完成
+          console.log("加载完成");
+        }
+  });
+
+  var uis;
+
+  $("#but_2d").click(function(){
+    if(uis)uis.dispose();
+    var _objs = app.project.findObjectsByCustomType('Humiture',{ isCurrent: false, isEnabled: true });
+    uis = MX3D.Builder.create2DLine("line_5498797", _objs);
+    uis.update();
+  });
+  $("#but_3d").click(function(){
+     if(uis)uis.dispose();
+    var _objs = app.project.findObjectsByCustomType('Humiture',{ isCurrent: false, isEnabled: true });
+    uis = MX3D.Builder.create3DLine("line_5498797", _objs);
+    uis.update();
+  });
+</script>

package/docs/models/model.md

@@ -0,0 +1,164 @@
+## 属性
+
+```javascript
+id: string //编号
+name: string //名称
+parentId: string //父编号
+objectType: string //模型类型
+customNumber: string //自定义编号
+customType: string //自定义类型
+modelId: string //模型资源编号
+Sight: Sight //视角
+effectType: EffectType //设备状态
+```
+
+### 视角 Sight
+
+#### 视角属性
+
+```javascript
+alpha: number //视角方向；弧度0-3.14
+focus: Vector3 //聚焦点
+radius: number //距离聚焦点的半径
+beta: number //视角高度；弧度0-3.14
+minimumLimit: number //距离聚焦点最近半径
+maximumLimit: number //距离聚焦点最远半径
+minBeta: number //最小视角高度限制；弧度0-3.14
+maxBeta: number //最高视角限制；弧度0-3.14
+```
+
+#### 视角方法
+
+```javascript
+//视角转成字符串形式
+let _sightJson = obj.Sight.toString();
+//视角json字符串转json
+obj.Sight.toJosn(_sightJson);
+//设置缩放范围
+obj.Sight.setLimit(_miniLimit: number, _maxiLimit: number) {}
+//设置上下视角限制
+obj.Sight.setBeta(_minBeta: number, _maxBeta: number) {}
+```
+
+## 方法
+
+### 设置闪烁
+
+```javascript
+/// <summary>
+/// 设置对象闪烁
+/// </summary>
+/// <param name="level">闪烁等级；1-5</param>
+obj.setFlash(level: number)
+```
+
+### 设置透明
+
+```javascript
+/// <summary>
+/// 设置透明
+/// </summary>
+obj.setTransparent()
+```
+
+### 设置正常
+
+```javascript
+/// <summary>
+/// 设置正常
+/// </summary>
+obj.setOpaque()
+```
+
+### 显示隐藏
+
+```javascript
+/// <summary>
+/// 显示隐藏
+/// </summary>
+obj.setEnabled(isEnabled)
+```
+
+### 设置颜色
+
+```javascript
+/// <summary>
+/// 设置颜色
+/// </summary>
+/// <param name="_color">带透明通道的16进制颜色字符串；可为空、为空则清除颜色设置</param>
+obj.setColor(_color: string="#ffffff")
+```
+
+### 播放动画
+
+```javascript
+/// <summary>
+/// 播放动画
+/// </summary>
+obj.play()
+```
+
+### 关闭动画
+
+```javascript
+/// <summary>
+/// 关闭动画
+/// </summary>
+obj.stop()
+```
+
+## 示例
+
+<div id="container" style="width: 100%;height: 500px;position: relative;">
+<div style="position: absolute;top: 20px;left: 20px;width: 120px;z-index: 5;" class="btn-group-vertical" role="group">
+  <button type="button" id="but_setFlash" class="btn btn-default">告警闪烁</button>
+  <button type="button" id="but_setTransparent" class="btn btn-default">透明</button>
+  <button type="button" id="but_setOpaque" class="btn btn-default">正常</button>
+  <button type="button" id="but_hide" class="btn btn-default">隐藏</button>
+  <button type="button" id="but_show" class="btn btn-default">显示</button>
+</div>
+</div>
+
+<script>
+   MX3D.accessToken = "0498A36E67B5ED17E7A7B23D0AC4ACB2E1D6DE1209A0C0894BA0B6973C606201DDCEF2EACFE268AB31FBE04616680A3F453EA85544AE248BA2B115141E029B13C3C90718BA0F15AE6A78BA9F3D70C41650FA4EDDC64D1DEFE5CBA2767EC3A52B347393871ACAC3FF01DF62EAF2F0AEB93578E90EB1F3B7B0793949E88BB4AF1EBB9AA0B0635B93738EC96287638F8716DD6FAC6087C8C8BE4F674F3853042BC60E391D9F5D54";
+   app = new MX3D.App({
+     container: document.getElementById("container")
+    });
+   app.load({
+        pk: "9a0b0f36-f283-49b5-b964-9a3bc630abda",
+        // isDefaultLevel:false,
+        progress: (_x) => { //加载进度
+          console.log(_x)
+        },
+        complete:()=>{ ///加载完成
+          console.log("加载完成");
+          // console.log(app.Project.getSceneTree());
+          // console.log(parseInt(new Date().getTime() - _t) / 1000);
+        }
+  });
+
+  $("#but_setFlash").click(function(){
+      var obj = app.project.findObjectById("qLokZixaMv5K");
+      obj.setFlash(1);
+  });
+
+  $("#but_setTransparent").click(function(){
+     var obj = app.project.findObjectById("qLokZixaMv5K");
+     obj.setTransparent();
+     //app.Environment.showDebug();
+  });
+
+  $("#but_setOpaque").click(function(){
+    var obj = app.project.findObjectById("qLokZixaMv5K");
+    obj.setOpaque();
+  });
+
+  $("#but_hide").click(function(){
+    var obj=app.project.findObjectById("qLokZixaMv5K")
+    obj.setEnabled(false);
+  });
+  $("#but_show").click(function(){
+    var obj=app.project.findObjectById("qLokZixaMv5K")
+    obj.setEnabled(true);
+  });
+</script>

package/docs/models/modelmgr.md

@@ -0,0 +1,79 @@
+# 场景管理
+
+## 获取指定编号层级树
+
+```javascript
+/// <summary>
+/// 获取指定编号层级树
+/// </summary>
+/// <param name="_id">对象编号；为空则为根层级</param>
+/// <param name="_excludeTypes">需排除的类型集合，默认为空</param>
+let treeData = app.project.getSceneTree(_id: string = this.root.id, _excludeTypes: Array<string> = [])
+```
+
+## 切换层级
+
+```javascript
+/// <summary>
+/// 切换层级
+/// </summary>
+/// <param name="_id">对象编号；为null则为根层级</param>
+/// <param name="_isFocus">切换完成后是否聚焦</param>
+let treeData = app.project.switchLevel(_id: string, _isFocus: boolean = false);
+```
+
+## 层级切换监听事件
+
+```javascript
+/// <summary>
+/// 层级切换监听事件
+/// </summary>
+/// <param>值为回调方法</param>
+app.levelEvent=(_obj)=>{
+  console.log(_obj);
+};
+```
+
+## 根据指定自定义编号获取对象数组
+
+```javascript
+  /// <summary>
+  /// 根据指定自定义编号获取对象
+  /// </summary>
+  /// <param name="_customNumber">对象自定义编号</param>
+ let object = app.project.findObjectByCustomNumber(_customNumber: string);
+```
+
+## 获取指定类型对象
+
+```javascript
+  /// <summary>
+  /// 获取指定类型对象
+  /// </summary>
+  /// <param name="_customType">对象类型</param>
+  /// <param name="queryParameters">查询参数：可选</param>
+  /// <param name="queryParameters.isCurrent">是否排除不在当前节点的对象；默认false</param>
+  /// <param name="queryParameters.isEnabled">是否排除隐藏的对象；默认false</param>
+ let objects = app.project.findObjectsByCustomType(_customType: string,queryParameters: { isCurrent: boolean, isEnabled: boolean });
+```
+
+## 根据编号获取对象
+
+```javascript
+  /// <summary>
+  /// 根据编号获取对象
+  /// </summary>
+  /// <param name="_id">对象编号</param>
+ let object = app.project.findObjectById(_id: string);
+```
+
+## 获取指定对象编号下的所有子对象
+
+```javascript
+  /// <summary>
+  /// 获取指定对象编号下的子对象数组
+  /// </summary>
+  /// <param name="_id">对象编号；为null则为根层级</param>
+  /// <param name="_includeSub">是否包括孙物体；默认false</param>
+ let objects = app.project.getChildsById(_id: string, _includeSub: boolean = false);
+```