Luces que se desvanecen

Este documento describe cómo configurar un actor de luz que cambia de color y se desvanece lentamente al contacto.

Para ello, se utilizará un componente de luz puntual que contenga un componente de caja para que actúe como activador de solapamiento y un componente de escala de tiempo para manipular al actor de luz puntual.

Cómo crear el actor de luz que se desvanece

1. Crea el nuevo proyecto de C++ basado en la plantilla en blanco, y nómbralo FadingLights.

   

2. Dirígete al explorador de contenido, haz clic en la carpeta C++ Classes y, a continuación, haz clic en el botón Añadir (+) y selecciona Nueva clase C++.

   

3. Selecciona Actor como clase padre.

   

4. Nombra al actor creado como LightActor.

   

5. Cuando se crea un nuevo actor, Visual Studio abre automáticamente los archivos LightActor.h y LightActor.cpp. Dirígete al archivo LightActor.h e introduce las siguientes declaraciones:

   LightActor.h

   C++

   #include "Components/TimelineComponent.h"

   Copy full snippet(1 line long)

6. A continuación, en la definición de la clase LightActor, añade el siguiente código:

   LightActor.h

   C++

   public:
   
                UPROPERTY(EditAnywhere)
                UCurveFloat* PointLightFloatCurve;
   
                UPROPERTY(EditAnywhere)
                UCurveLinearColor* PointLightColorCurve;
   
        protected:
   
   
   Expand code Copy full snippet(37 lines long)

7. Ve a LightActor.cpp y añade las siguientes bibliotecas de clases.

   LightActor.cpp

   C++

   #include "Components/BoxComponent.h"
        #include "Components/PointLightComponent.h"

   Copy full snippet(2 lines long)

8. En el constructor de ALightActor::ALightActor, introduce las siguientes declaraciones:

   LightActor.cpp

   C++

   ALightActor::ALightActor()
        {
            // Set this actor to call Tick() every frame.  You can turn this off to improve performance if you don't need it.
            PrimaryActorTick.bCanEverTick = true;
   
            //Create our Default Components
            PointLightComp = CreateDefaultSubobject<UPointLightComponent>(TEXT("PointLightComp"));
            LightTimelineComp = CreateDefaultSubobject<UTimelineComponent>(TEXT("LightTimelineComp"));
            LightOverlapVolume = CreateDefaultSubobject<UBoxComponent>(TEXT("LightOverlapVolume"));
   
   
   Expand code Copy full snippet(17 lines long)

9. A continuación, implementa los métodos UFunction del componente de luz puntual:

   LightActor.cpp

   C++

   void ALightActor::UpdateLightBrightness(float BrightnessOutput)
        {
            PointLightComp->SetLightBrightness(BrightnessOutput * 20.0f);
        }
   
        void ALightActor::UpdateLightColor(FLinearColor ColorOutput)
        {
            PointLightComp->SetLightColor(ColorOutput);
        }

   Copy full snippet(9 lines long)

10. A continuación, en el método BeginPlay, añade el siguiente código:

    LightActor.cpp

    C++

    void ALightActor::BeginPlay()
         {
             Super::BeginPlay();
    
             //Binding our float and color track to their respective functions
             UpdateBrightnessTrack.BindDynamic(this, &ALightActor::UpdateLightBrightness);
             UpdateColorTrack.BindDynamic(this, &ALightActor::UpdateLightColor);
    
             //If we have a float curve, bind it's graph to our update function
             if (PointLightFloatCurve)
    
    Expand code Copy full snippet(20 lines long)

11. Compila el código.

12. En el explorador de contenido, dirígete a la carpeta Clases de C++.

13. Haz clic derecho en el LightActor, selecciona Crear clase de Blueprint basada en LightActor y nombra al actor de Blueprint BP_LightActor.

    

Los valores predeterminados de clase de BP_LightActor tendrán el siguiente aspecto:

Código en progreso

LightActor.h

//Copyright 1998-2022 Epic Games, Inc. All Rights Reserved.

	#pragma once
	#include "Components/TimelineComponent.h"
	#include "CoreMinimal.h"
	#include "GameFramework/Actor.h"
	#include "LightActor.generated.h"

	UCLASS()
	class FADINGLIGHTS_API ALightActor : public AActor

LightActor.cpp

//Copyright 1998-2022 Epic Games, Inc. All Rights Reserved.

	#include "LightActor.h"
	#include "Components/BoxComponent.h"
	#include "Components/PointLightComponent.h"

	// Sets default values
	ALightActor::ALightActor()
	{
		// Set this actor to call Tick() every frame.  You can turn this off to improve performance if you don't need it.

Cómo crear y vincular el evento solapado de colisión

El componente de caja requiere la capacidad de activar el TimelineComponent cuando un actor entra en sus límites de colisión.

1. Dirígete a la definición de clase de LightActor.h e introduce las siguientes declaraciones en BrightnessMultiplier:

   LightActor.h

   C++

   protected:
   
            UFUNCTION()
            void OnOverlapBegin(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor, class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult);

   Copy full snippet(4 lines long)

2. A continuación, dirígete al archivo LightActor.cpp e implementa la función OnOverlapBegin.

   LightActor.cpp

   C++

   void ALightActor::OnOverlapBegin(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor, class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult)
        {
            LightTimelineComp->Play();
        }

   Copy full snippet(4 lines long)

3. Vincula la función de solapar en el método BeginPlay:

   LightActor.cpp

   C++

   //Binding our Box Component to our Light Actor's Overlap Function
        LightOverlapVolume->OnComponentBeginOverlap.AddDynamic(this, &ALightActor::OnOverlapBegin);

   Copy full snippet(2 lines long)

4. Compila el código.

Código finalizado

LightActor.h

//Copyright 1998-2022 Epic Games, Inc. All Rights Reserved.

	#pragma once
	#include "Components/TimelineComponent.h"
	#include "CoreMinimal.h"
	#include "GameFramework/Actor.h"
	#include "LightActor.generated.h"

	UCLASS()
	class FADINGLIGHTS_API ALightActor : public AActor

LightActor.cpp

//Copyright 1998-2022 Epic Games, Inc. All Rights Reserved.

	// Fill out your copyright notice in the Description page of Project Settings.

	#include "LightActor.h"
	#include "Components/BoxComponent.h"
	#include "Components/PointLightComponent.h"

	// Sets default values
	ALightActor::ALightActor()

Cómo configurar la pista de brillo

Cuando el jugador se solapa con los límites del componente de caja del actor de luz, el componente de escala de tiempo requerirá una curva flotante para manipular el valor de brillo del componente de luz puntual.

La luminosidad tendrá un valor inicial de 5000 y disminuirá hasta 0 en un lapso de 5 segundos.

1. Navega hasta el explorador de contenido, selecciona Añadir (+) > Varios > Curva.

   

2. Selecciona CurveFloat y nombra al recurso BrightnessCurveFloat.

   

3. Haz doble clic en BrightnessCurveFloat para abrir el editor de la escala de tiempo.

4. Añade dos claves a la curva float. Para ello, haz clic derecho sobre el grafo y selecciona Añadir clave. Ajusta el valor de tiempo de la primera clave a (0, 5000). Ajusta el valor de tiempo de la segunda clave a (5, 0). Tu BrightnessCurveFloat debe tener el siguiente aspecto:

   

5. Guarda BrightnessCurveFloat, vuelve al explorador de contenido y haz doble clic en BP_LightActor para abrir sus valores predeterminados de clase.

6. Navega hasta el panel Detalles y selecciona Curva flotante de brillo en el menú desplegable Curva flotante de luz puntual.

   

7. Haz clic en los botones Compilar y Guardar.

   

Cómo configurar la pista de color

Cuando el jugador se solapa con los límites del componente de caja del actor de luz, la escala de tiempo de la luz puntual requerirá una pista de curva de color lineal para manipular la propiedad de color del componente de luz puntual.

1. Navega hasta el explorador de contenido, selecciona Añadir (+) > Varios > Curva.

   

2. Selecciona CurveLinearColor y nombra al recurso LinearColorCurve.

   

3. Haz doble clic en LinearColorCurve para abrir el editor de la escala de tiempo.

4. Haz doble clic en la primera clave de color para modificarla y establece el valor RGB en: (R: 1, G: 0,665, B: 0,015).

   

5. Haz doble clic en la segunda clave de color para modificarla y establece el valor RGB en: (R: 0, G: 0, B: 0).

   

6. Haz clic sobre el segundo punto del grafo y fija el tiempo en 5 segundos.

   

7. Tu LinearColorCurve debe tener el siguiente aspecto:

   

8. Guarda LinearColorCurve, vuelve al explorador de contenido y haz doble clic en BP_LightActor para abrir sus valores predeterminados de clase.

9. Navega hasta el panel Detalles y selecciona Curva flotante de brillo en el menú desplegable Curva flotante de luz puntual.

   

10. Haz clic en los botones Compilar y Guardar.

    

Configuración del nivel

Para demostrar mejor las funciones del código que has escrito, tendrás que eliminar todos los actores de fuentes de luz del nivel.

1. En el explorador de contenido, dirígete al recurso BP_LightActor, selecciónalo y arrástralo al nivel.

   

2. Selecciona BP_LightActor en el esquematizador del mundo, dirígete al panel Detalles y fija los ajustes de posición en (0, 0, 300) y de escala en (10, 10, 10).

   

3. Elimina el actor DirectionalLight en el esquematizador del mundo.

   

4. El nivel debería tener el siguiente aspecto.

   

Resultado final

Una vez configurado el actor de luz y el nivel, haz clic en Reproducir (PIE) para tomar posesión automáticamente del peón espectador.

Puedes controlar el peón espectador y desplazarte hasta los límites del componente de caja del actor de luz.

Una vez que se ha activado la función Reproducir del componente de escala de tiempo, el color y la luminosidad de la luz deberían empezar a cambiar en un intervalo de 5 segundos.