summaryrefslogtreecommitdiff
path: root/lwjgl3/src
diff options
context:
space:
mode:
authorilotterytea <iltsu@alright.party>2025-01-20 19:29:50 +0500
committerilotterytea <iltsu@alright.party>2025-01-20 19:29:50 +0500
commit043834fa0adf502f61ba09fe312fa3e90b8a6bcc (patch)
tree6b140cc4fdb73c954d564b2baf6ff1086a4ada76 /lwjgl3/src
initial commit
Diffstat (limited to 'lwjgl3/src')
-rw-r--r--lwjgl3/src/main/java/kz/ilotterytea/frogartha/lwjgl3/Lwjgl3Launcher.java33
-rw-r--r--lwjgl3/src/main/java/kz/ilotterytea/frogartha/lwjgl3/StartupHelper.java179
-rw-r--r--lwjgl3/src/main/resources/libgdx128.pngbin0 -> 9754 bytes
-rw-r--r--lwjgl3/src/main/resources/libgdx16.pngbin0 -> 879 bytes
-rw-r--r--lwjgl3/src/main/resources/libgdx32.pngbin0 -> 2092 bytes
-rw-r--r--lwjgl3/src/main/resources/libgdx64.pngbin0 -> 4996 bytes
6 files changed, 212 insertions, 0 deletions
diff --git a/lwjgl3/src/main/java/kz/ilotterytea/frogartha/lwjgl3/Lwjgl3Launcher.java b/lwjgl3/src/main/java/kz/ilotterytea/frogartha/lwjgl3/Lwjgl3Launcher.java
new file mode 100644
index 0000000..e63402b
--- /dev/null
+++ b/lwjgl3/src/main/java/kz/ilotterytea/frogartha/lwjgl3/Lwjgl3Launcher.java
@@ -0,0 +1,33 @@
+package kz.ilotterytea.frogartha.lwjgl3;
+
+import com.badlogic.gdx.backends.lwjgl3.Lwjgl3Application;
+import com.badlogic.gdx.backends.lwjgl3.Lwjgl3ApplicationConfiguration;
+import kz.ilotterytea.frogartha.FrogarthaGame;
+
+/**
+ * Launches the desktop (LWJGL3) application.
+ */
+public class Lwjgl3Launcher {
+ public static void main(String[] args) {
+ if (StartupHelper.startNewJvmIfRequired()) return; // This handles macOS support and helps on Windows.
+ new Lwjgl3Application(FrogarthaGame.getInstance(), getDefaultConfiguration());
+ }
+
+ private static Lwjgl3ApplicationConfiguration getDefaultConfiguration() {
+ Lwjgl3ApplicationConfiguration configuration = new Lwjgl3ApplicationConfiguration();
+ configuration.setTitle("Frogartha");
+ //// Vsync limits the frames per second to what your hardware can display, and helps eliminate
+ //// screen tearing. This setting doesn't always work on Linux, so the line after is a safeguard.
+ configuration.useVsync(true);
+ //// Limits FPS to the refresh rate of the currently active monitor, plus 1 to try to match fractional
+ //// refresh rates. The Vsync setting above should limit the actual FPS to match the monitor.
+ configuration.setForegroundFPS(Lwjgl3ApplicationConfiguration.getDisplayMode().refreshRate + 1);
+ //// If you remove the above line and set Vsync to false, you can get unlimited FPS, which can be
+ //// useful for testing performance, but can also be very stressful to some hardware.
+ //// You may also need to configure GPU drivers to fully disable Vsync; this can cause screen tearing.
+ configuration.setWindowedMode(800, 600);
+ //// You can change these files; they are in lwjgl3/src/main/resources/ .
+ configuration.setWindowIcon("libgdx128.png", "libgdx64.png", "libgdx32.png", "libgdx16.png");
+ return configuration;
+ }
+}
diff --git a/lwjgl3/src/main/java/kz/ilotterytea/frogartha/lwjgl3/StartupHelper.java b/lwjgl3/src/main/java/kz/ilotterytea/frogartha/lwjgl3/StartupHelper.java
new file mode 100644
index 0000000..b51d415
--- /dev/null
+++ b/lwjgl3/src/main/java/kz/ilotterytea/frogartha/lwjgl3/StartupHelper.java
@@ -0,0 +1,179 @@
+/*
+ * Copyright 2020 damios
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+//Note, the above license and copyright applies to this file only.
+
+package kz.ilotterytea.frogartha.lwjgl3;
+
+import org.lwjgl.system.macosx.LibC;
+
+import java.io.BufferedReader;
+import java.io.File;
+import java.io.InputStreamReader;
+import java.lang.management.ManagementFactory;
+import java.util.ArrayList;
+
+/**
+ * Adds some utilities to ensure that the JVM was started with the
+ * {@code -XstartOnFirstThread} argument, which is required on macOS for LWJGL 3
+ * to function. Also helps on Windows when users have names with characters from
+ * outside the Latin alphabet, a common cause of startup crashes.
+ * <br>
+ * <a href="https://jvm-gaming.org/t/starting-jvm-on-mac-with-xstartonfirstthread-programmatically/57547">Based on this java-gaming.org post by kappa</a>
+ * @author damios
+ */
+public class StartupHelper {
+
+ private static final String JVM_RESTARTED_ARG = "jvmIsRestarted";
+
+ private StartupHelper() {
+ throw new UnsupportedOperationException();
+ }
+
+ /**
+ * Starts a new JVM if the application was started on macOS without the
+ * {@code -XstartOnFirstThread} argument. This also includes some code for
+ * Windows, for the case where the user's home directory includes certain
+ * non-Latin-alphabet characters (without this code, most LWJGL3 apps fail
+ * immediately for those users). Returns whether a new JVM was started and
+ * thus no code should be executed.
+ * <p>
+ * <u>Usage:</u>
+ *
+ * <pre><code>
+ * public static void main(String... args) {
+ * if (StartupHelper.startNewJvmIfRequired(true)) return; // This handles macOS support and helps on Windows.
+ * // after this is the actual main method code
+ * }
+ * </code></pre>
+ *
+ * @param redirectOutput
+ * whether the output of the new JVM should be rerouted to the
+ * old JVM, so it can be accessed in the same place; keeps the
+ * old JVM running if enabled
+ * @return whether a new JVM was started and thus no code should be executed
+ * in this one
+ */
+ public static boolean startNewJvmIfRequired(boolean redirectOutput) {
+ String osName = System.getProperty("os.name").toLowerCase();
+ if (!osName.contains("mac")) {
+ if (osName.contains("windows")) {
+// Here, we are trying to work around an issue with how LWJGL3 loads its extracted .dll files.
+// By default, LWJGL3 extracts to the directory specified by "java.io.tmpdir", which is usually the user's home.
+// If the user's name has non-ASCII (or some non-alphanumeric) characters in it, that would fail.
+// By extracting to the relevant "ProgramData" folder, which is usually "C:\ProgramData", we avoid this.
+ System.setProperty("java.io.tmpdir", System.getenv("ProgramData") + "/libGDX-temp");
+ }
+ return false;
+ }
+
+ // There is no need for -XstartOnFirstThread on Graal native image
+ if (!System.getProperty("org.graalvm.nativeimage.imagecode", "").isEmpty()) {
+ return false;
+ }
+
+ long pid = LibC.getpid();
+
+ // check whether -XstartOnFirstThread is enabled
+ if ("1".equals(System.getenv("JAVA_STARTED_ON_FIRST_THREAD_" + pid))) {
+ return false;
+ }
+
+ // check whether the JVM was previously restarted
+ // avoids looping, but most certainly leads to a crash
+ if ("true".equals(System.getProperty(JVM_RESTARTED_ARG))) {
+ System.err.println(
+ "There was a problem evaluating whether the JVM was started with the -XstartOnFirstThread argument.");
+ return false;
+ }
+
+ // Restart the JVM with -XstartOnFirstThread
+ ArrayList<String> jvmArgs = new ArrayList<>();
+ String separator = System.getProperty("file.separator");
+ // The following line is used assuming you target Java 8, the minimum for LWJGL3.
+ String javaExecPath = System.getProperty("java.home") + separator + "bin" + separator + "java";
+ // If targeting Java 9 or higher, you could use the following instead of the above line:
+ //String javaExecPath = ProcessHandle.current().info().command().orElseThrow();
+
+ if (!(new File(javaExecPath)).exists()) {
+ System.err.println(
+ "A Java installation could not be found. If you are distributing this app with a bundled JRE, be sure to set the -XstartOnFirstThread argument manually!");
+ return false;
+ }
+
+ jvmArgs.add(javaExecPath);
+ jvmArgs.add("-XstartOnFirstThread");
+ jvmArgs.add("-D" + JVM_RESTARTED_ARG + "=true");
+ jvmArgs.addAll(ManagementFactory.getRuntimeMXBean().getInputArguments());
+ jvmArgs.add("-cp");
+ jvmArgs.add(System.getProperty("java.class.path"));
+ String mainClass = System.getenv("JAVA_MAIN_CLASS_" + pid);
+ if (mainClass == null) {
+ StackTraceElement[] trace = Thread.currentThread().getStackTrace();
+ if (trace.length > 0) {
+ mainClass = trace[trace.length - 1].getClassName();
+ } else {
+ System.err.println("The main class could not be determined.");
+ return false;
+ }
+ }
+ jvmArgs.add(mainClass);
+
+ try {
+ if (!redirectOutput) {
+ ProcessBuilder processBuilder = new ProcessBuilder(jvmArgs);
+ processBuilder.start();
+ } else {
+ Process process = (new ProcessBuilder(jvmArgs))
+ .redirectErrorStream(true).start();
+ BufferedReader processOutput = new BufferedReader(
+ new InputStreamReader(process.getInputStream()));
+ String line;
+
+ while ((line = processOutput.readLine()) != null) {
+ System.out.println(line);
+ }
+
+ process.waitFor();
+ }
+ } catch (Exception e) {
+ System.err.println("There was a problem restarting the JVM");
+ e.printStackTrace();
+ }
+
+ return true;
+ }
+
+ /**
+ * Starts a new JVM if the application was started on macOS without the
+ * {@code -XstartOnFirstThread} argument. Returns whether a new JVM was
+ * started and thus no code should be executed. Redirects the output of the
+ * new JVM to the old one.
+ * <p>
+ * <u>Usage:</u>
+ *
+ * <pre>
+ * public static void main(String... args) {
+ * if (StartupHelper.startNewJvmIfRequired()) return; // This handles macOS support and helps on Windows.
+ * // the actual main method code
+ * }
+ * </pre>
+ *
+ * @return whether a new JVM was started and thus no code should be executed
+ * in this one
+ */
+ public static boolean startNewJvmIfRequired() {
+ return startNewJvmIfRequired(true);
+ }
+} \ No newline at end of file
diff --git a/lwjgl3/src/main/resources/libgdx128.png b/lwjgl3/src/main/resources/libgdx128.png
new file mode 100644
index 0000000..788f542
--- /dev/null
+++ b/lwjgl3/src/main/resources/libgdx128.png
Binary files differ
diff --git a/lwjgl3/src/main/resources/libgdx16.png b/lwjgl3/src/main/resources/libgdx16.png
new file mode 100644
index 0000000..47af189
--- /dev/null
+++ b/lwjgl3/src/main/resources/libgdx16.png
Binary files differ
diff --git a/lwjgl3/src/main/resources/libgdx32.png b/lwjgl3/src/main/resources/libgdx32.png
new file mode 100644
index 0000000..4cf903a
--- /dev/null
+++ b/lwjgl3/src/main/resources/libgdx32.png
Binary files differ
diff --git a/lwjgl3/src/main/resources/libgdx64.png b/lwjgl3/src/main/resources/libgdx64.png
new file mode 100644
index 0000000..ebcd8f1
--- /dev/null
+++ b/lwjgl3/src/main/resources/libgdx64.png
Binary files differ