Unreal學習筆記2-繪製簡單三角形

charlee44發表於2023-02-01

1. 概述

之所以寫這個繪製簡單三角形的例項其實是想知道如何在Unreal中透過程式碼繪製自定義Mesh，如果你會繪製一個三角形，那麼自然就會繪製複雜的Mesh了。所以這是很多圖形工作者的第一課。

2. 詳論

2.1. 程式碼實現

Actor是Unreal的基本顯示物件，有點類似於Unity中的GameObject或者OSG中的Node。因此，我們首先要實現一個繼承自AActor的類

標頭檔案CustomMeshActor.h：

#pragma once

// clang-format off
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "CustomMeshActor.generated.h"
// clang-format on

UCLASS()
class UESTUDY_API ACustomMeshActor : public AActor {
  GENERATED_BODY()

 public:
  // Sets default values for this actor's properties
  ACustomMeshActor();

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

  UStaticMesh* CreateMesh();
  void CreateGeometry(FStaticMeshRenderData* RenderData);
  void CreateMaterial(UStaticMesh* mesh);

 public:
  // Called every frame
  virtual void Tick(float DeltaTime) override;

  UPROPERTY(VisibleAnywhere, BlueprintReadOnly)
  UStaticMeshComponent* staticMeshComponent;
};

實現CustomMeshActor.cpp：

#include "CustomMeshActor.h"

#include "Output.h"

// Sets default values
ACustomMeshActor::ACustomMeshActor() {
  // 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 ACustomMeshActor::BeginPlay() {
  Super::BeginPlay();

  staticMeshComponent = NewObject<UStaticMeshComponent>(this);

  staticMeshComponent->SetMobility(EComponentMobility::Stationary);
  SetRootComponent(staticMeshComponent);
  staticMeshComponent->RegisterComponent();

  UStaticMesh* mesh = CreateMesh();
  if (mesh) {
    staticMeshComponent->SetStaticMesh(mesh);
  }
}

UStaticMesh* ACustomMeshActor::CreateMesh() {
  UStaticMesh* mesh = NewObject<UStaticMesh>(staticMeshComponent);
  mesh->NeverStream = true;
  mesh->SetIsBuiltAtRuntime(true);

  TUniquePtr<FStaticMeshRenderData> RenderData =
      MakeUnique<FStaticMeshRenderData>();

  CreateGeometry(RenderData.Get());

  CreateMaterial(mesh);

  mesh->SetRenderData(MoveTemp(RenderData));
  mesh->InitResources();
  mesh->CalculateExtendedBounds();  //設定包圍盒之後呼叫這個函式起效，否則會被視錐體剔除
  return mesh;
}

void ACustomMeshActor::CreateMaterial(UStaticMesh* mesh) {
  UMaterial* material1 = (UMaterial*)StaticLoadObject(
      UMaterial::StaticClass(), nullptr,
      TEXT("Material'/Game/Materials/RedColor.RedColor'"));

  mesh->AddMaterial(material1);

  UMaterial* material2 = (UMaterial*)StaticLoadObject(
      UMaterial::StaticClass(), nullptr,
      TEXT("Material'/Game/Materials/GreenColor.GreenColor'"));

  mesh->AddMaterial(material2);
}

void ACustomMeshActor::CreateGeometry(FStaticMeshRenderData* RenderData) {
  RenderData->AllocateLODResources(1);
  FStaticMeshLODResources& LODResources = RenderData->LODResources[0];

  int vertexNum = 4;

  TArray<FVector> xyzList;
  xyzList.Add(FVector(0, 0, 50));
  xyzList.Add(FVector(100, 0, 50));
  xyzList.Add(FVector(100, 100, 50));
  xyzList.Add(FVector(0, 100, 50));

  TArray<FVector2D> uvList;
  uvList.Add(FVector2D(0, 1));
  uvList.Add(FVector2D(0, 0));
  uvList.Add(FVector2D(1, 0));
  uvList.Add(FVector2D(1, 1));

  // 設定頂點資料
  TArray<FStaticMeshBuildVertex> StaticMeshBuildVertices;
  StaticMeshBuildVertices.SetNum(vertexNum);
  for (int m = 0; m < vertexNum; m++) {
    StaticMeshBuildVertices[m].Position = xyzList[m];
    StaticMeshBuildVertices[m].Color = FColor(255, 0, 0);
    StaticMeshBuildVertices[m].UVs[0] = uvList[m];
    StaticMeshBuildVertices[m].TangentX = FVector(0, 1, 0);  //切線
    StaticMeshBuildVertices[m].TangentY = FVector(1, 0, 0);  //副切線
    StaticMeshBuildVertices[m].TangentZ = FVector(0, 0, 1);  //法向量
  }

  LODResources.bHasColorVertexData = false;

  //頂點buffer
  LODResources.VertexBuffers.PositionVertexBuffer.Init(StaticMeshBuildVertices);

  //法線，切線，貼圖座標buffer
  LODResources.VertexBuffers.StaticMeshVertexBuffer.Init(
      StaticMeshBuildVertices, 1);

  //設定索引陣列
  TArray<uint32> indices;
  int numTriangles = 2;
  int indiceNum = numTriangles * 3;
  indices.SetNum(indiceNum);
  indices[0] = 2;
  indices[1] = 1;
  indices[2] = 0;
  indices[3] = 3;
  indices[4] = 2;
  indices[5] = 0;

  LODResources.IndexBuffer.SetIndices(indices,
                                      EIndexBufferStride::Type::AutoDetect);

  LODResources.bHasDepthOnlyIndices = false;
  LODResources.bHasReversedIndices = false;
  LODResources.bHasReversedDepthOnlyIndices = false;
  // LODResources.bHasAdjacencyInfo = false;

  FStaticMeshLODResources::FStaticMeshSectionArray& Sections =
      LODResources.Sections;
  {
    FStaticMeshSection& section = Sections.AddDefaulted_GetRef();

    section.bEnableCollision = false;
    section.MaterialIndex = 0;
    section.NumTriangles = 1;
    section.FirstIndex = 0;
    section.MinVertexIndex = 0;
    section.MaxVertexIndex = 2;
  }
  {
    FStaticMeshSection& section = Sections.AddDefaulted_GetRef();

    section.bEnableCollision = false;
    section.MaterialIndex = 0;
    section.NumTriangles = 1;
    section.FirstIndex = 3;
    section.MinVertexIndex = 3;
    section.MaxVertexIndex = 5;
  }

  double boundArray[7] = {0, 0, 0, 200, 200, 200, 200};

  //設定包圍盒
  FBoxSphereBounds BoundingBoxAndSphere;
  BoundingBoxAndSphere.Origin =
      FVector(boundArray[0], boundArray[1], boundArray[2]);
  BoundingBoxAndSphere.BoxExtent =
      FVector(boundArray[3], boundArray[4], boundArray[5]);
  BoundingBoxAndSphere.SphereRadius = boundArray[6];
  RenderData->Bounds = BoundingBoxAndSphere;
}

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

然後將這個類物件ACustomMeshActor拖放到場景中，顯示結果如下：

imglink1

2.2. 解析：Component

Actor只是一個空殼，具體的功能是透過各種型別的Component實現的（這一點與Unity不謀而合），這裡使用的是UStaticMeshComponent，這也是Unreal場景中用的最多的Mesh元件。

這裡元件初始化是在BeginPlay()中建立的，如果在建構函式中建立，那麼就不能使用NewObject，而應該使用如下方法：

// Sets default values
ACustomMeshActor::ACustomMeshActor() {
    // 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;

    staticMeshComponent =
        CreateDefaultSubobject<UStaticMeshComponent>(TEXT("SceneRoot"));
    staticMeshComponent->SetMobility(EComponentMobility::Static);
    SetRootComponent(staticMeshComponent);

    UStaticMesh* mesh = CreateMesh();
    if (mesh) {
        staticMeshComponent->SetStaticMesh(mesh);
    }
}

承接2，在BeginPlay()中建立和在建構函式中建立的區別就在於前者是執行時建立，而後者在程式執行之前就建立了，可以在未執行的編輯器狀態下看到靜態網格體和材質。
承接2，在建構函式中建立的UStaticMeshComponent移動性被設定成Static了，這時執行會提示“光照需要重建”，也就是靜態物件需要烘焙光照，在工具欄"構建"->"僅構建光照"烘培一下即可。這種方式執行時渲染效率最高。
對比4，執行時建立的UStaticMeshComponent移動性可以設定成Stationary，表示這個靜態物體不移動，啟用快取光照法，並且快取動態陰影。

2.3. 解析：材質

在UE編輯器分別建立了紅色和綠色簡單材質，注意材質是單面還是雙面的，C++程式碼設定的要和材質藍圖中設定的要保持一致。最開始我參考的就是參考文獻1中的程式碼，程式碼中設定成雙面，但是我自己的材質藍圖中用的單面，程式啟動直接崩潰了。
如果場景中材質顯示不正確，比如每次瀏覽場景時的效果都不一樣，說明可能法向量沒有設定，我最開始就沒有注意這個問題以為是光照的問題。
單面材質的話，正面是逆時針序還是順時針序？從這個案例來看應該是逆時針。UE是個左手座標系，X軸向前，法向量是(0, 0, 1)，從法向量的一邊看過去，頂點順序是(100, 100, 50)->(100, 0, 50)->(0, 0, 50)，明顯是逆時針。

2.4. 解析：包圍盒

包圍盒引數最好要設定，UE似乎預設實現了視景體裁剪，不在範圍內的物體會不顯示。如果在某些視角場景物件突然不顯示了，可能包圍盒引數沒有設定正確，導致視景體裁剪錯誤地篩選掉了當前場景物件。
```
FBoxSphereBounds BoundingBoxAndSphere;
//...
RenderData->Bounds = BoundingBoxAndSphere;
//...
mesh->CalculateExtendedBounds();  //設定包圍盒之後呼叫這個函式起效，否則會被視錐體剔除
```
即使是一個平面，包圍盒的三個Size引數之一也不能為0，否則還是可能會在某些視角場景物件不顯示。

2.5. 解析：Section

Mesh內部是可以進行劃分的，劃分成多少個section就使用多少個材質，比如這裡劃分了兩個section，最後就使用了兩個材質。如下程式碼所示：

FStaticMeshLODResources::FStaticMeshSectionArray& Sections =
    LODResources.Sections;
{
  FStaticMeshSection& section = Sections.AddDefaulted_GetRef();

  section.bEnableCollision = false;
  section.MaterialIndex = 0;
  section.NumTriangles = 1;
  section.FirstIndex = 0;
  section.MinVertexIndex = 0;
  section.MaxVertexIndex = 2;
}
{
  FStaticMeshSection& section = Sections.AddDefaulted_GetRef();

  section.bEnableCollision = false;
  section.MaterialIndex = 0;
  section.NumTriangles = 1;
  section.FirstIndex = 3;
  section.MinVertexIndex = 3;
  section.MaxVertexIndex = 5;
}

3. 其他

除了本文介紹的方法之外，也有其他的實現辦法，具體可以參考文獻3-5。實在是沒有時間進行進一步的研究了，因此記錄備份一下。另外，文獻6-7可能對了解UE關於Mesh的內部實現有所幫助，筆者反正是看麻了。不得不說，這麼一個微小的功能涉及到的內容還真不少，看來有的研究了。

4. 參考

程式碼地址

Unity3D學習筆記1——繪製一個三角形
2021-06-26
Unity3D筆記
學習OpenGL ES之繪製三角形
2019-03-04
Git 簡單使用學習筆記
2018-08-28
Git筆記
canvas學習筆記-繪製矩形及路徑(一)
2019-02-16
Canvas筆記
Ext學習筆記2-物件導向
2012-07-07
筆記物件
Flutter筆記——幀繪製系列之一(原始碼學習)
2020-01-23
Flutter筆記原始碼
2018.03.15、View 繪製流程學習筆記
2018-03-15
View筆記
化學繪圖軟體ChemDraw，繪製簡單的化學元素
2023-02-22
繪圖
機器學習程式碼筆記-2-簡單線性迴歸
2022-06-23
機器學習筆記
《Fluid Engine Development》學習筆記2-基礎
2019-06-18
UIdev筆記
【Go】Go語言學習筆記-2-函式
2019-02-16
Go筆記函式
SpringMVC學習筆記之---簡單入門
2019-08-06
SpringMVC筆記
SG學習筆記之RMAN簡單歸納
2009-02-12
筆記
Python 開發簡單爬蟲 (學習筆記)
2019-08-05
Python爬蟲筆記
學習筆記-React的簡單介紹&工作原理
2021-10-23
筆記React
ElasticSearch學習筆記(二)——對聚合的簡單理解
2018-06-17
Elasticsearch筆記
TDD學習筆記【二】---單元測試簡介
2014-08-30
筆記
canvas繪製三角形
2017-02-17
Canvas
CSS繪製三角形
2024-08-23
CSS
Python學習筆記：過濾N位數並繪製折線圖
2020-10-15
Python筆記
Git極簡學習筆記
2021-09-09
Git筆記
gcc簡介（學習筆記）
2020-10-04
GC筆記
Zookeeper學習筆記(一)基本概念和簡單使用
2022-06-26
筆記
Dubbo學習筆記(一)基本概念與簡單使用
2022-07-03
筆記
Activiti學習筆記二：簡單順序流演示demo
2016-09-03
筆記
TestNG簡單介紹以及安裝—學習筆記1
2015-05-17
筆記
hadoop學習筆記(11)——hbase shell簡單操作示例
2016-01-25
Hadoop筆記
資料結構學習筆記-簡單選擇排序
2024-06-04
資料結構筆記排序
GoldenGate學習筆記(5)_配置例程之單向複製
2010-01-07
Go筆記
純css繪製三角形
2021-09-09
CSS
Unity3D學習筆記2——繪製一個帶紋理的面
2021-07-06
Unity3D筆記
安卓學習筆記31：使用自定義檢視繪製文字、圖形與影像
2020-12-15
安卓筆記
MoveIt! 學習筆記2- MoveIt! Commander Scripting(命令列控制)
2020-12-28
筆記命令列
繪製流程圖的簡單軟體
2019-10-28
流程圖
SVG繪製直線簡單介紹
2018-08-04
SVG
Redis學習筆記（十三）複製（下）
2020-05-22
Redis筆記
OCI學習筆記--簡介（一）
2012-12-24
筆記
MuJoCo 學習筆記：簡介 Overview
2024-08-30
筆記View