Add android

QuestCraftPlusPlus · Oct 18, 2024 · 469f3c3 · 469f3c3
1 parent 160fac0
commit 469f3c3
Show file tree

Hide file tree

Showing 6 changed files with 826 additions and 1,408 deletions.
diff --git a/modules/lwjgl/openxr/src/templates/kotlin/openxr/ExtensionTypes.kt b/modules/lwjgl/openxr/src/templates/kotlin/openxr/ExtensionTypes.kt
diff --git a/modules/lwjgl/openxr/src/templates/kotlin/openxr/XRTypes.kt b/modules/lwjgl/openxr/src/templates/kotlin/openxr/XRTypes.kt
diff --git a/modules/lwjgl/openxr/src/templates/kotlin/openxr/templates/KHR_android_create_instance.kt b/modules/lwjgl/openxr/src/templates/kotlin/openxr/templates/KHR_android_create_instance.kt
@@ -0,0 +1,38 @@
+/*
+ * Copyright LWJGL. All rights reserved.
+ * License terms: https://www.lwjgl.org/license
+ * MACHINE GENERATED FILE, DO NOT EDIT
+ */
+package openxr.templates
+
+import org.lwjgl.generator.*
+import openxr.*
+
+val KHR_android_create_instance = "KHRAndroidCreateInstance".nativeClassXR("KHR_android_create_instance", type = "instance", postfix = "KHR") {
+    documentation =
+        """
+        The <a href="https://registry.khronos.org/OpenXR/specs/1.0/html/xrspec.html\#XR_KHR_android_create_instance">XR_KHR_android_create_instance</a> extension.
+
+        When the application creates an {@code XrInstance} object on Android systems, additional information from the application has to be provided to the XR runtime.
+
+        The Android XR runtime <b>must</b> return error #ERROR_VALIDATION_FAILURE if the additional information is not provided by the application or if the additional parameters are invalid.
+        """
+
+    IntConstant(
+        "The extension specification version.",
+
+        "KHR_android_create_instance_SPEC_VERSION".."3"
+    )
+
+    StringConstant(
+        "The extension name.",
+
+        "KHR_ANDROID_CREATE_INSTANCE_EXTENSION_NAME".."XR_KHR_android_create_instance"
+    )
+
+    EnumConstant(
+        "Extends {@code XrStructureType}.",
+
+        "TYPE_INSTANCE_CREATE_INFO_ANDROID_KHR".."1000008000"
+    )
+}
diff --git a/modules/lwjgl/openxr/src/templates/kotlin/openxr/templates/KHR_loader_init_android.kt b/modules/lwjgl/openxr/src/templates/kotlin/openxr/templates/KHR_loader_init_android.kt
@@ -0,0 +1,42 @@
+/*
+ * Copyright LWJGL. All rights reserved.
+ * License terms: https://www.lwjgl.org/license
+ * MACHINE GENERATED FILE, DO NOT EDIT
+ */
+package openxr.templates
+
+import org.lwjgl.generator.*
+import openxr.*
+
+val KHR_loader_init_android = "KHRLoaderInitAndroid".nativeClassXR("KHR_loader_init_android", type = "instance", postfix = "KHR") {
+    documentation =
+        """
+        The <a href="https://registry.khronos.org/OpenXR/specs/1.0/html/xrspec.html\#XR_KHR_loader_init_android">XR_KHR_loader_init_android</a> extension.
+
+        On Android, some loader implementations need the application to provide additional information on initialization. This extension defines the parameters needed by such implementations. If this is available on a given implementation, an application <b>must</b> make use of it.
+
+        On implementations where use of this is required, the following condition <b>must</b> apply:
+
+        <ul>
+            <li>Whenever an OpenXR function accepts an ##XrLoaderInitInfoBaseHeaderKHR pointer, the runtime (and loader) <b>must</b> also accept a pointer to an ##XrLoaderInitInfoAndroidKHR.</li>
+        </ul>
+        """
+
+    IntConstant(
+        "The extension specification version.",
+
+        "KHR_loader_init_android_SPEC_VERSION".."1"
+    )
+
+    StringConstant(
+        "The extension name.",
+
+        "KHR_LOADER_INIT_ANDROID_EXTENSION_NAME".."XR_KHR_loader_init_android"
+    )
+
+    EnumConstant(
+        "Extends {@code XrStructureType}.",
+
+        "TYPE_LOADER_INIT_INFO_ANDROID_KHR".."1000089000"
+    )
+}
diff --git a/modules/lwjgl/openxr/src/templates/kotlin/openxr/templates/KHR_opengl_es_enable.kt b/modules/lwjgl/openxr/src/templates/kotlin/openxr/templates/KHR_opengl_es_enable.kt
@@ -0,0 +1,101 @@
+/*
+ * Copyright LWJGL. All rights reserved.
+ * License terms: https://www.lwjgl.org/license
+ * MACHINE GENERATED FILE, DO NOT EDIT
+ */
+package openxr.templates
+
+import org.lwjgl.generator.*
+import openxr.*
+
+val KHR_opengl_es_enable = "KHROpenGLESEnable".nativeClassXR("KHR_opengl_es_enable", type = "instance", postfix = "KHR") {
+    documentation =
+        """
+        The <a href="https://registry.khronos.org/OpenXR/specs/1.0/html/xrspec.html\#XR_KHR_opengl_es_enable">XR_KHR_opengl_es_enable</a> extension.
+
+        This extension must be provided by runtimes supporting applications using OpenGL ES APIs for rendering. OpenGL ES applications need this extension to obtain compatible swapchain images which the runtime is required to supply. The runtime needs the following OpenGL ES objects from the application in order to interact properly with the OpenGL ES driver: EGLDisplay, EGLConfig and EGLContext.
+
+        These are passed from the application to the runtime in a ##XrGraphicsBindingOpenGLESAndroidKHR structure when creating the {@code XrSession}. Although not restricted to Android, the OpenGL ES extension is currently tailored for Android.
+
+        Note that the application is responsible for creating the required OpenGL ES objects, including an OpenGL ES context to be used for rendering.
+
+        This extension also provides mechanisms for the application to interact with images acquired by calling #EnumerateSwapchainImages().
+
+        In order to expose the structures, types, and functions of this extension, the application source code <b>must</b> define #USE_GRAPHICS_API_OPENGL_ES, as well as an appropriate <a target="_blank" href="https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html\#window-system-header-control">window system define</a>, before including the OpenXR platform header {@code openxr_platform.h}, in all portions of your library or application that include it. The only window system define currently supported by this extension is:
+
+        <ul>
+            <li>#USE_PLATFORM_ANDROID</li>
+        </ul>
+        """
+
+    IntConstant(
+        "The extension specification version.",
+
+        "KHR_opengl_es_enable_SPEC_VERSION".."8"
+    )
+
+    StringConstant(
+        "The extension name.",
+
+        "KHR_OPENGL_ES_ENABLE_EXTENSION_NAME".."XR_KHR_opengl_es_enable"
+    )
+
+    EnumConstant(
+        "Extends {@code XrStructureType}.",
+
+        "TYPE_GRAPHICS_BINDING_OPENGL_ES_ANDROID_KHR".."1000024001",
+        "TYPE_SWAPCHAIN_IMAGE_OPENGL_ES_KHR".."1000024002",
+        "TYPE_GRAPHICS_REQUIREMENTS_OPENGL_ES_KHR".."1000024003"
+    )
+
+    XrResult(
+        "GetOpenGLESGraphicsRequirementsKHR",
+        """
+        Retrieve the OpenGL ES version requirements for an instance and system.
+
+        <h5>C Specification</h5>
+        To query OpenGL ES API version requirements for an instance and system, call:
+
+        <pre><code>
+XrResult xrGetOpenGLESGraphicsRequirementsKHR(
+    XrInstance                                  instance,
+    XrSystemId                                  systemId,
+    XrGraphicsRequirementsOpenGLESKHR*          graphicsRequirements);</code></pre>
+
+        <h5>Description</h5>
+        The #GetOpenGLESGraphicsRequirementsKHR() function identifies to the application the minimum OpenGL ES version requirement and the highest known tested OpenGL ES version. The runtime <b>must</b> return #ERROR_GRAPHICS_REQUIREMENTS_CALL_MISSING (#ERROR_VALIDATION_FAILURE <b>may</b> be returned due to legacy behavior) on calls to #CreateSession() if #GetOpenGLESGraphicsRequirementsKHR() has not been called for the same {@code instance} and {@code systemId}.
+
+        <h5>Valid Usage (Implicit)</h5>
+        <ul>
+            <li>The {@link KHROpenGLESEnable XR_KHR_opengl_es_enable} extension <b>must</b> be enabled prior to calling #GetOpenGLESGraphicsRequirementsKHR()</li>
+            <li>{@code instance} <b>must</b> be a valid {@code XrInstance} handle</li>
+            <li>{@code graphicsRequirements} <b>must</b> be a pointer to an ##XrGraphicsRequirementsOpenGLESKHR structure</li>
+        </ul>
+
+        <h5>Return Codes</h5>
+        <dl>
+            <dt>On success, this command returns</dt>
+            <dd><ul>
+                <li>#SUCCESS</li>
+            </ul></dd>
+
+            <dt>On failure, this command returns</dt>
+            <dd><ul>
+                <li>#ERROR_FUNCTION_UNSUPPORTED</li>
+                <li>#ERROR_VALIDATION_FAILURE</li>
+                <li>#ERROR_RUNTIME_FAILURE</li>
+                <li>#ERROR_HANDLE_INVALID</li>
+                <li>#ERROR_INSTANCE_LOST</li>
+                <li>#ERROR_SYSTEM_INVALID</li>
+            </ul></dd>
+        </dl>
+
+        <h5>See Also</h5>
+        ##XrGraphicsRequirementsOpenGLESKHR
+        """,
+
+        XrInstance("instance", "an {@code XrInstance} handle previously created with #CreateInstance()."),
+        XrSystemId("systemId", "an {@code XrSystemId} handle for the system which will be used to create a session."),
+        XrGraphicsRequirementsOpenGLESKHR.p("graphicsRequirements", "the ##XrGraphicsRequirementsOpenGLESKHR output structure.")
+    )
+}