最簡單的 UE 4 C++ 教程 —— 掃描多線軌跡【十六】

​

原教程是基於 UE 4.18，我是基於 UE 4.25】

英文原地址

接上一節教程，本教程將說明如何使用 SweepMultiByChannel 返回給定半徑內的結果。

建立一個新的 C++ Actor 子類並將其命名爲 MySweepActor 。咱們不會對默認頭文件作任何修改。

下面是最終的頭文件。

MySweepActor.h

#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "MySweepActor.generated.h"

UCLASS()
class UNREALCPP_API AMySweepActor : public AActor
{
	GENERATED_BODY()
	
public:	
	// Sets default values for this actor's properties
	AMySweepActor();

protected:
	// Called when the game starts or when spawned
	virtual void BeginPlay() override;

public:	
	// Called every frame
	virtual void Tick(float DeltaTime) override;
	
};
複製代碼

在咱們編寫代碼的邏輯以前，咱們必須首先 #include DrawDebugHelpers.h 文件來幫助咱們可視化 actor 。

#include "MySweepActor.h"
// include debug helpers
#include "DrawDebugHelpers.h"
複製代碼

在這個例子中，咱們將在 BeginPlay() 函數中執行全部的邏輯。

首先，咱們將建立一個FHitResults 的 TArray，並將其命名爲 OutHits。

咱們但願掃描球體在相同的位置開始和結束，並經過使用 GetActorLocation 使它與 actor 的位置相等。碰撞球體能夠是不一樣的形狀，在這個例子中，咱們將使用 FCollisionShape:: makephere 使它成爲一個球體，咱們將它的半徑設置爲 500個虛幻單位。接下來，運行 DrawDebugSphere 來可視化掃描球體。

而後，咱們想要設置一個名爲 isHit 的 bool 變量來檢查咱們的掃描是否擊中了任何東西。

咱們運行 GetWorld()->SweepMultiByChannel 來執行掃描通道跟蹤並返回命中狀況到 OutHits 數組中。

你能夠在這裏瞭解更多關於 SweepMultiByChannel 功能。若是 isHit 爲真，咱們將循環遍歷 TArray 並打印出 hit actor 的名字和其餘相關信息。

你能夠在這裏瞭解更多關於 TArray 的信息。

下面是最後的.cpp文件。

MySweepActor.cpp

#include "MySweepActor.h"
#include "DrawDebugHelpers.h"


// Sets default values
AMySweepActor::AMySweepActor()
{
 	// Set this actor to call Tick() every frame. You can turn this off to improve performance if you don't need it.
	PrimaryActorTick.bCanEverTick = true;

}

// Called when the game starts or when spawned
void AMySweepActor::BeginPlay() {
	Super::BeginPlay();

	// create tarray for hit results
	TArray<FHitResult> OutHits;
	
	// start and end locations
	FVector SweepStart = GetActorLocation();
	FVector SweepEnd = GetActorLocation();

	// create a collision sphere
	FCollisionShape MyColSphere = FCollisionShape::MakeSphere(500.0f);

	// draw collision sphere
	DrawDebugSphere(GetWorld(), GetActorLocation(), MyColSphere.GetSphereRadius(), 50, FColor::Purple, true);
	
	// check if something got hit in the sweep
	bool isHit = GetWorld()->SweepMultiByChannel(OutHits, SweepStart, SweepEnd, FQuat::Identity, ECC_WorldStatic, MyColSphere);

	if (isHit)
	{
		// loop through TArray
		for (auto& Hit : OutHits)
		{
			if (GEngine) 
			{
				// screen log information on what was hit
				GEngine->AddOnScreenDebugMessage(-1, 5.f, FColor::Green, FString::Printf(TEXT("Hit Result: %s"), *Hit.Actor->GetName()));
				// uncommnet to see more info on sweeped actor
				// GEngine->AddOnScreenDebugMessage(-1, 5.f, FColor::Red, FString::Printf(TEXT("All Hit Information: %s"), *Hit.ToString()));
			}						
		}
	}
	
}

// Called every frame
void AMySweepActor::Tick(float DeltaTime) {
	Super::Tick(DeltaTime);

}
複製代碼

最終運行的效果以下所示

​

​