2.6

docs/mcdocs/1-ModAPI/接口/方块/渲染.md

@@ -123,6 +123,43 @@ print comp.DeleteClientDropItemEntity(entityId)
 
 
 
+## DestroyCrackFrame
+
+<span style="display:inline;color:#7575f9">客户端</span>
+
+method in mod.client.component.blockInfoCompClient.BlockInfoComponentClient
+
+- 描述
+
+    销毁特定方块位置上的破坏纹理（仅能销毁SetCrackFrame接口创建的破坏纹理）。
+
+- 参数
+
+    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | dimensionId | int | 方块所在维度。 |
+    | blockPos | tuple(int,int,int) | 目标方块的坐标。 |
+
+- 返回值
+
+    | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- |
+    | bool | 是否执行成功。 |
+
+- 备注
+    - 如果方块被替换，需开发者主动销毁裂纹
+
+- 示例
+
+```python
+import mod.client.extraClientApi as clientApi
+comp = clientApi.GetEngineCompFactory().CreateBlockInfo(levelId)
+# 销毁位置(30,66,30)的破坏纹理
+comp.DestroyCrackFrame(0, (30, 66, 30))
+```
+
+
+
 ## GetBlockEntityExtraUniforms
 
 <span style="display:inline;color:#7575f9">客户端</span>
@@ -444,7 +481,7 @@ method in mod.client.component.blockInfoCompClient.BlockInfoComponentClient
     | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
     | :--- | :--- | :--- |
     | pos | tuple(int,int,int) | 方块所在位置 |
-    | scale | tuple(int,int,int) | 实体模型在x,y,z各个轴上的缩放值。支持负值，当某一轴的缩放值为负值时，表示模型将会在这个轴上进行以另外两个轴为对称平面的镜像变换。 |
+    | scale | tuple(float,float,float) | 实体模型在x,y,z各个轴上的缩放值。支持负值，当某一轴的缩放值为负值时，表示模型将会在这个轴上进行以另外两个轴为对称平面的镜像变换。 |
 
 - 返回值
 
@@ -454,7 +491,7 @@ method in mod.client.component.blockInfoCompClient.BlockInfoComponentClient
 
 - 备注
     - 模型的大小可以通过两个方式来调整：
-        (1) 在entity.json中scripts字段下定义scale，如下所示
+        (1) 在entity.json中scripts字段下定义scale，如下所示：
             "minecraft:client_entity": {
                 ...
                 "scripts":{
@@ -549,3 +586,79 @@ print comp.SetBlockRenderDistance(48)
 
 
 
+## SetCrackFrame
+
+<span style="display:inline;color:#7575f9">客户端</span>
+
+method in mod.client.component.blockInfoCompClient.BlockInfoComponentClient
+
+- 描述
+
+    仅客户端的破坏纹理的渲染，可自定义破坏阶段在第几帧。
+
+- 参数
+
+    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | dimensionId | int | 方块所在维度。 |
+    | blockPos | tuple(int,int,int) | 目标方块的坐标。 |
+    | frame | int | 第几张纹理（取值范围0-9）。 |
+
+- 返回值
+
+    | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- |
+    | bool | 是否执行成功（不代表必定能显示裂纹）。 |
+
+- 备注
+    - 目前自定义方块实体外观，不支持裂纹的显示（client_entity、netease_model）。
+
+- 示例
+
+```python
+import mod.client.extraClientApi as clientApi
+comp = clientApi.GetEngineCompFactory().CreateBlockInfo(levelId)
+# 在(30,66,30)这个位置播放破坏方块的纹理，进度为1
+comp.SetCrackFrame(0, (30, 66, 30), 1)
+```
+
+
+
+## SetDropItemTransform
+
+<span style="display:inline;color:#7575f9">客户端</span>
+
+method in mod.client.component.itemCompClient.ItemCompClient
+
+- 描述
+
+    设置通过AddDropItemToWorld添加的掉落物的位置、角度和缩放
+
+- 参数
+
+    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | entityId | str | 掉落物的entityId，entityId可在调用[AddDropItemToWorld](#AddDropItemToWorld)时保存返回值，或者通过[GetClientDropItemEntityIdList](#GetClientDropItemEntityIdList)接口获取list |
+    | position | tuple(float,float,float) | 生成的掉落物所在位置。如需设置后续参数需填写None占位，传None表示不修改 |
+    | rotation | tuple(float,float,float) | 选填，设置掉落物的角度，不填默认为None，设置rotation后将会固定角度[AddDropItemToWorld](#AddDropItemToWorld)设置的spinSpeed无效。如需设置后续参数需填写None占位，传None表示不修改 |
+    | scale | float | 选填，设置掉落物的缩放，不填默认为None，传None表示不修改 |
+
+- 返回值
+
+    | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- |
+    | bool | 是否成功 |
+
+- 备注
+    - Scale不能为负数，设置过大可能会导致掉落物消失，同时Scale过大会出现某些摄像机视角不会渲染的情况
+
+- 示例
+
+```python
+import mod.client.extraClientApi as clientApi
+comp = clientApi.GetEngineCompFactory().CreateItem(levelId)
+print comp.SetDropItemTransform(entityId, (10, 10, 10), (90, 45, 30), 1.5) # entityId需要AddDropItemToWorld接口获取
+```
+
+
+