Structs：结构体类型参考

#include "Core/LCCStructure.h"

bool HasMaxDistanceLimit() const;      // 是否有距离限制
bool HasMaxNumLimit() const;           // 是否有数量限制
bool NeedPreload() const;              // 是否需要预加载
uint32 GetMaxDistance() const;         // 生效的最大距离
uint32 GetMaxSplatNum() const;         // 生效的最大数量
float GetLevelFactor() const;          // 生效的 LOD 因子
uint32 GetStartLevel() const;          // 生效的起始 Level
uint32 GetEndLevel() const;            // 生效的结束 Level
uint32 GetMaxCollisionDistance() const;
uint32 GetPreloadDistance() const;     // 返回 GetMaxDistance() + 35
bool GetIfUseFullLoad(uint32 SplatNum) const;   // 给定数量是否走全量加载
void Reset();                          // 只重置数值字段，不重置启用开关

// 推荐：用 Setter，开关自动处理
Component->SetMaxDistance(200);

// 直接改字段则必须自己开开关
Component->Performance.bDistanceLimit = true;
Component->Performance.MaxDistance = 200;

float GetSortFactor() const;
bool GetIfAddExtraPreNodes() const;
void Reset();

bool IsValid() const;              // 元信息是否有效
void Reset();
bool IsRTK() const;                // 是否含 RTK 地理信息
FVector GetOffset() const;         // 偏移转 FVector，元素数不足 3 时返回零向量并警告
FVector3f GetScale();              // 注意：非 const，且不检查元素数量
EFileType GetFileType() const;     // 文件类型枚举
float GetVersion() const;          // 版本号转 float
uint32 GetLevel0SplatNum() const;  // Level 0 的 Splat 数，单位万

if (Component->CheckIfLoaded())
{
    const FMetaInfoBase Meta = Component->GetMetaInfo();

    UE_LOG(LogTemp, Log, TEXT("Name: %s"), *Meta.Name);
    UE_LOG(LogTemp, Log, TEXT("Levels: %d, total splats: %d"),
        Meta.TotalLevel, Meta.TotalSplats);
    UE_LOG(LogTemp, Log, TEXT("Level 0 splats: %u (ten thousand)"),
        Meta.GetLevel0SplatNum());
    UE_LOG(LogTemp, Log, TEXT("Has SH: %s"),
        Meta.GetFileType() == EFileType::Quality ? TEXT("yes") : TEXT("no"));

    if (Meta.IsRTK())
    {
        UE_LOG(LogTemp, Log, TEXT("EPSG: %d, offset: %s"),
            Meta.Epsg, *Meta.GetOffset().ToString());
    }
}

FVector2f GetCellLength() const;
int32 GetXNum() const;                    // X 方向网格数
int32 GetYNum() const;                    // Y 方向网格数
FBox GetVisibleBoundingBox() const;       // 可见包围盒
FBox GetScaleBox() const;
FBox GetEnvironmentScaleBox() const;
FBox GetEnvironmentVisibleBox() const;
FBox GetShcoef() const;                   // 球谐取值范围
FBox GetEnvShcoef() const;
FBox GetNormal() const;
FBox GetEnvNormal() const;
FBox GetColor() const;
FVector2f GetOpacity() const;

FBox GetBounds() const;    // 根节点包围盒，已换算为厘米

FLCCSplat Hit;
if (LineTraceSingle(Start, End, Hit, false, 0.f, 0.f))
{
    // 命中位置
    const FVector HitPos = Hit.Location;
    // 该处当前加载的细节层级
    const int32 Level = Hit.NodeVector.Level;
}

FString ToString() const;     // 格式为 "X:%i,Y:%i,Level:%i"
void Reset();
static double Dist2D(const FLCCVector& A, const FLCCVector& B);

bool HasShN() const;    // 是否含高阶球谐，等价于 ShN.Files 非空

FLCC2SogMeta Meta;
if (ULCCUtilLibrary::ParseSogMetaFromFile(Path, Meta))
{
    UE_LOG(LogTemp, Log, TEXT("Version: %d, count: %d, high-order SH: %s"),
        Meta.Version, Meta.Count, Meta.HasShN() ? TEXT("yes") : TEXT("no"));
}

void ClearIterative();