World.h 库里的 Trace API

  • Trace模式

    • TraceSingle 单个结果
    • TraceMulti 多个结果
  • Trace 的检测依据
    • ByChanne
    • ByObjectType
    • ByProfile

LineTraceSingleByChannel

由于一般不使用 World 里的Trace API,故本小结只举 LineTraceSingleByChannel 一个例子

  • Syntax

    bool LineTraceSingleByChannel(
    struct FHitResult& OutHit,
    const FVector& Start,
    const FVector& End,
    ECollisionChannel TraceChannel,
    const FCollisionQueryParams& Params = FCollisionQueryParams::DefaultQueryParam,
    const FCollisionResponseParams& ResponseParam = FCollisionResponseParams::DefaultResponseParam
    ) const;
  • 代码实现

    // 碰撞参数
    FCollisionQueryParams CollisonQueryParams(TEXT("QueryParams"),true,NULL);
    CollisonQueryParams.bTraceComplex = true;
    CollisonQueryParams.bReturnPhysicalMaterial = false;
    CollisonQueryParams.AddIgnoredActor(this); // 起始点和检测结果
    FVector BeginLoc = GetActorLocation();
    FVector EndLoc = BeginLoc + GetActorForwardVector() * 1000;
    FHitResult HitResult; // 射线检测
    GetWorld()->LineTraceSingleByChannel(HitResult, BeginLoc, EndLoc, ECollisionChannel::ECC_Visibility, CollisonQueryParams);
    // 绘制射线
    DrawDebugLine(GetWorld(), BeginLoc, HitResult.GetActor() ? HitResult.Location : EndLoc, FColor::Red, false, 1.0f);
    if (HitResult.GetActor())
    {
    UKismetSystemLibrary::PrintString(GetWorld(), HitResult.GetActor()->GetName());
    }

UKismetSystemLibrary 库里的 Trace API

  • 与蓝图使用的 Trace 节点对应,

  • 实际调用的是 World.h 里的 Trace 函数

LineTrace

LineTraceSingle

根据 Channel 检测单个物体

  • Syntax

    static bool LineTraceSingle(
    const UObject* WorldContextObject,
    const FVector Start,
    const FVector End,
    ETraceTypeQuery TraceChannel,
    bool bTraceComplex,
    const TArray<AActor*>& ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult& OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor = FLinearColor::Red,
    FLinearColor TraceHitColor = FLinearColor::Green,
    float DrawTime = 5.0f
    );
  • ETraceTypeQuery 说明

    • 默认 TraceTypeQuery1 —— Visibility
    • 默认 TraceTypeQuery2 —— Camera
    • 可在 ProjectSettings->Engine->Collision->Trace Channels 添加自定义
  • 代码实现

    // 起始点和检测结果
    FVector BeginLoc = GetActorLocation();
    FVector EndLoc = BeginLoc + GetActorForwardVector() * 1000;
    FHitResult HitResult; // 要忽略的物体
    TArray<AActor*> IgnoreActors; // 射线检测
    bool bIsHit = UKismetSystemLibrary::LineTraceSingle(GetWorld(), BeginLoc, EndLoc, TraceTypeQuery1, false, IgnoreActors, EDrawDebugTrace::ForDuration, HitResult, true);
    if (bIsHit)
    {
    UKismetSystemLibrary::PrintString(GetWorld(), HitResult.GetActor()->GetName());
    }

LineTraceSingleForObjects

根据 Object Type 检测单个物体

  • Syntax

    static bool LineTraceSingleForObjects(
    const UObject* WorldContextObject,
    const FVector Start,
    const FVector End,
    const TArray<TEnumAsByte<EObjectTypeQuery> > & ObjectTypes,
    bool bTraceComplex,
    const TArray<AActor*>& ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult& OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor = FLinearColor::Red,
    FLinearColor TraceHitColor = FLinearColor::Green,
    float DrawTime = 5.0f
    );
  • EObjectTypeQuery 对应 ObjectType

    • 默认 ObjectTypeQuery1 —— WorldStatic
    • 默认 ObjectTypeQuery2 —— WorldDynamic
    • 默认 ObjectTypeQuery3 —— Oawn
    • 默认 ObjectTypeQuery4 —— PhysicasBody
    • 默认 ObjectTypeQuery5 —— Vehicle
    • 默认 ObjectTypeQuery6 —— Destructible
    • 可以再 ProjectSettings->Engine->Collision->Object Channels 添加自定义
  • 代码实现

    // 设置要检测的 Object Type
    TArray<TEnumAsByte<EObjectTypeQuery> > ObjectTypes;
    ObjectTypes.Add(EObjectTypeQuery::ObjectTypeQuery1); //开始检测
    bool bIsHit = UKismetSystemLibrary::LineTraceSingleForObjects(GetWorld(), BeginLoc, EndLoc, ObjectTypes, false, IgnoreActors, EDrawDebugTrace::ForDuration, HitResult, true);
    if (bIsHit)
    {
    UKismetSystemLibrary::PrintString(GetWorld(), HitResult.GetActor()->GetName());
    }

LineTraceSingleByProfile

根据 Collision Preset 检测单个物体

  • Syntax

    static bool LineTraceSingleByProfile(
    const UObject* WorldContextObject,
    const FVector Start,
    const FVector End,
    FName ProfileName,
    bool bTraceComplex,
    const TArray<AActor*>& ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult& OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor = FLinearColor::Red,
    FLinearColor TraceHitColor = FLinearColor::Green,
    float DrawTime = 5.0f
    );
  • ProfileName 对应 Collision Preset 的名称

  • 代码实现

    bool bIsHit = UKismetSystemLibrary::LineTraceSingleByProfile(GetWorld(), BeginLoc, EndLoc,TEXT("BlockAll"), false, IgnoreActors, EDrawDebugTrace::ForDuration, HitResult, true);
    if (bIsHit)
    {
    UKismetSystemLibrary::PrintString(GetWorld(), HitResult.GetActor()->GetName());
    }

LineTraceMulti

根据 Channel 检测多个物体,输出 TArray&

  • Syntax

    static bool LineTraceMulti(
    const UObject* WorldContextObject,
    const FVector Start,
    const FVector End,
    ETraceTypeQuery TraceChannel,
    bool bTraceComplex,
    const TArray<AActor*>& ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray<FHitResult>& OutHits,
    bool bIgnoreSelf,
    FLinearColor TraceColor = FLinearColor::Red,
    FLinearColor TraceHitColor = FLinearColor::Green,
    float DrawTime = 5.0f
    );

LineTraceMultiForObjects

根据 Object Type 检测多个物体,输出 TArray&

  • Syntax

    static bool LineTraceMultiForObjects(
    const UObject* WorldContextObject,
    const FVector Start,
    const FVector End,
    const TArray<TEnumAsByte<EObjectTypeQuery> > & ObjectTypes,
    bool bTraceComplex,
    const TArray<AActor*>& ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray<FHitResult>& OutHits,
    bool bIgnoreSelf, FLinearColor TraceColor = FLinearColor::Red,
    FLinearColor TraceHitColor = FLinearColor::Green,
    float DrawTime = 5.0f
    );

LineTraceMultiByProfile

根据 Collision Preset 检测多个物体,输出 TArray&

  • Syntax

    static bool LineTraceMultiByProfile
    (
    const UObject* WorldContextObject,
    const FVector Start,
    const FVector End,
    FName ProfileName,
    bool bTraceComplex,
    const TArray<AActor*>& ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray<FHitResult>& OutHits,
    bool bIgnoreSelf,
    FLinearColor TraceColor = FLinearColor::Red,
    FLinearColor TraceHitColor = FLinearColor::Green,
    float DrawTime = 5.0f
    );

BoxTrace

  • BoxTraceSingle

    static bool BoxTraceSingle
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    const FVector HalfSize,
    const FRotator Orientation,
    ETraceTypeQuery TraceChannel,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult & OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • BoxTraceMulti

    static bool BoxTraceMulti
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    FVector HalfSize,
    const FRotator Orientation,
    ETraceTypeQuery TraceChannel,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray < FHitResult > & OutHits,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • BoxTraceSingleForObjects

    static bool BoxTraceSingleForObjects
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    const FVector HalfSize,
    const FRotator Orientation,
    const TArray < TEnumAsByte < EObjectTypeQuery > > & ObjectTypes,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult & OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • BoxTraceMultiForObjects

    static bool BoxTraceMultiForObjects
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    const FVector HalfSize,
    const FRotator Orientation,
    const TArray < TEnumAsByte < EObjectTypeQuery > > & ObjectTypes,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray < FHitResult > & OutHits,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • BoxTraceSingleByProfile

    static bool BoxTraceSingleByProfile
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    const FVector HalfSize,
    const FRotator Orientation,
    FName ProfileName,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult & OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • BoxTraceMultiByProfile

    static bool BoxTraceMultiByProfile
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    FVector HalfSize,
    const FRotator Orientation,
    FName ProfileName,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray < FHitResult > & OutHits,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )

SphereTrace

  • SphereTraceSingle

    static bool SphereTraceSingle
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    ETraceTypeQuery TraceChannel,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult & OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • SphereTraceMulti

    static bool SphereTraceMulti
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    ETraceTypeQuery TraceChannel,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray < FHitResult > & OutHits,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • SphereTraceSingleForObjects

    static bool SphereTraceSingleForObjects
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    const TArray < TEnumAsByte < EObjectTypeQuery > > & ObjectTypes,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult & OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • SphereTraceMultiForObjects

    static bool SphereTraceMultiForObjects
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    const TArray < TEnumAsByte < EObjectTypeQuery > > & ObjectTypes,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray < FHitResult > & OutHits,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • SphereTraceSingleByProfile

    static bool SphereTraceSingleByProfile
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    FName ProfileName,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult & OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • SphereTraceMultiByProfile

    static bool SphereTraceMultiByProfile
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    FName ProfileName,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray < FHitResult > & OutHits,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )

CapsuleTrace

  • CapsuleTraceSingle

    static bool CapsuleTraceSingle
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    float HalfHeight,
    ETraceTypeQuery TraceChannel,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult & OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • CapsuleTraceMulti

    static bool CapsuleTraceMulti
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    float HalfHeight,
    ETraceTypeQuery TraceChannel,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray < FHitResult > & OutHits,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • CapsuleTraceSingleForObjects

    static bool CapsuleTraceSingleForObjects
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    float HalfHeight,
    const TArray < TEnumAsByte < EObjectTypeQuery > > & ObjectTypes,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult & OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • CapsuleTraceMultiForObjects

    static bool CapsuleTraceMultiForObjects
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    float HalfHeight,
    const TArray < TEnumAsByte < EObjectTypeQuery > > & ObjectTypes,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray < FHitResult > & OutHits,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • CapsuleTraceSingleByProfile

    static bool CapsuleTraceSingleByProfile
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    float HalfHeight,
    FName ProfileName,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    FHitResult & OutHit,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )
  • CapsuleTraceMultiByProfile

    static bool CapsuleTraceMultiByProfile
    (
    const UObject * WorldContextObject,
    const FVector Start,
    const FVector End,
    float Radius,
    float HalfHeight,
    FName ProfileName,
    bool bTraceComplex,
    const TArray < AActor * > & ActorsToIgnore,
    EDrawDebugTrace::Type DrawDebugType,
    TArray < FHitResult > & OutHits,
    bool bIgnoreSelf,
    FLinearColor TraceColor,
    FLinearColor TraceHitColor,
    float DrawTime
    )

参考

【UE4 C++】 射线检测 LineTrace 及 BoxTrace、SphereTrace、CapsuleTrace API的更多相关文章

  1. 【Unity3D】枪战游戏—发射子弹、射线检测

    一.子弹的碰撞检测: 因为子弹的移动速度非常的快,那么如果为子弹添加一个collider,就有可能检测不到了. 因为collider是每一帧在执行,第一帧子弹可能在100米处,那么下一帧就在900米处 ...

  2. Unity3D 之射线检测

    这里来记录下射线检测的相关内容: 射线检测故名就是通过射线去检测是否和碰撞器产生了交集,和碰撞器与碰撞器发生交集一样,会返回一个真. 射线的用法很多:比如检测是否跳跃,通过向地面投射射线控制在地面时候 ...

  3. Unity3D 5.0简单的射线检测实现跳跃功能

    这里是一个简单的跳跃,5.0和其他版本貌似不一样,并且,再起跳功能做的不完全. 不过一个基本的思路在这里. 1.首先,射线检测,这里是利用一个空对象,放到主角对象的下面 2.然后调节射线的位置,在主角 ...

  4. UGUI射线检测

    1.Graphic Raycaster 主要用于UI上的射线检测,挂有这个组件的物体,必须要挂上Canvas这个组件(当挂上Graphic Raycaster时Canvas也会自动挂上). Ignor ...

  5. Unity射线检测的用法总结

    RayCast 射线检测 本文提供全流程,中文翻译. Chinar 坚持将简单的生活方式,带给世人!(拥有更好的阅读体验 -- 高分辨率用户请根据需求调整网页缩放比例) Chinar -- 心分享.心 ...

  6. U3D学习10——关节和射线检测

    1.弹簧  2.铰链  3.固定关节  4.角色关节  5.自定义关节  6.raycast和raycasthit 射线有位移参数,可以设定只触发某一层的. 7.射线检测用于高速和精确 update是 ...

  7. Layabox 3D游戏开发学习笔记---射线检测,鼠标控制物体运动

    核心要点:3D物体碰撞是靠射线检测,射线与碰撞器相撞获取对应的碰撞点信息. class RayPicking03 { private ray: Laya.Ray; private point: Lay ...

  8. 【转】 [UnityUI]UGUI射线检测

    http://blog.csdn.net/lyh916/article/details/50947026 1.Graphic Raycaster 主要用于UI上的射线检测,挂有这个组件的物体,必须要挂 ...

  9. Unity - Raycast 射线检测

    本文简要分析了Unity中射线检测的基本原理及用法,包括: Ray 射线 RaycastHit 光线投射碰撞信息 Raycast 光线投射 SphereCast 球体投射 OverlapSphere ...

随机推荐

  1. iNeuOS工业互联平台,增加OPC UA驱动,同步和订阅方式读取数据

    目       录 1.      概述... 1 2.      平台演示... 2 3.      OPC UA应用效果... 2 1.   概述 最近的项目,用户需要使用OPC UA读取数据,通 ...

  2. 集合框架3-Arrays 类

    Arrays 和 Collections是分别操作数组和集合的两个工具类.今天就来对 Arrays 中的内容作个总结. 一.Arrays 类概述 Arrays 类位于 java.util包中.Arra ...

  3. DPDK应用示例指南简介(汇总)

    DPDK应用示例指南简介 <DPDK示例>系列文章主要是学习.记录.翻译DPDK官方示例文档.为了更好地理解和学习DPDK, 特通过对源码中的经典示例进行整理,供大家学习.交流和讨论. A ...

  4. Element UI:级联选择器Cascader_动态加载_多级请求不同接口(已知第一级调取第二级)

    ELEMENT UI_CASCADER 使用过饿了么级联动态加载的小伙伴应该都知道,lazyLoad本身是一个无差别返回渲染结点的函数. 当我们存在一个需求:已知级联选择器的第一级结点,现在需要通过第 ...

  5. 计算机基础知识以及java JDK、JRE

    计算机 计算机(Computer)全称:电子计算机,是一种能够按照程序运行,自动.高速处理海量数据的现代化智能电子设备.由硬件和软件所组成,没有安装任何软件的计算机称为裸机.常见的形式有台式计算机.笔 ...

  6. gitlab安装CI问题汇总

    0.设置gitlab获取代码的存放位置 vim /etc/gitlab-runner/config.toml 1.unable to access http://gitlab-ci-token:xxx ...

  7. logstash-input-jdbc配置说明

    Logstash由三个组件构造成,分别是input.filter以及output.我们可以吧Logstash三个组件的工作流理解为:input收集数据,filter处理数据,output输出数据.至于 ...

  8. Hello Wolrd

    这是一篇测试文章.....后续会更新一些文章.

  9. mysql事务干货详解

    说明: mysql是现在行业中流行的关系型数据库,它的核心是存储引擎.mysql的存储引擎有很多种我们可以通过命令查看如下 SHOW ENGINES 不同版本得到的数据不一样,我们今天说的事务是在 M ...

  10. symfony2 数据库原生查询

    1. 数组,没有键名 但只查询出第一个结果 $conn = $this->getDoctrine()->getConnection(); $data = $conn->fetchAr ...