Add custom error display for platforms

Implemented currently for 3DS and SDL2. Switch and Vita are possible,
however an Error report might be generated on Switch (bad, could get
send to big N) and for Vita one would need to match framebuffer format
and such when dealing with GXM for dialog display. This is not worth
currently, since we likely migrate away from vita2d library in the
future.
Go through platform teardown code. While this may not work for every
case (e.g. out of memory on Wii), this should be cleaner.

Author: carstene1ns

CMakeLists.txt

@@ -231,6 +231,7 @@ add_library(${PROJECT_NAME} OBJECT
 	src/instrumentation.cpp
 	src/instrumentation.h
 	src/keys.h
+	src/main.h
 	src/main_data.cpp
 	src/main_data.h
 	src/maniac_patch.cpp

Makefile.am

@@ -212,6 +212,7 @@ libeasyrpg_player_a_SOURCES = \
 	src/instrumentation.cpp \
 	src/instrumentation.h \
 	src/keys.h \
+	src/main.h \
 	src/main_data.cpp \
 	src/main_data.h \
 	src/maniac_patch.cpp \

src/baseui.h

@@ -103,6 +103,14 @@ class BaseUi {
 	 */
 	virtual bool ShowCursor(bool /* flag */) { return true; };
 
+	/**
+	 * Outputs the error message in a custom way depending on platform
+	 *
+	 * @param message message string.
+	 * @return wether error has been handled
+	 */
+	virtual bool HandleErrorOutput(const std::string & /* message */) { return false; }
+
 	/**
 	 * Gets if fullscreen mode is active.
 	 *

src/main.h

@@ -0,0 +1,33 @@
+/*
+ * This file is part of EasyRPG Player.
+ *
+ * EasyRPG Player is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * EasyRPG Player is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with EasyRPG Player. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef EP_MAIN_H
+#define EP_MAIN_H
+
+namespace Platform {
+
+	/**
+	 * Run Platform teardown code and set return status code when
+	 * program terminates.
+	 *
+	 * @param without_error Whether to set an error exit code
+	 */
+	int Exit(bool without_error = true);
+
+}
+
+#endif

src/output.cpp

@@ -28,8 +28,6 @@
 #include <fmt/ostream.h>
 #ifdef EMSCRIPTEN
 #  include "platform/emscripten/interface.h"
-#elif defined(__vita__)
-#  include <psp2/kernel/processmgr.h>
 #endif
 
 #include "output.h"
@@ -42,6 +40,7 @@
 #include "message_overlay.h"
 #include "font.h"
 #include "baseui.h"
+#include "main.h"
 
 // fmt 7 has renamed the namespace
 #if FMT_VERSION < 70000
@@ -203,10 +202,7 @@ static void HandleErrorOutput(const std::string& err) {
 	BitmapRef surface = DisplayUi->GetDisplaySurface();
 	surface->FillRect(surface->GetRect(), Color(255, 0, 0, 128));
 
-	std::string error = "Error:\n";
-	error += err;
-
-	error += "\n\nEasyRPG Player will close now.\nPress [ENTER] key to exit...";
+	std::string error = err + "\nPress [ENTER] key to exit...";
 
 	Text::Draw(*surface, 11, 11, *Font::DefaultBitmapFont(), Color(0, 0, 0, 255), error);
 	Text::Draw(*surface, 10, 10, *Font::DefaultBitmapFont(), Color(255, 255, 255, 255), error);
@@ -294,16 +290,18 @@ void Output::ToggleLog() {
 
 void Output::ErrorStr(std::string const& err) {
 	WriteLog(LogLevel::Error, err);
+	std::string error = "Error:\n" + err + "\n\nEasyRPG Player will close now.";
+
 	static bool recursive_call = false;
 	if (!recursive_call && DisplayUi) {
 		recursive_call = true;
-		HandleErrorOutput(err);
+		// Try platform handler first
+		if (!DisplayUi->HandleErrorOutput(error))
+			HandleErrorOutput(error);
 		DisplayUi.reset();
 	} else {
 		// Fallback to Console if the display is not ready yet
-		std::cout << err << std::endl;
-		std::cout << std::endl;
-		std::cout << "EasyRPG Player will close now.";
+		std::cout << error << std::endl;
 #if defined (PLAYER_NINTENDO) || defined(__vita__)
 		// stdin is non-blocking
 		Game_Clock::SleepFor(5s);
@@ -316,11 +314,12 @@ void Output::ErrorStr(std::string const& err) {
 #endif
 	}
 
-	// FIXME: This does not go through platform teardown code
-#ifdef __vita__
-	sceKernelExitProcess(EXIT_FAILURE);
-#endif
+#ifdef USE_LIBRETRO
+	// FIXME
 	exit(EXIT_FAILURE);
+#else
+	exit(Platform::Exit(false));
+#endif
 }
 
 void Output::WarningStr(std::string const& warn) {

src/platform/3ds/main.cpp

@@ -19,6 +19,7 @@
 #include <cstdio>
 
 #include "player.h"
+#include "main.h"
 #include <string>
 #include <sys/stat.h>
 #include <unistd.h>
@@ -178,6 +179,11 @@ int main(int argc, char* argv[]) {
 	Player::Init(std::move(args));
 	Player::Run();
 
+	// Close
+	return Platform::Exit();
+}
+
+int Platform::Exit(bool without_error) {
 	romfsExit();
 	stop3DSLink();
 	gfxExit();
@@ -186,5 +192,6 @@ int main(int argc, char* argv[]) {
 		APT_SetAppCpuTimeLimit(old_time_limit);
 	}
 
-	return EXIT_SUCCESS;
+	if(without_error) return EXIT_SUCCESS;
+	return EXIT_FAILURE;
 }

src/platform/3ds/ui.cpp

@@ -428,3 +428,15 @@ void CtrUi::vGetConfig(Game_ConfigVideo& cfg) const {
 	cfg.touch_ui.SetDescription("Toggle the backlight of the bottom screen");
 	cfg.touch_ui.Set(bottom_state != screen_state::off);
 }
+
+bool CtrUi::HandleErrorOutput(const std::string &message) {
+	errorConf errCnf;
+	std::string error = Player::GetFullVersionString();
+	error += "\n\n" + message;
+
+	errorInit(&errCnf, ERROR_TEXT_WORD_WRAP, CFG_LANGUAGE_EN);
+	errorText(&errCnf, error.c_str());
+	errorDisp(&errCnf);
+
+	return true;
+}

src/platform/3ds/ui.h

@@ -54,6 +54,7 @@ class CtrUi final : public BaseUi {
 	void ToggleStretch() override;
 	void ToggleTouchUi() override;
 	void vGetConfig(Game_ConfigVideo& cfg) const override;
+	bool HandleErrorOutput(const std::string &message) override;
 
 #ifdef SUPPORT_AUDIO
 	AudioInterface& GetAudio();

src/platform/psvita/main.cpp

@@ -24,6 +24,7 @@
 #include <psp2/appmgr.h>
 #include "player.h"
 #include "output.h"
+#include "main.h"
 
 int _newlib_heap_size_user = 330 * 1024 * 1024;
 
@@ -107,6 +108,13 @@ int main(int argc, char* argv[]) {
 	Player::Run();
 
 	// Close
-	sceKernelExitProcess(EXIT_SUCCESS);
-	return EXIT_SUCCESS;
+	return Platform::Exit();
+}
+
+int Platform::Exit(bool without_error) {
+	if(without_error) return sceKernelExitProcess(EXIT_SUCCESS);
+	sceKernelExitProcess(EXIT_FAILURE);
+
+	// Does not matter
+	return 0;
 }

src/platform/sdl/main.cpp

@@ -21,6 +21,7 @@
 #include "player.h"
 #include "utils.h"
 #include "output.h"
+#include "main.h"
 
 #ifdef USE_SDL // This is needed on Windows, SDL wraps main()
 #  include <SDL.h>
@@ -86,5 +87,11 @@ extern "C" int main(int argc, char* argv[]) {
 	Player::Init(std::move(args));
 	Player::Run();
 
-	return EXIT_SUCCESS;
+	// Close
+	return Platform::Exit();
+}
+
+int Platform::Exit(bool without_error) {
+	if(without_error) return EXIT_SUCCESS;
+	return EXIT_FAILURE;
 }