PhysX Scene Queries

您可以使用物理特性光线投射查询来确定特定线段是否与物理特性几何体相交。同样，形状转换查询（也称为扫描）测试沿线段拉伸的形状是否与物理几何体相交。这些查询的示例用途可能包括确定一个对象是否在另一个对象的前面，或测试视线。重叠查询是第三种类型的场景查询，用于确定固定形状是否与其他物理几何体相交。所有这些场景查询都在AzPhysics::SceneInterface 对象上执行，并且它们都针对整个场景进行测试。请注意，除了针对整个场景的查询外，还可以对单个 PhysX 模拟体执行光线投射。

每种类型的场景查询都可以使用AzPhysics::SceneQueryRequest对象来执行（三种场景查询类型中的每一种都有请求对象的专用化）。除了执行单个查询外，还可以使用AzPhysics::SceneQueryRequests对象（许多查询的容器）将一批查询收集到单个调用中。也可以同步或异步调用请求。

virtual SceneQueryHits QueryScene(SceneHandle sceneHandle, const SceneQueryRequest* request) = 0;
virtual SceneQueryHitsList QuerySceneBatch(SceneHandle sceneHandle, const SceneQueryRequests& requests) = 0;
[[nodiscard]] virtual bool QuerySceneAsync(SceneHandle sceneHandle, SceneQuery::AsyncRequestId requestId,
    const SceneQueryRequest* request, SceneQuery::AsyncCallback callback) = 0;
[[nodiscard]] virtual bool QuerySceneAsyncBatch(SceneHandle sceneHandle, SceneQuery::AsyncRequestId requestId,
    const SceneQueryRequests& requests, SceneQuery::AsyncBatchCallback callback) = 0;

场景查询的结果使用AzPhysics::SceneQueryHit对象的容器进行描述。

注意:

场景查询可能会降低性能。

光线投射

光线投射查询是最常见的场景查询，它基于从开始位置沿光线方向发射光线指定距离的光线。

例 光线投射查询仅与五边形相交。

光线投射查询是使用AzPhysics::RayCastRequest指定的。

RayCastRequest 属性

要执行光线投射查询，请使用AzPhysics::SceneInterface.

示例 (C++)

auto* sceneInterface = AZ::Interface<AzPhysics::SceneInterface>::Get();

AzPhysics::RayCastRequest request;
request.m_start = AZ::Vector3(-100.0f, 0.0f, 0.0f);
request.m_direction = AZ::Vector3(1.0f, 0.0f, 0.0f);
request.m_distance = 200.0f;

AzPhysics::SceneQueryHits result = sceneInterface->QueryScene(AzPhysics::DefaultPhysicsSceneName, &request);
auto numHits = result.size();

示例 (Lua)

physicsSystem = GetPhysicsSystem()
sceneHandle = physicsSystem:GetSceneHandle(DefaultPhysicsSceneName)
scene = physicsSystem:GetScene(sceneHandle)
request = RayCastRequest()
request.Start = Vector3(5.0, 0.0, 5.0)
request.Direction = Vector3(0.0, 0.0, -1.0)
request.Distance = 10.0
request.ReportMultipleHits = true
hits = scene:QueryScene(request)
numHits = hits.HitArray:Size()

Script Canvas

以下节点在 Script Canvas 中可用：

• Raycast (Local Space) 返回光线从源实体沿指定方向在本地空间中投射的第一个实体。
• Raycast (World Space) 返回光线在世界空间中从指定方向的起始位置投射的第一个实体。
• Raycast Multiple (Local Space) 返回光线在局部空间中从源实体沿指定方向投射的所有实体。

Shapecast

形状投射查询与光线投射查询类似，不同之处在于形状投射查询采用形状以及点和方向。形状沿射线扫掠以形成体积。与此卷相交的任何内容都将从查询中返回。

示例 形状转换查询呈球体形状，并与矩形和五边形实体相交。

光线投射查询是使用AzPhysics::ShapeCastRequest.

ShapeCastRequest 属性

支持长方体、胶囊体和球体几何体，并且有帮助程序函数可用于在AzPhysics::ShapeCastRequestHelpers中使用这些形状创建查询。C++ 也支持凸网格几何结构，但目前不支持脚本。

要执行 shapecast 查询，请使用 AzPhysics::SceneInterface.

示例 (C++)

auto* sceneInterface = AZ::Interface<AzPhysics::SceneInterface>::Get();

AzPhysics::ShapeCastRequest request = AzPhysics::ShapeCastRequestHelpers::CreateSphereCastRequest(1.0f,
    AZ::Transform::CreateTranslation(AZ::Vector3(-20.0f, 0.0f, 0.0f)),
    AZ::Vector3(1.0f, 0.0f, 0.0f),
    20.0f,
    AzPhysics::SceneQuery::QueryType::StaticAndDynamic,
    AzPhysics::CollisionGroup::All,
    nullptr);

AzPhysics::SceneQueryHits hits = sceneInterface->QueryScene(AzPhysics::DefaultPhysicsSceneName, &request);

示例 (Lua)

physicsSystem = GetPhysicsSystem()
sceneHandle = physicsSystem:GetSceneHandle(DefaultPhysicsSceneName)
scene = physicsSystem:GetScene(sceneHandle)

boxDimensions = Vector3(1.0, 1.0, 1.0)
startPose = Transform.CreateTranslation(Vector3(0.0, 0.0, 5.0))
direction = Vector3(0.0, 0.0, -1.0)
distance = 10.0
queryType = 0
collisionGroup = CollisionGroup("All")
request = CreateBoxCastRequest(boxDimensions, startPose, direction, distance, queryType, collisionGroup)

hits = scene:QueryScene(request)

Script Canvas

以下节点在 Script Canvas 中可用：

• Box Cast 返回具有框几何体的形状转换查询命中的第一个实体。
• Capsule Cast 返回具有胶囊体几何体的形状投射查询命中的第一个实体。
• Sphere Cast 返回具有球体几何体的形状投射查询命中的第一个实体。

Overlap

重叠查询更简单，因为它们不采用方向或距离。重叠查询只返回在世界中指定位置与形状相交的所有对象。

重叠查询是使用AzPhysics::OverlapRequest.

OverlapRequest 属性

支持长方体、胶囊体和球体几何体，并且有帮助程序函数可用于在AzPhysics::OverlapRequestHelpers中使用这些形状创建查询。C++ 也支持凸网格几何结构，但目前不支持脚本。

要执行重叠查询，请使用AzPhysics::SceneInterface.

示例 (C++)

auto* sceneInterface = AZ::Interface<AzPhysics::SceneInterface>::Get();

AzPhysics::OverlapRequest request = AzPhysics::OverlapRequestHelpers::CreateBoxOverlapRequest(AZ::Vector3(3.0f),
    AZ::Transform::CreateTranslation(AZ::Vector3(13.0f, 0.0f, 0.0f)));

AzPhysics::SceneQueryHits results = sceneInterface->QueryScene(AzPhysics::DefaultPhysicsSceneName, &request);

示例 (Lua)

physicsSystem = GetPhysicsSystem()
sceneHandle = physicsSystem:GetSceneHandle(DefaultPhysicsSceneName)
scene = physicsSystem:GetScene(sceneHandle)

boxDimensions = Vector3(1.0, 1.0, 1.0)
pose = Transform.CreateTranslation(Vector3(0.0, 0.0, 5.0))
request = CreateBoxOverlapRequest(boxDimensions, pose)

hits = scene:QueryScene(request)

Script Canvas

以下节点在 Script Canvas 中可用：

• Overlap Box 返回与盒体几何体重叠的 Entity ID 数组。
• Overlap Capsule 返回与胶囊体几何体重叠的实体 ID 数组。
• Overlap Sphere 返回与球体几何体重叠的实体 ID 数组。

SceneQueryHit

场景查询的结果使用 AzPhysics::SceneQueryHit对象进行描述。单个查询可能会返回多个结果，这些结果包含在AzPhysics::SceneQueryHits对象中。批处理查询的结果使用AzPhysics::SceneQueryHitsList对象进行描述，该对象是AzPhysics::SceneQueryHits对象的容器。

SceneQueryHit 属性