forked from StarOpenSource/Engine
Add unfinished Vulkan subsystem
It will be for a very long time. Many say that OpenGL is easier to learn, so I'll go with that one first.
This commit is contained in:
parent
a8c4633ae5
commit
faf51f6c18
10 changed files with 338 additions and 0 deletions
93
graphics/vulkan/build.gradle
Normal file
93
graphics/vulkan/build.gradle
Normal file
|
@ -0,0 +1,93 @@
|
|||
import org.gradle.internal.os.OperatingSystem
|
||||
|
||||
plugins {
|
||||
id 'java'
|
||||
id 'io.freefair.lombok' version "${pluginLombok}"
|
||||
}
|
||||
|
||||
// Determine LWJGL native stuff
|
||||
switch (OperatingSystem.current()) {
|
||||
case OperatingSystem.LINUX:
|
||||
project.dependencyLwjglNatives = "natives-linux"
|
||||
def osArch = System.getProperty("os.arch")
|
||||
if (osArch.startsWith("arm") || osArch.startsWith("aarch64")) {
|
||||
project.dependencyLwjglNatives += osArch.contains("64") || osArch.startsWith("armv8") ? "-arm64" : "-arm32"
|
||||
} else if (osArch.startsWith("ppc")) {
|
||||
project.dependencyLwjglNatives += "-ppc64le"
|
||||
} else if (osArch.startsWith("riscv")) {
|
||||
project.dependencyLwjglNatives += "-riscv64"
|
||||
}
|
||||
break
|
||||
case OperatingSystem.MAC_OS:
|
||||
project.dependencyLwjglNatives = System.getProperty("os.arch").startsWith("aarch64") ? "natives-macos-arm64" : "natives-macos"
|
||||
break
|
||||
case OperatingSystem.WINDOWS:
|
||||
def osArch = System.getProperty("os.arch")
|
||||
project.dependencyLwjglNatives = osArch.contains("64")
|
||||
? "natives-windows${osArch.startsWith("aarch64") ? "-arm64" : ""}"
|
||||
: "natives-windows-x86"
|
||||
break
|
||||
}
|
||||
|
||||
dependencies {
|
||||
// -> Runtime <-
|
||||
// Lombok
|
||||
compileOnly 'org.projectlombok:lombok:' + project.dependencyLombok
|
||||
annotationProcessor 'org.projectlombok:lombok:' + project.dependencyLombok
|
||||
|
||||
// JetBrains Annotations
|
||||
compileOnly 'org.jetbrains:annotations:' + project.dependencyJetbrainsAnnotations
|
||||
|
||||
// LWJGL
|
||||
implementation platform("org.lwjgl:lwjgl-bom:${dependencyLwjgl}")
|
||||
implementation "org.lwjgl:lwjgl"
|
||||
implementation "org.lwjgl:lwjgl-bgfx"
|
||||
implementation "org.lwjgl:lwjgl-egl"
|
||||
implementation "org.lwjgl:lwjgl-glfw"
|
||||
implementation "org.lwjgl:lwjgl-ktx"
|
||||
implementation "org.lwjgl:lwjgl-shaderc"
|
||||
implementation "org.lwjgl:lwjgl-sse"
|
||||
implementation "org.lwjgl:lwjgl-vma"
|
||||
implementation "org.lwjgl:lwjgl-vulkan"
|
||||
runtimeOnly "org.lwjgl:lwjgl::${dependencyLwjglNatives}"
|
||||
runtimeOnly "org.lwjgl:lwjgl-bgfx::${dependencyLwjglNatives}"
|
||||
runtimeOnly "org.lwjgl:lwjgl-glfw::${dependencyLwjglNatives}"
|
||||
runtimeOnly "org.lwjgl:lwjgl-ktx::${dependencyLwjglNatives}"
|
||||
runtimeOnly "org.lwjgl:lwjgl-shaderc::${dependencyLwjglNatives}"
|
||||
runtimeOnly "org.lwjgl:lwjgl-sse::${dependencyLwjglNatives}"
|
||||
runtimeOnly "org.lwjgl:lwjgl-vma::${dependencyLwjglNatives}"
|
||||
if (project.dependencyLwjglNatives == "natives-macos" || project.dependencyLwjglNatives == "natives-macos-arm64") runtimeOnly "org.lwjgl:lwjgl-vulkan::${dependencyLwjglNatives}"
|
||||
|
||||
// -> Testing <-
|
||||
// Jetbrains Annotations
|
||||
testCompileOnly 'org.jetbrains:annotations:' + project.dependencyJetbrainsAnnotations
|
||||
|
||||
// JUnit
|
||||
testImplementation platform('org.junit:junit-bom:5.' + project.dependencyJunit)
|
||||
testImplementation 'org.junit.jupiter:junit-jupiter'
|
||||
testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
|
||||
|
||||
// jOOR
|
||||
testImplementation 'org.jooq:joor:' + project.dependencyJoor
|
||||
|
||||
// -> Project <-
|
||||
implementation project(":base")
|
||||
implementation project(":graphics")
|
||||
}
|
||||
|
||||
javadoc.options {
|
||||
setMemberLevel(JavadocMemberLevel.PUBLIC)
|
||||
setOverview("src/main/javadoc/overview.html")
|
||||
setLocale("en_US")
|
||||
setJFlags([
|
||||
// Force Javadoc to use English translations
|
||||
"-Duser.language=en_US"
|
||||
])
|
||||
}
|
||||
|
||||
test {
|
||||
useJUnitPlatform()
|
||||
testLogging {
|
||||
events "passed", "skipped", "failed"
|
||||
}
|
||||
}
|
1
graphics/vulkan/gradle
Symbolic link
1
graphics/vulkan/gradle
Symbolic link
|
@ -0,0 +1 @@
|
|||
../../gradle
|
1
graphics/vulkan/gradlew
vendored
Symbolic link
1
graphics/vulkan/gradlew
vendored
Symbolic link
|
@ -0,0 +1 @@
|
|||
../../gradlew
|
1
graphics/vulkan/gradlew.bat
vendored
Symbolic link
1
graphics/vulkan/gradlew.bat
vendored
Symbolic link
|
@ -0,0 +1 @@
|
|||
../../gradlew.bat
|
|
@ -0,0 +1,34 @@
|
|||
/*
|
||||
* STAROPENSOURCE ENGINE SOURCE FILE
|
||||
* Copyright (c) 2024 The StarOpenSource Engine Contributors
|
||||
* Licensed under the GNU Affero General Public License v3
|
||||
*
|
||||
* This program is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as
|
||||
* published by the Free Software Foundation, either version 3 of the
|
||||
* License, or (at your option) any later version.
|
||||
*
|
||||
* This program 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 Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
package de.staropensource.sosengine.graphics.vulkan;
|
||||
|
||||
import de.staropensource.sosengine.base.classes.Vec2i;
|
||||
import de.staropensource.sosengine.graphics.classes.ApiManagementClass;
|
||||
import de.staropensource.sosengine.graphics.classes.Window;
|
||||
import org.jetbrains.annotations.NotNull;
|
||||
|
||||
public class VulkanManagement implements ApiManagementClass {
|
||||
/** {@inheritDoc} */
|
||||
@NotNull
|
||||
@Override
|
||||
public Window createWindow(String title, Vec2i size) {
|
||||
return null;
|
||||
}
|
||||
}
|
|
@ -0,0 +1,162 @@
|
|||
/*
|
||||
* STAROPENSOURCE ENGINE SOURCE FILE
|
||||
* Copyright (c) 2024 The StarOpenSource Engine Contributors
|
||||
* Licensed under the GNU Affero General Public License v3
|
||||
*
|
||||
* This program is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as
|
||||
* published by the Free Software Foundation, either version 3 of the
|
||||
* License, or (at your option) any later version.
|
||||
*
|
||||
* This program 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 Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
package de.staropensource.sosengine.graphics.vulkan;
|
||||
|
||||
import de.staropensource.sosengine.base.annotations.EventListener;
|
||||
import de.staropensource.sosengine.base.classes.EventPriority;
|
||||
import de.staropensource.sosengine.base.logging.LoggerInstance;
|
||||
import de.staropensource.sosengine.base.types.LogIssuer;
|
||||
import de.staropensource.sosengine.base.utility.Miscellaneous;
|
||||
import de.staropensource.sosengine.graphics.GraphicsSubsystem;
|
||||
import de.staropensource.sosengine.graphics.classes.ApiMainClass;
|
||||
import de.staropensource.sosengine.graphics.classes.ApiManagementClass;
|
||||
import de.staropensource.sosengine.graphics.vulkan.events.GraphicsErrorEvent;
|
||||
import lombok.Getter;
|
||||
import org.lwjgl.glfw.GLFWErrorCallback;
|
||||
|
||||
import static org.lwjgl.glfw.GLFW.*;
|
||||
|
||||
/**
|
||||
* The main object for the Vulkan Graphics API.
|
||||
*
|
||||
* @since 1-alpha0
|
||||
*/
|
||||
@SuppressWarnings({ "unused", "JavadocDeclaration", "JavadocBlankLines" })
|
||||
public final class VulkanSubsystem implements ApiMainClass {
|
||||
/**
|
||||
* Instance.
|
||||
*
|
||||
* @since 1-alpha0
|
||||
*
|
||||
* -- GETTER --
|
||||
* Returns the {@link VulkanSubsystem} instance.
|
||||
*
|
||||
* @return {@link VulkanSubsystem} instance unless uninitialized
|
||||
* @since 1-alpha0
|
||||
*/
|
||||
@Getter
|
||||
private static VulkanSubsystem instance = null;
|
||||
|
||||
/**
|
||||
* Logger instance.
|
||||
*
|
||||
* @see LoggerInstance
|
||||
* @since 1-alpha0
|
||||
*/
|
||||
private final LoggerInstance logger = new LoggerInstance(new LogIssuer(getClass()));
|
||||
|
||||
/**
|
||||
* The Graphics API management class.
|
||||
*
|
||||
* @see ApiManagementClass
|
||||
* @since 1-alpha0
|
||||
*
|
||||
* -- GETTER --
|
||||
* {@inheritDoc}
|
||||
*/
|
||||
@Getter
|
||||
private ApiManagementClass management;
|
||||
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @since 1-alpha0
|
||||
*/
|
||||
public VulkanSubsystem() {
|
||||
// Check if subsystem has already initialized
|
||||
if (instance == null)
|
||||
instance = this;
|
||||
else {
|
||||
instance.logger.crash("The subsystem tried to initialize twice");
|
||||
return;
|
||||
}
|
||||
|
||||
// Warn about instability
|
||||
logger.warn("The Vulkan Graphics API is unfinished. Trying to initialize it will lead to an engine crash.");
|
||||
|
||||
// Register Graphics API
|
||||
GraphicsSubsystem.getInstance().registerGraphicsApi(this);
|
||||
|
||||
logger.info("Initialized subsystem");
|
||||
}
|
||||
|
||||
/** {@inheritDoc} */
|
||||
@Override
|
||||
public void initializeApi() {
|
||||
logger.verb("Initializing Graphics API");
|
||||
|
||||
long initTime = Miscellaneous.measureExecutionTime(() -> {
|
||||
logger.crash("The Vulkan Graphics API subsystem is unfinished.");
|
||||
|
||||
// Set error callback
|
||||
try (GLFWErrorCallback errorCallback = GLFWErrorCallback.create(new GraphicsErrorEvent())) {
|
||||
errorCallback.set();
|
||||
}
|
||||
|
||||
// Initialize GLFW
|
||||
if (!glfwInit())
|
||||
logger.crash("Unable to initialize GLFW");
|
||||
});
|
||||
|
||||
logger.info("Initialized Graphics API in " + initTime + "ms");
|
||||
}
|
||||
|
||||
/** {@inheritDoc} */
|
||||
@Override
|
||||
public String getApiName() {
|
||||
return "Vulkan";
|
||||
}
|
||||
|
||||
/** {@inheritDoc} */
|
||||
@Override
|
||||
public boolean isCompatible() {
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Called when a graphics error occurs. This method just logs the error and returns.
|
||||
*
|
||||
* @param error graphics error
|
||||
* @since 1-alpha0
|
||||
*/
|
||||
@EventListener(event = GraphicsErrorEvent.class, priority = EventPriority.EXTREMELY_IMPORTANT)
|
||||
public static void onGraphicsError(String error) {
|
||||
instance.logger.error("An error occurred: " + error);
|
||||
}
|
||||
|
||||
/**
|
||||
* Shuts the graphics subsystem down.
|
||||
*
|
||||
* @since 1-alpha0
|
||||
*/
|
||||
public static void shutdownApi() {
|
||||
LoggerInstance logger = instance.logger;
|
||||
logger.verb("Shutting down");
|
||||
|
||||
@SuppressWarnings("resource")
|
||||
long shutdownTime = Miscellaneous.measureExecutionTime(() -> {
|
||||
glfwTerminate();
|
||||
//noinspection DataFlowIssue
|
||||
glfwSetErrorCallback(null).free();
|
||||
});
|
||||
|
||||
logger.info("Shut down in " + shutdownTime + "ms");
|
||||
}
|
||||
}
|
|
@ -0,0 +1,42 @@
|
|||
/*
|
||||
* STAROPENSOURCE ENGINE SOURCE FILE
|
||||
* Copyright (c) 2024 The StarOpenSource Engine Contributors
|
||||
* Licensed under the GNU Affero General Public License v3
|
||||
*
|
||||
* This program is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as
|
||||
* published by the Free Software Foundation, either version 3 of the
|
||||
* License, or (at your option) any later version.
|
||||
*
|
||||
* This program 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 Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
package de.staropensource.sosengine.graphics.vulkan.events;
|
||||
|
||||
import org.lwjgl.glfw.GLFWErrorCallbackI;
|
||||
|
||||
/**
|
||||
* Called when a graphics error occurs.
|
||||
*
|
||||
* @since 1-alpha0
|
||||
*/
|
||||
@SuppressWarnings({ "unused" })
|
||||
public class GraphicsErrorEvent extends de.staropensource.sosengine.graphics.events.GraphicsErrorEvent implements GLFWErrorCallbackI {
|
||||
/**
|
||||
* Constructor.
|
||||
*/
|
||||
public GraphicsErrorEvent() {}
|
||||
|
||||
|
||||
/** {@inheritDoc} */
|
||||
@Override
|
||||
public void invoke(int error, long description) {
|
||||
callEvent(description + " (" + error + ")");
|
||||
}
|
||||
}
|
|
@ -3,4 +3,5 @@ rootProject.name = 'sosengine'
|
|||
include 'base'
|
||||
include 'slf4j-compat'
|
||||
include 'graphics'
|
||||
include 'graphics:vulkan'
|
||||
include 'testapp'
|
||||
|
|
|
@ -18,6 +18,7 @@ dependencies {
|
|||
implementation project(":base")
|
||||
implementation project(":slf4j-compat")
|
||||
implementation project(":graphics")
|
||||
implementation project(":graphics:vulkan")
|
||||
}
|
||||
|
||||
javadoc.options {
|
||||
|
|
|
@ -26,6 +26,7 @@ import de.staropensource.sosengine.base.types.LogIssuer;
|
|||
import de.staropensource.sosengine.graphics.GraphicsSubsystem;
|
||||
import de.staropensource.sosengine.graphics.classes.ApiMainClass;
|
||||
import de.staropensource.sosengine.graphics.classes.ApiManagementClass;
|
||||
import de.staropensource.sosengine.graphics.vulkan.VulkanSubsystem;
|
||||
import de.staropensource.sosengine.slf4j_compat.Slf4jCompatibilitySubsystem;
|
||||
import lombok.Getter;
|
||||
import lombok.SneakyThrows;
|
||||
|
@ -101,6 +102,7 @@ public class Main {
|
|||
// Initialize subsystems
|
||||
new Slf4jCompatibilitySubsystem();
|
||||
new GraphicsSubsystem();
|
||||
new VulkanSubsystem();
|
||||
|
||||
// Choose Graphics API to use
|
||||
if (!GraphicsSubsystem.getInstance().setGraphicsApi()) {
|
||||
|
|
Loading…
Reference in a new issue