界面介绍
本文主要介绍编辑器界面各个部分的详细功能。
编辑器地址
界面结构
编辑界面分为以下几个部分：
- 顶部导航栏，包括项目文件操作菜单、文档地址导航、项目名称编辑、产品地址导航以及用户信息管理。
- 次顶部工具栏，包括场景列表菜单按钮、数据集和网络配置按钮、编辑操作按钮、保存及发布相关按钮。
- 左侧资源栏，分为系统资源和用户资源，两者都包括模型、面板、图片、HDR以及LUT资源，系统资源还拥有方案资源。
- 右侧属性栏，包含场景及模型的基础属性、动画、动态数据、交互事件以及场景模型结构，还有相机和光源的配置按钮。
- 中间主画布区域，是3D引擎渲染场景的核心区域。
顶部导航栏
最左侧是乐吾乐LOGO，点击LOGO可以访问官网首页。
LOGO右侧是菜单操作按钮，它们的功能分别是：
- 文件
-
- 导入项目：导入本地的.l3d项目文件。
- 保存：保存当前项目数据至乐吾乐个人中心。
- 另存为：保存当前项目数据为副本，用于备份项目数据。
- 保存至本地：下载项目数据为至本地，文件格式为.l3d。
- 编辑
-
- 撤销：撤销上一步操作，同工具栏的撤销按钮。
- 恢复：恢复撤销的操作，同工具栏的恢复按钮。
- 查看
-
- 暗黑主题：设置编辑器页面的色调为暗黑系。
- 明亮主题：设置编辑器页面的色调为明亮系。（开发中）
- 帮助：访问乐吾乐3D可视化相关文档。
中间为当前项目的名称，点击后可修改。
右侧可快速访问乐吾乐不同产品的地址，以及账户管理。
次顶部工具栏
下面为您从左至右依次介绍工具栏按钮的功能。
- 场景列表：显示当前项目中已创建的场景列表，可进行增加、删除、切换操作。
- 数据集：可在弹窗中编辑数据订阅接口，以及配置数据集。
- 网络请求：配置向后端接口发送数据的网络请求。
- 撤销：撤销场景的上一步操作。
- 恢复：恢复被撤销的操作。
- 复制为实体：复制被选择目标为实体（相当于重新生成模型）。
- 复制为引用：复制被选择目标为引用，引用模型与源模型共享几何体以及材质，删除源模型时引用模型也会一并删除。
- 操作器：系统提供了位置、旋转、缩放三种操作器， 用来修改模型属性。这三种操作器是互斥的。
- 调整枢纽点：拖入模型时以当前选项为准确定模型的枢纽点位置。
- 保存：将数据保存到云端。与文件- 保存功能一致。
- 运行：将编辑器切换至运行状态。
- 在线预览：打开在线地址以查看项目运行效果，会自动保存项目数据。
- 分享：修改在线地址查看权限，会自动保存项目数据。
左侧资源栏
3D场景中可以用到的资源包括模型、图片、环境光照贴图（HDR）、颜色查找（LUT）等，除了系统预设的资源外，用户也可以上传并使用自己的资源文件。您可以在顶部切换显示系统资源或者我的资源，使用搜索栏可显示含有指定名称的资源，刷新按钮可重新加载所有资源，收起按钮可快速折叠文件夹。
下面为您介绍如何管理并使用这些资源。
删除资源文件夹，同时也会删除文件夹内的所有资源。如果删除了某个资源，已用到该资源的项目仍会正常显示该资源。
方案
系统为您提供了一些乐吾乐官方制作的3D可视化解决方案，目前包括厂区、环境等类型。您只需拖拽对应的方案图片至画布上方，在警告弹窗中点击确定，系统便会读取方案数据并且加载。对于初次接触乐吾乐3D可视化编辑器的用户来说，通过官方案例来学习是一个比较好的选择。
模型
3D场景的基础操作单元便是模型。除了使用系统预置的模型外，您可以在我的资源中上传模型文件至乐吾乐云盘。
打开我的资源 - 模型，点击新建文件夹按钮，输入文件夹名称后点击确认，即可创建文件夹，然后点击文件夹名称右侧的新建按钮，在弹窗中输入模型名称并上传模型文件和图片，然后即可通过拖拽的方式在场景中生成。您可以随时修改文件夹名称，以及模型名称和预览图，也可以删除模型或者文件夹。
编辑器目前仅支持.glb格式的模型文件，其他的模型格式如.3ds、.obj、.bim等需要在建模软件中转换成.glb后方可使用。
面板
面板是专门用来做信息展示的平面模型，它是系统自带的模型。面板目前可以添加文字和图片，并且设置背景图、背景颜色、透明度等属性。面板的使用方式和模型一样，可通过拖拽直接在场景中生成。
为了方便复用，用户可将场景中已设置好的面板上传至我的资源中。打开我的资源 - 面板，创建一个文件夹，然后点击文件夹名称右侧的新建按钮，在弹窗中输入面板名称，选择场景中已有的面板，上传预览图后点击确认按钮，等待资源上传成功后即可。
图片
图片资源主要用在天空盒、材质中纹理的贴图、面板背景图、面板图片元素等属性中。
打开我的资源 - 图片，创建一个文件夹，然后在新建弹窗中输入图片名称、文件，点击确认按钮后等待资源上传成功后即可。
图片资源目前支持.png、.jpg、.gif等常见格式。
HDR
环境纹理（HDR）可以在具有PBR材质的模型表面提供模拟周围环境反射的效果，用来增强模型的真实感，同时也是提供场景整体光照效果的重要手段。系统内置了白天、黄昏、夜晚等不同效果的HDR，用户同时也可以上传自己的HDR资源。
打开我的资源 - HDR，创建一个文件夹，然后在新建弹窗中输入HDR名称、文件、预览图，点击确认后等待资源上传成功即可。系统支持.dds、.hdr、.env三种格式的文件。
场景对象的HDR属性可用到该资源。
LUT
颜色查找表（LUT）主要用作场景的滤镜特效，使用不同的LUT文件可使场景的色彩看起来有不同的效果。
打开我的资源 - LUT，创建一个文件夹，然后在新建弹窗中输入LUT的名称、文件、预览图，点击确认后等待资源上传成功即可。系统目前支持.3dl格式文件。
右侧属性栏
属性栏主要用来设置被选择对象的属性，包括基础、动画、数据以及交互。另外，还可以设置相机视角、相机属性、主光源和辅光源的属性。您还可以在结构中查看场景中所有的模型元素以及分组信息。
基础属性
选择不同的操作对象时，基础属性的内容也会不同。如果没有选中任何对象，显示的是场景的基础属性，包括天空盒、HDR、特效等。如果选择模型对象，也会因为节点类型不同而有所区分，比如转换节点（TransformNode）没有材质及特效的设置，2D面板（2DPanel）增加了编辑内容按钮，引用对象（InstancedMesh）增加了选择源对象的按钮。这些属性内容比较多，我们会在后面的章节中为您详细介绍。
动画
无论是场景还是模型，它们都属于编辑器可操作对象，都可以配置动画。动画分为自定义动画和自带动画，自定义动画指在编辑器中为操作对象配置的动画，自带动画指在建模时为模型设置的动画。自定义动画可以配置循环模式、动画速率以及修改动画帧，自带动画则无法修改动画帧。
在编辑状态下，您可以点击播放按钮来预览动画效果，点击停止按钮或者取消选中操作对象时会停止播放。
在运行状态下播放动画有两种方法，您可以激活动画名称前的勾选框，在切换至当前场景后会自动播放，也可以通过事件动作中的开始动画来执行。
我们会在动画章节中为您详细介绍动画的配置方法。
数据
属性面板中的数据也被称为动态数据，它既是数据点与操作对象属性建立关联关系的纽带，也可以通过匹配条件执行某些动作。当您需要实现后台数据控制模型属性时，需要先将模型属性设置为动态数据，然后再将它关联至数据点号，这样在运行时当数据点号的值发生改变后，该属性值也会同步发生改变。同时，如果设置了状态项，当值满足预设的条件时，也会执行状态项中配置的动作。
我们会在数据章节中为您详细介绍数据的配置方法。
交互
交互又称为事件，它负责监听用户的行为（比如鼠标点击）或者操作对象状态的变化（比如切换场景、改变属性、改变数据等），当指定类型的行为被触发时，若满足预设的条件，则执行配置的动作。
事件的触发类型包括自身事件和全局事件，自身事件指当用户与操作对象发生交互或者操作对象本身的属性、动画等状态发生改变时触发的事件，比如鼠标点击某个模型，则只会触发该模型的鼠标点击事件。而全局事件指相机、窗口消息、网络、数据点等发生改变时，场景内所有对象都会触发的事件。
用户可以对操作对象设置任意数量的交互事件，每个满足条件的事件会按照列表顺序由上至下依次执行，您可以在编辑状态下随时点击上移或者下移图标调整事件顺序。当关闭事件名称前的勾选框时，则表示该事件在运行状态下永远不会被执行。
我们会在事件章节中为您详细介绍事件的配置方法。
结构
无论当前选中何种操作对象，结构列表中显示的内容都是一致的，它以树形结构展示了当前场景中的节点和分组内容。
在节点树形结构中，根节点为场景对象，展开后显示的是模型根节点，每个模型根节点都表示被导入到场景中的完整模型，您只能对模型的根节点执行删除或者复制操作，无法删除或者复制更深层级的子节点。在画布中点击操作对象时，树节点会自动展开父节点并显示到对应的位置。您也可以使用搜索功能来过滤显示含有指定名称的节点，点击搜索栏右侧按钮可快速折叠所有节点。
鼠标悬停在节点上时，右侧会出现一些操作图标。点击定位图标会将相机中心点移动至模型的几何中心（场景节点会移动至 0, 0, 0 ）。点击删除按钮会删除该模型（删除场景需要在场景列表中操作，且至少要有一个场景）。点击拾取按钮可切换模型的拾取状态，当模型不可拾取时，编辑状态下无法在场景中通过鼠标点击的方式选中该模型，运行状态下无法触发模型的鼠标事件。点击启用按钮时会切换模型的是否启用状态，相当于显示隐藏功能，模型处于隐藏状态时也无法被拾取。
单击节点表示选中该操作对象，双击节点时表示将相机定位至该节点，按住Ctrl时单击节点可以多选。
在分组树形结构中，根节点为分组名称，子节点均为已被添加至该分组的操作对象，每一个子节点均为单一节点，不包含原有的嵌套节点，这也意味着您可以把原有的父子节点同时设置到同一分组。点击右侧新建分组图标可以新增一个分组。
鼠标悬停在节点上时，右侧会出现一些操作图标。点击删除图标时，若是分组节点则会删除该分组，同时会将该分组从节点分组信息中移除，若是模型节点则会从该分组中移除该节点，不会删除该节点。点击定位按钮时会将相机定位至该节点。
单击分组节点表示选中该分组下的所有节点，单击模型节点表示选中该模型节点，双击模型节点表示将相机定位至该节点，按住Ctrl时单击分组或节点可多选。另外，在节点树中，您可以先选中某个模型节点，然后拖拽该节点至分组节点上方松开，可以快速将该节点添加到分组。
在属性面板左侧有一些小按钮，分别是相机视角、相机、主光源、辅光源。
相机视角
相机视角提供了保存当前相机视角位置以及快速切换相机至对应视角的功能，同时在交互事件中可以监听视角切换以及执行切换视角动作。
我们会在相机及视角章节中为您详细介绍视角的操作方法。
相机属性
相机设置中提供了旋转相机相关的属性设置，例如旋转相机的中心、最大最小半径的限制、旋转角度的限制等。我们会在相机及视角章节中为您详细介绍相机属性的功能。
主光源及辅光源
主光源和辅光源可以为场景提供光照效果，一个场景最多可以同时存在一个主光源及三个辅光源。
我们会在灯光章节中为您详细介绍灯光的相关属性。
基础操作
3D场景操作：
- 选择模型：单击左键。
- 选择子模型：按住Alt+单击左键。
- 删除模型：Delete或者Backspace。
- 取消选择：Esc。
- 定位相机至模型：双击左键。
- 旋转相机：按住左键并移动。
- 移动相机中心点：按住右键并移动。
- 改变相机半径：滚动滚轮。
- 切换操作器：1 位置操作器，2 缩放操作器，3 旋转操作器。
- 撤销：Ctrl+Z。
- 恢复：Ctrl+Shift+Z。
2D面板编辑界面操作：
- 撤销：Ctrl+Z。
- 恢复：Ctrl+Shift+Z。
- 选择内容：单击左键。
- 删除内容：Delete或者Backspace。
- 取消选择：Esc。
- 复制内容：按住Ctrl后左键拖动被复制的内容。
