XGRIDSDocumentation

ALCC2ProxyMesh : Actor de maillage proxy

Actor de maillage proxy, qui fournit au mode de normales ProxyMesh de LCC2 une profondeur et des normales de scène réelles.

ModuleLCC4UnrealRuntime
En-têteLCC2ProxyMesh.h
Classe parenteAActor
LicenceLe mode de normales ProxyMesh nécessite une licence, voir Éditions et licences
#include "LCC2ProxyMesh.h"

Le principe du maillage proxy, les exigences de fabrication du whitebox, les étapes de placement, les bonnes pratiques et le dépannage figurent dans Maillage proxy. Cette page ne liste que les interfaces.

Propriétés

PropriétéTypeAccèsDescription
StaticMeshComponentUStaticMeshComponent*Lecture seuleComponent de maillage statique racine, qui fournit la profondeur de scène et le GBuffer. Placer le whitebox dans son emplacement StaticMesh

Le Component lui-même est BlueprintReadOnly et ne peut pas être remplacé, mais son StaticMesh peut être défini.

CustomDepth est géré automatiquement par l'Actor : il est activé dès qu'un maillage valide est assigné, et reste inactif si le maillage est vide, avec un avertissement émis une fois (au plus une fois par instance). Voir Comportement pour le détail.

Utilisation

#include "LCC2ProxyMesh.h"
#include "LCC2Component.h"
#include "Components/StaticMeshComponent.h"

void AMyLightingSetup::SetupProxyMesh(ALCC2Actor* LCC2Actor, UStaticMesh* ProxyAsset)
{
    // Place it at the same location as the 3DGS; pairing relies on spatial overlap, no explicit reference needed
    ALCC2ProxyMesh* Proxy = GetWorld()->SpawnActor<ALCC2ProxyMesh>(
        ALCC2ProxyMesh::StaticClass(),
        LCC2Actor->GetActorLocation(),
        LCC2Actor->GetActorRotation());
    if (!Proxy)
    {
        return;
    }

    // Assign the mesh, CustomDepth turns on automatically
    Proxy->StaticMeshComponent->SetStaticMesh(ProxyAsset);

    // Switch to the ProxyMesh normal mode
    ULCC2Component* Comp = Cast<ULCC2Component>(LCC2Actor->GetLCCComponent());
    if (Comp)
    {
        Comp->SetLightMode(ELightMode::Lit);
        Comp->NormalMode = ELCC2NormalGenerationMode::ProxyMesh;

        // Without a license it silently falls back to Fixed, so confirm it
        if (Comp->GetEffectiveNormalGenerationMode() != ELCC2NormalGenerationMode::ProxyMesh)
        {
            UE_LOG(LogTemp, Warning, TEXT("ProxyMesh requires a license"));
        }
    }
}

L'utilisation en Blueprint est décrite dans Maillage proxy - Utilisation en Blueprint.

Voir aussi