文字面板

CreateTextBoardInWorld

客户端

method in mod.client.component.textBoardCompClient.TextBoardComponentClient

• 描述

  创建文字面板

• 参数

  参数名	数据类型	说明
  text	str	文字显示内容
  textColor	tuple(float,float,float,float)	文字颜色的RGBA值，范围0-1
  boardColor	tuple(float,float,float,float)	可选参数，默认None，设置为黑色，面板颜色的RGBA值，范围0-1
  faceCamera	bool	是否始终朝向相机, 默认为True

• 返回值

  数据类型	说明
  int	返回生成的id，如果生成失败，返回None

• 备注

  • 切换维度后会自动隐藏非本维度创建的而且没有绑定实体的文字面板, 回到该维度后会自动重新显示

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateTextBoard(clientApi.GetLevelId())
comp.CreateTextBoardInWorld("我显示在世界坐标位置",(0.5, 0.4, 0.3, 0.8),(0, 0, 0, 1), True)

RemoveTextBoard

客户端

method in mod.client.component.textBoardCompClient.TextBoardComponentClient

• 描述

  删除文字面板

• 参数

  参数名	数据类型	说明
  boardId	int	创建的时候返回的id

• 返回值

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

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateTextBoard(clientApi.GetLevelId())
boardId = comp.CreateTextBoardInWorld("我显示在世界坐标位置",(0.5, 0.4, 0.3, 0.8),(0, 0, 0, 1), True)
if boardId:
    comp.RemoveTextBoard(boardId)

SetBoardBackgroundColor

客户端

method in mod.client.component.textBoardCompClient.TextBoardComponentClient

• 描述

  修改背景颜色

• 参数

  参数名	数据类型	说明
  boardId	int	文字面板的id
  backgroundColor	tuple(float,float,float,float)	颜色的RGBA值，范围0-1

• 返回值

  数据类型	说明
  bool	返回是否设置成功

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateTextBoard(clientApi.GetLevelId())
boardId = comp.CreateTextBoardInWorld("我显示在玩家头顶",(0.5, 0.4, 0.3, 0.8),(0, 0, 0, 1),True)
if boardId:
    comp.SetBoardBindEntity(boardId, clientApi.GetLocalPlayerId(), (0.0, 1.5, 0.0), (0.0, 0.0, 0.0))
    comp.SetBoardBackgroundColor(boardId, (1.0, 1.0, 1.0, 1.0))

SetBoardBindEntity

客户端

method in mod.client.component.textBoardCompClient.TextBoardComponentClient

• 描述

  文字面板绑定实体对象

• 参数

  参数名	数据类型	说明
  boardId	int	文字面板的id
  bindEntityId	str	绑定entity的Id; 如果为None，则为取消实体绑定, 此时下面参数为世界坐标和旋转
  offset	tuple(float,float,float)	相对于实体的偏移量
  rot	tuple(float,float,float)	相对于实体的偏移角度

• 返回值

  数据类型	说明
  bool	返回是否设置成功

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateTextBoard(clientApi.GetLevelId())
boardId = comp.CreateTextBoardInWorld("我显示在玩家头顶",(0.5, 0.4, 0.3, 0.8),(0, 0, 0, 1),True)
if boardId:
    comp.SetBoardBindEntity(boardId, clientApi.GetLocalPlayerId(), (0.0, 1.5, 0.0), (0.0, 0.0, 0.0))

SetBoardDepthTest

客户端

method in mod.client.component.textBoardCompClient.TextBoardComponentClient

• 描述

  设置是否开启深度测试, 默认状态下是开启

• 参数

  参数名	数据类型	说明
  boardId	int	文字面板的id
  depthTest	bool	True为开启深度测试,False为不开启

• 返回值

  数据类型	说明
  bool	返回是否设置成功

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateTextBoard(clientApi.GetLevelId())
boardId = comp.CreateTextBoardInWorld("我显示在玩家头顶",(0.5, 0.4, 0.3, 0.8),(0, 0, 0, 1),True)
if boardId:
    comp.SetBoardBindEntity(boardId, clientApi.GetLocalPlayerId(), (0.0, 1.5, 0.0), (0.0, 0.0, 0.0))
    comp.SetBoardDepthTest(boardId, False)

SetBoardFaceCamera

客户端

method in mod.client.component.textBoardCompClient.TextBoardComponentClient

• 描述

  设置文字面板的朝向

• 参数

  参数名	数据类型	说明
  boardId	int	文字面板的id
  faceCamera	bool	是否始终朝向相机, 默认为True

• 返回值

  数据类型	说明
  bool	返回是否设置成功

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateTextBoard(clientApi.GetLevelId())
boardId = comp.CreateTextBoardInWorld("我显示在玩家头顶",(0.5, 0.4, 0.3, 0.8),(0, 0, 0, 1),True)
if boardId:
    comp.SetBoardBindEntity(boardId, clientApi.GetLocalPlayerId(), (0.0, 1.5, 0.0), (0.0, 0.0, 0.0))
    comp.SetBoardFaceCamera(boardId, True)

SetBoardPos

客户端

method in mod.client.component.textBoardCompClient.TextBoardComponentClient

• 描述

  修改位置

• 参数

  参数名	数据类型	说明
  boardId	int	文字面板的id
  pos	tuple(float,float,float)	坐标

• 返回值

  数据类型	说明
  bool	返回是否设置成功

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateTextBoard(clientApi.GetLevelId())
boardId = comp.CreateTextBoardInWorld("我显示在玩家头顶",(0.5, 0.4, 0.3, 0.8),(0, 0, 0, 1),True)
if boardId:
    comp.SetBoardBindEntity(boardId, clientApi.GetLocalPlayerId(), (0.0, 1.5, 0.0), (0.0, 0.0, 0.0))
    comp.SetBoardPos(boardId, (0.0, 3.0, 0.0))

SetBoardRot

客户端

method in mod.client.component.textBoardCompClient.TextBoardComponentClient

• 描述

  修改旋转角度, 若设置了文本朝向相机，则旋转角度的修改不会生效

• 参数

  参数名	数据类型	说明
  boardId	int	文字面板的id
  rot	tuple(float,float,float)	角度(不是弧度)

• 返回值

  数据类型	说明
  bool	返回是否设置成功

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateTextBoard(clientApi.GetLevelId())
boardId = comp.CreateTextBoardInWorld("我显示在玩家头顶",(0.5, 0.4, 0.3, 0.8),(0, 0, 0, 1),True)
if boardId:
    comp.SetBoardBindEntity(boardId, clientApi.GetLocalPlayerId(), (0.0, 1.5, 0.0), (0.0, 0.0, 0.0))
    comp.SetBoardRot(boardId, (45.0, 90.0, 0.0))

SetBoardScale

客户端

method in mod.client.component.textBoardCompClient.TextBoardComponentClient

• 描述

  内容整体缩放

• 参数

  参数名	数据类型	说明
  boardId	int	文字面板的id
  scale	tuple(float,float)	x,y方向上的缩放值,要求值大于0,正常状态下是(1.0,1.0)

• 返回值

  数据类型	说明
  bool	返回是否设置成功

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateTextBoard(clientApi.GetLevelId())
boardId = comp.CreateTextBoardInWorld("我显示在玩家头顶",(0.5, 0.4, 0.3, 0.8),(0, 0, 0, 1),True)
if boardId:
    comp.SetBoardBindEntity(boardId, clientApi.GetLocalPlayerId(), (0.0, 1.5, 0.0), (0.0, 0.0, 0.0))
    comp.SetBoardScale(boardId, (2.0, 2.0))

SetBoardTextColor

客户端

method in mod.client.component.textBoardCompClient.TextBoardComponentClient

• 描述

  修改字体颜色

• 参数

  参数名	数据类型	说明
  boardId	int	文字面板的id
  textColor	tuple(float,float,float,float)	颜色的RGBA值，范围0-1

• 返回值

  数据类型	说明
  bool	返回是否设置成功

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateTextBoard(clientApi.GetLevelId())
boardId = comp.CreateTextBoardInWorld("我显示在玩家头顶",(0.5, 0.4, 0.3, 0.8),(0, 0, 0, 1),True)
if boardId:
    comp.SetBoardBindEntity(boardId, clientApi.GetLocalPlayerId(), (0.0, 1.5, 0.0), (0.0, 0.0, 0.0))
    comp.SetBoardTextColor(boardId, (1.0, 1.0, 0.0, 0.8))

SetText

客户端

method in mod.client.component.textBoardCompClient.TextBoardComponentClient

• 描述

  修改文字面板内容

• 参数

  参数名	数据类型	说明
  boardId	int	文字面板id
  text	str	文字内容

• 返回值

  数据类型	说明
  bool	是否修改成功

• 示例

import mod.client.extraClientApi as clientApi
comp = clientApi.GetEngineCompFactory().CreateTextBoard(clientApi.GetLevelId())
boardId = comp.CreateTextBoardInWorld("初始文字",(0.5, 0.4, 0.3, 0.8),(0, 0, 0, 1),True)
if boardId:
    comp.SetText(boardId, "修改后的文字")