Add fadeOutOnly option to jngl::Fade

Author: jhasse

src/jngl/Fade.cpp

@@ -1,4 +1,4 @@
-// Copyright 2025 Jan Niklas Hasse <jhasse@bixense.com>
+// Copyright 2025-2026 Jan Niklas Hasse <jhasse@bixense.com>
 // For conditions of distribution and use, see copyright notice in LICENSE.txt
 #include "Fade.hpp"
 
@@ -11,12 +11,13 @@
 
 namespace jngl {
 
-Fade::Fade(std::shared_ptr<Work> work, int speed)
-: work(std::move(work)), oldWork(getWork()), fadeCount(0), speed(speed) {
+Fade::Fade(std::shared_ptr<Work> work, std::optional<Options> options)
+: work(std::move(work)), oldWork(getWork()), fadeCount(0), speed(options ? options->speed : 20),
+  fadeOutOnly(options ? options->fadeOutOnly : false) {
 }
 
-Fade::Fade(std::function<std::shared_ptr<Scene>()> factory, int speed)
-: Fade(std::make_shared<WorkFactory>(std::move(factory)), speed) {
+Fade::Fade(std::function<std::shared_ptr<Scene>()> factory, std::optional<Options> options)
+: Fade(std::make_shared<WorkFactory>(std::move(factory)), options) {
 }
 
 Fade::~Fade() {
@@ -52,6 +53,9 @@ void Fade::step() {
 				break;
 			}
 		}
+		if (fadeOutOnly) {
+			setScene(work);
+		}
 	}
 }
 

src/jngl/Fade.hpp

@@ -1,23 +1,33 @@
-// Copyright 2025 Jan Niklas Hasse <jhasse@bixense.com>
+// Copyright 2025-2026 Jan Niklas Hasse <jhasse@bixense.com>
 // For conditions of distribution and use, see copyright notice in LICENSE.txt
 /// Contains jngl::Fade class
 /// @file
 #pragma once
 
 #include "Scene.hpp"
 
+#include <optional>
+
 namespace jngl {
 
 /// Fades between two scenes, first fading to jngl::getBackgroundColor() and then fading to the new
 /// scene
 class Fade : public Scene {
 public:
-	explicit Fade(std::shared_ptr<Scene>, int speed = 20);
+	struct Options {
+		int speed = 20;
+
+		/// If true, only fades out and then immediately switches to the new scene
+		bool fadeOutOnly = false;
+	};
+
+	explicit Fade(std::shared_ptr<Scene>, std::optional<Options> options = {});
 
 	/// Uses factory() to get the new Scene when the screen has faded to black (or the background
 	/// color). This is useful when the ctor of your new Scene might take a long time (e.g. loading
 	/// assets) and you don't want the lag to be noticable.
-	explicit Fade(std::function<std::shared_ptr<Scene>()> factory, int speed = 20);
+	explicit Fade(std::function<std::shared_ptr<Scene>()> factory,
+	              std::optional<Options> options = {});
 
 	~Fade() override;
 	void step() override;
@@ -31,6 +41,7 @@ class Fade : public Scene {
 	double fadeCount;
 	int speed;
 	bool quit = false;
+	bool fadeOutOnly;
 };
 
 } // namespace jngl