Supported Languages: 中文 / 繁體中文 / English / 日本語 / 한국어 / русский / Le français
- 名称：Shadow Editor
- 版本：v0.4.6(开发中)
- 简介：基于
three.js的场景编辑器。 - 源码：GitHub Gitee | 文档：GitHub Gitee | 示例：GitHub Gitee | 视频：微博 Bilibili | 资源：百度云
- 技术栈：
html、css、javascript、rollup、react.js、webgl、three.js、asp.net。 - 如果对您有帮助，请【捐赠】支持项目发展，谢谢。
- 修复加载自动保存场景确认对话框无法取消bug，
取消按钮改为清空。 - 修复保存示例场景报
ID不合法的错误，现在可以正常保存示例场景。 - 修复一打开页面，立刻添加
背景音乐组件报错bug。 - 修复
背景音乐组件发布场景时，未导出音乐文件bug。 - 修复了一个严重bug，由于多次调用
clock.getElapsedTime，导致所有动画播放变慢bug。 - 修复
视频贴图发布场景后，视频地址不正确bug。 - 修复获取服务端配置，未使用配置的服务端地址的bug。
- Go语言服务端。（开发中）
v0.4.5更新【更新日志】
- 发布日期：2020年3月22日
- 更新日志：
- 播放场景，默认的轨道控制器
启用惯性设置。 EnableDamping的翻译由启用减震改为启用惯性。DampingFactor的翻译由减震系数改为惯性系数。- 脚本面板新增
新建文件夹，支持树状结构，支持拖动排序，支持修改文件夹和脚本名称。 控制器模式选择由状态栏移动到选项菜单中。添加模式由绘制工具栏移动到选项菜单中，默认改为添加到场景中心。选择模式由状态栏移动到选项菜单中。- 修复
点击场景添加模型，添加过程中不出现模型预览bug。 app.editor.scripts由Object改为Array，不会对以前的场景造成影响。- 场景脚本第三方编辑器支持，场景中创建的脚本自动同步到
SceneScript文件夹中。（未完成） - 新增
自动保存场景功能，每10秒保存一次。刷新浏览器询问是否加载自动保存的场景，避免数据丢失。 - 修复部分情况下
javascript格式化插件报错，导致页面崩溃的bug。
- 基于three.js/WebGL的3D场景在线编辑器，使用
MongoDB保存场景、模型、贴图、材质、音频、动画、截图、视频数据，支持一键备份数据库功能。 - 内置物体：组、平面、正方体、圆、圆柱体、球体、二十面体、轮胎、纽结、茶壶、酒杯、不缩放文字、三维文字、线段、CatmullRom曲线、二次贝塞尔曲线、三次贝塞尔曲线、椭圆曲线、点标注、精灵。
- 内置光源：环境光、平行光、点光源、聚光灯、半球光、矩形光，自带点光源帮助器（光晕效果）、半球光帮助器（天空球）、矩形光帮助器（荧幕）。
- 支持多种不同3D格式模型和动画导入。支持
3ds、3mf、amf、assimp(anim)、awd、babylon、binary、bvh(anim)、collada、ctm、draco、fbx(anim)、gcode、gltf(anim)、js(anim)、json(anim)、kmz、lmesh(anim)、md2、mmd(anim)、nrrd、obj、pcd、pdb、ply、prwm、sea3d(anim)、stl、vrm、vrml、vtk、x31种3D文件格式，带anim的表示支持动画。多种3D文件同时支持json和二进制格式。mmd文件同时支持pmd和pmx格式，支持vmd格式的模型和相机动画。它也是唯一支持lmesh(lolking网站lol模型)的编辑器。 - 内置材质：线条材质、虚线材质、基本材质、深度材质、法向量材质、兰伯特材质、冯氏材质、点云材质、标准材质、物理材质、精灵材质、着色器材质、原始着色器材质。
- 支持纹理：颜色纹理、透明纹理、凹凸纹理、法线纹理、位移纹理、镜面纹理、环境纹理、光照纹理、遮挡纹理、自发光纹理。
- 支持贴图：图片、立方体贴图、视频贴图。
- 内置组件：背景音乐、粒子发射器、天空、火焰、水、烟、布、柏林地形组件。
- 可视化修改场景、相机等物体属性，提供各种组件可视化修改面板。
- 在线编辑js脚本、着色器程序，带智能提示。
- 自带播放器，实时演示场景动态效果，支持全屏和新窗口播放，可以直接嵌入项目
iframe中。 - 支持补间动画、骨骼动画、粒子动画、mmd动画、lmesh动画（lolking网站lol模型）。
- 支持场景、模型、贴图、材质、音频、动画、截图、视频管理，支持自定义分类，根据汉字和拼音快速搜索。
- 支持第一视角控制器、飞行控制器、轨道控制器、指针锁定控制器、轨迹球控制器5种控制器。
- 支持点阵化特效、颜色偏移特效、残影特效、背景虚化、快速近似抗锯齿(FXAA)、毛刺特效、半色调特效、全屏抗锯齿(SSAA)、像素特效、可扩展环境光遮挡(SAO)、多重采样抗锯齿(SMAA)、屏幕空间环境光遮蔽(SSAO)、时间抗锯齿(TAA)。
- 提供历史记录和日志功能，支持撤销、重做。
- 支持导出
gltf、obj、ply、stl、Collada、DRACO场景和模型。 - 支持
bullet物理引擎。正方体、圆形、圆柱体、二十面体、酒杯、平面、球体、茶壶、轮胎、纽结和加载的模型都支持刚体组件。支持可视化设置碰撞体形状（正方体、球体）、质量和惯性。 - 具有平移、旋转、缩放、在物体表面绘制点、线、贴花的工具，实时统计场景种物体、顶点、三角形数量。
- 支持场景发布功能，可以将场景发布成静态资源，部署到任何一台服务器上。
- 软件内置语言：
中文、繁體中文、English、日本語、한국어、русский、Le français。 - 支持色调旋转(hue-rotate)、饱和度、亮度、高斯模糊(blur)、对比度、灰度、颜色反转(invert)、复古(sepia)滤镜。
- 支持版本控制，可以打开任何时间保存的场景。
- 支持截图工具，视频录制工具。
- 内置权限管理：组织机构管理、用户管理、角色管理、权限管理、系统初始化、系统重置、注册、登录、修改密码。
- 示例：打砖块、相机、粒子、乒乓球、着色器。
- 自带字体管理器、转换器工具，可以将ttf字体文件转换为json文件，便于创建三维文字。
- 支持设置选中颜色和边框粗细、鼠标高亮颜色，阴影类型，各种帮助器显示隐藏，滤镜效果，天气效果。
该项目仅支持Windows系统，电脑上需要安装.Net Framework 4.7.2及更新版本。
兼容火狐和谷歌浏览器，推荐使用最新版谷歌浏览器。
- 安装
NodeJs，在最外层目录（有README.md文件的那个文件），执行以下命令。
npm install
npm run build- 下载
MongoDB，安装并启动MongoDB服务。MongoDB服务的默认端口为27017。
MongoDB下载地址:https://www.mongodb.com/download-center/community
可以下载zip版本，然后在MongoDB的bin文件夹执行以下命令安装服务，注意修改路径。
mongod --dbpath=D:\mongodb\db --logpath=D:\mongodb\log\mongoDB.log --install --serviceName MongoDB
net start MongoDB- 编辑文件
ShadowEditor.Web/Web.config，将27017修改为你电脑上MongoDB服务的端口。
<add key="mongo_connection" value="mongodb://127.0.0.1:27017" />-
使用
Visual Studio 2017打开项目，生成ShadowEditor.Web项目。 -
将
ShadowEditor.Web部署在iis上即可在浏览器中访问。
注意：发布网站部署，Web目录外面需要多加一层文件夹，用于存放日志、数据库备份等不能公开的资源。
- 编译文档，请安装gitbook。
npm install -g gitbook-cli然后切换到docs-dev目录，安装gitbook插件。
gitbook install然后切换到上级目录，执行以下命令生成文档。
npm run docs- 上传模型时为什么都是上传失败？
需要把模型贴图等资源压缩成一个zip包，而且入口文件不能嵌套文件夹。服务端会解压上传的zip包放到~/Upload/Model文件下，并在MongoDB _Mesh表里添加一条数据。
- 如何将多个模型组合在一起？
基本几何体都支持多层嵌套。可以添加一个组（在几何体菜单中），然后在场景树状图上，将多个模型拖动到组上。
- 如何开启权限系统？
打开ShadowEditor.Web/Web.config文件，将EnableAuthority设置为true。默认管理员用户名是admin，密码是123456。
- 前端报
asm.js 已被禁用，因为脚本调试程序已连接。请断开调试程序的连接，以启用 asm.js。的错误。
完整错误：asm.js 已被禁用，因为脚本调试程序已连接。请断开调试程序的连接，以启用 asm.js。 ammo.js (1,1) SCRIPT1028: SCRIPT1028: Expected identifier, string or number ShadowEditor.js (3948,8) SCRIPT5009: 'Shadow' is not defined。
解决方法：腾讯浏览器不支持使用Emscripten编译的ammo.js（WebAssembly），建议换成谷歌浏览器。
- 前端报
404.0 - Not Found您要找的资源已被删除、已更名或暂时不可用。的错误。
可能原因1：iis没有开启asp.net支持。
解决方法：
1、打开控制面板、程序和功能、启用或关闭Windows功能。
2、把.NET Framework勾选上。
3、把Internet Information Services、万维网服务、应用程序开发功能，下面的.NET Extensibility、ASP.NET、ISAPI扩展、ISAPI筛选器、应用程序初始化勾选上，确定。
可能原因2：服务端没有编译。
解决方法：
使用Visual Studio 2017打开项目，在解决方案管理器ShadowEditor.Web项目上右键，选择重新生成。
- 上传模型报
对路径“C:\inetpub\wwwroot\Upload\Model\20200208192356\temp”的访问被拒绝。的错误。
原因：Upload文件夹没有写入权限。
解决方法：
右键Upload文件夹，点击属性。安全选项卡，点高级，添加。选择主体，填写Everyone，基本权限，选择完全控制就好了。
- 发布场景后没反应。
1、看一下谷歌浏览器地址栏右侧，弹出窗口是不是被拦截了。
2、打开开发者工具，看一下Console或Network选项卡，是不是报错了。
3、发布的场景在ShadowEditor.Web\temp目录下，看一下有没有。
- 将.net framework升级到4.7.2报错：未能找到文件
E:\github\ShadowEditor\ShadowEditor.Web\bin\roslyn\csc.exe。
解决方法：清理解决方案，重新生成解决方案即可。