碼上歡樂
相關內容    簡體    繁體

【UE4 C++】 射線檢測 LineTrace 及 BoxTrace、SphereTrace、CapsuleTrace API

本文轉載自   查看原文   2021-05-07 21:57   5793    UE4 Prime/ UE4 主線日志

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 函數

    image

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
)

參考


免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。



猜您在找 UE4復習4_射線檢測 【UE4 C++】碰撞檢測與事件綁定 Ue4_C++射線檢測Trace Channel UE4射線的碰撞與繪制 UE4 C++ Tips UE4 C++ 筆記 [UE4]C++ string的用法和例子 【UE4 C++】UKismetSystemLibrary 源代碼 【UE4 C++】UKismetMathLibrary 源代碼 【UE4 C++】A*尋路算法
 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM