Преглед изворни кода

4.28.2021 updates (#178)

* update physics

* update input

* update

* update code sharing in getting-help.md

* Export Compliance

* update on file i/o

* pi / 4

* inputs

* forum url

* read only user

* html5 gamepad

* sdk api update

* update

* image properties

* update editor

* defold sdk update

* animation updates

* animation fix

* run as admin

* update bob

* update about AndroidX support

* software render

* linux-faq.md update

* 4.28.2021 updates
COCO пре 4 година
родитељ
комит
17c823f385

+ 33 - 32
docs/zh/manuals/bob.md

@@ -18,63 +18,64 @@ Bob 运行于命令行界面 `java` (再Windows上是 `java.exe`) 后跟bob的ja
 ```text
 $ java -jar bob.jar --help
 usage: bob [options] [commands]
- -a,--archive                        编译数据包
+  -a,--archive                       编译数据包
  -ar,--architectures <arg>           逗号分割发布架构, 例如 "arm64-android,armv7-android"
-                                     
-    --binary-output <arg>            指定可执行文件存放地址
+  -u,--auth <arg>                    作者認證標記
+     --binary-output <arg>           指定可执行文件存放地址
                                      默认地址是
                                      "<build-output>/<platform>/"
- -bo,--bundle-output <arg>           打包输出目录
  -br,--build-report <arg>            指定编译报告的存放存放地址
                                      报告为JSON格式
  -brhtml,--build-report-html <arg>   指定编译报告的存放存放地址
                                      报告为HTML格式
-    --build-server <arg>             编译服务器 (当使用原生扩展
+     --build-server <arg>            编译服务器 (当使用原生扩展
                                      时使用)
- -d,--debug                          使用dmengine的debug版本(当
+ -bo,--bundle-output <arg>           打包輸出目錄
+     --bundle-format <apk|aab>       Android 打包格式
+  -d,--debug                         使用dmengine的debug版本(当
                                      编译时). 弃用, 使用--variant
                                      代替
-    --defoldsdk <arg>                指定defold sdk (sha1)
+     --debug-ne-upload               把文件打包為upload.zip之後上傳到
+                                     編譯服務器
+     --defoldsdk <arg>               指定defold sdk (sha1)
                                      使用版本
- -e,--email <arg>                    用户电邮
- -h,--help                           帮助文档
- -i,--input <arg>                    指定源目录, 默认是当前
+     --exclude-build-folder          逗號分割的排除目錄列表
+  -e,--email <arg>                   用户电邮
+  -h,--help                          帮助文档
+  -i,--input <arg>                   指定源目录, 默认是当前
                                      目录
-    --identity <arg>                 指定签名 (iOS)
- -k,--keep-unused                    指定未使用资源仍然打包
+     --identity <arg>                指定签名 (iOS)
+  -k,--keep-unused                   指定未使用资源仍然打包
                                      输出
- -l,--liveupdate <arg>               要在发布后使用热更新功能
-                                     参数填yes
- -mp,--mobileprovisioning <arg>      指定mobileprovisioning profile (iOS)
- -o,--output <arg>                   输出目录. 默认是
+     --keystore <arg>                Android 打包密鑰文件.
+     --keystore-pass <arg>           Android 打包密鑰密碼文件路徑.
+     --keystore-alias <arg>          Android 打包密鑰別名文件路徑.
+  -l,--liveupdate <arg>              要在发布后使用热更新功能
+                                     参数填 yes
+ -mp,--mobileprovisioning <arg>      指定 mobileprovisioning profile (iOS)
+  -o,--output <arg>                  输出目录. 默认是
                                      "build/default"
- -p,--platform <arg>                 发布平台 (打包时)
- -r,--root <arg>                     指定编译目录. 默认是
+  -p,--platform <arg>                发布平台 (打包时)
+  -r,--root <arg>                    指定编译目录. 默认是
                                      当前目录
-    --settings <arg>                 指定项目设置文件的
+     --settings <arg>                指定项目设置文件的
                                      路径. 可以使用多个
                                      文件. 设置根据文件
                                      从左到右应用.
-    --strip-executable               去掉dmengine的debug信息
+     --strip-executable              去掉dmengine的debug信息
                                      (编译 iOS 或 Android时)
  -tc,--texture-compression <arg>     使用纹理档中指定的
                                      纹理压缩
  -tp,--texture-profiles <arg>        使用纹理压缩档 (弃用)
- -u,--auth <arg>                     用户auth符
-    --use-vanilla-lua                只使用 vanilla 源代码 (即
+     --use-vanilla-lua               只使用 vanilla 源代码 (即
                                      不要字节码)
- -v,--verbose                        冗余输出
-    --variant <arg>                  指定使用 debug, release 或者 headless
-                                     dmengine版本 (编译时)
-    --version                        打印输出
+  -v,--verbose                       冗余输出
+     --variant <arg>                 指定使用 debug, release 或者 headless
+                                     dmengine版本 (编译时)
+     --version                       打印输出
                                      版本号
-    --with-symbols                   生成标记文件 (如果
+     --with-symbols                  生成标记文件 (如果
                                      可用)
-    --bundle-format <apk|aab>        使用哪种格式打 Android 包.
-    --keystore <arg>                 使用哪个密匙注册
-                                     Android 包.
-    --keystore-pass <arg>            密匙密码路径用于打 Android 包.
-    --keystore-alias <arg>           密匙别名用于打 Android 包.
 ```
 
 支持的命令:

+ 5 - 4
docs/zh/manuals/physics-joints.md

@@ -7,10 +7,11 @@ brief: Defold 支持 2D 物理关节约束. 本教程介绍了其用法.
 
 Defold 支持物理关节. 一个关键基于某种限制连接两个物体. 支持的关节类型如下:
 
-* Fixed (physics.JOINT_TYPE_FIXED) - 限制两物体最大距离的固定关节. 在 Box2D 被称为绳子关节.
-* Hinge (physics.JOINT_TYPE_HINGE) - 把两个物体通过一个锚点钉在一起的钉子关节. 两物体相对位置固定而相对旋转没有限制. 这种关节可以开启马达给一个最大扭力与速度. 在 Box2D 被称为旋转关节.
-* Spring (physics.JOINT_TYPE_SPRING) - 限制两个物体之间距离范围的弹簧关节. 弹簧关节通过设定其频率和阻尼比可以让物体像是被软弹簧连接. 在 Box2D 被称为距离关节.
-* Slider (physics.JOINT_TYPE_SLIDER) - 限制两物体只能在某个指定轴上相对移动而不允许相对转动的滑动关节. 在 Box2D 被称为活塞关节.
+* **Fixed (physics.JOINT_TYPE_FIXED)** - 限制两物体最大距离的固定关节. 在 Box2D 被称为绳子关节.
+* **Hinge (physics.JOINT_TYPE_HINGE)** - 把两个物体通过一个锚点钉在一起的钉子关节. 两物体相对位置固定而相对旋转没有限制. 这种关节可以开启马达给一个最大扭力与速度. 在 Box2D 被称为旋转关节.
+* **Weld (physics.JOINT_TYPE_WELD)** - 用於完全保持對象之間的位置關係的關節. 通過調整頻率和阻尼率軟化的焊接關節可以產生類似彈簧的效果. 在 Box2D 被称为焊接关节.
+* **Spring (physics.JOINT_TYPE_SPRING)** - 限制两个物体之间距离范围的弹簧关节. 弹簧关节通过设定其频率和阻尼比可以让物体像是被软弹簧连接. 在 Box2D 被称为距离关节.
+* **Slider (physics.JOINT_TYPE_SLIDER)** - 限制两物体只能在某个指定轴上相对移动而不允许相对转动的滑动关节. 在 Box2D 被称为活塞关节.
 
 ## 建立关节
 

+ 2 - 3
docs/zh/manuals/physics-shapes.md

@@ -36,7 +36,7 @@ brief: 碰撞对象的形状可以包含多个简单形状组成也可以由一
 复杂形状可以由瓷砖地图生成或者使用凸多边形.
 
 ## 瓷砖地图碰撞形状
-Defold 包含一个功能就是从瓷砖地图中自动生成物理碰撞形状. [瓷砖地图教程](/manuals/tilemap/) 介绍了新建瓷砖图源的碰撞组与把瓷砖分配给碰撞组的 ([例子](/examples/tilemap/collisions/)).
+Defold 包含一个功能就是从瓷砖地图中自动生成瓷磚圖源的物理碰撞形状. [瓷砖圖源教程](/manuals/tilesource/#tile-source-collision-shapes) 介绍了新建瓷砖图源的碰撞组与把瓷砖分配给碰撞组的 ([例子](/examples/tilemap/collisions/)).
 
 在瓷砖地图上添加碰撞:
 
@@ -63,8 +63,7 @@ Defold 有一个功能就是让你用3个或多个点建立凸多边形. 可以
 
 
 # 缩放碰撞形状
-
-可以让碰撞形状继承游戏对象的缩放. 在 *game.project* 里的物理部分勾选 [Allow Dynamic Transforms](/manuals/project-settings/#Allow Dynamic Transforms) 即可. 注意缩放继承只支持等比缩放, 如果不等比, 去三周最小值.
+碰撞對象及其形狀繼承于游戲對象. 不想要該功能的話可以取消勾選 *game.project* 中物理部分下的 [Allow Dynamic Transforms](/manuals/project-settings/#allow-dynamic-transforms). 注意只有等比縮放受支持, 數值不等比的話以最小的一項數值為准.
 
 
 # 旋转碰撞形状

+ 5 - 2
docs/zh/manuals/project-settings.md

@@ -140,10 +140,10 @@ debug线的不透明度, `0`--`1`. 默认是 `0.9`.
 设定物理世界与游戏世界的数值映射比例, `0.01`--`1.0`. 如果设置为 `0.02`, 相当于物理引擎视50个游戏单位为1米 ($1 / 0.02$). 默认值是 `1.0`.
 
 #### Allow Dynamic Transforms
-设定物理世界碰撞物体是否进行像游戏对象同等的缩放.
+設置物理碰撞對象縮放是否繼承于其父級游戲對象. 默認為 `true`.
 
 #### Debug Scale
-设置物理元物体画多大, 比如原向量和法线,  默认是`30`.
+设置物理元物体画多大, 比如原向量和法线,  默认是 `30`.
 
 #### Max Collisions
 设置向脚本报告多少个碰撞, 默认是 `64`.
@@ -238,6 +238,9 @@ HTTP超时秒数. 设置为 `0` 则关闭超时, 默认关闭.
 #### Max Sound Instances
 同一时间声音实例最大数目, 也就是实际同时播放声音最大数目. 默认是 `256`.
 
+#### Use Thread
+勾選的話, 系統將使用綫程進行聲音播放以減少因爲主綫程過載造成的卡頓. 默認勾選.
+
 ## Sprite
 
 #### Max Count

+ 3 - 1
docs/zh/manuals/shader.md

@@ -186,6 +186,8 @@ void main()
 
 ## 深入学习
 
-- 著名着色器开源站 Shadertoy (https://www.shadertoy.com) 上有大量开发者开源着色器. 可以通过学习各种着色技术作为自己的灵感源泉. 其中很多着色器改改就能应用到 Defold 中去. [Shadertoy 教程](https://www.defold.com/tutorials/shadertoy/) 介绍了把网站着色器用于 Defold 的具体步骤.
+- [Shadertoy](https://www.shadertoy.com) 上有大量开发者开源着色器. 可以通过学习各种着色技术作为自己的灵感源泉. 其中很多着色器改改就能应用到 Defold 中去. [Shadertoy 教程](https://www.defold.com/tutorials/shadertoy/) 介绍了把网站着色器用于 Defold 的具体步骤.
 
 - [渐变教程](https://www.defold.com/tutorials/grading/) 介绍了使用纹理采样进行全屏颜色渐变效果的编写方法.
+
+- [The Book of Shaders](https://thebookofshaders.com/00/) 介紹了將著色器應用於項目的方法, 有利於提高性能和視覺效果.

+ 4 - 1
docs/zh/manuals/sound.md

@@ -27,7 +27,10 @@ Defold 支持声音但是不那么强大. 要注意两个概念:
 : 从项目中选择一个声音文件. 文件需要 _Wave_ 或者 _Ogg Vorbis_ 格式. Defold 支持 16bit 位深和 44100 采样率的声音文件.
 
 *Looping*
-: 开启此选项声音会循环播放除非手动停止.
+: 开启此选项声音会循环播放除非循環次數達到 _Loopcount_ 或者手动停止.
+
+*Loopcount*
+: 停止前要循環播放的次數 (0 表示除非手動停止否則永遠循環).
 
 *Group*
 : 声音属于的组. 如果置空, 此声音默认归属 "master" 组.