Skip to content

索引 ​


关节 ​

接口
描述
CreateDistanceJoint服务端创建距离关节,限制两个锚点之间的距离范围,可配弹簧
CreateFixedJoint服务端创建固定关节,两个刚体刚性连接,无自由度
CreatePrismaticJoint服务端创建滑动关节;两个刚体仅能沿指定轴相对平移,旋转被锁定,可加行程限制
CreateRevoluteJoint服务端创建铰链关节,绕指定轴单轴旋转,可加角度限制和电机
CreateSphericalJoint服务端创建球窝关节,允许三轴旋转,可加锥形角度限制
DestroyAllJoints服务端销毁所有关节
DestroyJoint服务端销毁关节
DestroyJointsForEntity服务端销毁指定实体上所有关联的关节,应在实体销毁前调用
GetJointBreakForce服务端获取关节的断裂力和断裂扭矩
GetJointFrames服务端获取关节两端当前的本地frame和世界frame
GetJointType服务端查询关节类型
GetRevoluteJointAngle服务端获取铰链关节当前相对于创建零位的旋转角度。仅对RevoluteJoint有效
GetRevoluteJointVelocity服务端获取铰链关节当前角速度。仅对RevoluteJoint有效
IsJointBroken服务端查询关节是否已断裂
SetDistanceJointParams服务端设置距离关节参数
SetJointBreakForce服务端设置关节可承受的约束力/约束扭矩阈值;PhysX求解出的实际约束载荷超过任一阈值时自动断裂。冲量(eIMPULSE,单位N·s)不能直接与力阈值(N)比较
SetJointCollisionEnabled服务端设置关节关联的两个刚体之间是否发生碰撞,适用于所有关节类型
SetPrismaticJointLimit服务端设置滑动关节的行程限制并启用
SetRevoluteJointDrive服务端设置铰链关节的电机并启用
SetRevoluteJointLimit服务端设置铰链关节的角度限制并启用
SetSphericalJointLimitCone服务端设置球窝关节的锥形角度限制并启用

场景 ​

接口
描述
ClearRemoteVisualSync服务端清除该自定义 PhysX 刚体的运行时远端同步配置,恢复实体定义的默认带宽优化行为,仅服务端可调用。
ConnectPvd服务端连接本机 PhysX Visual Debugger(PVD)以调试当前 PhysX 场景
DisconnectPvd服务端断开当前 PhysX 场景与本机 PhysX Visual Debugger(PVD)的连接
Raycast服务端射线检测,获取与射线相交的碰撞体。目前仅支持获取自定义刚体
Raycast客户端射线检测,获取与射线相交的碰撞体。目前仅支持获取自定义刚体
SampleBuoyancy服务端使用C++批量采样自定义刚体的浸没体积、浮力合力和浮心;本接口只计算,不施力,仅服务端可调用。
SetRemoteVisualSync服务端设置该自定义 PhysX 刚体的远端位置与四元数同步降频参数,整个刚体的所有 shape/mesh 一并生效,仅服务端可调用。
SetSceneGravity服务端设置指定维度 PhysX 场景的全局重力,仅服务端可调用;立即影响该维度内全部受重力的动态 PhysX 刚体。

刚体 ​

接口
描述
AddForce服务端对自定义刚体的质心施加全局坐标力;数值单位由mode决定,对运动学刚体无效
AddForceAtPos服务端对自定义刚体的指定位置添加力,对运动学刚体无效
AddForceAtPosLocal服务端对自定义刚体的指定位置添加力,对运动学刚体无效
AddTorque服务端对自定义刚体添加扭矩,对运动学刚体无效
AddTorqueLocal服务端在自定义刚体本地坐标系中添加扭矩,对运动学刚体无效。X轴为Roll(滚转),Y轴为Yaw(偏航),Z轴为Pitch(俯仰)
CreatePxActor服务端给实体创建自定义刚体
GetActorFlags服务端获取 actor 当前 ActorFlags(诊断接口,bit1=eDISABLE_GRAVITY,bit2=eSEND_SLEEP_NOTIFIES,bit3=eDISABLE_SIMULATION)
GetAngularVelocity服务端获取自定义刚体的角速度
GetAngularVelocity客户端获取自定义刚体在世界坐标系下的角速度
GetLinearVelocity服务端获取自定义刚体的线速度(world space)
GetLinearVelocity客户端获取自定义刚体在世界坐标系下的线速度
GetMass服务端获取自定义刚体的质量(PhysX 内部 mass,由 density+体积合成)
GetMassSpaceInertiaTensor服务端获取刚体的惯性张量对角线分量
GetQuaternion服务端获取自定义刚体的四元数旋转
GetQuaternion客户端获取自定义刚体的四元数旋转
GetRigidBodyFlags服务端获取刚体当前 RigidBodyFlags(诊断接口,bit0=eKINEMATIC)
GetRigidDynamicLockFlags服务端获取动态刚体当前 RigidDynamicLockFlags(诊断接口,bit0-2=Linear XYZ lock,bit3-5=Angular XYZ lock)
IsDefaultPxActor服务端是否为引擎默认创建的 PxActor(诊断接口,True 表示 mod CreatePxActor 实际是 no-op)
IsSleeping服务端查询自定义刚体是否处于休眠状态
PutToSleep服务端强制刚体进入休眠
SetActorFlag服务端设置物理实体的行为开关
SetAngularDamping服务端设置动态刚体的角阻尼,值越大角速度衰减越快
SetAngularVelocity服务端设置自定义刚体的角速度,对运动学刚体无效
SetCMassLocalPose服务端设置质心相对于actor原点的偏移,用于手动调整重心
SetGlobalPose服务端设置自定义刚体的变换(直接瞬移)
SetGlobalPose客户端设置客户端本地自定义刚体的变换(直接瞬移)
SetKinematicTarget服务端设置运动学刚体的目标变换,仅对开启了PxRigidBodyFlag.eKINEMATIC的自定义刚体生效
SetLinearDamping服务端设置动态刚体的线性阻尼,值越大线速度衰减越快
SetLinearVelocity服务端设置自定义刚体的线速度(world space),仅对PxRigidDynamic生效
SetMass服务端设置动态刚体质量
SetMaxAngularVelocity服务端设置自定义刚体的最大角速度,防止碰撞后疯转
SetMaxLinearVelocity服务端设置自定义刚体的最大线速度,防止物体飞出天际
SetRigidBodyFlag服务端设置自定义刚体的行为开关
SetRigidDynamicLockFlags服务端设置自定义刚体的约束
WakeUp服务端唤醒休眠中的刚体

碰撞体 ​

接口
描述
AddBoxGeometry服务端给自定义刚体创建盒形碰撞体
AddBoxGeometry客户端给客户端本地自定义刚体创建盒形碰撞体
AddBoxTrigger服务端给自定义刚体创建盒子形触发器
AddCapsuleGeometry服务端给自定义刚体创建胶囊形碰撞体
AddSphereGeometry服务端给自定义刚体创建球形碰撞体
GetShapeCount服务端获取自定义刚体当前的碰撞 shape 数量
GetShapeCount客户端获取客户端本地自定义刚体当前的碰撞 shape 数量
GetShapeInfo服务端获取指定碰撞 shape 的信息
GetShapeInfo客户端获取客户端本地指定碰撞 shape 的信息
RemoveShape服务端删除自定义刚体上指定索引的碰撞 shape,适用于盒形、胶囊形、球形碰撞体和触发器
RemoveShape客户端删除客户端本地自定义刚体上指定索引的碰撞 shape
RemoveShapeByUserData服务端删除所有 userData 与指定值相同的碰撞 shape
RemoveShapeByUserData客户端删除客户端本地所有 userData 与指定值相同的碰撞 shape