Skip to content

渲染

索引


接口
描述
AddArrowShape客户端新建箭头形状
AddBoxShape客户端新建盒子形状
AddCircleShape客户端新建圆形状
AddLineShape客户端新建线条形状
AddSphereShape客户端新建球形状
AddTextShape客户端新建文本形状
GetBoxScale客户端获取BoxShape的大小
GetColor客户端获取Shape的颜色
GetEndPos客户端获取LineShape或ArrowShape的结束位置
GetLength客户端获取ArrowShape的头部长度
GetPos客户端获取Shape的位置
GetPriority客户端获取Shape的优先级
GetRadius客户端获取CircleShape或ArrowShape或SphereShape的半径
GetSegments客户端获取CircleShape或ArrowShape头部的分段数
GetText客户端获取TextShape的文本
GetType客户端获取Shape的类型
GetVisible客户端获取Shape是否可见
Remove客户端删除Shape
RemoveAll客户端删除当前所有Shape
SetBoxScale客户端设置BoxShape的大小
SetColor客户端设置Shape的颜色
SetEndPos客户端设置LineShape或ArrowShape的结束位置
SetLength客户端设置组成ArrowShape头部的长度
SetPos客户端设置Shape的位置
SetPriority客户端设置Shape的渲染优先级, 同一像素点处优先渲染优先级高的Shape, 默认为0
SetRadius客户端设置CircleShape或ArrowShape或SphereShape的半径
SetSegments客户端设置组成ArrowShape头部的网格数量, 最小为3
SetText客户端设置TextShape的文本内容
SetVisible客户端设置Shape是否可见

AddArrowShape

客户端

method in mod.client.component.drawingCompClient.DrawingCompClient

  • 描述

    新建箭头形状

  • 参数

    参数名
    数据类型
    说明
    startPostuple(float,float,float)箭头形状的起始位置
    endPostuple(float,float,float)箭头形状的结束位置
    colortuple(float,float,float)箭头形状的颜色, RGB值, 取值范围为[0,1], 默认为(1,1,1)
    headSegmentsNumint组成箭头形状头部的网格数量, 最小为3, 默认为20
    arrowHeadLengthfloat箭头形状头部的长度, 默认为1
    radiusfloat箭头形状头部的半径, 默认为0.5
  • 返回值

    数据类型
    说明
    DrawingShapeCompClient新建的箭头形状
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
arrow = comp.AddArrowShape((20,100,20), (20,150,20), (1,0,0), 40, 5, 2.5)

AddBoxShape

客户端

method in mod.client.component.drawingCompClient.DrawingCompClient

  • 描述

    新建盒子形状

  • 参数

    参数名
    数据类型
    说明
    postuple(float,float,float)盒子形状的位置
    scaletuple(float,float,float)盒子形状的大小, 默认为(1,1,1)
    colortuple(float,float,float)盒子形状的颜色, RGB值, 取值范围为[0,1], 默认为(1,1,1)
  • 返回值

    数据类型
    说明
    DrawingShapeCompClient新建的盒子形状
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
shape = comp.AddBoxShape((-37, 100, 100),(5,5,5),(1,0,0))

AddCircleShape

客户端

method in mod.client.component.drawingCompClient.DrawingCompClient

  • 描述

    新建圆形状

  • 参数

    参数名
    数据类型
    说明
    postuple(float,float,float)圆形状的位置
    radiusfloat圆形状的半径
    colortuple(float,float,float)圆形状的颜色, RGB值, 取值范围为[0,1], 默认为(1,1,1)
    planeint圆形状的平面, 0时为不指定平面, 1时为XY平面, 2时为XZ平面, 3时为YZ平面, 默认为2
    segmentsNumint圆形状的网格数量, 默认为20, 最小为1, 小于1后不渲染
  • 返回值

    数据类型
    说明
    DrawingShapeCompClient新建的圆形状
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
circle = comp.AddCircleShape((50,100,50), 5, (1,0,0))

AddLineShape

客户端

method in mod.client.component.drawingCompClient.DrawingCompClient

  • 描述

    新建线条形状

  • 参数

    参数名
    数据类型
    说明
    startPostuple(float,float,float)线条形状的起始位置
    endPostuple(float,float,float)线条形状的结束位置
    colortuple(float,float,float)线条形状的颜色, RGB值, 取值范围为[0,1], 默认为(1,1,1)
  • 返回值

    数据类型
    说明
    DrawingShapeCompClient新建的线条形状
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
line = comp.AddLineShape((-37, 100, 100), (0,0,0),(1,0,0))

AddSphereShape

客户端

method in mod.client.component.drawingCompClient.DrawingCompClient

  • 描述

    新建球形状

  • 参数

    参数名
    数据类型
    说明
    postuple(float,float,float)球形状的位置
    radiusfloat球形状的半径
    colortuple(float,float,float)球形状的颜色, RGB值, 取值范围为[0,1], 默认为(1,1,1)
    segmentsNumint球形状的网格数量, 默认为20, 最小为1, 小于等于1后不渲染
  • 返回值

    数据类型
    说明
    DrawingShapeCompClient新建的球形状
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
sphere = comp.AddSphereShape((-50, 100, -50), 5, (1,0,0))

AddTextShape

客户端

method in mod.client.component.drawingCompClient.DrawingCompClient

  • 描述

    新建文本形状

  • 参数

    参数名
    数据类型
    说明
    postuple(float,float,float)文本形状的位置
    textstr文本形状的文本
    colortuple(float,float,float)文本形状的颜色, RGB值, 取值范围为[0,1], 默认为(1,1,1)
  • 返回值

    数据类型
    说明
    DrawingShapeCompClient新建的文本形状
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
text = comp.AddTextShape((20,100,20), "test 测试", (1,0,0))

GetBoxScale

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    获取BoxShape的大小

  • 参数

  • 返回值

    数据类型
    说明
    tuple(float,float,float)BoxShape的大小
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
box = comp.AddBoxShape((-37, 100, 100),(5,5,5),(1,0,0))
box.GetBoxScale()

GetColor

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    获取Shape的颜色

  • 参数

  • 返回值

    数据类型
    说明
    tuple(float,float,float)Shape的颜色
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
box = comp.AddBoxShape((-37, 100, 100),(5,5,5),(1,0,0))
box.GetColor()

GetEndPos

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    获取LineShape或ArrowShape的结束位置

  • 参数

  • 返回值

    数据类型
    说明
    tuple(float,float,float)LineShape或ArrowShape的结束位置
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
line = comp.AddLineShape((0, 100, 100), (20,20,2),(1,0,0))
line.GetEndPos()

GetLength

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    获取ArrowShape的头部长度

  • 参数

  • 返回值

    数据类型
    说明
    floatArrowShape的头部长度
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
arrow = comp.AddArrowShape((20,100,20), (20,150,20), (1,0,0), 40, 5)
arrow.GetLength()

GetPos

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    获取Shape的位置

  • 参数

  • 返回值

    数据类型
    说明
    tuple(float,float,float)Shape的位置
  • 备注

    • 对于线条形状和箭头形状来说是指起点Pos, 其他是指形状中心Pos
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
box = comp.AddBoxShape((-37, 100, 100),(5,5,5),(1,0,0))
box.GetPos()

GetPriority

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    获取Shape的优先级

  • 参数

  • 返回值

    数据类型
    说明
    intShape的优先级
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
box = comp.AddBoxShape((-37, 100, 100),(5,5,5),(1,0,0))
box.GetPriority()

GetRadius

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    获取CircleShape或ArrowShape或SphereShape的半径

  • 参数

  • 返回值

    数据类型
    说明
    floatCircleShape或ArrowShape或SphereShape的半径
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
circle = comp.AddCircleShape((50,100,50), 5, (1,0,0))
circle.GetRadius()

GetSegments

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    获取CircleShape或ArrowShape头部的分段数

  • 参数

  • 返回值

    数据类型
    说明
    intCircleShape或ArrowShape头部的分段数
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
circle = comp.AddCircleShape((50,100,50), 5, (1,0,0))
circle.GetSegments()

GetText

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    获取TextShape的文本

  • 参数

  • 返回值

    数据类型
    说明
    strTextShape的文本
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
text = comp.AddTextShape((20,100,20), "test 测试", (1,0,0))
text.GetText()

GetType

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    获取Shape的类型

  • 参数

  • 返回值

    数据类型
    说明
    ShapeTypeShape的类型
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
box = comp.AddBoxShape((-37, 100, 100),(5,5,5),(1,0,0))
box.GetType()

GetVisible

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    获取Shape是否可见

  • 参数

  • 返回值

    数据类型
    说明
    boolShape是否可见
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
box = comp.AddBoxShape((-37, 100, 100),(5,5,5),(1,0,0))
box.GetVisible()

Remove

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    删除Shape

  • 参数

  • 返回值

    数据类型
    说明
    bool删除是否成功
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
arrow = comp.AddArrowShape((20,100,20), (20,150,20), (1,0,0),40, 5, 2.5)
arrow.Remove()

RemoveAll

客户端

method in mod.client.component.drawingCompClient.DrawingCompClient

  • 描述

    删除当前所有Shape

  • 参数

  • 返回值

    数据类型
    说明
    bool删除是否成功
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
comp.RemoveAll()

SetBoxScale

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    设置BoxShape的大小

  • 参数

    参数名
    数据类型
    说明
    scaletuple(float,float,float)BoxShape的目标大小
  • 返回值

    数据类型
    说明
    bool设置是否成功
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
box = comp.AddBoxShape((-37,100,100),(5,5,5),(1,0,0))
box.SetBoxScale((9,9,9))

SetColor

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    设置Shape的颜色

  • 参数

    参数名
    数据类型
    说明
    colortuple(float,float,float)Shape的颜色, RGB值, 取值范围为[0,1]
  • 返回值

    数据类型
    说明
    bool设置是否成功
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
arrow = comp.AddArrowShape((20,100,20), (20,150,20), (1,0,0),40, 5, 2.5)
arrow.SetColor((0,0,0))

SetEndPos

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    设置LineShape或ArrowShape的结束位置

  • 参数

    参数名
    数据类型
    说明
    endPostuple(float,float,float)LineShape或ArrowShape的结束位置
  • 返回值

    数据类型
    说明
    bool设置是否成功
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
line = comp.AddLineShape((0, 100, 100), (0,100,50),(1,0,0))
line.SetEndPos((20,200, 20))

SetLength

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    设置组成ArrowShape头部的长度

  • 参数

    参数名
    数据类型
    说明
    lengthfloat组成ArrowShape头部的长度
  • 返回值

    数据类型
    说明
    bool设置是否成功
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
arrow = comp.AddArrowShape((20,100,20), (20,150,20), (1,0,0),40, 5, 2.5)
arrow.SetLength(10)

SetPos

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    设置Shape的位置

  • 参数

    参数名
    数据类型
    说明
    postuple(float,float,float)Shape的目标位置
  • 返回值

    数据类型
    说明
    bool设置是否成功
  • 备注

    • 对于线条形状和箭头形状来说是指起点Pos, 其他是指形状中心Pos
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
line = comp.AddLineShape((0,100,100), (0,100,50),(1,0,0))
line.SetPos((0,100,70))

SetPriority

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    设置Shape的渲染优先级, 同一像素点处优先渲染优先级高的Shape, 默认为0

  • 参数

    参数名
    数据类型
    说明
    priorityintShape的渲染优先级
  • 返回值

    数据类型
    说明
    bool设置是否成功
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
arrow = comp.AddArrowShape((20,100,20), (20,150,20), (1,0,0),40, 5, 2.5)
arrow.SetPriority(10)

SetRadius

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    设置CircleShape或ArrowShape或SphereShape的半径

  • 参数

    参数名
    数据类型
    说明
    radiusfloatCircleShape或ArrowShape或SphereShape的半径
  • 返回值

    数据类型
    说明
    bool设置是否成功
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
circle = comp.AddCircleShape((50,100,50), 5, (1,0,0))
print circle.SetRadius(2.0)

SetSegments

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    设置组成ArrowShape头部的网格数量, 最小为3

  • 参数

    参数名
    数据类型
    说明
    segmentsint组成ArrowShape头部的网格数量, 最小为3
  • 返回值

    数据类型
    说明
    bool设置是否成功
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
arrow = comp.AddArrowShape((20,100,20), (20,150,20), (1,0,0),40, 5, 2.5)
arrow.SetSegments(100)

SetText

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    设置TextShape的文本内容

  • 参数

    参数名
    数据类型
    说明
    textstrTextShape的文本内容
  • 返回值

    数据类型
    说明
    bool设置是否成功
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
text = comp.AddTextShape((20,100,20), "test 测试", (1,0,0))
text.SetText("tteesstt")

SetVisible

客户端

method in mod.client.component.drawingShapeCompClient.DrawingShapeCompClient

  • 描述

    设置Shape是否可见

  • 参数

    参数名
    数据类型
    说明
    visibleboolShape是否可见
  • 返回值

    数据类型
    说明
    bool设置是否成功
  • 示例

python
import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateDrawing(levelId)
arrow = comp.AddArrowShape((20,100,20), (20,150,20), (1,0,0),40, 5, 2.5)
arrow.SetVisible(False)