[UE4] 快速繪製2D/3D Debug圖形 (C++)

UE4的藍圖內有各種方便的Debug繪製功能，在此整理在C++中使用的快速繪製Debug圖形方法。

2D繪製:使用UDebugDrawService

此處以某攝影機的Actor為例子。 在Class內追加FDelegateHandleCameraDebugDrawHandle。 之後將它登錄到UDebugDrawService。登錄後每個Frame會呼叫此登錄的函數。 在函數傳入值的Canvas上直接繪製需要的圖形。

(TestCamera.h)
class ATestCamera : public AActor
{
	GENERATED_BODY()

public:
	ASideScrollTestCamera();

	void DebugDraw(UCanvas* InCanvas, APlayerController* InPC);

protected:
	FDelegateHandle CameraDebugDrawHandle;
};

(TestCamera.cpp)
#include "TestCamera.h"
#include "Debug/DebugDrawService.h"

ASideScrollTestCamera::ATestCamera()
{
	FDebugDrawDelegate DrawDebugDelegate = FDebugDrawDelegate::CreateUObject(this, &TestCamera::HandleDebugDraw);

	CameraDebugDrawHandle = UDebugDrawService::Register(TEXT("GameplayDebug"), DrawDebugDelegate);
}

void ANxPlayerCameraManager::BeginDestroy()
{
	Super::BeginDestroy();
	// 物件刪除時解除登錄
	UDebugDrawService::Unregister(this->DrawDebugDelegateHandle);
}

void ASideScrollTestCamera::HandleDebugDraw(UCanvas* InCanvas, APlayerController* InPC)
{
	// 在此繪製Debug圖形
	FCanvasLineItem item(FVector2D(100.f, 100.0f), FVector2D(200.f, 200.0f));
	item.LineThickness = 10.f;
	item.SetColor(FLinearColor::Red);
	InCanvas->DrawItem(item);
}

3D繪製:使用DrawDebugHelpers

請參照引擎原始碼的DrawDebugHelpers.h的DrawDebugLine等，include後直接使用即可。

/** Draw a debug line */
ENGINE_API void DrawDebugLine(const UWorld* InWorld, FVector const& LineStart, FVector const& LineEnd, FColor const& Color, bool bPersistentLines = false, float LifeTime=-1.f, uint8 DepthPriority = 0, float Thickness = 0.f);
/** Draw a debug point */
ENGINE_API void DrawDebugPoint(const UWorld* InWorld, FVector const& Position, float Size, FColor const& PointColor, bool bPersistentLines = false, float LifeTime=-1.f, uint8 DepthPriority = 0);
/** Draw directional arrow **/
ENGINE_API void DrawDebugDirectionalArrow(const UWorld* InWorld, FVector const& LineStart, FVector const& LineEnd, float ArrowSize, FColor const& Color, bool bPersistentLines = false, float LifeTime=-1.f, uint8 DepthPriority = 0, float Thickness = 0.f);

其實這篇主要是想提2D繪製。之前還要特別製作Widget來繪製，之後才發現有這個方便的功能，讓繪製的流程快速多了。