ALCCSectionPlane: plano de sección del 3DGS

Actor de plano de sección que corta una escena LCC con un plano y conserva uno de sus lados.

#include "Tools/LCCSectionPlane.h"

Para los pasos de uso, una demostración y la descripción del panel de propiedades, consultar Edición de escenas - Planos de sección. Esta página solo enumera las interfaces.

El editor muestra un componente de flecha que indica la orientación del plano, y el lado hacia el que apunta la flecha es Upside.

Propiedades

Arriba y abajo son relativos a la orientación del propio plano, no a las coordenadas del mundo. Rotar el plano de sección permite obtener una sección en cualquier dirección. Para el significado de los valores, consultar ESectionType.

Ninguna de las dos propiedades tiene Setter; se asignan directamente. Un cambio de propiedad o de transform en tiempo de ejecución surte efecto en el fotograma siguiente, sin necesidad de notificar manualmente al lado del renderizado.

Métodos

SetUpdateComponent / Refresh (obsoletos)

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

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

Ambos métodos están obsoletos e implementados como operaciones vacías; llamarlos no tiene efecto ni genera error.

Los datos de sección se leen ahora en cada fotograma, así que los cambios de propiedades y de transform se reflejan en la imagen en el fotograma siguiente. El flujo anterior de vincular primero con SetUpdateComponent y llamar a Refresh() después de cada cambio ya no es necesario.

Las llamadas existentes se pueden eliminar sin más. En Blueprint estos dos nodos muestran un aviso de obsolescencia, y la sustitución consiste en eliminar el nodo.

Creación en tiempo de ejecución

#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;   // recortar lo que queda por encima del plano
    Plane->bEnabled = true;

    Component->AddSectionPlane(Plane);

    return Plane;
}

Algunas configuraciones habituales:

Mover el plano de sección produce una animación de descubrimiento capa por capa; basta con cambiar la posición en cada fotograma:

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

Los cambios de propiedades son igual de directos:

SectionPlane->bEnabled = false;

Para los nodos de Blueprint, consultar Edición de escenas - Métodos de Blueprint.

Notas

• El seccionado solo afecta al renderizado, no a la colisión. Una parte seccionada puede seguir siendo impactada por un rayo y sigue bloqueando a un personaje.
• Upside y Downside son relativos a la orientación del propio plano. Después de una rotación, confirmar de nuevo qué lado es "arriba"; mirar la flecha en el editor es la forma más directa.
• La escala Z se establece en 0.01 durante la construcción (una lámina fina), y cambiar la escala en el editor se fuerza de vuelta a ese valor. Un cambio de escala en tiempo de ejecución no está sujeto a esta restricción, pero normalmente no necesita cambiarse.
• El número de planos de sección activos a la vez está limitado, a 50 sin licencia; los excedentes no participan en el renderizado y se registra una advertencia. Los planos de sección y los volúmenes de recorte comparten esta cuota. Para las licencias, consultar Ediciones y licencias.
• Destruir un plano de sección solo provoca una actualización del renderizado y no elimina el elemento del array SectionPlanes del Component, lo que deja un puntero obsoleto en el array (se omite automáticamente durante el renderizado). Para mantener el array limpio, llamar a RemoveSectionPlane antes de destruirlo.

Véase también

• Edición de escenas: descripción completa de uso
• ALCCClippingVolume: recorte con un volumen delimitado
• ULCCComponentBase: AddSectionPlane y RemoveSectionPlane