1. 复制标准模型创建整体场景

复制标准模型(如标准层)生成整体模型,并可递增修改特定构件属性。


请求方式:POST

请求地址:/api/{databaseKey}/scenes/array/standard

1.1. 请求参数

Headers:

参数名 类型 示例 是否必填 参数含义
Authorization string c4570cb9ca324bc8ba7dd9d1967710ea 操作的通关令牌

PathParas:

参数名 类型 示例 是否必填 参数含义
databaseKey string test 数据库key,必传

SearchParas:

参数名 类型 示例 是否必填 参数含义
无参数 NULL NULL NULL NULL

Body

application/json:

{
  "name": "复制标准层形成的整体模型",
  "mesh": [
    {
      "type": "model",
      "modelKey": "M157767667407",
      "count": 10,  // 递增数量,必传
        "attributeIncr": [    // 递增(减)属性
       {
               "name":"BeePC.BOM.PCData.PCCode",  
             "initial": 1, //初始值
             "increment": 1,  //递增值,非必传,默认为1
             "pattern": "SPLIT(-, 4)"  // 替换方式,必传
       },
    {
      ... ...
      "pattern": "SUBSTRING(11, 12)"  // 替换方式,必传
    },
    ... ...
    ],
    "matrixIncr":{
       //第一个模型相对于原始位置的偏移xyz
       "base":[0,0,0]
       //后续模型基于第一个模型的偏移xyz
      "increment":[0,3,1]
     }  
     "attribute": {  // 固定值属性
         "约束.标高": "标高1",
         ......
      }
    },
    {
      "type": "components",
      "componentsKey": ["M157767674083_24", .....],
      "count": 10,  // 递增数量,必传
      "attributeIncr": [  // 递增(减)属性
                  ... ...
       ],
       "matrixIncr":{},  // 递增(减)矩阵    
       "attribute": {  // 固定值属性
           ... ...
        }
    }
  ]
},
    "docKey": "012e245f581788970"
}

1.2. 参数说明

参数名 类型 示例 是否必填 参数含义
name string 阵列 名字
type string model 类型
modelKey string M157767667407 模型key
matrix string [1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1] 矩阵

1.3. 正确返回

{
    "message": "请求处理成功",
    "code": "SUCCESS",
    "data": {
        "remark": "场景正在创建中",
        "key": "M1604894785223",
        "status": "0"
    }
}

1.4. 状态码

状态码 code message data 原因
400 BAD_PARAMETER type(xxx)类型不正确 NULL 当type类型不是model、components时;当参数中某个key的值类型不正确时;当attributeIncr和attribute中的属性名重复时
400 PARAMETER_REQUIRED 参数(children)不能为空 NULL 当group类型下不包含children时;当attributeIncr、name、pattern、matrixIncr或者matrixIncr中的increment为空时
400 COMPONENT_NOT_FOUND 构件(xxx)不存在 NULL 当component的key不存在时
400 MODEL_NOT_FOUND 模型(xxx)不存在 NULL 当model的key不存在时
400 BAD_PARAMETER_TYPE 参数(xxx)类型不正确 NULL 当count或attributeIncr中的 initial、increment不为int时;当pattern不以SPLIT或SUBSTRING开头时
400 BAD_PARAMETER_FORMAT 参数(pattern)格式不正确 NULL 当pattern格式错误时

1.5. 备注

1、1.0版几何格式的模型或构件与2.0、3.0版几何格式不兼容。

2、此接口DWG图纸不适用。

1.6. 注意事项

1)type类型必须为model、components其中之一

2)生成新场景的长度单位是mm,若参数模型长度为其他单位,统一转为mm

3)复制原模型中的几何、材质、纹理和属性数据,构建一个独立的模型

4)attribute在components下代表修改一组构件的属性;attribute在model下代表修改模型所有构件的属性。如构件无指定属性,则增加,如有则替换原属性

5)attribute属性中,key为多层级属性名,层级间用点号隔开,value为属性值。

6)在递增属性中,pattern为SPLIT开头时,根据分隔符和分隔区域(area)确定需要修改的数字位置,区域在第area-1至第area个分隔符之间。当area超出分隔符总数时,不作处理。同时,这种递增只支持"xxF"格式的递增。

7)在递增属性中,pattern为SUBSTRING开头时,使用下标类型截取数字进行递增。

8)在递增属性中,initial传值为0时,视为未传值;未传值时,根据attributeIncr中的name、start、end取基准模型相应属性值

9)在递增属性中,increment传值为0时,视为未传值;increment允许传负数,传负数时属性递减

10)在递增属性中,只允许修改构件attribute中的属性

11)若递增属性不为String类型,不作处理

12)自动生成空间树,以构件为单位,每次递增的所有构件代表一层楼,在空间树中按类型划分,空间树从1楼开始递增。

版权所有@盈嘉互联(北京)科技有限公司 京ICP备15051988号-9 Copyright © 2021 all right reserved,powered by Gitbook该文件修订时间: 2021-08-25 16:16:24

results matching ""

    No results matching ""