Example which renders RGBA color wheel, alpha gradient and full value channel textures to catch conversion errors and bad internal type representations between different backend renderers.

The example uses bimg to convert from a master texture to different textures.

Each texture is rendered in an ImGui list using ImGui::Image. A close-up is visible when hovering over each image.

U and I textures are skipped because they don't work for sampling. Compressed textures are skipped because they don't have conversion functions. Depth textures are not rendered because they don't work with channels.

Note: The screenshot shows existing bugs (ref: https://github.com/bkaradzic/bx/issues/282 #2866) and was taken in OpenGL

Hello, i've successfully compiled all the examples (amazing work btw), and run some of them on a Raspberry PI 3. The example 20 is very very slow on the raspberry pi 3, but it seems that is actually using the proper OpenGLES renderer, not a simulated one.

Do you have any clue?

Thanks

Edit: 2019-08-01 - I reopened this pull request as one commit.

First of all, I would like to thank you for producing a light-weight but great renderer. I am working in the image and video graphics field, and decided to integrate the BGFX renderer into my engine.

Additionally, I think that it would be very nice if the BGFX could be executed with the Vulkan backend everywhere (#274), so I decided to do additional implementation of the vulkan backend, and this pull request is the draft of the implementation.

Major changes

The macOS-vulkan support setting (thanks to MoltenVK!)

• KHR_SURFACE_EXTENSION_NAME and VK_IMPORT_INSTANCE_PLATFORM for BX_PLATFORM_OSX are defined.
• libvulkan.dylib would be loaded for BX_PLATFORM_OSX.
• The surface creation code is implemented by referring to renderer_mtl.mm.

Surface format

• Figure out whether VK_FORMAT_R8G8B8A8_UNORM or VK_FORMAT_R8G8B8A8_UNORM is supported, and use it for surface texture format.
• Currently depth-stencil format is fixed to VK_FORMAT_D24_UNORM_S8_UINT.

The order of steps in the initialization is arranged

• The render pass creation step is moved after the swapchain image view creation.

The number of swapchain image

• While the array size of the swapchain image is fixed to 4, the number of swapchain image provided by the vulkan device can be less than that. (e.g. android device)
• Thus, the swapchain image views, framebuffers, semaphores, and command buffers are created with the suggested number of the swapchain image for the surface.

Descriptor set binding index

• I've encountered the validation error when I tried to use the shader with texture, and the error message said that the descriptor set binding index should be different from the others.
• So I've decided to modify the SPIR-V shader compiler in order to automatically set descriptor binding index.

// shaderc_spirv.cpp, line 639
shader->setEntryPoint("main");
shader->setAutoMapBindings(true);
uint32_t bindingOffset = (stage == EShLanguage::EShLangFragment ? 48 : 0);
shader->setShiftBinding(glslang::EResUbo, bindingOffset);
shader->setShiftBinding(glslang::EResTexture, bindingOffset + 16);
shader->setShiftBinding(glslang::EResSampler, bindingOffset + 32);

• By using this code, the binding indices the UBO, texture, and sampler for a vertex shader would be started from 0, 16, 32 respectively, and those for a fragement shader would be started from 48, 64, 80.

Descriptor set layout and pipeline layout

• Because I could not find the way to convert a separated image into the combined image sampler in the vulkan, I have to bind both of image and its sampler with VkDescriptorImageInfo.
• And the other uniforms seem to be a structure and it can be feeded with VkDescriptorBufferInfo
• And all of those binding infomation should be included in the one descriptor set layout.
• So the descriptor set bindings for each shader are set in its shader creation process, and the descriptor set layout is created and cached during the program creation.
• Then the pipeline layout is created for the cached descriptor set layout. I think that it also be cached, but don't tried yet.

Uniform size for ubo structure

• While the uniform array (e.g. u_model[32]) used in the GLSL shader can be optimized during compilation, the SPIR-V compilation does not reduce its size because it combined with the other uniforms as a structure form.
• So I changed the calculation method of the size of UBO as below:

// shaderc_spirv.cpp, line 594
if (un.type != UniformType::Sampler)
	size = bx::max(size, (uint16_t)(un.regIndex + un.regCount*16));

Sampler stage index

• Some code is written for getting the samplers stage index.
• Then it is stored as a location of the uniform.
• Now a sampler uniform uses all storage for loc, regIndex, regCount in order to store stageIndex, imageBindingIndex, samplerBindingIndex, respectively.

Texture and buffer

• I referred to D3D12 renderer implementation.
• The memory of texture images and vertex buffers is allocated for device access by default.
• Thus the staging buffers are used in order to copy its contents from host memory into device memory.

Current status

• I've tested on windows 10, macOS.
• I've succeeded to execute example 01, 02, 03, 04, 06, 07, 10, 11, 12, 13, and 14, even though some examples does not correctly.
• Note that shaders in examples should be rebuilt by using the modified SPIR-V shader compiler.

Next work

• Debug text and image (the most important, I think!)
• Cube map support
• Framebuffer support
• Instancing

I'd like to listen your advise about how to implement the things above, especially debug text. Please leave the comment!

Thank you for reading!

On certain platforms where the building/running the examples requires some manual step ( like iOS/OSX or android). It would be great to have a mega example that includes all current examples and lets the user select which example to start. This way with only one setup/build/install step a user could check every example.

This app also could be uploaded to the googleplay/iOS store, so interested developers can check it.

As a proof of concept I have implemented it here: https://gist.github.com/attilaz/410a4543020da4de11c62c00ec098c77

It worked well. Only minor modification were needed in the current examples( adding #ifndef SKIP_ENTRY_IMPLEMENT_MAIN ) around ENTRY_IMPLEMENT_MAIN.

The only limitation I have found with this implementation is name collision. With certain examples I get errors like this: 's_cubeVertices' : redefinition; different subscripts.

I think this could be solved: A. putting every example code into a separate namespace. ( needs modification for examples ) B. Instead of including cpp files the project file could include every examples' cpp. (needs a genie script to generate this)

Adding a "back"/"quit" button to examples to step back to the selector screen also could be handy.

Hi. I've created a simple example in https://github.com/TamToucan/bgfx/blob/master/examples/XX-map/map.cpp

which reproduces the problem I'm having. NOTE: I am running on Windows using OPENGL (the example is hard-coded to OpenGL and the shaders have only been compiled for glsl)

The rendering does the following

1. map view - Render part of a large texture to the FBO.
2. sprite view - Renders 3 sprites to the FBO using a vertex buffer containing the 4 corners of each sprite and an index buffer to create the 6 vertices for the 2 triangles for each sprite.
3. screen view - The texture from the FBO is rendered to the screen

Everything works fine, but in the example I only perform step(2) if Space is pressed, when space isn't pressed then nothing is done using the sprite view i.e. the transient vertex buffer containing the sprite data isn't created, the sprite shader program isn't used etc.

The problem is when Space is then released I get a crash inside the ATI graphics driver DLL. I've been trying to step through the internals of BGFX, but I'm getting no where. Running with CodeXL gives

"The thread tried to read or write data that is misaligned on hardware that does not provide alignment. For example, 16-bit values must be aligned on 2-byte boundaries; 32-bit values on 4-byte boundaries, and so on."

Regards, Tam.

Hi, I have one user who consistently crashes in bgfx::init(). Do you think this might be a bug in bgfx? Of course, it's also possible the user just has bad drivers. If you think so, feel free to close. He can run other games though.

I managed to extract this info from a .dmp. I didn't include the purported argument values because they seemed to be garbage. (s_ctx NULL right after a NULL check.) The call stack looks plausible, though.

Operating system: Windows NT
                  6.1.7601 Service Pack 1
CPU: x86
     GenuineIntel family 6 model 15 stepping 11
     2 CPUs

Crash reason:  EXCEPTION_ACCESS_VIOLATION_READ
Crash address: 0x24

Thread 1:
ntdll!ZwWaitForSingleObject+0x15
KERNELBASE!WaitForSingleObjectEx+0x98
kernel32!WaitForSingleObjectExImplementation+0x75
kernel32!WaitForSingleObject+0x12
bgfx::Context::frame+0x26 [bgfx\src\bgfx.cpp @ 1412]
bgfx::Context::init+0x175 [bgfx\src\bgfx.cpp @ 1209]
bgfx::init+0xe2 [bgfx\src\bgfx.cpp @ 2384]
(...snip...)

Thread 2 (Crashed):
d3d11!CContext::ID3D11DeviceContext1_Begin_<1>+0x8
bgfx::d3d11::TimerQueryD3D11::begin+0xdf [bgfx\src\renderer_d3d11.cpp @ 4575]
bgfx::d3d11::RendererContextD3D11::submit+0x93 [bgfx\src\renderer_d3d11.cpp @ 4702]
bgfx::Context::renderFrame+0xb6 [bgfx\src\bgfx.cpp @ 1502]
bgfx::renderFrame+0x32 [bgfx\src\bgfx.cpp @ 992]
bgfx::Context::renderThread+0x5 [bgfx\src\bgfx_p.h @ 2102]
bx::Thread::threadFunc+0x25 [bx\include\bx\thread.h @ 201]
kernel32!BaseThreadInitThunk+0xe
ntdll!__RtlUserThreadStart+0x70
ntdll!_RtlUserThreadStart+0x1b

Hi,

I think I discovered some issue with the autorelease pool in the OSX Metal backend. If I call bgfx::RenderFrame() before calling bgfx::Init() (both on the same thread) to init single threaded mode, bgfx crashes inside renderer_metal.mm in the flip() function on line 1135 where the autorelease pool is released.

The console tells this: "Invalid or prematurely-freed autorelease pool".

If bgfx runs in multi threaded mode everything seems fine.

Just integrating https://github.com/Celtoys/Remotery into my code, and I noticed I would have to add the macros into the bgfx code myself if I was running multi-threaded.

I was wondering if you could provide a simple profiling hook into the render function if it's running multi-threaded?

Provides a simple example to demonstrate real-time hex tiling, mainly a simple port of what is done here https://github.com/mmikk/hextile-demo

https://github.com/bkaradzic/bgfx/issues/2842

This has been tested on windows (dx11/opengl)

Hi, most of the other samples work, but the hello world sample doesn't display anything other than a grey background. The metaballs example is also missing the debug text that's in the screenshot. I built the project from the command line using GNU Make, and that appeared to work without any errors. I then compiled using Visual Studio 2013. Initially it failed to compile complaining about Direct3D9 stuff, but I downloaded the 2010 DirectX SDK and set the environment variable for that, and after that it compiled.

Here's the debug output. I don't see any obvious errors occurring...

'example-00-helloworldDebug.exe' (Win32): Loaded 'D:\Dropbox\Work\Game Dev\Libs\bgfx\.build\win64_vs2013\bin\example-00-helloworldDebug.exe'. Symbols loaded.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\ntdll.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\kernel32.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\KernelBase.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\gdi32.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\user32.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\imm32.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\msctf.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\msvcrt.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\XInput9_1_0.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\uxtheme.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\combase.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\rpcrt4.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Program Files\Common Files\microsoft shared\ink\tiptsf.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\oleaut32.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\dwmapi.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\ole32.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\sechost.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\kernel.appcore.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\cryptbase.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\bcryptprimitives.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\oleacc.dll'. Cannot find or open the PDB file.
..\..\..\src\bgfx.cpp(1977): BGFX Init...
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\XInput1_4.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\cfgmgr32.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\devobj.dll'. Cannot find or open the PDB file.
..\..\..\src\bgfx.cpp(959): BGFX Creating rendering thread.
d:\dropbox\work\game dev\libs\bgfx\src\bgfx_p.h(1913): BGFX render thread start
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\d3d11.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\dxgi.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\d3d9.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\version.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\clbcatq.dll'. Cannot find or open the PDB file.
..\..\..\src\renderer_d3d11.cpp(521): BGFX Adapter #0
..\..\..\src\renderer_d3d11.cpp(525): BGFX  Description: NVIDIA GeForce GTX 670
..\..\..\src\renderer_d3d11.cpp(531): BGFX  VendorId: 0x000010de, DeviceId: 0x00001189, SubSysId: 0x35421458, Revision: 0x000000a1
..\..\..\src\renderer_d3d11.cpp(536): BGFX  Memory: 2082140160 (video), 0 (system), 2147807232 (shared)
..\..\..\src\renderer_d3d11.cpp(521): BGFX Adapter #1
..\..\..\src\renderer_d3d11.cpp(525): BGFX  Description: Microsoft Basic Render Driver
..\..\..\src\renderer_d3d11.cpp(531): BGFX  VendorId: 0x00001414, DeviceId: 0x0000008c, SubSysId: 0x00000000, Revision: 0x00000000
..\..\..\src\renderer_d3d11.cpp(536): BGFX  Memory: 0 (video), 0 (system), 268435456 (shared)
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\dxgidebug.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\nvwgf2umx.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\psapi.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\advapi32.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\bcrypt.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\shell32.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\shlwapi.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\SHCore.dll'. Cannot find or open the PDB file.
The thread 0x680c has exited with code 0 (0x0).
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\nvspcap64.dll'. Cannot find or open the PDB file.
'example-00-helloworldDebug.exe' (Win32): Loaded 'C:\Windows\System32\d3d11_2sdklayers.dll'. Cannot find or open the PDB file.
..\..\..\src\renderer_d3d11.cpp(601): BGFX D3D device 11.3, hr 0
..\..\..\src\bgfx.cpp(262): BGFX Graphics debugger is present.
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BE1FFB0, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
D3D11 INFO: Destroy ID3D11Buffer: Name="unnamed", Addr=0x000000510BE1FFB0 [ STATE_CREATION INFO #2097230: DESTROY_BUFFER]
D3D11 INFO: Create ID3D11RenderTargetView: Name="unnamed", Addr=0x000000510BE20030, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097243: CREATE_RENDERTARGETVIEW]
D3D11 INFO: Create ID3D11Texture2D: Name="unnamed", Addr=0x000000510BE1E6E0, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097234: CREATE_TEXTURE2D]
D3D11 INFO: Create ID3D11DepthStencilView: Name="unnamed", Addr=0x000000510BE1E250, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097246: CREATE_DEPTHSTENCILVIEW]
..\..\..\src\bgfx.cpp(895): BGFX Supported capabilities (Direct3D 11):
..\..\..\src\bgfx.cpp(900): BGFX    BGFX_CAPS_TEXTURE_COMPARE_LEQUAL
..\..\..\src\bgfx.cpp(900): BGFX    BGFX_CAPS_TEXTURE_COMPARE_ALL
..\..\..\src\bgfx.cpp(900): BGFX    BGFX_CAPS_TEXTURE_3D
..\..\..\src\bgfx.cpp(900): BGFX    BGFX_CAPS_VERTEX_ATTRIB_HALF
..\..\..\src\bgfx.cpp(900): BGFX    BGFX_CAPS_INSTANCING
..\..\..\src\bgfx.cpp(900): BGFX    BGFX_CAPS_RENDERER_MULTITHREADED
..\..\..\src\bgfx.cpp(900): BGFX    BGFX_CAPS_FRAGMENT_DEPTH
..\..\..\src\bgfx.cpp(900): BGFX    BGFX_CAPS_BLEND_INDEPENDENT
..\..\..\src\bgfx.cpp(900): BGFX    BGFX_CAPS_COMPUTE
..\..\..\src\bgfx.cpp(900): BGFX    BGFX_CAPS_SWAP_CHAIN
..\..\..\src\bgfx.cpp(904): BGFX Supported texture formats:
..\..\..\src\bgfx.cpp(914): BGFX    [x] BC1
..\..\..\src\bgfx.cpp(914): BGFX    [x] BC2
..\..\..\src\bgfx.cpp(914): BGFX    [x] BC3
..\..\..\src\bgfx.cpp(914): BGFX    [x] BC4
..\..\..\src\bgfx.cpp(914): BGFX    [x] BC5
..\..\..\src\bgfx.cpp(914): BGFX    [x] BC6H
..\..\..\src\bgfx.cpp(914): BGFX    [x] BC7
..\..\..\src\bgfx.cpp(914): BGFX    [*] ETC1
..\..\..\src\bgfx.cpp(914): BGFX    [*] ETC2
..\..\..\src\bgfx.cpp(914): BGFX    [*] ETC2A
..\..\..\src\bgfx.cpp(914): BGFX    [*] ETC2A1
..\..\..\src\bgfx.cpp(914): BGFX    [ ] PTC12
..\..\..\src\bgfx.cpp(914): BGFX    [*] PTC14
..\..\..\src\bgfx.cpp(914): BGFX    [ ] PTC12A
..\..\..\src\bgfx.cpp(914): BGFX    [*] PTC14A
..\..\..\src\bgfx.cpp(914): BGFX    [ ] PTC22
..\..\..\src\bgfx.cpp(914): BGFX    [ ] PTC24
..\..\..\src\bgfx.cpp(914): BGFX    [x] R1
..\..\..\src\bgfx.cpp(914): BGFX    [x] R8
..\..\..\src\bgfx.cpp(914): BGFX    [x] R16
..\..\..\src\bgfx.cpp(914): BGFX    [x] R16F
..\..\..\src\bgfx.cpp(914): BGFX    [x] R32
..\..\..\src\bgfx.cpp(914): BGFX    [x] R32F
..\..\..\src\bgfx.cpp(914): BGFX    [x] RG8
..\..\..\src\bgfx.cpp(914): BGFX    [x] RG16
D3D11 INFO: Create ID3D11Texture2D: Name="unnamed", Addr=0x000000510BE45C10, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097234: CREATE_TEXTURE2D]
..\..\..\src\bgfx.cpp(914): BGFX    [x] RG16F
..\..\..\src\bgfx.cpp(914): BGFX    [x] RG32
..\..\..\src\bgfx.cpp(914): BGFX    [x] RG32F
..\..\..\src\bgfx.cpp(914): BGFX    [x] BGRA8
..\..\..\src\bgfx.cpp(914): BGFX    [x] RGBA16
..\..\..\src\bgfx.cpp(914): BGFX    [x] RGBA16F
..\..\..\src\bgfx.cpp(914): BGFX    [x] RGBA32
..\..\..\src\bgfx.cpp(914): BGFX    [x] RGBA32F
..\..\..\src\bgfx.cpp(914): BGFX    [x] R5G6B5
..\..\..\src\bgfx.cpp(914): BGFX    [x] RGBA4
..\..\..\src\bgfx.cpp(914): BGFX    [x] RGB5A1
..\..\..\src\bgfx.cpp(914): BGFX    [x] RGB10A2
..\..\..\src\bgfx.cpp(914): BGFX    [x] R11G11B10F
..\..\..\src\bgfx.cpp(914): BGFX    [x] D16
..\..\..\src\bgfx.cpp(914): BGFX    [x] D24
..\..\..\src\bgfx.cpp(914): BGFX    [x] D24S8
..\..\..\src\bgfx.cpp(914): BGFX    [x] D32
..\..\..\src\bgfx.cpp(914): BGFX    [x] D16F
..\..\..\src\bgfx.cpp(914): BGFX    [x] D24F
..\..\..\src\bgfx.cpp(914): BGFX    [x] D32F
..\..\..\src\bgfx.cpp(914): BGFX    [x] D0S8
..\..\..\src\bgfx.cpp(919): BGFX Max FB attachments: 8
d:\dropbox\work\game dev\libs\bgfx\src\bgfx_p.h(2930): BGFX Creating uniform (handle   0) bgfx_clear_color
D3D11 INFO: Create ID3D11Sampler: Name="unnamed", Addr=0x000000510BE07220, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097267: CREATE_SAMPLER]
..\..\..\src\renderer_d3d11.cpp(2615): BGFX Texture   0: R8 (requested: R8), 2048x24.
D3D11 INFO: Create ID3D11Texture2D: Name="unnamed", Addr=0x000000510BE0B710, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097234: CREATE_TEXTURE2D]
D3D11 INFO: Create ID3D11ShaderResourceView: Name="unnamed", Addr=0x000000510BE0ED20, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097240: CREATE_SHADERRESOURCEVIEW]
..\..\..\src\renderer_d3d11.cpp(2424): BGFX Vertex Shader consts 1
..\..\..\src\renderer_d3d11.cpp(2485): BGFX     predefined: u_modelViewProj (mat4), num  0, r.index 2528, r.count  4
D3D11 INFO: Create ID3D11VertexShader: Name="unnamed", Addr=0x000000510BE6F560, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097249: CREATE_VERTEXSHADER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BE729F0, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
..\..\..\src\renderer_d3d11.cpp(2424): BGFX Fragment Shader consts 0
D3D11 INFO: Create ID3D11PixelShader: Name="unnamed", Addr=0x000000510BE35B60, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097261: CREATE_PIXELSHADER]
vertexdecl acb2facc (92a03374), stride 28
    attr 0 - Attrib::Position, num 3, type 3, norm 0, asint 0, offset 0
    attr 4 - Attrib::Color0, num 4, type 0, norm 1, asint 0, offset 12
    attr 5 - Attrib::Color1, num 4, type 0, norm 1, asint 0, offset 16
    attr 8 - Attrib::TexCoord0, num 2, type 3, norm 0, asint 0, offset 20
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BE44760, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BE39B10, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
..\..\..\src\renderer_d3d11.cpp(2424): BGFX Vertex Shader consts 0
D3D11 INFO: Create ID3D11VertexShader: Name="unnamed", Addr=0x000000510BE410D0, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097249: CREATE_VERTEXSHADER]
..\..\..\src\renderer_d3d11.cpp(2424): BGFX Fragment Shader consts 1
..\..\..\src\renderer_d3d11.cpp(2485): BGFX     user: bgfx_clear_color (vec2), num  8, r.index   0, r.count  8
D3D11 INFO: Create ID3D11PixelShader: Name="unnamed", Addr=0x000000510BEDFA90, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097261: CREATE_PIXELSHADER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510E5C2480, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
..\..\..\src\renderer_d3d11.cpp(2424): BGFX Fragment Shader consts 1
..\..\..\src\renderer_d3d11.cpp(2485): BGFX     user: bgfx_clear_color (vec2), num  8, r.index   0, r.count  8
D3D11 INFO: Create ID3D11PixelShader: Name="unnamed", Addr=0x000000510BE4AB60, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097261: CREATE_PIXELSHADER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BE4AF30, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
..\..\..\src\renderer_d3d11.cpp(2424): BGFX Fragment Shader consts 1
..\..\..\src\renderer_d3d11.cpp(2485): BGFX     user: bgfx_clear_color (vec2), num  8, r.index   0, r.count  8
D3D11 INFO: Create ID3D11PixelShader: Name="unnamed", Addr=0x000000510BE4BF10, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097261: CREATE_PIXELSHADER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BE48F50, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
..\..\..\src\renderer_d3d11.cpp(2424): BGFX Fragment Shader consts 1
..\..\..\src\renderer_d3d11.cpp(2485): BGFX     user: bgfx_clear_color (vec2), num  8, r.index   0, r.count  8
D3D11 INFO: Create ID3D11PixelShader: Name="unnamed", Addr=0x000000510BEA5B10, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097261: CREATE_PIXELSHADER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BEA08C0, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
..\..\..\src\renderer_d3d11.cpp(2424): BGFX Fragment Shader consts 1
..\..\..\src\renderer_d3d11.cpp(2485): BGFX     user: bgfx_clear_color (vec2), num  8, r.index   0, r.count  8
D3D11 INFO: Create ID3D11PixelShader: Name="unnamed", Addr=0x000000510BEA1A00, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097261: CREATE_PIXELSHADER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BEDE000, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
..\..\..\src\renderer_d3d11.cpp(2424): BGFX Fragment Shader consts 1
..\..\..\src\renderer_d3d11.cpp(2485): BGFX     user: bgfx_clear_color (vec2), num  8, r.index   0, r.count  8
D3D11 INFO: Create ID3D11PixelShader: Name="unnamed", Addr=0x000000510BE798C0, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097261: CREATE_PIXELSHADER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BE7A420, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
..\..\..\src\renderer_d3d11.cpp(2424): BGFX Fragment Shader consts 1
..\..\..\src\renderer_d3d11.cpp(2485): BGFX     user: bgfx_clear_color (vec2), num  8, r.index   0, r.count  8
D3D11 INFO: Create ID3D11PixelShader: Name="unnamed", Addr=0x000000510BE7AC10, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097261: CREATE_PIXELSHADER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BED88D0, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
..\..\..\src\renderer_d3d11.cpp(2424): BGFX Fragment Shader consts 1
..\..\..\src\renderer_d3d11.cpp(2485): BGFX     user: bgfx_clear_color (vec2), num  8, r.index   0, r.count  8
D3D11 INFO: Create ID3D11PixelShader: Name="unnamed", Addr=0x000000510BED1B90, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097261: CREATE_PIXELSHADER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BED2790, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
vertexdecl 623c7ad8 (54fc4dc5), stride 12
    attr 0 - Attrib::Position, num 3, type 3, norm 0, asint 0, offset 0
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BEBD370, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510E6B4F70, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BED7640, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
..\..\..\src\bgfx.cpp(2013): BGFX Init complete.
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BED8280, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
D3D11 INFO: Create ID3D11Buffer: Name="unnamed", Addr=0x000000510BEA4EB0, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097228: CREATE_BUFFER]
D3D11 INFO: Destroy ID3D11RenderTargetView: Name="unnamed", Addr=0x000000510BE20030 [ STATE_CREATION INFO #2097245: DESTROY_RENDERTARGETVIEW]
D3D11 INFO: Destroy ID3D11Texture2D: Name="unnamed", Addr=0x000000510BE170E0 [ STATE_CREATION INFO #2097236: DESTROY_TEXTURE2D]
D3D11 INFO: Create ID3D11Texture2D: Name="unnamed", Addr=0x000000510BE170E0, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097234: CREATE_TEXTURE2D]
D3D11 INFO: Create ID3D11RenderTargetView: Name="unnamed", Addr=0x000000510BEB2710, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097243: CREATE_RENDERTARGETVIEW]
D3D11 INFO: Create ID3D11Texture2D: Name="unnamed", Addr=0x000000510BEB0FA0, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097234: CREATE_TEXTURE2D]
D3D11 INFO: Create ID3D11DepthStencilView: Name="unnamed", Addr=0x000000510BEB1550, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097246: CREATE_DEPTHSTENCILVIEW]
D3D11 INFO: Create ID3D11BlendState: Name="unnamed", Addr=0x000000510BEC2760, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097270: CREATE_BLENDSTATE]
D3D11 INFO: Create ID3D11DepthStencilState: Name="unnamed", Addr=0x000000510BEB2930, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097273: CREATE_DEPTHSTENCILSTATE]
D3D11 INFO: Create ID3D11RasterizerState: Name="unnamed", Addr=0x000000510BEB2D80, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097276: CREATE_RASTERIZERSTATE]
D3D11 INFO: Create ID3D11DepthStencilState: Name="unnamed", Addr=0x000000510BEB6160, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097273: CREATE_DEPTHSTENCILSTATE]
D3D11 INFO: Create ID3D11InputLayout: Name="unnamed", Addr=0x000000510BE4E330, ExtRef=1, IntRef=0 [ STATE_CREATION INFO #2097264: CREATE_INPUTLAYOUT]
D3D11 INFO: Destroy ID3D11DepthStencilView: Name="unnamed", Addr=0x000000510BE1E250 [ STATE_CREATION INFO #2097248: DESTROY_DEPTHSTENCILVIEW]
D3D11 INFO: Destroy ID3D11Texture2D: Name="unnamed", Addr=0x000000510BE1E6E0 [ STATE_CREATION INFO #2097236: DESTROY_TEXTURE2D]

This addresses a subtle bug when the sequence of blit operations contains 2 consecutive copies like so: A -> B, C -> A (src of a blit becomes dst of next blit) A -> B, B -> C (dst of a blit becomes src of next blit) A -> B, B -> A (dst and src of blit are swapped in the next one)

The last case is necessary to implement blitting part of an image (A) into itself (using B as intermediate). The code as currently written triggers a validation error because B is transitioned back to its original layout (instead of staying src layout) in the second blit.

OpenGL has glCopyBufferSubData

https://registry.khronos.org/OpenGL-Refpages/gl4/html/glCopyBufferSubData.xhtml

I could have a crack at making an OpenGl implementation of this feature but I have no idea as to how to approach the other backends.

Proposed api:

bgfx::copyBuffer( VB bufferA, VB bufferB,  size_t byteStart, size_t bytesLen);

Where VB is either a VertexBuffer or a DynamicVertexBuffer.

Describe the bug D3D9 has some pixel format inconsistencies with the rest of the backends

• [ ] R8
• [ ] R16
• [ ] R16F
• [ ] R32F
• [ ] RG8
• [ ] RG16
• [ ] RG16F
• [ ] RG32F
• [ ] RGB9E5

To Reproduce

1. Run example-47-pxielformats --d3d9

Expected behavior All the mentioned formats should match those in --d3d11 mode.

Screenshots

Describe the bug When iteratively resizing a dynamic buffer, after reaching a certain size (around 159K vertices in my case), ram usage explodes.

To Reproduce I am not sure if this is because I am doing something wrong but I can reproduce with this code:

// Include BGFX headers
#include <vector>

void setupView(bgfx::ViewId view, uint16_t width, uint16_t height)
{
    bgfx::setViewClear(view, BGFX_CLEAR_COLOR | BGFX_CLEAR_DEPTH, 0, 1.0f, 0);
    bgfx::setViewRect(view, 0, 0, width, height);
    bgfx::setViewTransform(view, nullptr, nullptr);
}

void resizeBuffer(uint32_t size, std::vector<Vertex>& vertices, std::vector<uint32_t>& indexes)
{
    vertices.resize(size);
    indexes.resize(size);
}

void updateBufferData(std::vector<Vertex>& vertices, std::vector<uint32_t>& indexes, bgfx::DynamicVertexBufferHandle vbh, bgfx::DynamicIndexBufferHandle ibh)
{
    bgfx::update(vbh, 0, bgfx::copy(vertices.data(), vertices.size() * sizeof(Vertex)));
    bgfx::update(ibh, 0, bgfx::copy(indexes.data(), indexes.size() * sizeof(uint32_t)));
}

void setBuffersActive(uint32_t size, bgfx::DynamicVertexBufferHandle vbh, bgfx::DynamicIndexBufferHandle ibh)
{
    bgfx::setVertexBuffer(0, vbh, 0, size);
    bgfx::setIndexBuffer(ibh, 0, size);
}

int32_t main()
{
    // Create application context
    const int32_t window_width  = 1000;
    const int32_t window_height = 1000;

    // Create context
    ....

    std::vector<Vertex>   vertices;
    std::vector<uint32_t> indexes;
    bgfx::DynamicVertexBufferHandle vbh = bgfx::createDynamicVertexBuffer(uint32_t{0}, Vertex::s_layout, BGFX_BUFFER_ALLOW_RESIZE);
    bgfx::DynamicIndexBufferHandle  ibh = bgfx::createDynamicIndexBuffer(uint32_t{0}, BGFX_BUFFER_ALLOW_RESIZE | BGFX_BUFFER_INDEX32);

    bgfx::ProgramHandle program;
    // Initialize shader program
    ....

    uint32_t object_count = 53000;

    while (true)
    {
        const bgfx::ViewId view = 0;
        setupView(view, window_width, window_height);

        // Iteratively increment buffer size
        object_count += object_count < 54000 ? 1 : 0;
        const uint32_t vertex_count = 3 * object_count;

        // Update buffer data
        resizeBuffer(vertex_count, vertices, indexes);
        for (uint32_t i{0}; i<vertex_count; ++i) {
            const float range = 0.1f;
            vertices[i].position = {/* random coords in range [-1, 1] */};
            vertices[i].color    = { random color};
            indexes[i] = i;
        }
        updateBufferData(vertices, indexes, vbh, ibh);

        // Render the triangles
        setBuffersActive(vertex_count, vbh, ibh);
        bgfx::submit(view, shader.m_program);

        bgfx::frame();
    }

    // Close BGFX and free context
    ....
    return 0;
}

Expected behavior I would expect the ram usage to grow linearly (and slowly) with the number of vertex

Screenshots Here is a graph I made with the ram usage of the process depending on the max buffer size.

Additional context

If I directly allocate a dynamic buffer of size 55000 the ram usage is normal (around 110 MB).

I am using an M1 based mac on macOS 12.5 (Monterey).

Thank you for your help.

If the frame buffer contains a depth buffer with MSAA the D3D11 backend will error with e.g. D3D11 ERROR: ID3D11DeviceContext::ResolveSubresource: The Format (0x27, R32_TYPELESS) is never able to resolve multisampled resources. [ RESOURCE_MANIPULATION ERROR #294: DEVICE_RESOLVESUBRESOURCE_FORMAT_INVALID]

I don't know what the proper fix is but something like const bool needResolve = (NULL != m_rt) && !bimg::isDepth(bimg::TextureFormat::Enum(m_textureFormat)); works around it.

Describe the bug Hi, I have use bgfx to render lots of scenes and all of them are runing perfect. Today I got nvidia's bistro scene, which contains hundreds of textures and thousands of mesh, in opengl and directx, the render is OK, but in vulkan, the renderer crashed after loading all the textures.

The error code is maxMemoryAllocationCount when loading, and after loading got this error and crashed: C:\Test\3rdparty\bgfx\src\renderer_vk.cpp (3732): BGFX ASSERT vkAllocateDescriptorSets(m_device, &dsai, &descriptorSet); VK error 0xc4642878: VK_ERROR_OUT_OF_POOL_MEMORY C:\Test\3rdparty\bgfx\src\renderer_vk.cpp (3732): BGFX FATAL 0x00000000: vkAllocateDescriptorSets(m_device, &dsai, &descriptorSet); VK error 0xc4642878: VK_ERROR_OUT_OF_POOL_MEMORY

I've tested if I skip the first 40 textures when loading the scene(Total number of texture is 271), then the rendering is OK, but adding one more texture, will crash.

I also tested if I replace all the texture with a 16X16 texture, and the renderer also crashes. The vram usage is 2.1GB/10GB, which is enough.

Describe the bug When using bgfx function getShaderUniforms with compute shader. In DirectX backend this function return correct uniform number, but in opengl backend always return 0.