feat:上传mcguide-开发指南部份

2024-12-23 10:57:59 +08:00
parent 7292166c88
commit 0dc59fa4f0
3297 changed files with 63375 additions and 0 deletions
--- a/mcguide/20-玩法开发/14-预设玩法编程/11-深入理解预设/4-预设变换.md
+++ b/mcguide/20-玩法开发/14-预设玩法编程/11-深入理解预设/4-预设变换.md
@@ -0,0 +1,182 @@
+# 预设变换
+
+## 坐标属性
+
+![1625726982736](./images/1625726982736.png)
+
+如上图所示,预设属性中坐标变换有三类属性：位置，旋转，缩放。此三类属性都有(x,y,z)轴3个值。
+
+**位置**: 设置预设在父节点坐标系的位置偏移，如果预设是根节点，则设置预设在世界坐标系的位置。
+
+**旋转**: 设置预设在父节点坐标系的旋转欧拉角度。如果预设是根节点，则设置预设在世界坐标系下的旋转欧拉角。
+
+**缩放**: 设置预设在父节点坐标系的缩放系数。如果预设是根节点，则设置预设在世界坐标系下的缩放系数。
+
+
+
+**坐标的属性变换顺序**：
+
+![](./images/1625730517868.png)![1625730585491](./images/1625730585491.png)
+
+
+
+![1625733206438](./images/1625733206438.png)![1625733280166](./images/1625733280166.png)
+
+如上参数所示，预设是按照当前所在坐标系，先进行**缩放**变换，然后进行**旋转**变换，然后进行位置**平移**变换。
+
+**旋转变换**的顺序是先按**Z轴**旋转，再按**X轴**旋转，再按**Y轴**旋转。
+
+各变换参考的坐标系都是当前所在父节点的坐标系（根节点则是世界坐标系），而不是自身的缩放和旋转变换后的坐标系。
+
+
+
+## 预设变换操作
+
+**鼠标拾取和选中**：
+
+![1625735741835](./images/1625735741835.png)![1625735833546](./images/1625735833546.png)![1625736191024](./images/1625736191024.png)  
+
+鼠标左键**单击**地图**场景中**的特效,生物,素材等预设，即可**选中**当前预设，进行相关操作。
+
+鼠标左键**单击关卡编辑器**里的**舞台界面**中的预设列表项，或者**预设编辑器**里**层级界面**中的预设列表，也可以选中对应预设。
+
+鼠标左键**双击**预设列表项则会**快速定位**到对应预设的位置。
+
+
+
+在**预设编辑器**中，因为**根节点**没有坐标变换相关属性，因此**不能选中操作根节点**。
+
+![1625745022676](./images/1625745022676.png)![1625745091606](./images/1625745091606.png)
+
+如生物预设，因为不能挂载在其他预设节点下面，因此不能在预设编辑器点击选中和操作。
+
+![1625745206164](./images/1625745206164.png)![1625745231339](./images/1625745231339.png)
+
+特效预设可以挂载在预设节点之下，因此可以在预设编辑器下点击选中进行操作。
+
+
+
+**切换操作模式**：
+
+![1625736614607](./images/1625736721582.png)![1625736938598](./images/1625736938598.png)![1625736968462](./images/1625736968462.png)
+
+在当前选中预设时，按键盘数字键"**1**" "**2**" "**3**" 可以切换操作模式为**位置平移**，**旋转**和**缩放**操作模式。
+
+![](./images/1625737797422.png) ![](./images/1625737920101.png)
+
+**平移和缩放操作**：点击对应操作坐标轴，按住鼠标左键，移动鼠标方向，即可操作移动或拉伸预设。
+
+![](./images/1625737856125.png)
+
+**旋转操作**：点击对应操作坐标轴，按住鼠标左键，向**右下**移动**增加**旋转角度，向**左上**移动**减少**旋转角度。
+
+注意，**旋转的顺序是ZXY轴**,因此旋转操作最终效果**由ZXY旋转角度的顺序**决定。
+
+
+
+## 预设变换限制
+
+预设操作因为MC的规则限制，
+
+**素材预设变换限制：**
+
+		位置限制：素材方块对应坐标需为整数，对应非整数部分，舍去小数部分处理。
+
+		旋转限制：素材方块只能旋转90度的倍数角度，非90度倍数部分忽略，对于负角度按对应正方向角度处理。
+
+					       如旋转300度，对应素材方块旋转270度。而旋转-40度，对应旋转320度，对应素材旋转270度。
+
+						   同时一些方块如床等也有旋转方向的限制。
+
+	    缩放现在:  素材缩放效果不会小于1个方块。
+
+                          素材缩放最大值100，同时素材方块尺寸不能多于一千万个方块。素材尺寸太大会影响操作性能。
+
+						  素材缩放尺寸的系数为负值，则当做正值处理。
+
+**生物预设变换限制：**
+
+		旋转限制：生物旋转只支持Y轴，X和Z轴旋转只忽略。
+
+	    缩放现在:  生物缩放最小值为0.1,同时缩放效果不会小于1个方块。
+
+                          素材缩放最大值100，同时素材方块尺寸不能多于一千万个方块。素材尺寸太大会影响操作性能。
+
+特效变换限制：
+
+		旋转限制：序列帧特效的旋转同时会受到**始终面向相机**的属性影响。
+
+							粒子特效的旋转同时会受到**特效方向**以及**粒子朝向模式**的影响。
+
+![](./images/1625748565709.png)
+
+![](./images/1625748639428.png) ![](./images/1625748680515.png)
+
+
+
+## 预设变换API
+
+![1625813374207](./images/1625813374207.png)
+
+**变换更新间隔(updateTransformInterval):** 
+
+		用来控制游戏模式下预设及子节点的坐标变换(位置,旋转,缩放)更新间隔，默认值为2。  我的世界逻辑帧率为每秒30帧，建议对于非必要每帧更新的预设设置此值为合适值。 
+
+		设置为0时,通过API设置预设的坐标变换都不会更新,因此其附加子节点也不会跟随更新。设置为1时,每帧更新。设置为2时，则每两帧更新一次。
+
+		如游戏模式下，生物预设挂载了一个特效预设为子节点。其中生物预设的变换更新间隔是0，则通过API控制生物预设或者游戏内AI或者操作逻辑移动了生物对象，其坐标变换也不会更新修改。因此其挂载的特效也不会有位置或者旋转的跟随变换。如果变换更新间隔为10，则每10帧同步更新一次坐标变换，同时也会更新其特效子节点的位置变换。
+
+
+
+**Transform**:
+
+		Transform对象拥有**pos**(位置),**rotation**(旋转),**scale**(缩放)三个属性,都为**tulpe(x,y,z)**格式。
+
+        通过**AddOffset**,**AddRotation**,**AddScale**接口,传入对应tuple(x,y,z)参数，可在Transform当前属性基础上修改Transform对应的pos,rotation,scale属性。
+
+		通过**AddTransform**接口,传入一个Transform对象，可在Transform当前属性基础上同时修改Transform对应的pos,rotation,scale属性。
+
+       注意，Transform对象本身并没有关联父节点数据，同时也没关联其游戏内所在对象。
+
+	   通过以上接口直接操作Transform的属性，并不会对游戏内关联对象产生坐标变换的更新。
+
+
+
+**TransformObject**:
+
+		TransformObject对象关联了游戏种的生物，特效等象，同时关联其父节点和子节点。通过此对象API可以控制游戏对象和其子节点的在游戏中的坐标变换。
+
+	    TransformObject的坐标变换属性有两个坐标参考系，一个是**WorldTransform**，对应的是**世界坐标系**下的坐标变换（位置,旋转,缩放）属性。一个是**LocalTransform**,对应的是其**父节点局部坐标系**下的坐标变换（位置,旋转,缩放）属性。当一个预设节点是根节点时，其WorldTransform和LocalTransform相等。
+
+		WorldTransform是由LocalTransform和父节点的局部坐标系转换得到，因此以下接口修改WorldTransform会转换成修改对应的LocalTransform属性。而修改LocalTransform即同时修改了WorldTransform属性。
+
+		**GetLocalTransform**接口:
+
+		获取当前TransformObject的Transform对象。此Transform属性对应的是其在父节点的局部坐标系下的坐标转换属性。本身为根节点则为世界坐标系下坐标转换属性。
+
+	   **SetLocalTransform**接口:
+
+		传入一个Transform对象，设置其在父节点的局部坐标系下的坐标转换属性。本身为根节点则为世界坐标系下坐标转换属性。
+
+		获取和修改**LocalTransform**具体属性：
+
+		GetLocalPosition，SetLocalPosition，GetLocalRotation，SetLocalRotation，GetLocalScale，SetLocalScale分别获取和设置LocalTransform的pos(位置),rotation(旋转),scale(缩放)属性。
+
+		AddLocalOffset，AddLocalRotation，AddLocalScale分别增加LocalTransform的pos(位置),rotation(旋转),scale(缩放)属性值。可用来实现其在父节点局部坐标系下如按速度旋转或者移动的逻辑。
+
+
+
+		**GetWorldTransform**接口：
+
+		获取当前TransformObject的在世界坐标系下坐标转换属性。当其为根节点时，此值和GetLocalTransform一致。当其为子节点时，则由其LocalTransform和父节点的WorldTransform变换得到。
+
+	   **SetWorldTransform**接口：
+
+		传入一个Transform对象，设置其在世界坐标系下转换属性。本身为根节点则和SetLocalTransform一致。其为子节点，则根据父节点的WorldTransform转换得到对应LocalTransform。
+
+		获取和修改**WorldTransform**具体属性：
+
+		GetWorldPosition，SetWorldPosition，GetWorldRotation，SetWorldRotation，GetWorldScale，SetWorldScale分别获取和设置**WorldTransform**的pos(位置),rotation(旋转),scale(缩放)属性。
+
+		AddWorldOffset，AddWorldRotation，AddWorldScale分别增加**WorldTransform**的pos(位置),rotation(旋转),scale(缩放)属性值。可用来实现其在世界坐标系下如按速度旋转或者移动的逻辑。
+