AR_Engine_SDK
Functions | Variables
XEActor.lua File Reference
类 XEActor 继承关系图:
Inheritance graph

Functions

function XEActor GetTypeName () end
 
function XEActor Initialize (pWorld) end
 
function XEActor PostInitialized () end
 
function XEActor GetRenderOrderFactor () end
 
function XEActor PreTick (fDelMs) end
 
function XEActor Tick (fDelMs, bForceTick) end
 
function XEActor PostTick (fDelMs) end
 
function XEActor PresentPhysics (fDel) end
 
function XEActor Render (pViewport) end
 
function XEActor RenderDrawDebug (pViewport) end
 
function XEActor Release () end
 
function XEActor SetRootComponent (pRootComponent) end
 
function XEActor AttachToActor (pActor) end
 
function XEActor AttachToActor (pActor, attachRules) end
 
function XEActor AttachToActorNode (pParentActor, szBindNodeName) end
 
function XEActor AttachToActorNode (pParentActor, szBindNodeName, attachRules) end
 
function XEActor DetachFromActor () end
 
function XEActor DetachFromActor (detachRules) end
 
function XEActor GetCusAABB () end
 
function XEActor RayPick (hr) end
 
function XEActor RayPick (hr, vScreenPoint, viewport) end
 
function XEActor RayPick (vScreenPoint, pViewport) end
 
function XEActor FocusActor (bFocus) end
 
function XEActor OnSocketTick (pBindSocketIns, matWorld) end
 
function XEActor OnSocketRender (pBindSocketIns) end
 
function XEActor SetActorLocation (fX, fY, fZ) end
 
function XEActor SetActorLocation (loc) end
 
function XEActor SetActorRotation (fPitch, fYaw, fRoll) end
 
function XEActor SetActorRotation (rot) end
 
function XEActor SetDeleted (bDelete) end
 
function XEActor SetHidden (bHide) end
 
function XEActor SetHiddenInGame (bHide) end
 
function XEActor SetActorName (szActorName, pContext) end
 
function XEActor GetRootComponent () end
 
function XEActor GetBelongToChildActorComponent () end
 
function XEActor GetComponentOfIndex (nIndex) end
 
function XEActor GetParentActor () end
 
function XEActor GetChildActors (child) end
 
function XEActor GetChildActors () end
 
function XEActor GetAllChildActors (child) end
 
function XEActor GetAllChildActors () end
 
function XEActor GetActorLocation () end
 
function XEActor GetActorRotation () end
 
function XEActor GetActorScale () end
 
function XEActor GetActorLocalLocation () end
 
function XEActor SetActorLocalLocation (location) end
 
function XEActor GetActorLocalRotation () end
 
function XEActor GetActorLocalScale () end
 
function XEActor SetActorScale (sca) end
 
function XEActor GetRawWorldTransform () end
 
function XEActor GetWorldTransform () end
 
function XEActor ChangeSubActorFilterPath (strParentOriginName, strParentNewName) end
 
function XEActor IsSerialized (pEleParent) end
 
function XEActor GetComponentValidIndex () end
 
function XEActor AddExtendParam (pExtendParam) end
 
function XEActor RemoveExtendParam (pExtendParam, bDeleteMemory) end
 
function XEActor GetExtendParam (nIndex) end
 
function XEActor GetExtendParam (strExtendParamName) end
 
function XEActor GetExtendParam () end
 
function XEActor MergeToWorldTransform (toMatrix) end
 
function XEActor ApplyWorldTransform (matrix, bSyncGuestFromParent) end
 
function XEActor TravelToGuestWorld (pGuestWorld) end
 
function XEActor ReturnBackToOwnerWorld () end
 
function XEActor IsInGuestWorld () end
 
function XEActor GetActorShortName () end
 
function XEActor GetParentActorTypeFilterList () end
 
function XEActor AddParentActorTypeFilter (strActorType) end
 
function XEActor GetMergeRenderHidden (nBit) end
 
function XEActor SetMergeRenderHidden (nMergeBit, bHidden) end
 
function XEActor SetMergeRenderHiddenEnable (nMergeBit, bEnable) end
 
function XEActor ResetMergeRenderHidden () end
 
function XEActor UpdateLocalTransformForChildComponent () end
 
function XEActor SetTransformMergeMode (bMerge, bRecursion) end
 
function XEActor AttachBindingScriptAsset (pAssetPath) end
 
function XEActor DetachBindingScriptInstance () end
 
function XEActor AddActorComponent (szType) end
 
function XEActor GetActorComponent (szType) end
 
function XEActor GetActorComponent (szType, runType) end
 
function XEActor GetActorForwardVector () end
 
function XEActor GetActorUpVector () end
 
function XEActor GetActorRightVector () end
 
function XEActor SetForwardDirAndUp (vForwardDir, vUp) end
 
function XEActor SetPositionAndForwardDirUp (vPosition, vForwardDir, vUp) end
 
function XEActor RotateX (fDeltaRadian) end
 
function XEActor RotateY (fDeltaRadian) end
 
function XEActor RotateZ (fDeltaRadian) end
 
function XEActor RotateAxis (vRotateAxis, fDeltaRadian) end
 
function XEActor IsHidden () end
 
function XEActor IsHiddenInGame () end
 
function XEActor SetBoundingBoxColor (clVal) end
 
function XEActor GetBoundingBoxColor () end
 
function XEActor GetActorName () end
 
function XEActor SetActorTickEnabled (bEnable) end
 
function XEActor IsActorTickable () end
 
function XEActor SetOrder (nOrder) end
 
function XEActor GetOrder () end
 
function XEActor IsDeleted () end
 
function XEActor IsModified () end
 
function XEActor SetModified (bModified) end
 
function XEActor GetPickMask () end
 
function XEActor GetPickPriority () end
 
function XEActor IsPickEnable () end
 
function XEActor SetPickMask (nMask) end
 
function XEActor SetPickPriority (nPriority) end
 
function XEActor SetFilterPath (szFilterPath) end
 
function XEActor SetFilterPath (szFilterPath, bIsToLower) end
 
function XEActor GetFilterPath () end
 
function XEActor IsTransformMergeMode () end
 
function XEActor SetDrawDebugType (nDebug) end
 
function XEActor GetDrawDebugType () end
 
function XEActor IsDrawAuxiliary () end
 
function XEActor IsBoundingBoxVisible () end
 
function XEActor IsDummyShapeVisible () end
 
function XEActor GetCollisionChannel () end
 
function XEActor SetCollisionChannel (ccm) end
 
function XEActor GetScriptContainerInstance () end
 
function XEActor ReCalculateParentMatrixByUserNode (pParentActor, matOutParentMatrix) end
 
function XEActor ReCalculateParentMatrixByUserNode (pParentActor) end
 
function XEActor UpdateBindDataFromParentUserNode (bBindUserNodeData) end
 
function XEActor GetBindUserNodeData () end
 
function XEActor SetUpdateTranfromFromUserNode (bIsUpdate) end
 
function XEActor GetIsUpdateTranformFromUserNode () end
 
function XEActor IsChildActor (pChildActor) end
 
function XEActor GetOwner () end
 
function XEActor GetLevelOwner () end
 
function XEActor SpawnCloneActor () end
 
function XEActor GeSerializeContent () end
 
function XEActor DeserializeFromContent (strContent) end
 

Variables

 XEActor = {}
 
XEActor EDD_DRAW_NONE = 0
 
XEActor EDD_DRAW_AUXILIARY = 0
 
XEActor EDD_DUMMY_SHAPE = 0
 
XEActor EDD_BOUNDINGBOX = 0
 
XEActor EDD_OUTLINE = 0
 

Function Documentation

◆ AddActorComponent()

function XEActor AddActorComponent ( szType  )

为当前XEActor添加指定类型的组件

Parameters
szTypestring 组件类型名称
Returns
XEActorComponent 返回添加的组件指针

◆ AddExtendParam()

function XEActor AddExtendParam ( pExtendParam  )

为当前XEActor添加扩展参数对象,并返回在扩展参数列表中的索引。目前支持的类型有表示移动端配置的移动端参数、相机参数配置的相机参数等。

Parameters
pExtendParamIXEExtendParam
Returns
number

◆ AddParentActorTypeFilter()

function XEActor AddParentActorTypeFilter ( strActorType  )

添加过滤父Actor的类型

Parameters
strActorTypestring
Returns
void

◆ ApplyWorldTransform()

function XEActor ApplyWorldTransform ( matrix  ,
bSyncGuestFromParent   
)

设置当前非头饰的XEActor的世界矩阵

Parameters
matrixXMATRIX4 设置当前非头饰的XEActor的世界矩阵
bSyncGuestFromParentboolean 是否同步更新与其关联的子Actor组件的世界矩阵(当本Actor作为子Actor组件嵌套到了其他Actor上,本Actor会记录这个子Actor组件)
Returns
boolean 是否设置成功

◆ AttachBindingScriptAsset()

function XEActor AttachBindingScriptAsset ( pAssetPath  )

附加一个绑定脚本资源(与DetachBindingScriptInstance成对使用)

Parameters
pAssetPathstring 脚本资源路径
Returns
boolean 是否附加成功

◆ AttachToActor() [1/2]

function XEActor AttachToActor ( pActor  )

根据指定的嵌套规则,将当前XEActor附加到指定XEActor(pActor)上,即父子Actor嵌套。

Parameters
pActorXEActor 当前XEActor将要附加到的XEActor,也就是pActor将变为当前XEActor的父节点。
Returns
void
Attention
此函数默认采用KeepWorld的嵌套规则,含义是子Actor附加到父Actor时,子Actor的世界状态(位置、朝向和大小)不改变。

◆ AttachToActor() [2/2]

function XEActor AttachToActor ( pActor  ,
attachRules   
)

附加到其他Actor,采用KeepWorld的嵌套规则,将当前 XEActor 附加到指定 XEActor(pActor)上,即父子 Actor 嵌套。

Parameters
pActorXEActor 当前XEActor将要附加到的XEActor,也就是pActor将变为当前XEActor的父节点。
attachRulesXEAttachRules 指定的父子Actor嵌套规则
Returns
void
Attention
目前XECoreSDK中支持三种父子嵌套的规则,分别是KeepRelative 、KeepWorld 、SnapToTarget,具体可参见 XEAttachRules 部分

◆ AttachToActorNode() [1/2]

function XEActor AttachToActorNode ( pParentActor  ,
szBindNodeName   
)

将当前 XEActor 附加到指定pParentActor的指定节点上,即父子Actor嵌套。如果父Actor不存在szBindNodeName对应的节点, 则父子嵌套失败。默认采用XEAttachRules::SnapToTargetNotIncludingScale 嵌套规则。 子 Actor 的平移和旋转采用父 Actor的节点的平移和旋转,子 Actor 的缩放还是采用自身的世界坐标系的缩放。

Parameters
pParentActorXEActor 当前XEActor将要附加到的XEActor,也就是pActor将变为当前XEActor的父节点。
szBindNodeNamestring 用于绑定子Actor的父Actor上的节点名称,可以是骨骼名称,也可以是槽名称。
Returns
void
Attention
此函数采用XEAttachRules::SnapToTargetNotIncludingScale 嵌套规则,表示子 Actor 附加到父 Actor 的指定节点时,

◆ AttachToActorNode() [2/2]

function XEActor AttachToActorNode ( pParentActor  ,
szBindNodeName  ,
attachRules   
)

根据指定的嵌套规则,将当前XEActor附加到指定pParentActor的指定节点上,即父子Actor嵌套。 如果父 Actor 不存在szBindNodeName对应的节点,则父子嵌套失败。

Parameters
pParentActorXEActor 当前XEActor将要附加到的XEActor,也就是pActor将变为当前XEActor的父节点。
szBindNodeNamestring 用于绑定子Actor的父Actor上的节点名称,可以是骨骼名称,也可以是槽名称。
attachRulesXEAttachRules 指定子Actor嵌套到父Actor指定节点的规则
Returns
void

◆ ChangeSubActorFilterPath()

function XEActor ChangeSubActorFilterPath ( strParentOriginName  ,
strParentNewName   
)

修改子Actor的筛选路径

Parameters
strParentOriginNamestring 原始路径名
strParentNewNamestring 新路径名
Returns
boolean

◆ DeserializeFromContent()

function XEActor DeserializeFromContent ( strContent  )

从序列化字符串中还原Actor的参数信息(Warning! 如果Actor已经被反序列化,则存在数据丢失或者冲突风险)

Parameters
strContentstring
Returns
boolean

◆ DetachBindingScriptInstance()

function XEActor DetachBindingScriptInstance ( )

移除附加的绑定脚本资源(与AttachBindingScriptAsset成对使用)

Returns
void

◆ DetachFromActor() [1/2]

function XEActor DetachFromActor ( )

采用KeepWorld规则解除当前Actor与其父Actor的父子关系,也就是保持当前Actor的世界状态不改变

Returns
void

◆ DetachFromActor() [2/2]

function XEActor DetachFromActor ( detachRules  )

根据指定的解除规则,解除当前Actor与其父Actor的父子关系

Parameters
detachRulesXEDetachmentTransformRules 表示当前Actor与其父Actor解除父子关系时,当前Actor的世界状态如何改变的规则
Returns
void
Attention
目前XECoreSDK 支持两种解除父子关系的规则,分别是KeepRelative 和 KeepWorld,具体可参见 XEDetachmentTransformRules.

◆ FocusActor()

function XEActor FocusActor ( bFocus  )

聚焦当前Actor

Parameters
bFocusboolean
Returns
void

◆ GeSerializeContent()

function XEActor GeSerializeContent ( )

获取Actor的序列化字符串(xml格式)

Returns
string

◆ GetActorComponent() [1/2]

function XEActor GetActorComponent ( szType  )

XEActor_GetActorComponent00

Parameters
szTypestring
Returns
XEActorComponent

◆ GetActorComponent() [2/2]

function XEActor GetActorComponent ( szType  ,
runType   
)

XEActor_GetActorComponent01

Parameters
szTypestring
runTypenumber
Returns
XEActorComponent

◆ GetActorForwardVector()

function XEActor GetActorForwardVector ( )

获取当前Actor在世界坐标系下的朝向(Z)单位向量

Returns
XVECTOR3

◆ GetActorLocalLocation()

function XEActor GetActorLocalLocation ( )

获取当前Actor相对于父Actor坐标系的局部坐标位置

Returns
XVECTOR3

◆ GetActorLocalRotation()

function XEActor GetActorLocalRotation ( )

获取当前Actor相对于父Actor坐标系的局部坐标旋转

Returns
XQUATERNION

◆ GetActorLocalScale()

function XEActor GetActorLocalScale ( )

获取当前Actor相对于父Actor坐标系的局部坐标缩放

Returns
XVECTOR3

◆ GetActorLocation()

function XEActor GetActorLocation ( )

获取当前Actor在世界坐标系中的位置

Returns
XVECTOR3

◆ GetActorName()

function XEActor GetActorName ( )

设置当前Actor名字

Returns
string

◆ GetActorRightVector()

function XEActor GetActorRightVector ( )

获取当前Actor在世界坐标系下的向右(X)单位向量

Returns
XVECTOR3

◆ GetActorRotation()

function XEActor GetActorRotation ( )

获取当前Actor在世界坐标系中的朝向

Returns
XQUATERNION

◆ GetActorScale()

function XEActor GetActorScale ( )

获取当前Actor在世界坐标系中的缩放值

Returns
XVECTOR3

◆ GetActorShortName()

function XEActor GetActorShortName ( )

获取当前Actor的短名字(只有名字,没有前缀)

Returns
string

◆ GetActorUpVector()

function XEActor GetActorUpVector ( )

获取当前Actor在世界坐标系下的UP(Y)单位向量

Returns
XVECTOR3

◆ GetAllChildActors() [1/2]

function XEActor GetAllChildActors ( child  )

获取当前XEActor包含的所有子孙Actor,包括其子Actor包含的子孙Actor

Parameters
childXEActor[] [out]当前XEActor所包含的所有子孙Actor的列表
Returns
void

◆ GetAllChildActors() [2/2]

function XEActor GetAllChildActors ( )

XEActor_GetAllChildActors01

Returns
XEActor[]
void

◆ GetBelongToChildActorComponent()

function XEActor GetBelongToChildActorComponent ( )

获取当前Actor属于哪个Actor的子ActorComponent

Returns
XEChildActorComponent

◆ GetBindUserNodeData()

function XEActor GetBindUserNodeData ( )

获取父子嵌套时挂载节点信息

Returns
XEBindUserNodeData

◆ GetBoundingBoxColor()

function XEActor GetBoundingBoxColor ( )

获取当前Actor的包围盒颜色

Returns
number

◆ GetChildActors() [1/2]

function XEActor GetChildActors ( child  )

获取当前XEActor包含的直接子Actor,不包括其子Actor包含的子孙Actor

Parameters
childXEActor[] [out]当前XEActor的直接子Actor的列表
Returns
void

◆ GetChildActors() [2/2]

function XEActor GetChildActors ( )

XEActor_GetChildActors01

Returns
XEActor[]
void

◆ GetCollisionChannel()

function XEActor GetCollisionChannel ( )

获取当前Actor的碰撞通道

Returns
XECollisionChannelMeta

◆ GetComponentOfIndex()

function XEActor GetComponentOfIndex ( nIndex  )

根据索引获取该Actor的(子)组件

Parameters
nIndexnumber 索引
Returns
XEActorComponent 获取到的组件指针

◆ GetComponentValidIndex()

function XEActor GetComponentValidIndex ( )

获取一个有效的组件索引值

Returns
number

◆ GetCusAABB()

function XEActor GetCusAABB ( )

获取当前 XEActor 的 AABB 包围盒,并返回

Returns
XCusAABB

◆ GetDrawDebugType()

function XEActor GetDrawDebugType ( )

获取当前Actor渲染的辅助类型

Returns
number

◆ GetExtendParam() [1/3]

function XEActor GetExtendParam ( nIndex  )

根据索引获取扩展参数指针

Parameters
nIndexnumber 在扩展配置参数列表中的索引
Returns
IXEExtendParam 如果找到,返回该扩展参数指针

◆ GetExtendParam() [2/3]

function XEActor GetExtendParam ( strExtendParamName  )

根据名称获取扩展参数指针

Parameters
strExtendParamNamestring 扩展配置参数名称
Returns
IXEExtendParam 如果找到,返回该扩展参数指针

◆ GetExtendParam() [3/3]

function XEActor GetExtendParam ( )

获取扩展参数列表

Returns
IXEExtendParam[]

◆ GetFilterPath()

function XEActor GetFilterPath ( )

获取筛选路径字符串

Returns
string

◆ GetIsUpdateTranformFromUserNode()

function XEActor GetIsUpdateTranformFromUserNode ( )

是否根据挂载节点更新当前Actor的Transform

Returns
boolean

◆ GetLevelOwner()

function XEActor GetLevelOwner ( )

获取当前Actor所在的关卡对象指针

Returns
XELevel

◆ GetMergeRenderHidden()

function XEActor GetMergeRenderHidden ( nBit  )

获取显隐的合并状态值,每两位组成一对, 高位表示该状态是否有效, 低位表示是否显示, 当所有有效位对应的显示状态为1时,隐藏,否则显示

Parameters
nBitnumber 要获取的位
Returns
boolean 该位的显隐状态

◆ GetOrder()

function XEActor GetOrder ( )

获取当前XEActor的序号

Returns
number

◆ GetOwner()

function XEActor GetOwner ( )

获取当前Actor所属的世界对象指针

Returns
XEWorld

◆ GetParentActor()

function XEActor GetParentActor ( )

获取当前Actor的父Actor

Returns
XEActor

◆ GetParentActorTypeFilterList()

function XEActor GetParentActorTypeFilterList ( )

获取attach时过滤父Actor的类型

Returns
string[]

◆ GetPickMask()

function XEActor GetPickMask ( )

获取当前XEActor的拾取掩码

Returns
number

◆ GetPickPriority()

function XEActor GetPickPriority ( )

获取当前XEActor的拾取优先级

Returns
number

◆ GetRawWorldTransform()

function XEActor GetRawWorldTransform ( )

获取当前XEActor的原始世界矩阵,实际是从引擎获取当前实例的世界矩阵

Returns
XMATRIX4

◆ GetRenderOrderFactor()

function XEActor GetRenderOrderFactor ( )

获取Actor渲染顺序影响因子(位置的z分量)

Returns
number

◆ GetRootComponent()

function XEActor GetRootComponent ( )

获取当前XEActor的根组件

Returns
XEActorComponent

XEActor_GetRootComponent01

Returns
XEActorComponent

◆ GetScriptContainerInstance()

function XEActor GetScriptContainerInstance ( )

获取绑定脚本指针

Returns
XEScriptContainerInstance

◆ GetTypeName()

function XEActor GetTypeName ( )

获取当前XEActor的类型,如XECameraActor的类型是“CameraActor”;XEDirLightActor的类型是 “DirLightActor”。

Returns
string

◆ GetWorldTransform()

function XEActor GetWorldTransform ( )

获取当前XEActor的世界矩阵

Returns
XMATRIX4

◆ Initialize()

function XEActor Initialize ( pWorld  )

初始化根组件m_pRootComponent以及当前XEActor的序号(order)、DrawDebugType和碰撞通道等。

Parameters
pWorldXEWorld 当前Actor所属的世界指针
Returns
void

◆ IsActorTickable()

function XEActor IsActorTickable ( )

获取当前Actor是否允许Tick

Returns
boolean

◆ IsBoundingBoxVisible()

function XEActor IsBoundingBoxVisible ( )

包围盒是否可见

Returns
boolean

◆ IsChildActor()

function XEActor IsChildActor ( pChildActor  )

判断某个Actor是否是当前Actor的子Actor

Parameters
pChildActorXEActor
Returns
boolean

◆ IsDeleted()

function XEActor IsDeleted ( )

判断当前XEActor的是否被标记为已删除

Returns
boolean

◆ IsDrawAuxiliary()

function XEActor IsDrawAuxiliary ( )

判断渲染辅助类型EDD_DRAW_AUXILIARY是否被标记

Returns
boolean

◆ IsDummyShapeVisible()

function XEActor IsDummyShapeVisible ( )

Actor的示意图例/渲染示意形状是否可见

Returns
boolean

◆ IsHidden()

function XEActor IsHidden ( )

获取当前Actor是否隐藏

Returns
boolean

◆ IsHiddenInGame()

function XEActor IsHiddenInGame ( )

获取当前Actor是否在世界运行态时隐藏的状态

Returns
boolean

◆ IsInGuestWorld()

function XEActor IsInGuestWorld ( )

当前Actor是否在其他世界,返回true,表示目前在其他世界;返回false,表示目前在自己所在的世界

Returns
boolean

◆ IsModified()

function XEActor IsModified ( )

判断当前XEActor(包括它的组件)是否被标记为已修改

Returns
boolean

◆ IsPickEnable()

function XEActor IsPickEnable ( )

判断当前XEActor的是否允许拾取

Returns
boolean

◆ IsSerialized()

function XEActor IsSerialized ( pEleParent  )

当前Actor是否已经被序列化

Parameters
pEleParentXMLElement
Returns
boolean

◆ IsTransformMergeMode()

function XEActor IsTransformMergeMode ( )

判断Transform是否处于合并模式

Returns
boolean

◆ MergeToWorldTransform()

function XEActor MergeToWorldTransform ( toMatrix  )

设置当前代表头饰的XEActor的世界矩阵,目前此方法仅用于头饰模型,如果想为非头饰的模型设置世界矩阵,可通过调用ApplyWorldTransform函数。

Parameters
toMatrixXMATRIX4 设置当前代表头饰的XEActor的世界矩阵
Returns
boolean 是否设置成功

◆ OnSocketRender()

function XEActor OnSocketRender ( pBindSocketIns  )

当当前XEActor被绑定到其他槽上时,用于渲染绑定物体

Parameters
pBindSocketInsXEBindSocketInstance 来源插槽
Returns
void

◆ OnSocketTick()

function XEActor OnSocketTick ( pBindSocketIns  ,
matWorld   
)

当当前XEActor被绑定到其他槽上时,用于根据槽的变换更新当前XEActor的状态。

Parameters
pBindSocketInsXEBindSocketInstance
matWorldXMATRIX4 用于更新当前XEActor状态的世界矩阵
Returns
void

◆ PostInitialized()

function XEActor PostInitialized ( )

在初始化完成后, 可能会进行一些后处理操作

Returns
void

◆ PostTick()

function XEActor PostTick ( fDelMs  )

更新当前XEActor[帧后]

Parameters
fDelMsnumber 表示当前XEActor每帧更新的时间间隔(ms)
Returns
void

◆ PresentPhysics()

function XEActor PresentPhysics ( fDel  )

更新物理

Parameters
fDelnumber 间隔
Returns
void

◆ PreTick()

function XEActor PreTick ( fDelMs  )

更新当前XEActor[帧前]

Parameters
fDelMsnumber 表示当前XEActor每帧更新的时间间隔(ms)
Returns
void

◆ RayPick() [1/3]

function XEActor RayPick ( hr  )

对当前 XEActor 执行拾取运算,并返回拾取结果

Parameters
hrXEHitResult [in][out]拾取结果结构体,包含输入的射线起始位置和方向;输出的拾取到的XEActor、拾取到的3D场景的坐标点等,具体参考XEHitResult的介绍.
Returns
boolean 是否拾取成功

◆ RayPick() [2/3]

function XEActor RayPick ( hr  ,
vScreenPoint  ,
viewport   
)

对当前 XEActor 执行拾取运算,并返回拾取结果

Parameters
hrXEHitResult [in][out]拾取结果结构体,包含输入的射线起始位置和方向;输出的拾取到的XEActor、拾取到的3D场景的坐标点等,具体参考XEHitResult的介绍.
vScreenPointXVECTOR2 拾取时的像素坐标,例如在编辑器的窗口中进行拾取时,鼠标的坐标.
viewportXViewport 当前拾取坐标所在窗口绑定的视口对象.
Returns
boolean 是否拾取成功

◆ RayPick() [3/3]

function XEActor RayPick ( vScreenPoint  ,
pViewport   
)

对当前 XEActor 执行拾取运算,并返回拾取结果

Parameters
vScreenPointXVECTOR2 拾取时的像素坐标,例如在编辑器的窗口中进行拾取时,鼠标的坐.
pViewportXViewport 当前拾取坐标所在窗口绑定的视口对象.
Returns
XEHitResult 拾取结果结构体,具体参考XEHitResult的介绍.

◆ ReCalculateParentMatrixByUserNode() [1/2]

function XEActor ReCalculateParentMatrixByUserNode ( pParentActor  ,
matOutParentMatrix   
)

根据嵌套时选择的父Actor的骨骼或槽点,得到对应的矩阵信息

Parameters
pParentActorXEActor 当前Actor的父Actor
matOutParentMatrixXMATRIX4 [out]输出矩阵
Returns
boolean

◆ ReCalculateParentMatrixByUserNode() [2/2]

function XEActor ReCalculateParentMatrixByUserNode ( pParentActor  )

XEActor_ReCalculateParentMatrixByUserNode01

Parameters
pParentActorXEActor
Returns
XMATRIX4
boolean

◆ Release()

function XEActor Release ( )

释放资源

Returns
void

◆ RemoveExtendParam()

function XEActor RemoveExtendParam ( pExtendParam  ,
bDeleteMemory   
)

从当前XEActor 的扩展参数列表中删除 pExtendParam,当 bDeleteMemory 为 xtrue 时,释放 pExtendParam 指针。

Parameters
pExtendParamIXEExtendParam
bDeleteMemoryboolean 代表是否释放pExtendParam指针
Returns
boolean 是否移除成功

◆ Render()

function XEActor Render ( pViewport  )

渲染当前XEActor,包括根据状态判断是否渲染包围盒、dummy以及辅助元素等,以及该Actor的组件。

Parameters
pViewportXEViewport 当前Actor所属的世界对象绑定的视口指针
Returns
void

◆ RenderDrawDebug()

function XEActor RenderDrawDebug ( pViewport  )

渲染当前XEActor的辅助元素,默认不渲染任何辅助元素,子类可重写此函数来渲染不同的元素,如相机Actor可渲染其视椎体的线框。

Parameters
pViewportXEViewport 当前Actor所属的世界对象绑定的视口指针
Returns
void

◆ ResetMergeRenderHidden()

function XEActor ResetMergeRenderHidden ( )

重置显隐的合并状态值

Returns
void

◆ ReturnBackToOwnerWorld()

function XEActor ReturnBackToOwnerWorld ( )

当前Actor回到自己的世界

Returns
boolean 是否成功

◆ RotateAxis()

function XEActor RotateAxis ( vRotateAxis  ,
fDeltaRadian   
)

将当前XEActor绕vRotateAxis轴旋转fDeltaRadian弧度

Parameters
vRotateAxisXVECTOR3
fDeltaRadiannumber
Returns
void

◆ RotateX()

function XEActor RotateX ( fDeltaRadian  )

将当前XEActor绕X轴旋转fDeltaRadian弧度。

Parameters
fDeltaRadiannumber
Returns
void

◆ RotateY()

function XEActor RotateY ( fDeltaRadian  )

将当前XEActor绕Y轴旋转fDeltaRadian弧度。

Parameters
fDeltaRadiannumber
Returns
void

◆ RotateZ()

function XEActor RotateZ ( fDeltaRadian  )

将当前XEActor绕Z轴旋转fDeltaRadian弧度。

Parameters
fDeltaRadiannumber
Returns
void

◆ SetActorLocalLocation()

function XEActor SetActorLocalLocation ( location  )

获取当前Actor相对于父Actor坐标系的局部坐标位置

Parameters
locationXVECTOR3
Returns
void

◆ SetActorLocation() [1/2]

function XEActor SetActorLocation ( fX  ,
fY  ,
fZ   
)

设置当前XEActor在世界坐标系中的位置

Parameters
fXnumber 在世界中指定位置的x分量
fYnumber 在世界中指定位置的y分量
fZnumber 在世界中指定位置的z分量
Returns
void

◆ SetActorLocation() [2/2]

function XEActor SetActorLocation ( loc  )

设置当前XEActor在世界坐标系中的位置

Parameters
locXVECTOR3 在世界中指定的位置
Returns
void

◆ SetActorName()

function XEActor SetActorName ( szActorName  ,
pContext   
)

设置当前XEActor的名称, 子类可对此方法进行重载。注意, 改变Actor的名字的行为有风险!您需要在子类中解决名字改变带来的风险

Parameters
szActorNamestring 代表要为XEActor设置名称的字符串
pContextXEWorld 当前XEActor所属的世界指针,以允许该Actor在未指定所属世界时,外部传入一个世界上下文。
Returns
boolean 表示设置是否成功

◆ SetActorRotation() [1/2]

function XEActor SetActorRotation ( fPitch  ,
fYaw  ,
fRoll   
)

设置当前XEActor在世界坐标系中的朝向

Parameters
fPitchnumber 在世界坐标系下,绕x轴旋转角(弧度制)
fYawnumber 在世界坐标系下,绕y轴旋转角(弧度制)
fRollnumber 在世界坐标系下,绕z轴旋转角(弧度制)
Returns
void

◆ SetActorRotation() [2/2]

function XEActor SetActorRotation ( rot  )

设置当前XEActor在世界坐标系中的朝向

Parameters
rotXQUATERNION 代表当前XEActor在世界中朝向的四元数
Returns
void

◆ SetActorScale()

function XEActor SetActorScale ( sca  )

设置当前Actor在世界坐标系中的缩放值

Parameters
scaXVECTOR3
Returns
void

◆ SetActorTickEnabled()

function XEActor SetActorTickEnabled ( bEnable  )

设置当前Actor是否允许Tick

Parameters
bEnableboolean
Returns
void

◆ SetBoundingBoxColor()

function XEActor SetBoundingBoxColor ( clVal  )

设置当前Actor的包围盒颜色

Parameters
clValnumber
Returns
void

◆ SetCollisionChannel()

function XEActor SetCollisionChannel ( ccm  )

设置当前Actor的碰撞通道

Parameters
ccmXECollisionChannelMeta
Returns
void

◆ SetDeleted()

function XEActor SetDeleted ( bDelete  )

设置删除状态

Parameters
bDeleteboolean 是否删除
Returns
void

◆ SetDrawDebugType()

function XEActor SetDrawDebugType ( nDebug  )

设置当前Actor渲染的辅助类型

Parameters
nDebugnumber
Returns
void

◆ SetFilterPath() [1/2]

function XEActor SetFilterPath ( szFilterPath  )

设置当前XEActor的筛选路径,默认把路径小写

Parameters
szFilterPathstring
Returns
void

◆ SetFilterPath() [2/2]

function XEActor SetFilterPath ( szFilterPath  ,
bIsToLower   
)

设置当前XEActor的筛选路径

Parameters
szFilterPathstring
bIsToLowerboolean 是否把路径字符串小写
Returns
void

◆ SetForwardDirAndUp()

function XEActor SetForwardDirAndUp ( vForwardDir  ,
vUp   
)

在世界坐标系下,设置当前XEActor的朝向向量和UP向量。通过设置朝向向量和UP向量设置当前XEActor的旋转朝向

Parameters
vForwardDirXVECTOR3
vUpXVECTOR3
Returns
void

◆ SetHidden()

function XEActor SetHidden ( bHide  )

设置隐藏状态

Parameters
bHideboolean 是否隐藏
Returns
void

◆ SetHiddenInGame()

function XEActor SetHiddenInGame ( bHide  )

设置当前Actor是否在世界运行态时隐藏

Parameters
bHideboolean
Returns
void

◆ SetMergeRenderHidden()

function XEActor SetMergeRenderHidden ( nMergeBit  ,
bHidden   
)

设置显隐的合并状态值

Parameters
nMergeBitnumber
bHiddenboolean
Returns
number 当前合并状态值

◆ SetMergeRenderHiddenEnable()

function XEActor SetMergeRenderHiddenEnable ( nMergeBit  ,
bEnable   
)

设置显隐的合并状态值的指定有效位是否有效

Parameters
nMergeBitnumber 要设置的位
bEnableboolean 要设置的显隐状态
Returns
number 当前合并状态值

◆ SetModified()

function XEActor SetModified ( bModified  )

设置当前Actor是否被修改了

Parameters
bModifiedboolean
Returns
void

◆ SetOrder()

function XEActor SetOrder ( nOrder  )

设置当前XEActor的序号,用于排序使用

Parameters
nOrdernumber
Returns
void

◆ SetPickMask()

function XEActor SetPickMask ( nMask  )

设置当前XEActor的拾取掩码

Parameters
nMasknumber
Returns
void

◆ SetPickPriority()

function XEActor SetPickPriority ( nPriority  )

设置当前XEActor的拾取优先级

Parameters
nPrioritynumber
Returns
void

◆ SetPositionAndForwardDirUp()

function XEActor SetPositionAndForwardDirUp ( vPosition  ,
vForwardDir  ,
vUp   
)

在世界坐标系下,设置当前XEActor的位置、朝向向量和UP向量,其中设置朝向向量和UP向量是为了计算当前XEActor的旋转状态

Parameters
vPositionXVECTOR3
vForwardDirXVECTOR3
vUpXVECTOR3
Returns
void

◆ SetRootComponent()

function XEActor SetRootComponent ( pRootComponent  )

设置当前XEActor的根组件。 如果当前 XEActor 的根组件为空,则直接将pRootComponent赋值给根组件; 如果当前根组件不为空并且不是pRootComponent,则把当前XEActor的根组件修改为pRootComponent。

Parameters
pRootComponentXEActorComponent
Returns
boolean 表示给当前XEActor根组件赋值成功或失败

◆ SetTransformMergeMode()

function XEActor SetTransformMergeMode ( bMerge  ,
bRecursion   
)

【适用于人脸追踪的3D头饰】 设置变换是否是合并模式

Parameters
bMergeboolean 是否合并,为xtrue时,将会被标记为变换合并模式,该模式会影响该Actor的变换行为,例如将会将自身坐标系变换到外部传递的坐标系内。
bRecursionboolean 是否递归影响其子节点
Returns
void

◆ SetUpdateTranfromFromUserNode()

function XEActor SetUpdateTranfromFromUserNode ( bIsUpdate  )

设置是否根据挂载节点更新当前Actor的Transform

Parameters
bIsUpdateboolean
Returns
void

◆ SpawnCloneActor()

function XEActor SpawnCloneActor ( )

完整克隆并在Level中产出新的拷贝Actor对象,自动分配唯一名称,克隆的Actor对象将会储存在所属Level中

Returns
XEActor

◆ Tick()

function XEActor Tick ( fDelMs  ,
bForceTick   
)

更新当前XEActor帧

Parameters
fDelMsnumber 表示当前XEActor每帧更新的时间间隔(ms)
bForceTickboolean 是否强制Tick.如果为true,不管当前Actor是否隐藏,都会更新;如果为false,当前Actor如果隐藏时不更新。
Returns
void

◆ TravelToGuestWorld()

function XEActor TravelToGuestWorld ( pGuestWorld  )

当前Actor离开自己的世界,到其他世界去

Parameters
pGuestWorldXEWorld 当前Actor去往的其他世界指针
Returns
boolean 是否成功

◆ UpdateBindDataFromParentUserNode()

function XEActor UpdateBindDataFromParentUserNode ( bBindUserNodeData  )

更新父子嵌套的挂载节点信息

Parameters
bBindUserNodeDataXEBindUserNodeData
Returns
void

◆ UpdateLocalTransformForChildComponent()

function XEActor UpdateLocalTransformForChildComponent ( )

更新当前Actor内记录的与其关联的子Actor组件的矩阵

Returns
void

Variable Documentation

◆ EDD_BOUNDINGBOX

XEActor EDD_BOUNDINGBOX = 0

◆ EDD_DRAW_AUXILIARY

XEActor EDD_DRAW_AUXILIARY = 0

◆ EDD_DRAW_NONE

XEActor EDD_DRAW_NONE = 0

◆ EDD_DUMMY_SHAPE

XEActor EDD_DUMMY_SHAPE = 0

◆ EDD_OUTLINE

XEActor EDD_OUTLINE = 0

◆ XEActor

XEActor = {}