3D
所有文档

          AR开放平台

          3D

          Plane

          此类描述json PLANE相关字段

          version
          Fields
          Plane maxHorizontalAngle
          水平方向最大旋转角度
          Plane minHorizontalAngle
          水平方向最小旋转角度
          Plane minVerticalAngle
          竖直方向最小旋转角度
          Plane maxVerticalAngle
          竖直方向最大旋转角度
          Plane rotateLimit
          配置水平和竖直方向的旋转角度
          Plane batchNum
          分布加载批次id
          Plane keepAspectRatio
          保持随屏节点原有比例大小
          Plane offScreenGuidanceNodeConfig
          离屏引导主节点配置
          Plane offScreenGuidanceNodeConfig
          离屏引导主节点配置
          Plane offScreenGuidanceTarget
          离屏引导主节点配置开关
          Plane children
          子节点
          Plane common
          通用material配置
          Plane defaultShaderName
          默认shader名称
          Plane depthPosition
          随屏深度信息
          Plane heightRatio
          节点相对父节点的高度百分比
          Plane hudDisplay
          随屏参数配置
          Plane hudElement
          节点(中心点)距离屏幕上方百分比
          Plane marginLeft
          节点(中心点)距离屏幕左边百分比(hudDisplay使用)
          Plane marginLeft
          节点(左上点)距离父节点左边百分比(hudElement使用)
          Plane marginTop
          节点(中心点)距离屏幕上方百分比(hudDisplay使用)
          Plane marginTop
          节点(左上点)距离父节点上方百分比(hudElement使用)
          Plane material
          material配置
          Plane name
          开发者自定义,建议名称有具体含义
          Plane position
          模型在三维空间的位置
          Plane record
          HUD物体是否录进屏幕
          Plane ratio
          随屏节点屏占比
          Plane rotation
          模型旋转角度
          Plane scale
          模型在各个方向放大或缩小倍数
          Plane screenHeightRatio
          节点所占屏幕高度百分比
          Plane screenRatio
          随屏节点屏占比
          Plane screenWidthRatio
          节点所占屏幕宽度百分比
          Plane textureList
          节点所占屏幕宽度百分比
          Plane textureName
          图片名称(图片存储路径)
          Plane touchable
          是否可点击
          Plane type
          当前节点类型
          Plane visible
          是否显示
          Plane widthRatio
          节点相对父节点的宽度百分比
          Public methods
          Plane PlaneDemo()
          Plane示例

          PlaneDemo ()

          Plane示例

          sample:
          {
          "name": "custom_name",
          "type": "plane",
          "visible": 1,
          "touchable": 1,
          "batchNum":1,
          "offScreenGuidanceNodeConfig": 
          {
             "offScreenGuidanceTarget":1
          },
          "material": 
          {
             "common": 
             {
                "defaultShaderName": "planeShader",
                "textureList": [
                {
                   "textureName": "res/texture/xxx.png"
                }
                ]
             }
          },
          "scale": "1,1,1",
          "position": "0,0,0",
          "rotation": "90,0,0",
          "record":0,
          "children":[]
          }

          hudElement

          version 150

          随屏参数配置(非随屏元素无需添加该字段)

           sample:
          
           //以手机屏幕作为顶层布局
           {
                  "name": "XXX",
                  "type": "plane",
                  "visible": 1,
                  "touchable": 0,
                  "material": {
                      "common": {
                          "defaultShaderName": "planeShader",
                          "textureList": [
                              {
                                  "textureName": "res/texture/XX.png"
                              }
                          ]
                      }
                  },
                  "hudElement": {
                      "marginLeft": 0,
                      "marginTop": 0.35,
                      "depthPosition": -200,
                      "ratio": {
                          "heightRatio" : 0.0479,
                          "keepAspectRatio":1
                      }
                  },
                  "children": []
            }
          
           // 如父节点无hudElement则相对手机屏幕布局,否则相对父节点布局
             {
                  "name": "parent",
                  "type": "plane",
                  "visible": 1,
                  "touchable": 1,
                  "material": {
                      "common": {
                          "defaultShaderName": "planeShader",
                          "textureList": [
                              {
                                  "textureName": "res/texture/xx.png"
                              }
                          ]
                      }
                  },
                  "hudElement": {
                      "marginLeft": 0,
                      "marginTop": 0.5,
                      "depthPosition": 0,
                      "ratio": {
                          "heightRatio" : 0.0479,
                           "keepAspectRatio":1
                      }
                  },
                  "children": [
                              //child 相对parent作为布局
                               {
                               "name": "child",
                               "type": "plane",
                               "visible": 1,
                               "touchable": 0,
                               "material": {
                               "common": {
                               "defaultShaderName": "planeShader",
                               "textureList": [
                                               {
                                               "textureName": "res/texture/xx.png"
                                               }
                                               ]
                               }
                               },
                               "hudElement": {
                               "marginTop": 0, 
                               "marginLeft": 0.8, 
                               "depthPosition": -100, //相对父节点,此时child depthPosition = -100
                               "ratio": {
                               "heightRatio" : 1,
                               "widthRatio": 1
                               }
                               }
                               }
                  ]
          }

          ratio

          version 150

          随屏节点屏占比,控制在屏幕上显示的大小,该属性会覆盖scale字段

          sample:
          "ratio": 
          {
             "widthRatio": 1,
             "heightRatio": 1,
             "keepAspectRatio":1
          }

          heightRatio

          version 150

          节点所占屏幕高度百分比,只设置heightRatio一个参数时,widthRatio会随着heightRatio变化,呈矩形显示。两个参数都不设置时,不显示节点。

          sample:
          详见:"ratio"字段

          widthRatio

          version 150

          节点所占屏幕宽度百分比, 只设置widthRatio一个参数时, heightRatio会随着widthRatio变化,呈矩形显示。两个参数都不设置时,不显示节点。

          sample:
          详见:"ratio"字段

          marginLeft

          version 150

          节点(左上点)距离父节点左边百分比,默认为0。

          sample:
          详见:"ratio"字段

          marginTop

          version 150

          节点(左上点)距离父节点上方百分比, 默认为0

          sample:
          详见:"ratio"字段

          maxHorizontalAngle

          version 100

          需lua内开启 enable_only_rotate_horizontal,默认值为0,水平方向最大旋转角度(正方向)[0,180] (number 类型)

          sample:
          详见:"rotateLimit"字段

          maxVerticalAngle

          version 100

          需lua内开启 enable_only_rotate_vertical,默认值为0,竖直方向最大旋转角度(正方向)[0,180] (number 类型)

          sample:
          详见:"rotateLimit"字段

          minHorizontalAngle

          version 100

          需lua内开启 enable_only_rotate_horizontal,默认值为0 水平方向最小旋转角度(负方向) [-180,0] (number 类型)

          sample:
          详见:"rotateLimit"字段

          minVerticalAngle

          version 100

          需lua内开启 enable_only_rotate_vertical,默认值为0,竖直方向最小旋转角度(负方向)[-180,0] (number 类型)

          sample:
          详见:"rotateLimit"字段

          rotateLimit

          version 100

          配置水平和竖直方向的旋转角度

          sample:
          "rotateLimit": 
          {
             "minHorizontalAngle": -30,
             "maxHorizontalAngle": 30,
             "minVerticalAngle": -30,
             "maxVerticalAngle": 30
          }

          batchNum

          version 23

          分布加载批次id,默认加载批次为0,依次递增

          sample:
          "batchNum":1

          keepAspectRatio

          version 23

          保持随屏节点原有比例大小, 默认为0,配置为1生效(有"screenWidthRatio"字段,会以此字段计算图片宽度,再反算高度,保持图片长宽比不变;无"screenWidthRatio"字段,有"screenHeightRatio"字段,会以screenHeightRatio字段计算图像高度,以此反算宽度,保持随屏节点长宽比不变;若两者都无,则宽度高度保持原始图片大小)

          sample:
          "keepAspectRatio":1

          offScreenGuidanceNodeConfig

          version 23

          离屏引导主节点配置,当需要配置该节点为主节点时添加

          sample:
          "offScreenGuidanceNodeConfig": 
          {
             "offScreenGuidanceTarget":1
          }

          offScreenGuidanceTarget

          version 23

          离屏引导主节点配置开关 1表示该节点是主节点,0表示不是

          sample:
          详见offScreenGuidanceNodeConfig字段

          children

          version 8

          子节点,里面元素类型也是node类型,children包含可以包含任意类型的子节点,子节点格式同对应类型的配置一样

          sample:
          "children":[]

          common

          version 8

          通用material配置,其他的有Android和ios平台配置

          sample:
          使用见:material字段 code

          defaultShaderName

          version 8

          默认shader名称

          sample:
          使用见:material字段 code

          depthPosition

          version 8

          随屏深度信息,用于控制多个随屏模型前后的叠加位置, 默认是19000,范围是【-20000-20000】,不能等于20000和-20000

          sample:
          详见:"hudDisplay"字段

          hudDisplay

          version 8

          随屏参数配置(非随屏元素无需添加该字段)

          open SDK2.3版本之后推荐使用hudElement进行配置

          sample:
          "hudDisplay": 
          {
             "marginLeft": 0,
             "marginTop": 0,
             "depthPosition": 19000,
             "screenRatio": 
             {
                "screenWidthRatio": 1,
                "screenHeightRatio": 1
                "keepAspectRatio":1
             }
           }

          marginLeft

          version 8

          节点(中心点)距离屏幕左边百分比,取值范围0.0~1.0, 默认为0

          sample:
          详见:"hudDisplay"字段

          marginTop

          version 8

          节点(中心点)距离屏幕上方百分比,取值范围0.0~1.0, 默认为0

          sample:
          详见:"hudDisplay"字段

          material

          version 8

          material配置

          sample:
          "material": 
          {
             "common": 
             {
                "defaultShaderName": "planeShader",
                "textureList": [
                {
                "textureName": "res/texture/xxx.png"
                }
                ]
             }
          }

          name

          version 8

          开发者自定义,建议名称有具体含义 (string 类型)

          sample:
          "name":"xxx"

          position

          version 8

          模型在三维空间的位置,三个数分别对应x、y、z坐标,如"1,1,0",默认为"0,0,0" (string 类型)

          sample:
          "position":"1,1,1"

          record

          version 8

          HUD物体是否录进屏幕,默认值是1, 0表示不录进屏幕

          sample:
          "record":"1"

          rotation

          version 8

          模型旋转角度,三个数依次表示绕x、y、z周旋转的角度, 默认为"0,0,0" (string 类型)

          sample:
          "rotation":"90,0,0"
          
          [注意:2D资源在空间中属于水平放置,所以需要X旋转90°,才能看到]

          scale

          version 8

          模型在各个方向放大或缩小倍数,默认为"1,1,1",放大(scale > 1),缩小 (0 < scale < 1) (string 类型)

          sample:
          "scale":"1,1,1"

          screenHeightRatio

          version 8

          节点所占屏幕高度百分比,只设置screenHeightRatio一个参数时,screenWidthRatio会随着screenHeightRatio变化,呈矩形显示。两个参数都不设置时,不显示节点。

          sample:
          详见:"screenRatio"字段

          screenRatio

          version 8

          随屏节点屏占比,控制在屏幕上显示的大小,该属性会覆盖scale字段

          sample:
          "screenRatio": 
          {
             "screenWidthRatio": 1,
             "screenHeightRatio": 1
             "keepAspectRatio":1
          }

          screenWidthRatio

          version 8

          节点所占屏幕宽度百分比, 只设置screenWidthRatio一个参数时,screenHeightRatio会随着screeWidthRatio变化,呈矩形显示。两个参数都不设置时,不显示节点。

          sample:
          详见:"screenRatio"字段

          textureList

          version 8

          节点所占屏幕宽度百分比, 默认为1

          sample:
          详见:"screenRatio"字段

          textureName

          version 8

          图片名称(图片存储路径)

          sample:
          使用见:material字段 code

          touchable

          version 8

          是否可点击 (1 可点击 0 不可点击)(number 类型)

          sample:
          "visible":0

          type

          version 8

          当前节点类型 (string 类型)

          sample:
          "type":"plane"

          visible

          version 8

          是否显示 (1 显示 0 隐藏)(number 类型)

          sample:
          "visible":0

          Pod

          此类描述json POD相关字段

          Fields
          Pod billboard
          billboard类型
          Pod batchNum
          分布加载批次id
          Pod offScreenGuidanceNodeConfig
          离屏引导主节点配置
          Pod offScreenGuidanceTarget
          离屏引导主节点配置开关
          Pod podsubNodeName
          离屏引导:配置对该pod节点中的子节点进行离屏引导,设置为子节点名称
          Pod allDropShadow
          当前节点是否产生阴影
          Pod allReceiveShadow
          当前节点是否接受其他物体产生的阴影
          Pod shadow
          pod模型阴影配置
          Pod shadowDroppingSubNodeList
          当allDropShadow = 0 时有效,指定能产生阴影的子节点名称
          Pod shadowReceivingSubNodeList
          allReceiveShadow = 0 时有效,指定能接受阴影的子节点名称
          Pod touchZone
          手势交互范围
          Pod allSubnodeTouchable
          是否将所有子节点设置为可响应触控的
          string animationName
          动画名称
          number endFrame
          pod动画结束帧数
          Pod podAnimationList
          描述pod片段动画
          number startFrame
          pod动画开始帧数
          Pod subNodeName1
          需要响应触控的子节点名字
          Pod touchableSubnodeList
          子元素为需要响应触控的子节点名字
          Pod material
          material配置
          Pod common
          material的子集
          Pod texturePath
          模型贴图路径
          Pod disableLightEffect
          不受光照影响
          Pod children
          子节点
          Pod maxScale
          配置缩放极大值
          Pod minScale
          配置缩放极小值
          Pod name
          开发者自定义,建议名称有具体含义
          Pod position
          模型在三维空间的位置
          Pod rotation
          模型旋转角度
          Pod scale
          模型在各个方向放大或缩小倍数
          Pod type
          当前节点类型
          Pod visible
          是否显示
          Public methods
          Pod PodDemo()
          Pod示例

          PodDemo ()

          Pod示例

          sample:
          {
          "name": "custom_name",
          "type": "pod",
          "visible": 1,
          "batchNum":1,
          "offScreenGuidanceNodeConfig": 
          {
             "offScreenGuidanceTarget":1,
             "podsubNodeName":"subnode_name"
          },
          "meshFileName": "res/model/xxx.pod",
          "position": "2,2,14",
          "minScale": 0.0001,
          "maxScale": 10000,
          "scale": "10,10,10",
          "rotation": "15,0,0",
          "billboard": 2
          "touchZone":120,
          "children": [
          {
             "name": "custom_name",
             "type": "pod",
             "visible": 1,
             "meshFileName": "res/model/xxx.pod",
             "podSuppl": 
                {
                   "allSubnodeTouchable": 0,
                   "touchableSubnodeList": [
                   "subNodeName1",
                   "subNodeName2",
                   "subNodeName3"
                    ]
                },
             "podAnimationList":[
             {
                "animationName":"custom",
                "startFrame":1,
                "endFrame":70
             },
             {
                "animationName":"custom2",
                "startFrame":71,
                "endFrame":140
             }
             ]
             }
             ],
             "shadow": 
             {
                "allDropShadow": 0,
                "shadowDroppingSubNodeList": [
                "subNodeName1",
                "subNodeName2"
                 ],
                "allReceiveShadow": 0,
                "shadowReceivingSubNodeList": [
                "subNodeName1",
                "subNodeName2"
                 ]
             }
          },

          billboard

          version 24

          billboard类型:0表示无billboard效果,为字段默认值;1表示模型旋转与相机旋转完全一致,需要该节点旋转设定为(90,0,0),适用所有类型;2表示模型水平和俯仰旋转面向相机,需要该节点旋转设定为(180,0,180),适用imu type 0和slam类型; 3表示仅水平旋转面向相机,需要该节点设定旋转为(180,0,180),适用imu type 0和slam类型

          sample:
          "rotation": "180,0,180"
          "billboard": 2

          batchNum

          version 23

          分布加载批次id

          sample:
          "batchNum":1

          offScreenGuidanceNodeConfig

          version 23

          离屏引导主节点配置,当需要配置该节点为主节点时添加

          sample:
          "offScreenGuidanceNodeConfig": 
          {
             "offScreenGuidanceTarget":1,
             "podsubNodeName":"subname"
          }

          offScreenGuidanceTarget

          version 23

          离屏引导主节点配置开关 1表示该节点是主节点,0表示不是

          sample:
          详见offScreenGuidanceNodeConfig字段

          podsubNodeName

          version 23

          离屏引导:配置对该pod节点中的子节点进行离屏引导,设置为子节点名称

          sample:
          详见offScreenGuidanceNodeConfig字段

          allDropShadow

          version 14

          当前节点是否产生阴影, 默认为1 (1 全部节点产生阴影 / 0 不是全部节点产生阴影)

          sample:
          详见:"podSuppl"字段

          allReceiveShadow

          version 14

          当前节点是否接受其他物体产生的阴影, 默认为1 (1 全部节点接受阴影 / 0 不是全部节点接受阴影)

          sample:
          详见:"podSuppl"字段

          shadow

          version 14

          pod模型阴影配置

          sample:
          "shadow": 
          {
             "allDropShadow": 0,
             "shadowDroppingSubNodeList": [
             "subNodeName1",
             "subNodeName2"
              ],
             "allReceiveShadow": 0,
             "shadowReceivingSubNodeList": [
             "subNodeName1",
             "subNodeName2"
          ]
          }

          shadowDroppingSubNodeList

          version 14

          当allDropShadow = 0 时有效,指定能产生阴影的子节点名称

          sample:
          详见:"podSuppl"字段

          shadowReceivingSubNodeList

          version 14

          allReceiveShadow = 0 时有效,指定能接受阴影的子节点名称

          sample:
          详见:"podSuppl"字段

          touchZone

          version 12

          手势交互范围,默认120

          sample:
          "touchZone":120
          
          使用该字段需开启热区:"enableTouchZone":0
          
          (双指在屏幕上的中心点,如果在热区范围内即可触发手势交互)

          allSubnodeTouchable

          version 9

          是否将所有子节点设置为可响应触控的, 默认为0 (0:除touchableSubnodeList中指定名字的节点以外.都不响应触控事件,1:所有子节点均可以响应触控)

          sample:
          详见:"podSuppl"字段

          animationName

          version 9

          动画名称(开发者自定义,需起有明确意义的名称)

          sample:
          详见:"podSuppl"字段

          endFrame

          version 9

          pod动画结束帧数

          sample:
          详见:"podSuppl"字段

          podAnimationList

          version 9

          描述pod片段动画

          sample:
          "podAnimationList":[
          {
             "animationName":"custom",
             "startFrame":1,
             "endFrame":70
          },
          {
             "animationName":"custom2",
             "startFrame":71,
             "endFrame":140
          }
          ]

          podSuppl

          version 9

          pod节点专用配置项

          sample:
          "podSuppl": 
          {
             "allSubnodeTouchable": 0,
             "touchableSubnodeList": [
             "subNodeName1",
             "subNodeName2",
             "subNodeName3"
          ]
          }

          startFrame

          version 9

          pod动画开始帧数

          sample:
          详见:"podSuppl"字段

          subNodeName1

          version 9

          需要响应触控的子节点名字 (通过模型工具查看子节点[subNodeName]名称,例如:PVRShaman工具),如果要获取子节点,需要通过scene.nodeName_subNodeName 即可获取.

          sample:
          详见:"podSuppl"字段

          touchableSubnodeList

          version 9

          子元素为需要响应触控的子节点名字

          sample:
          详见:"podSuppl"字段

          material

          version 8

          material配置

          sample:
          "material": {
                      "common": {
                      "texturePath":"res/texture/",
                      "disableLightEffect":0
                      }
                      },

          common

          version 8

          material的子集

          sample:
          使用见:material字段 code

          texturePath

          version 8

          模型贴图路径

          sample:
          使用见:material字段 code

          disableLightEffect

          version 8

          不受光照影响

          sample:
          使用见:material字段 code

          children

          version 8

          子节点,里面元素类型也是node类型,children包含可以包含任意类型的子节点,子节点格式同对应类型的配置一样

          sample:
          "children":[]

          maxScale

          version 8

          配置缩放极大值,与scale参数类似, 默认为10000

          sample:
          "maxScale":10000
          
          生效需开启热区:"enableTouchZone":0
          设置热区范围:"touchZone":120

          minScale

          version 8

          配置缩放极小值, 与scale参数类似, 默认为0.0001

          sample:
          ""minScale":0.0001
          
          生效需开启热区:"enableTouchZone":0
          设置热区范围:"touchZone":120

          name

          version 8

          开发者自定义,建议名称有具体含义

          sample:
          "name":"xxx"

          position

          version 8

          模型在三维空间的位置,三个数分别对应x、y、z坐标,如"1,1,0",默认为"0,0,0"

          sample:
          "position":"1,1,1"

          rotation

          version 8

          模型旋转角度,三个数依次表示绕x、y、z周旋转的角度, 默认为"0,0,0"

          sample:
          "rotation":"90,0,0"
          
          [注意:2D资源在空间中属于水平放置,所以需要X旋转90°,才能看到]

          scale

          version 8

          模型在各个方向放大或缩小倍数,默认为"1,1,1",放大(scale > 1),缩小 (0 < scale < 1)

          sample:
          "scale":"1,1,1"

          type

          version 8

          当前节点类型

          sample:
          "type":"pod"

          visible

          version 8

          是否显示(1 显示 0 隐藏)

          sample:
          "visible":0

          SkyBox

          此类描述json 天空盒相关字段

          Fields
          SkyBox batchNum
          分布加载批次id
          SkyBox offScreenGuidanceNodeConfig
          离屏引导主节点配置
          SkyBox offScreenGuidanceTarget
          离屏引导主节点配置开关
          SkyBox textureShaderName
          贴图shader名称
          SkyBox textureType
          图片名称(图片存储路径)
          SkyBox common
          通用material配置
          SkyBox defaultShaderName
          默认shader名称
          SkyBox material
          material配置
          SkyBox name
          开发者自定义,建议名称有具体含义
          SkyBox position
          模型在三维空间的位置
          SkyBox rotation
          模型旋转角度
          SkyBox scale
          模型在各个方向放大或缩小倍数
          SkyBox textureList
          图片列表
          SkyBox textureName
          图片名称(图片存储路径)
          SkyBox touchable
          是否可点击
          SkyBox type
          当前节点类型
          SkyBox visible
          是否显示
          Public methods
          SkyBox SkyBoxDemo()
          SkyBox示例

          SkyBoxDemo ()

          SkyBox示例

          sample:
          {
          "name": "custom",
          "type": "skybox",
          "visible": 1,
          "batchNum":1,
          "offScreenGuidanceNodeConfig": 
          {
             "offScreenGuidanceTarget":1
          },
          "touchable": 0,
          "position": "0,0,0",
          "scale": "8000, 8000, 8000",
          "rotation": "0,0,0",
          "material":
          {
             "common": 
          {
          "defaultShaderName": "skyboxShader",
          "textureList": [
          {
             "textureShaderName": "tCube",
             "textureName": "res/texture/xxx.jpg",
             "textureType": "cubeMap"
          }
          ]
          }
          }
          }

          batchNum

          version 23

          分布加载批次id

          sample:
          "batchNum":1

          offScreenGuidanceNodeConfig

          version 23

          离屏引导主节点配置,当需要配置该节点为主节点时添加

          sample:
          "offScreenGuidanceNodeConfig":
          {
             "offScreenGuidanceTarget":1
          } 

          offScreenGuidanceTarget

          version 23

          离屏引导主节点配置开关,1表示该节点是主节点,0表示不是

          sample:
          详见offScreenGuidanceNodeConfig字段

          textureShaderName

          version 14

          贴图shader名称(2D的一般默认为diffuseMap)

          sample:
          使用见:material字段 

          textureType

          version 14

          图片名称(图片存储路径)

          sample:
          使用见:material字段 
          
          详细描述:
          纹理类型  cubeMap[立方纹理]
          cubeMap 由固定的六张图片组成,文件名必须以 _nx,_ny,_nx,_px,_py,_pz结尾,textureName指定文件时,不需要描述这些结尾。
          天空盒示例如下:
          "textureList": [
          {
             "textureShaderName": "tCube",
             "textureName": "res/texture/park.jpg",
             "textureType": "cubeMap"
          }
          ]
          文件列表
          res/texture/park_nx.jpg
          res/texture/park_ny.jpg
          res/texture/park_nz.jpg
          res/texture/park_px.jpg
          res/texture/park_py.jpg
          res/texture/park_pz.jpg

          common

          version 8

          通用material配置,其他的有Android和ios平台配置

          sample:
          使用见:material字段 

          defaultShaderName

          version 8

          默认shader名称

          sample:
          使用见:material字段 

          material

          version 8

          material配置

          sample:
          "material": {
          "common": 
          {
             "defaultShaderName": "skyboxShader",
             "textureList": [
             {
                "textureShaderName": "tCube",
                "textureName": "res/texture/xxx.jpg",
                "textureType": "cubeMap"
             }
             ]
          }
          }

          name

          version 8

          开发者自定义,建议名称有具体含义 (string 类型)

          sample:
          "name":"xxx"

          position

          version 8

          模型在三维空间的位置,三个数分别对应x、y、z坐标,如"1,1,0",默认为"0,0,0" (string 类型)

          sample:
          "position":"1,1,1"

          rotation

          version 8

          模型旋转角度,三个数依次表示绕x、y、z周旋转的角度, 默认为"0,0,0" (string 类型)

          sample:
          "rotation":"0,0,0"

          scale

          version 8

          模型在各个方向放大或缩小倍数,默认为"1,1,1",放大(scale > 1),缩小 (0 < scale < 1) (string 类型)

          sample:
          "scale":"1,1,1"

          textureList

          version 8

          图片列表

          sample:
          使用见:material字段 

          textureName

          version 8

          图片名称(图片存储路径)

          sample:
          使用见:material字段 

          touchable

          version 8

          是否可点击 (1 可点击 0 不可点击)(number 类型)

          sample:
          "visible":0

          type

          version 8

          当前节点类型 (string 类型)

          sample:
          "type":"SkyBox"

          visible

          version 8

          是否显示 (1 显示 0 隐藏)(number 类型)

          sample:
          "visible":0

          Material

          此类描述json Material相关字段

          Fields
          Material aoMapIntensity
          环境光遮蔽贴图对光线的影响强度
          Material bumpScale
          bump贴图对材质的影响强度
          Material clearCoat
          透明涂层的透明度
          Material clearCoatRoughness
          透明涂层的粗糙度
          Material displacementBias
          displacement贴图的偏移量
          Material displacementScale
          displacement贴图对mesh的影响强度
          Material emissive
          物体自发光的颜色
          Material emissiveIntensity
          物体自发光的强度
          Material envBlendOperation
          反射贴图的混合方式
          Material envMapIntensity
          反射贴图对光线的影响强度
          Material materialExtend
          高级渲染
          Material metalness
          金属性贴图
          Material normalScale
          normal贴图对材质的影响强度
          Material offsetRepeat
          偏移量
          Material pod_mesh_name
          pod模型工具查看mesh名称
          Material reflectivity
          物体反射系数
          Material refractionRatio
          折射率
          Material roughness
          材料的粗糙度
          Material shininess
          镜面高光赋予更清晰的亮点
          Material textureList
          纹理列表
          Material textureName
          纹理名称
          Material textureShaderName
          纹理shader名称
          Material textureType
          纹理类型
          Material transparent
          材质是否透明
          Material type
          mesh类型
          Public methods
          Material MaterialDemo()
          Material示例

          MaterialDemo ()

          Material示例

          sample:
          {
          "name": "car",
          "type": "pod",
          "meshFileName": "res/model/xxx.pod",
          "materialExtend": 
          {
             "pod_mesh_name": 
               {
                "type": "MESH_PHYSICAL"|"MESH_STANDARD"|"MESH_PHONG"|"MESH_LAMBERT"|"MESH_BASIC",
                "textureList": [
                {
                   "textureShaderName":"map|specularMap|alphaMap|envMap|aoMap|emissiveMap|bumpMap|normalMap|displacementMap|roughnessMap|metalnessMap",
                   "textureName": "cube.png",
                   "textureType": "2d|cubeMap"
                }
                ],
               "transparent": 0,
               "emissive": "255,255,255",
               "emissiveIntensity": 0.0,
               "reflectivity": 0.01,
               "refractionRatio": 0.914,
               "shininess": 1320,
               "roughness": 0.5,
               "metalness": 0.0,
               "clearCoat": 0.5,
               "clearCoatRoughness": 0.1,
               "envBlendOperation": "MULTIPLY",
               "offsetRepeat": "0, 1, 1, -1",
               "envMapIntensity": 6.0,
               "aoMapIntensity": 1.0,
               "bumpScale": 1.0,
               "normalScale": "1.0, 1.0",
               "displacementScale": 1.0,
               "displacementBias": 0
               }
          }
          },  

          aoMapIntensity

          version 14

          环境光遮蔽贴图对光线的影响强度,默认为1 (number 类型)

          sample:
          使用见:MaterialDemo()

          bumpScale

          version 14

          bump贴图对材质的影响强度:0~1,默认为1 (number 类型)

          sample:
          使用见:MaterialDemo()  

          clearCoat

          version 14

          透明涂层的透明度:0.0~1.0,默认为0 (number 类型)

          sample:
          使用见:MaterialDemo() 

          clearCoatRoughness

          version 14

          透明涂层的粗糙度,默认为0 (number 类型)

          sample:
          使用见:MaterialDemo()  

          displacementBias

          version 14

          displacement贴图的偏移量,默认为0 (number 类型)

          sample:
          使用见:MaterialDemo()  

          displacementScale

          version 14

          displacement贴图对mesh的影响强度 (number 类型)

          sample:
          使用见:MaterialDemo() 

          emissive

          version 14

          物体自发光的颜色,默认为"0,0,0" (string 类型)

          sample:
          使用见:MaterialDemo()

          emissiveIntensity

          version 14

          物体自发光的强度,默认为1,0表示不发光 (number 类型)

          sample:
          使用见:MaterialDemo()  

          envBlendOperation

          version 14

          反射贴图的混合方式:ADD | MIX | MULTIPLY,默认为"MULTIPLY" (number 类型)

          sample:
          使用见:MaterialDemo()  

          envMapIntensity

          version 14

          反射贴图对光线的影响强度,默认为1 (number 类型)

          sample:
          使用见:MaterialDemo() 

          materialExtend

          version 14

          高级渲染

          sample:
          使用见:MaterialDemo() 

          metalness

          version 14

          金属性贴图 :0.0~1.0,默认为0.5 (number 类型)

          sample:
          使用见:MaterialDemo()  

          normalScale

          version 14

          normal贴图对材质的影响强度:0~1,默认Vector2:"1,1"(number 类型)

          sample:
          使用见:MaterialDemo()  

          offsetRepeat

          version 14

          [默认为"0,1,1,-1"] offsetRepeat(x, y, z, w),uv` = (uoffsetRepeat.z + offsetRepeat.x, voffsetRepeat.w + offsetRepeat.y) (number 类型)

          sample:
          使用见:MaterialDemo() 

          pod_mesh_name

          version 14

          pod模型工具查看mesh名称

          sample:
          使用见:MaterialDemo()

          reflectivity

          version 14

          物体反射系数,默认为1,取值:0 ~ 1,0:不反射 (number 类型)

          sample:
          使用见:MaterialDemo() 

          refractionRatio

          version 14

          折射率,默认为0.98(number 类型)

          sample:
          使用见:MaterialDemo() 

          roughness

          version 14

          材料的粗糙度:0 表示着光滑镜面反射,1 表示完全扩散,如果提供roughnessMap(Map内的值),两值相乘,默认为0(number 类型)

          sample:
          使用见:MaterialDemo() 

          shininess

          version 14

          镜面高光赋予更清晰的亮点,默认值为30(number 类型)

          sample:
          使用见:MaterialDemo()  

          textureName

          version 14

          纹理名称 (string 类型)

          sample:
          使用见: textureList字段 code  

          textureShaderName

          version 14

          纹理shader名称 (string 类型)

          sample:
          使用见: textureList字段 code  

          textureType

          version 14

          纹理类型 (string 类型)

          sample:
          使用见: textureList字段 code  

          transparent

          version 9

          材质是否透明,默认为0,0:不透明 1:透明(number 类型)

          sample:
          使用见:MaterialDemo()

          textureList

          version 8

          纹理列表

          sample:
          "textureList": [
          {
             "textureShaderName":"map|specularMap|alphaMap|envMap|aoMap|emissiveMap|bumpMap|normalMap|displacementMap|roughnessMap|metalnessMap",
             "textureName": "cube.png",
             "textureType": "2d|cubeMap"
          }
          ],

          type

          version 8

          mesh类型("MESH_PHYSICAL","MESH_STANDARD","MESH_PHONG","MESH_LAMBERT","MESH_BASIC")

          sample:
          使用见: MaterialDemo()透明涂层
          上一篇
          场景互动脚本API
          下一篇
          多媒体