2021-01-28 18:37:34 +08:00
// dear imgui: Renderer for WebGPU
// This needs to be used along with a Platform Binding (e.g. GLFW)
2021-01-28 19:11:26 +08:00
// (Please note that WebGPU is currently experimental, will not run on non-beta browsers, and may break.)
2021-01-28 18:37:34 +08:00
2024-09-16 22:07:02 +08:00
// Important note to dawn and/or wgpu users: when targeting native platforms (i.e. NOT emscripten),
// one of IMGUI_IMPL_WEBGPU_BACKEND_DAWN or IMGUI_IMPL_WEBGPU_BACKEND_WGPU must be provided.
// Add #define to your imconfig.h file, or as a compilation flag in your build system.
// This requirement will be removed once WebGPU stabilizes and backends converge on a unified interface.
//#define IMGUI_IMPL_WEBGPU_BACKEND_DAWN
//#define IMGUI_IMPL_WEBGPU_BACKEND_WGPU
2021-01-28 18:37:34 +08:00
// Implemented features:
// [X] Renderer: User texture binding. Use 'WGPUTextureView' as ImTextureID. Read the FAQ about ImTextureID!
2023-02-07 19:24:42 +08:00
// [X] Renderer: Large meshes support (64k+ vertices) with 16-bit indices.
2024-10-08 04:12:09 +08:00
// [X] Renderer: Expose selected render state for draw callbacks to use. Access in '(ImGui_ImplXXXX_RenderState*)GetPlatformIO().Renderer_RenderState'.
2021-01-28 18:37:34 +08:00
2022-11-08 04:35:05 +08:00
// You can use unmodified imgui_impl_* files in your project. See examples/ folder for examples of using this.
2021-05-27 19:59:35 +08:00
// Prefer including the entire imgui/ repository into your project (either as a copy or as a submodule), and only build the backends you need.
2023-09-11 19:47:08 +08:00
// Learn about Dear ImGui:
// - FAQ https://dearimgui.com/faq
// - Getting Started https://dearimgui.com/getting-started
// - Documentation https://dearimgui.com/docs (same as your local docs/ folder).
// - Introduction, links and more at the top of imgui.cpp
2021-01-28 18:37:34 +08:00
# pragma once
2021-01-28 19:11:26 +08:00
# include "imgui.h" // IMGUI_IMPL_API
2023-07-13 17:27:52 +08:00
# ifndef IMGUI_DISABLE
2021-01-28 18:37:34 +08:00
# include <webgpu/webgpu.h>
2024-01-22 21:46:41 +08:00
// Initialization data, for ImGui_ImplWGPU_Init()
struct ImGui_ImplWGPU_InitInfo
{
WGPUDevice Device ;
int NumFramesInFlight = 3 ;
WGPUTextureFormat RenderTargetFormat = WGPUTextureFormat_Undefined ;
WGPUTextureFormat DepthStencilFormat = WGPUTextureFormat_Undefined ;
2024-01-22 21:54:45 +08:00
WGPUMultisampleState PipelineMultisampleState = { } ;
ImGui_ImplWGPU_InitInfo ( )
{
PipelineMultisampleState . count = 1 ;
2024-03-25 10:10:38 +08:00
PipelineMultisampleState . mask = UINT32_MAX ;
2024-01-22 21:54:45 +08:00
PipelineMultisampleState . alphaToCoverageEnabled = false ;
}
2024-01-22 21:46:41 +08:00
} ;
2024-07-25 22:59:34 +08:00
// Follow "Getting Started" link and check examples/ folder to learn about using backends!
2024-01-22 21:46:41 +08:00
IMGUI_IMPL_API bool ImGui_ImplWGPU_Init ( ImGui_ImplWGPU_InitInfo * init_info ) ;
2021-01-28 18:37:34 +08:00
IMGUI_IMPL_API void ImGui_ImplWGPU_Shutdown ( ) ;
IMGUI_IMPL_API void ImGui_ImplWGPU_NewFrame ( ) ;
IMGUI_IMPL_API void ImGui_ImplWGPU_RenderDrawData ( ImDrawData * draw_data , WGPURenderPassEncoder pass_encoder ) ;
// Use if you want to reset your rendering device without losing Dear ImGui state.
IMGUI_IMPL_API void ImGui_ImplWGPU_InvalidateDeviceObjects ( ) ;
IMGUI_IMPL_API bool ImGui_ImplWGPU_CreateDeviceObjects ( ) ;
2023-07-13 17:27:52 +08:00
2024-10-08 03:00:07 +08:00
// [BETA] Selected render state data shared with callbacks.
2024-10-08 04:12:09 +08:00
// This is temporarily stored in GetPlatformIO().Renderer_RenderState during the ImGui_ImplWGPU_RenderDrawData() call.
2024-10-08 03:00:07 +08:00
// (Please open an issue if you feel you need access to more data)
struct ImGui_ImplWGPU_RenderState
{
WGPUDevice Device ;
WGPURenderPassEncoder RenderPassEncoder ;
} ;
2023-07-13 17:27:52 +08:00
# endif // #ifndef IMGUI_DISABLE