Verblassende Lichter

In diesem Dokument wird beschrieben, wie ein Licht-Actor eingerichtet wird, der bei Kontakt seine Farbe ändert und langsam verschwindet.

Dies geschieht mit einer Point Light Component, die eine Box-Komponente enthält, die als Überlappungsauslöser dient, und eine Timeline-Komponente zum Bearbeiten des Point Light Actors.

Erstellen des Fading Light-Actors

1. Erstellen Sie das neue C++-Projekt basierend auf der Vorlage Leer, benennen Sie es FadingLights.

   

2. Navigieren Sie zum Inhaltsbrowser, klicken Sie auf C++-Klassen und klicken Sie dann auf Hinzufügen (+) und wählen Sie Neue C++-Klasse.

   

3. Wählen Sie Actor als eine übergeordnete Klasse.

   

4. Benennen Sie den erstellten Actor Lichtactor.

   

5. Wenn ein neuer Actor erstellt wird, öffnet Visual Studio automatisch die Dateien LightActor.h und LightActor.cpp. Navigieren Sie zum LightActor.h Datei und erklären Sie Folgendes:

   LightActor.h

   C++

   #include "Components/TimelineComponent.h"

   Copy full snippet(1 line long)

6. Als nächstes in der LightActor-Klassendefinition, fügen Sie den folgenden Code hinzu:

   LightActor.h

   C++

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

7. Navigieren Sie zu LightActor.cpp und fügen Sie die folgenden Klassenbibliotheken hinzu.

   LightActor.cpp

   C++

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

   Copy full snippet(2 lines long)

8. Im Konstruktor für Ein Lichtactor::Ein Lichtactor erklären Sie Folgendes:

   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. Als nächstes implementieren Sie die UFunction-Methoden der Punktlicht-Komponente:

   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. Dann, in der BeginPlay-Methode den folgenden Code hinzufügen:

    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. Kompilieren Sie Ihren Code.

12. Vom Inhaltsbrowser navigieren Sie zum C++-Klassenordner.

13. Klicken Sie mit der rechten Maustaste auf Lichtactor, wählen Sie Erstellen Sie eine Blueprint-Klasse basierend auf LightActor und benennen Sie den Blueprint-Actor BP_LightActor.

    

Die Klassenstandards des BP_LightActor werden wie folgt angezeigt:

In Arbeit befindlicher Code

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.

Erstellen und Binden des Kollisionsüberlappungsevents

Die Box-Komponente erfordert die Fähigkeit, das TimelineComponent auszulösen, wenn ein Actor seine Kollisionsgrenzen betritt.

1. Navigieren Sie zur Klassendefinition des LightActor.h Datei und erklären Sie Folgendes unter Helligkeitsmultiplikator:

   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. Navigieren Sie anschließend zur Datei LightActor.cpp und implementieren Sie die OnOverlapBegin-Funktion.

   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. Binden Sie die Überlappungsfunktion in die Methode Spielbeginn:

   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. Kompilieren Sie Ihren Code.

Vollständiger Code

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()

Einrichten des Helligkeits-Tracks

Wenn sich der Pebene mit den Grenzen der Box-Komponente des Licht-Actors überschneidet, benötigt die Timeline-Komponente eine Float-Kurve, um den Helligkeitswert der Punktlicht-Komponente zu manipulieren.

Die Leuchtkraft hat einen Anfangswert von 5000 und sinkt auf 0 über die Spanne von 5 Sekunden.

1. Navigieren Sie zum Inhaltsbrowser, wählen Sie Hinzufügen (+) > Verschiedenes > Kurve.

   

2. Wählen Sie CurveFloat und benennen Sie das Asset BrightnessCurveFloat.

   

3. Doppelklicken Sie auf HelligkeitskurveFloat zum Öffnen des Zeitleisten-Editor.

4. Fügen Sie der Float-Kurve zwei Schlüssel hinzu, indem Sie mit der rechten Maustaste auf das Diagramm klicken und wählen Sie dann Schlüssel hinzufügen. Passen Sie den Zeitwert des ersten Schlüssels an (0, 5000) an. Passen Sie den Zeitwert der zweiten Taste an (5, 0) an. Ihr BrightnessCurveFloat sollte wie folgt aussehen:

   

5. Speichern Sie das BrightnessCurveFloat und navigieren Sie dann zurück zum Inhaltsbrowser und doppelklicken Sie auf BP_LightActor, um seine Klassenstandards zu öffnen.

6. Navigieren Sie zum Details-Panel und wählen Sie Helligkeitskurve-Float aus dem Dropdown-Menü Punktlicht-Float-Kurve.

   

7. Klicken Sie die Schaltflächen Kompilieren und Speichern.

   

Einrichten des Farb-Tracks

Wenn sich der Pebene mit den Grenzen der Box-Komponente des Licht-Actors überschneidet, erfordert die PointLight-Zeitleiste einen linearen Farbkurven-Track, um die Farbeigenschaft der PointLight-Komponente zu manipulieren.

1. Navigieren Sie zum Inhaltsbrowser, wählen Sie Hinzufügen (+) > Verschiedenes > Kurve.

   

2. Wählen Sie CurveLinearColor und benennen Sie das Asset LinearColorCurve.

   

3. Doppelklicken Sie auf LinearColorCurve zum Öffnen des Zeitleisten-Editor.

4. Doppelklicken Sie auf den ersten Farbschlüssel, um ihn zu ändern, stellen Sie RGB ein auf: (R:1, G:0,665, B:0,015).

   

5. Doppelklicken Sie auf den zweiten Farbschlüssel, um ihn zu ändern, stellen Sie RGB ein auf: (R:0, G:0, B:0).

   

6. Wählen Sie den zweiten Punkt auf dem Diagramm und klicken Sie darauf und stellen Sie die Uhrzeit auf 5 Sekunden ein.

   

7. Ihre LienarColorCurve sollte wie folgt aussehen:

   

8. Speichern Sie LineareFarbkurve, navigieren Sie dann zurück zum Inhaltsbrowser und doppelklicken Sie auf BP_LightActor um die Klassenstandards zu öffnen.

9. Navigieren Sie zum Details-Panel und wählen Sie Helligkeitskurve-Float aus dem Dropdown-Menü Punktlicht-Float-Kurve.

   

10. Klicken Sie die Schaltflächen Kompilieren und Speichern.

    

Level-Einrichtung

Um die Funktionalität des von Ihnen geschriebenen Codes optimal zu demonstrieren, müssen Sie alle Lichtquellen-Actore aus dem Level entfernen.

1. Im Inhaltsbrowser navigieren Sie zum Asset BP_LightActor, wählen Sie es aus und ziehen Sie es in die Ebene.

   

2. Wählen Sie BP_LightActor im Welt-Outliner, navigieren Sie zum Details-Panel und stellen Sie Standort auf (0, 0, 300) ein und Skala auf (10, 10, 10).

   

3. Löschen Sie den DirectionalLight Actor im Welt-Outliner.

   

4. Das Level sollte wie folgt aussehen.

   

Endergebnis

Nachdem Sie nun den Licht-Actor und die Ebene eingerichtet haben, klicken Sie auf Spielen (PIE) um automatisch den Zuschauer-Pawn in Besitz zu nehmen.

Sie können den Zuschauer-Pawn steuern und in die Grenzen der Box-Komponente des Licht-Actors navigieren.

Sobald die Wiedergabefunktion der Zeitleistenkomponente ausgelöst wurde, sollten sich Farbe und Leuchtkraft des Lichts innerhalb von 5 Sekunden ändern.