From 636f49f4f063d7ad2f411a5bc36109c7890dc58f Mon Sep 17 00:00:00 2001 From: Ioannis Tsakpinis Date: Sat, 16 Dec 2023 18:52:01 +0200 Subject: [PATCH] feat(bgfx) update to API version 124 --- doc/notes/3.3.4.md | 2 +- .../generated/java/org/lwjgl/bgfx/BGFX.java | 32 +++++++++---------- .../templates/kotlin/bgfx/templates/BGFX.kt | 9 ++++-- 3 files changed, 23 insertions(+), 20 deletions(-) diff --git a/doc/notes/3.3.4.md b/doc/notes/3.3.4.md index efd4131e26..e1f008bf39 100644 --- a/doc/notes/3.3.4.md +++ b/doc/notes/3.3.4.md @@ -7,7 +7,7 @@ This build includes the following changes: #### Bindings - Assimp: Updated to 5.3.1 (up from 5.2.5) -- bgfx: Updated to API version 123 (up from 122) +- bgfx: Updated to API version 124 (up from 122) * Windows: support for the Direct3D 9 backend has been dropped. - FMOD: Updated to 2.02.19 (up from 2.02.16) - glfw: Updated to latest 3.3.9 (up from 3.3.8) diff --git a/modules/lwjgl/bgfx/src/generated/java/org/lwjgl/bgfx/BGFX.java b/modules/lwjgl/bgfx/src/generated/java/org/lwjgl/bgfx/BGFX.java index 9cc42457e5..94a42d8913 100644 --- a/modules/lwjgl/bgfx/src/generated/java/org/lwjgl/bgfx/BGFX.java +++ b/modules/lwjgl/bgfx/src/generated/java/org/lwjgl/bgfx/BGFX.java @@ -229,7 +229,7 @@ public static SharedLibrary getLibrary() { } /** API version */ - public static final int BGFX_API_VERSION = 123; + public static final int BGFX_API_VERSION = 124; /** Invalid handle */ public static final short BGFX_INVALID_HANDLE = (short)0xFFFF; @@ -707,23 +707,21 @@ public static SharedLibrary getLibrary() { *
  • {@link #BGFX_RENDERER_TYPE_OPENGLES RENDERER_TYPE_OPENGLES} - OpenGL ES 2.0+
    • *
  • {@link #BGFX_RENDERER_TYPE_OPENGL RENDERER_TYPE_OPENGL} - OpenGL 2.1+
    • *
  • {@link #BGFX_RENDERER_TYPE_VULKAN RENDERER_TYPE_VULKAN} - Vulkan
    • - *
  • {@link #BGFX_BGFX_RENDERER_TYPE_WEBGPU BGFX_RENDERER_TYPE_WEBGPU} - WebGPU
    • *
  • {@link #BGFX_RENDERER_TYPE_COUNT RENDERER_TYPE_COUNT}
    • * */ public static final int - BGFX_RENDERER_TYPE_NOOP = 0, - BGFX_RENDERER_TYPE_AGC = 1, - BGFX_RENDERER_TYPE_DIRECT3D11 = 2, - BGFX_RENDERER_TYPE_DIRECT3D12 = 3, - BGFX_RENDERER_TYPE_GNM = 4, - BGFX_RENDERER_TYPE_METAL = 5, - BGFX_RENDERER_TYPE_NVN = 6, - BGFX_RENDERER_TYPE_OPENGLES = 7, - BGFX_RENDERER_TYPE_OPENGL = 8, - BGFX_RENDERER_TYPE_VULKAN = 9, - BGFX_BGFX_RENDERER_TYPE_WEBGPU = 10, - BGFX_RENDERER_TYPE_COUNT = 11; + BGFX_RENDERER_TYPE_NOOP = 0, + BGFX_RENDERER_TYPE_AGC = 1, + BGFX_RENDERER_TYPE_DIRECT3D11 = 2, + BGFX_RENDERER_TYPE_DIRECT3D12 = 3, + BGFX_RENDERER_TYPE_GNM = 4, + BGFX_RENDERER_TYPE_METAL = 5, + BGFX_RENDERER_TYPE_NVN = 6, + BGFX_RENDERER_TYPE_OPENGLES = 7, + BGFX_RENDERER_TYPE_OPENGL = 8, + BGFX_RENDERER_TYPE_VULKAN = 9, + BGFX_RENDERER_TYPE_COUNT = 10; /** * Access mode ({@code bgfx_access_t}) @@ -1259,7 +1257,7 @@ public static long nbgfx_vertex_layout_begin(long _this, int _renderer) { * Start a vertex layout. * * @param _this the vertex layout - * @param _renderer the renderer backend type. One of:
    {@link #BGFX_RENDERER_TYPE_NOOP RENDERER_TYPE_NOOP}{@link #BGFX_RENDERER_TYPE_AGC RENDERER_TYPE_AGC}{@link #BGFX_RENDERER_TYPE_DIRECT3D11 RENDERER_TYPE_DIRECT3D11}{@link #BGFX_RENDERER_TYPE_DIRECT3D12 RENDERER_TYPE_DIRECT3D12}
    {@link #BGFX_RENDERER_TYPE_GNM RENDERER_TYPE_GNM}{@link #BGFX_RENDERER_TYPE_METAL RENDERER_TYPE_METAL}{@link #BGFX_RENDERER_TYPE_NVN RENDERER_TYPE_NVN}{@link #BGFX_RENDERER_TYPE_OPENGLES RENDERER_TYPE_OPENGLES}
    {@link #BGFX_RENDERER_TYPE_OPENGL RENDERER_TYPE_OPENGL}{@link #BGFX_RENDERER_TYPE_VULKAN RENDERER_TYPE_VULKAN}{@link #BGFX_BGFX_RENDERER_TYPE_WEBGPU BGFX_RENDERER_TYPE_WEBGPU}{@link #BGFX_RENDERER_TYPE_COUNT RENDERER_TYPE_COUNT}
    + * @param _renderer the renderer backend type. One of:
    {@link #BGFX_RENDERER_TYPE_NOOP RENDERER_TYPE_NOOP}{@link #BGFX_RENDERER_TYPE_AGC RENDERER_TYPE_AGC}{@link #BGFX_RENDERER_TYPE_DIRECT3D11 RENDERER_TYPE_DIRECT3D11}{@link #BGFX_RENDERER_TYPE_DIRECT3D12 RENDERER_TYPE_DIRECT3D12}
    {@link #BGFX_RENDERER_TYPE_GNM RENDERER_TYPE_GNM}{@link #BGFX_RENDERER_TYPE_METAL RENDERER_TYPE_METAL}{@link #BGFX_RENDERER_TYPE_NVN RENDERER_TYPE_NVN}{@link #BGFX_RENDERER_TYPE_OPENGLES RENDERER_TYPE_OPENGLES}
    {@link #BGFX_RENDERER_TYPE_OPENGL RENDERER_TYPE_OPENGL}{@link #BGFX_RENDERER_TYPE_VULKAN RENDERER_TYPE_VULKAN}{@link #BGFX_RENDERER_TYPE_COUNT RENDERER_TYPE_COUNT}
    * * @return itself */ @@ -1688,7 +1686,7 @@ public static long nbgfx_get_renderer_name(int _type) { /** * Returns name of renderer. * - * @param _type the renderer type. One of:
    {@link #BGFX_RENDERER_TYPE_NOOP RENDERER_TYPE_NOOP}{@link #BGFX_RENDERER_TYPE_AGC RENDERER_TYPE_AGC}{@link #BGFX_RENDERER_TYPE_DIRECT3D11 RENDERER_TYPE_DIRECT3D11}{@link #BGFX_RENDERER_TYPE_DIRECT3D12 RENDERER_TYPE_DIRECT3D12}
    {@link #BGFX_RENDERER_TYPE_GNM RENDERER_TYPE_GNM}{@link #BGFX_RENDERER_TYPE_METAL RENDERER_TYPE_METAL}{@link #BGFX_RENDERER_TYPE_NVN RENDERER_TYPE_NVN}{@link #BGFX_RENDERER_TYPE_OPENGLES RENDERER_TYPE_OPENGLES}
    {@link #BGFX_RENDERER_TYPE_OPENGL RENDERER_TYPE_OPENGL}{@link #BGFX_RENDERER_TYPE_VULKAN RENDERER_TYPE_VULKAN}{@link #BGFX_BGFX_RENDERER_TYPE_WEBGPU BGFX_RENDERER_TYPE_WEBGPU}{@link #BGFX_RENDERER_TYPE_COUNT RENDERER_TYPE_COUNT}
    + * @param _type the renderer type. One of:
    {@link #BGFX_RENDERER_TYPE_NOOP RENDERER_TYPE_NOOP}{@link #BGFX_RENDERER_TYPE_AGC RENDERER_TYPE_AGC}{@link #BGFX_RENDERER_TYPE_DIRECT3D11 RENDERER_TYPE_DIRECT3D11}{@link #BGFX_RENDERER_TYPE_DIRECT3D12 RENDERER_TYPE_DIRECT3D12}
    {@link #BGFX_RENDERER_TYPE_GNM RENDERER_TYPE_GNM}{@link #BGFX_RENDERER_TYPE_METAL RENDERER_TYPE_METAL}{@link #BGFX_RENDERER_TYPE_NVN RENDERER_TYPE_NVN}{@link #BGFX_RENDERER_TYPE_OPENGLES RENDERER_TYPE_OPENGLES}
    {@link #BGFX_RENDERER_TYPE_OPENGL RENDERER_TYPE_OPENGL}{@link #BGFX_RENDERER_TYPE_VULKAN RENDERER_TYPE_VULKAN}{@link #BGFX_RENDERER_TYPE_COUNT RENDERER_TYPE_COUNT}
    */ @Nullable @NativeType("char const *") @@ -2830,6 +2828,8 @@ public static short nbgfx_create_shader(long _mem) { /** * Creates shader from memory buffer. + * + *

    Shader binary is obtained by compiling shader offline with shaderc command line tool.

    * * @return shader handle */ diff --git a/modules/lwjgl/bgfx/src/templates/kotlin/bgfx/templates/BGFX.kt b/modules/lwjgl/bgfx/src/templates/kotlin/bgfx/templates/BGFX.kt index 679d6e7fdc..85c9fb8ca6 100644 --- a/modules/lwjgl/bgfx/src/templates/kotlin/bgfx/templates/BGFX.kt +++ b/modules/lwjgl/bgfx/src/templates/kotlin/bgfx/templates/BGFX.kt @@ -14,7 +14,7 @@ val BGFX = "BGFX".nativeClass(Module.BGFX, prefix = "BGFX", prefixMethod = "bgfx IntConstant( "API version", - "API_VERSION".."123" + "API_VERSION".."124" ) ShortConstant( @@ -563,7 +563,6 @@ val BGFX = "BGFX".nativeClass(Module.BGFX, prefix = "BGFX", prefixMethod = "bgfx "RENDERER_TYPE_OPENGLES".enum("OpenGL ES 2.0+"), "RENDERER_TYPE_OPENGL".enum("OpenGL 2.1+"), "RENDERER_TYPE_VULKAN".enum("Vulkan"), - "BGFX_RENDERER_TYPE_WEBGPU".enum("WebGPU"), "RENDERER_TYPE_COUNT".enum ).javaDocLinks @@ -1457,7 +1456,11 @@ RGBA16S bgfx_shader_handle_t( "create_shader", - "Creates shader from memory buffer.", + """ + Creates shader from memory buffer. + + Shader binary is obtained by compiling shader offline with shaderc command line tool. + """, bgfx_memory_t.const.p("_mem", ""),