XGRIDSDokumentation

ALCCLoadVolume: Load-Volumen

Leitet von AVolume ab, im Panel angezeigt als LCC Load Volume.

Der entscheidende Unterschied zu einem Clipping-Volumen oder einer Schnittebene ist die Phase, in der es greift: Clipping und Schneiden ändern nur das Endergebnis des Renderings, während die Daten wie üblich geladen und in den Grafikspeicher hochgeladen werden; ein Load-Volumen greift während der Node-Traversierung, und abgewiesene Nodes werden gar nicht gelesen. Es ist damit das einzige der drei, das Ladevolumen und Grafikspeicherbedarf senkt.

HeaderTools/LCCLoadVolume.h
BasisklasseAVolume
BlueprintBlueprintable / BlueprintType
LizenzFunktion der Pro Edition; ohne Lizenz ohne Wirkung

Ein Load-Volumen kann gleichzeitig auf mehrere LCC-Actors in der Szene wirken.

Properties

EigenschaftTypBeschreibung
bEnabledboolOb es aktiviert ist
ModeELoadRegionInside (nur laden, was innen liegt) oder Outside (ausschließen, was innen liegt)
VolumeTypeELoadVolumeTypeBox oder Sphere

Zur Bedeutung der Werte siehe ELoadRegion und ELoadVolumeType.

Keine der drei Eigenschaften hat einen Setter; sie werden direkt zugewiesen. Das Filtern greift beim Laden, nach einer Änderung müssen die Daten daher neu geladen werden.

Genauigkeit der Grenze

Der Test arbeitet pro Node und nicht pro Splat, die Grenze ist daher grober als bei einem Clipping-Volumen: Ein Randnode fällt vollständig weg, sobald er die Bedingung nicht erfüllt.

Die beiden Modi verwenden unterschiedliche Tests:

ModusBedingungVerhalten an der Grenze
InsideEin Node wird nur geladen, wenn er vollständig im Volumen liegtDer behaltene Bereich ist etwas kleiner als das Volumen
OutsideEin Node wird ausgeschlossen, sobald er das Volumen überlapptDer ausgeschlossene Bereich ist etwas größer als das Volumen

Beide Seiten sind bewusst konservativ, um das LOD-Umschalten stabil zu halten. In einem Octree liegen die Bounds eines Kind-Nodes immer innerhalb der des Elternteils, und die LOD wechselt vom Kind zum Elternteil, wenn sich die Kamera entfernt. Würde Inside einen Schnittmengentest verwenden, würde der Elternteil wegen der teilweisen Überlappung geladen und brächte Regionen zurück, die die Kinder bereits ausgeschlossen hatten — sichtbar als ein Block Inhalt, der beim Herauszoomen plötzlich auftaucht. Outside hätte mit einem Enthaltenseinstest das symmetrische Problem.

Wird eine exakte Grenze gebraucht, ein Clipping-Volumen mit derselben Transformation darüberlegen: Das Load-Volumen senkt das Ladevolumen, das Clipping-Volumen trimmt den Rand.

Erstellen zur Laufzeit

ALCCLoadVolume* Volume = GetWorld()->SpawnActor<ALCCLoadVolume>(
    ALCCLoadVolume::StaticClass(), Location, FRotator::ZeroRotator);

Volume->VolumeType = ELoadVolumeType::Box;
Volume->Mode = ELoadRegion::Inside;
Volume->bEnabled = true;
Volume->SetActorScale3D(FVector(20.0f, 20.0f, 10.0f));

Component->AddLoadVolume(Volume);
Component->Load(Path);   // muss vor dem Laden konfiguriert sein

Die Reihenfolge ist wichtig: Das Filtern geschieht während des Ladens, ein Hinzufügen oder Entfernen eines Load-Volumens oder eine Eigenschaftsänderung nach Load() verändert die bereits geladenen Daten nicht; ein erneutes Laden ist nötig.

// Nach Änderung des gefilterten Bereichs neu laden
Volume->SetActorLocation(NewLocation);
Component->Refresh();   // intern UnLoad, dann Load

Refresh() kostet so viel wie ein vollständiges erneutes Laden, siehe ALCCActorBase::Refresh.

Wahl zwischen diesem und einem Clipping-Volumen

BedarfWas verwenden
Nur einen kleinen Teil einer großen Szene nutzen und Grafikspeicher sowie Ladezeit sparenLoad-Volumen
Löcher schneiden oder eine Hülle öffnen, wo eine exakte Grenze zähltClipping-Volumen
Grafikspeicher sparen und exakte GrenzeBeide mit derselben Transformation übereinanderlegen
Den Effekt zur Laufzeit häufig umschaltenClipping-Volumen (bEnabled wirkt im nächsten Frame, ohne erneutes Laden)

See Also