ALCCSectionPlane: 3DGS-Schnittebene

Schnittebenen-Actor, der eine LCC-Szene mit einer Ebene schneidet und eine Seite davon behält.


Modul	`LCC4UnrealRuntime`
Header	`Tools/LCCSectionPlane.h`
Basisklasse	`AVolume`
Angezeigter Name im Panel	LCC Section Plane

#include "Tools/LCCSectionPlane.h"

Zu den Schritten der Verwendung, einer Vorführung und der Beschreibung des Eigenschaften-Panels siehe Szenenbearbeitung - Schnittebenen. Diese Seite nennt nur die Schnittstellen.

Der Editor zeigt eine Arrow-Component, die die Ausrichtung der Ebene angibt; die Seite, auf die der Pfeil zeigt, ist Upside.

Eigenschaften

Eigenschaft	Typ	Beschreibung
`bEnabled`	`bool`	Ob sie am Schneiden teilnimmt
`Mode`	`ESectionType`	`Upside` schneidet weg, was über der Ebene liegt, `Downside` schneidet weg, was darunter liegt

Oben und unten beziehen sich auf die Ausrichtung der Ebene selbst, nicht auf die Weltkoordinaten. Das Drehen der Schnittebene ergibt einen Schnitt in beliebiger Richtung. Zur Bedeutung der Werte siehe ESectionType.

Keine der beiden Eigenschaften hat einen Setter; sie werden direkt zugewiesen. Eine Änderung einer Eigenschaft oder des Transforms zur Laufzeit wird im nächsten Frame wirksam, ohne die Rendering-Seite von Hand benachrichtigen zu müssen.

Methoden

SetUpdateComponent / Refresh (veraltet)

UFUNCTION(BlueprintCallable, Category = "XGrids", meta = (DeprecatedFunction))
void SetUpdateComponent(ULCCComponentBase* Component);

UFUNCTION(BlueprintCallable, Category = "XGrids", meta = (DeprecatedFunction))
void Refresh();

Beide Methoden sind veraltet und als No-Ops implementiert; ein Aufruf hat keine Wirkung und erzeugt keinen Fehler.

Die Schnittdaten werden inzwischen jeden Frame gelesen, sodass Änderungen an Eigenschaften und Transform im nächsten Frame im Bild erscheinen. Der ältere Ablauf, zuerst mit SetUpdateComponent zu binden und nach jeder Änderung Refresh() aufzurufen, ist nicht mehr nötig.

Bestehende Aufrufe können einfach entfernt werden. In Blueprint zeigen diese beiden Nodes eine Veraltet-Warnung; der Ersatz besteht darin, den Node zu löschen.

Erzeugen zur Laufzeit

#include "Tools/LCCSectionPlane.h"
#include "LCCComponentBase.h"

ALCCSectionPlane* AMyTool::CreateSectionPlane(
    ULCCComponentBase* Component, const FVector& Location, const FRotator& Rotation)
{
    ALCCSectionPlane* Plane = GetWorld()->SpawnActor<ALCCSectionPlane>(
        ALCCSectionPlane::StaticClass(), Location, Rotation);
    if (!Plane)
    {
        return nullptr;
    }

    Plane->Mode = ESectionType::Upside;   // wegschneiden, was über der Ebene liegt
    Plane->bEnabled = true;

    Component->AddSectionPlane(Plane);

    return Plane;
}

Einige gängige Konfigurationen:

Wirkung	Position und Rotation	Mode
Aufsicht in das Innere eines Gebäudes	Eine bestimmte Höhe, `FRotator::ZeroRotator`	`Upside`
Senkrechter Schnitt zum Betrachten einer Fassade	`FRotator(0, 0, 90)`, damit die Ebene senkrecht steht	`Upside`
Nur die mittlere Schicht behalten	Eine Ebene darüber und eine darunter	`Downside` für die untere Grenze, `Upside` für die obere Grenze

Das Bewegen der Schnittebene ergibt eine Animation, die Schicht für Schicht freilegt; dazu einfach jeden Frame die Position ändern:

FVector Loc = SectionPlane->GetActorLocation();
Loc.Z = FMath::FInterpTo(Loc.Z, TargetHeight, DeltaTime, 1.0f);
SectionPlane->SetActorLocation(Loc);

Änderungen von Eigenschaften sind genauso unmittelbar:

SectionPlane->bEnabled = false;

Zu den Blueprint-Nodes siehe Szenenbearbeitung - Blueprint-Methoden.

Hinweise

Das Schneiden wirkt nur auf das Rendering, nicht auf die Kollision. Ein weggeschnittener Teil kann weiterhin von einem Strahl getroffen werden und blockiert weiterhin einen Charakter.
Upside und Downside beziehen sich auf die Ausrichtung der Ebene selbst. Nach einer Rotation erneut bestätigen, welche Seite „oben“ ist; der Pfeil im Editor ist dafür der unmittelbarste Weg.
Die Z-Skalierung wird beim Konstruieren auf 0.01 gesetzt (eine dünne Scheibe), und eine Änderung der Skalierung im Editor wird auf diesen Wert zurückgesetzt. Eine Änderung der Skalierung zur Laufzeit unterliegt dieser Einschränkung nicht, ist aber normalerweise nicht nötig.
Die Anzahl der gleichzeitig wirksamen Schnittebenen ist begrenzt, ohne Lizenz auf 50; die überzähligen nehmen nicht am Rendering teil und es wird eine Warnung protokolliert. Schnittebenen und Clipping-Volumen teilen sich dieses Kontingent. Zur Lizenzierung siehe Editionen und Lizenzierung.
Das Zerstören einer Schnittebene löst nur eine Aktualisierung des Renderings aus und entfernt das Element nicht aus dem Array SectionPlanes der Component, sodass ein veralteter Zeiger im Array bleibt (beim Rendering automatisch übersprungen). Um das Array sauber zu halten, vor dem Zerstören RemoveSectionPlane aufrufen.

Siehe auch

Szenenbearbeitung: vollständige Beschreibung der Verwendung
ALCCClippingVolume: Beschneiden mit einem begrenzten Volumen
ULCCComponentBase: AddSectionPlane und RemoveSectionPlane