diff --git a/docs-dev/SUMMARY.md b/docs-dev/SUMMARY.md index b53e04c3..c80724c0 100644 --- a/docs-dev/SUMMARY.md +++ b/docs-dev/SUMMARY.md @@ -6,7 +6,7 @@ * [工具栏](ui/Toolbar.md) * [场景编辑区](ui/Scene.md) * [场景层次图](ui/Hierachy.md) - * 脚本列表 + * [脚本面板](ui/ScriptPanel.md) * 属性面板 * 动画编辑区 * [状态栏](ui/StatusBar.md) diff --git a/docs-dev/ui/ScriptPanel.md b/docs-dev/ui/ScriptPanel.md new file mode 100644 index 00000000..83c6f9f3 --- /dev/null +++ b/docs-dev/ui/ScriptPanel.md @@ -0,0 +1,42 @@ +# 脚本面板 + +脚本面板用来管理当前场景中的`Javascript`脚本。 + +![image](image/scriptPanel.png) + +## 新建脚本 + +单击新建脚本按钮,弹出新建脚本窗口。输入脚本名称(中英文都行),点确定,打开脚本编辑器。 + +![image](image/createScript.png) + +脚本编辑器会提供一个脚本模板,里面提供13个事件,会在不同情况下自动调用:场景渲染前、场景渲染后、每帧、结束、单击、双击、键盘按下、键盘抬起、鼠标按下、鼠标移动、鼠标抬起、鼠标滚轮滚动、屏幕大小改变。 + +脚本编辑器中,默认提供scene、camera、renderer三个全局变量,基本用法是使用`scene.getObjectByName('名称')`获取场景中的物体,然后可以对物体属性进行各种修改。 + +![image](image/scriptEditor.png) + +我们用一个最简单的例子来说明用法。假设场景中有个叫“正方体”的物体,创建`正方体旋转`脚本,输入以下代码: + +```javascript +var box = scene.getObjectByName('正方体'); + +// 程序运行过程中,每帧都要执行 +function update(clock, deltaTime) { + box.rotation.x += 0.1; +} +``` + +关闭脚本编辑器窗口,会自动保存脚本。点击启动按钮,可以看到正方体旋转起来了。 + +## 编辑脚本 + +点击编辑按钮,可以编辑脚本。 + +## 保存脚本 + +关闭脚本编辑器按钮,可以自动保存脚本。 + +## 删除脚本 + +点击删除,可以弹出删除脚本对话框。点击确认,可以删除脚本。 \ No newline at end of file diff --git a/docs-dev/ui/image/createScript.png b/docs-dev/ui/image/createScript.png new file mode 100644 index 00000000..9a90676e Binary files /dev/null and b/docs-dev/ui/image/createScript.png differ