0.5.12 • Published 18 days ago

i3viewer v0.5.12

Weekly downloads
-
License
-
Repository
-
Last release
18 days ago

🔨 示例

VUE

使用官方模型示例

<template><div class="home" ref="home"></div></template>
<script>
import { Viewer, Setting, Examples } from "i3viewer";
export default {
  mounted() {
    const settings = new Setting({ camInitDirection: [1, 1, 1], sceneBgColor: 0xffffff });
    const viewer = new Viewer(this.$refs["home"], settings);
    new Examples.SmallCity(viewer).load();
  },
};
</script>
<style lang="scss" scoped>
.home {
  width: 100%;
  height: 100%;
}
</style>

加载后端模型数据

<template>
  <div class="home" ref="home"></div>
</template>

<script>
import { Viewer, Setting, Model, Source } from "i3viewer";

const modelUrl = `http://220.168.85.72:10000/i3viewer/mdsbk/40287e0289f801050189f80105db0000_LOD0.zip`;
const infoUrl = `http://220.168.85.72:10000/i3viewer/mdsbk/40287e0289f801050189f80105db0000_json.zip`;
const metaUrl = `http://220.168.85.72:10000/i3viewer/mdsbk/40287e0289f801050189f80105db0000_metadata.zip`;

export default {
  mounted() {
    const settings = new Setting({
      camInitDirection: [1, 1, 1],
      sceneBgColor: 0xffffff,
    });

    const viewer = new Viewer(this.$refs["home"], settings);

    const models = [
      new Model({
        id: "40287e0289f801050189f80105db0000",
        modelSrc: new Source({ url: modelUrl }),
        infoSrc: new Source({ url: infoUrl }),
        metaSrc: new Source({ url: metaUrl }),
      }),
    ];

    viewer.load(models);
  },
};
</script>

<style lang="scss" scoped>
.home {
  width: 100%;
  height: 100%;
}
</style>

🔠 类型

Viewer 三维浏览器类

属性

属性名类型描述
isModelLoadingboolean模型是否正在下载或加载中
settingSetting获取设置信息
boundingBoxObject获取当前所有模型的总包围盒
boundingSphereObject获取当前所有模型的总包围球
dataHelperDataHelper数据相关辅助方法
operaHelperOperaHelper操作相关辅助方法
settingHelperSettingHelper设置相关辅助方法
controlsHelperControlsHelper轨道控制器辅助方法
currSelectedThingContainerShell获取当前被选中的构件的业务信息

构造方法

constructor(dom: HTMLElement, setting?: Setting);

  • outerContainer: 需要加载 Viewer 的 dom 容器
  • setting: (可选) 设置项

实例方法

load(models: Array): Promise;

加载模型

on(eventName: string, fn: (data?: any) => void): Viewer;

监听事件的方法

  • eventName: 事件名称
  • fn: 事件回调

off(eventName: string, fn: (data?: any) => void): Viewer;

解除事件监听的方法

  • eventName: 事件名称
  • fn: 之前注册过的事件回调

updateSize(): void;

根据 Viewer 所在 DOM 容器的尺寸更新 Viewer 尺寸(不会触发 viewer-resized 事件)

事件

事件名解释参数
viewer-resized模型视口尺寸改变并更新模型位置后-
model-loaded模型加载后触发被加载的模型信息对象

单击、双击等更多事件


DataHelper 数据辅助类

点此跳转

OperaHelper 操作辅助类

点此跳转

SettingHelper 设置辅助类

点此跳转

ControlsHelper 轨道控制器辅助类

点此跳转


Setting 设置类

属性

属性名类型默认值描述
camInitDirectionnumber, number, number1, 1, 1初始的摄像头方位(顺序xyz)
upAxis'X', 'Y', 'Z''Y'设置朝向上的轴
sceneBgColornumber0x000000场景背景色(16进制数字)
axesHelperMultiplesnumber03色坐标与场景包围盒尺寸的比例(为0时无3色坐标)
toolBarSettingIToolBarSettingundefined对工具条的设置
useCache'none', 'parsed', 'final''none'是否缓存模型数据到本地(parsed 缓存中间过程, final 缓存最终结果)
isOutlineDrawnbooleanfalse是否描边
outlineColorHexnumber0x000000描边的颜色(16进制数字)

Model 模型类

属性

属性名类型默认值描述
idstring''模型全局唯一id
prefixstring''指定 bizId 的前缀
modelSrcSource必传模型三维数据获取地址
infoSrcSourceundefined模型额外信息获取地址
compSrcSourceundefined模型构件信息获取地址

Source 模型来源类

属性

属性名类型描述
urlstring资源地址
method'GET', 'POST'下载方法
tokenToken请求 Token

Token 模型来源凭证类

属性

属性名类型描述
valuestringtoken 的值
key'GET', 'POST'token 的键
position'header', 'query', 'body'token 的传输方式

Transform 移动、旋转、缩放类

属性

属性名类型默认值描述
idstring--
positionPointnew Point()位置
rotationPointnew Point()旋转
scalePointnew Point()缩放

Point 位置/向量

属性

属性名类型默认值描述
xnumber0x 轴数值
ynumber0y 轴数值
znumber0z 轴数值

IToolBarSetting

属性名类型默认值描述
rowCountnumber1工具条分多少行
includestring[]undefined包含哪些按钮(若为空数组,则工具条不显示)
excludestring[]undefined不包含哪些按钮

Examples 可选模型库

模型类名描述
Examples.SmallCity小城市
Examples.Building小区排楼
Examples.BlueHouse小别墅
Examples.ResidentalHouse花园别墅
Examples.TwoStoryHouse二层独栋别墅
Examples.SimpleGeomatry01立方体和球体

ThingContainerShell 组件信息集合类

实例方法

on(eventName: string, fn: (data?: any) => void): ThingContainerShell;

监听事件的方法

  • eventName: 事件名称
  • fn: 事件回调

off(eventName: string, fn: (data?: any) => void): ThingContainerShell;

解除事件监听的方法

  • eventName: 事件名称
  • fn: 之前注册过的事件回调

get length(): number;

获取构件的个数

getAll(): Array\;

获取所有相关构件的业务数据

empty(): void;

清除所有相关构件

事件

事件名解释参数
add添加一个或多个键值对之后触发BizInfo
del删除一个或多个键值对之后触发BizInfo

BizInfo 组件业务数据

属性名类型描述
innerIdnumber内置 id
bizIdstring组件 id
modelIdnumber模型 id

示例

获取当前被选中的构件的业务信息

// 监听当前新增选中的构件的业务信息
viewer.currSelected.on("add", (bizInfos) => {
  console.log("bizInfos adding:>> ", bizInfos);
});

// 监听当前取消选中的构件的业务信息
viewer.currSelected.on("del", (bizInfos) => {
  console.log("bizInfos deleting:>> ", bizInfos);
});

// 获取当前选中的所有构件的业务信息
const bizInfos = viewer.currSelected.getAll();
console.log("current bizInfos:>> ", bizInfos);

🔌 插件开发

点此跳转

🛠️ 更多示例

点此跳转

0.5.12

18 days ago

0.5.10

28 days ago

0.5.11

27 days ago

0.5.9

1 month ago

0.5.8

4 months ago

0.4.9

8 months ago

0.4.8

8 months ago

0.5.4

7 months ago

0.5.3

7 months ago

0.5.6

7 months ago

0.5.5

7 months ago

0.5.0

8 months ago

0.5.2

8 months ago

0.5.1

8 months ago

0.5.7

7 months ago

0.4.5

8 months ago

0.4.4

8 months ago

0.4.7

8 months ago

0.4.6

8 months ago

0.4.3

8 months ago

0.3.9

8 months ago

0.3.6

8 months ago

0.3.5

8 months ago

0.3.8

8 months ago

0.3.7

8 months ago

0.4.1

8 months ago

0.4.0

8 months ago

0.3.4

8 months ago

0.4.2

8 months ago

0.3.3

9 months ago

0.3.2

9 months ago

0.3.1

9 months ago

0.3.0

9 months ago

0.2.9

9 months ago

0.2.8

9 months ago

0.2.7

9 months ago

0.2.6

9 months ago

0.2.5

9 months ago

0.2.4

9 months ago

0.2.3

9 months ago

0.2.2

9 months ago

0.2.1

9 months ago

0.2.0

9 months ago

0.1.9

9 months ago

0.1.8

9 months ago

0.1.7

10 months ago

0.1.6

10 months ago

0.1.5

10 months ago

0.1.3

10 months ago

0.1.2

10 months ago

0.1.1

10 months ago

0.1.0

10 months ago

0.0.9

11 months ago

0.0.8

11 months ago

0.0.7

11 months ago

0.0.6

11 months ago

0.0.5

11 months ago

0.0.3

11 months ago

0.0.2

11 months ago

0.0.1

11 months ago