b8ca49f7dc
5c1d2d1e4c5 Version 1.91.7 9f8481a842e (Breaking) TreeNode: renamed ImGuiTreeNodeFlags_SpanTextWidth to ImGuiTreeNodeFlags_SpanLabelWidth. (#6937) 21902e2f536 Backends: SDL_GPU: fixed SDL_GPUViewport initialisation. (#8163, #7998, #7988) c38c18c1a07 Avoid using 1<<31 for ImGuiWindowFlags_NavFlattened as it seems to confuse some binding generators. c5f60942bdd Demo: tweak demo for ImGuiTreeNodeFlags_LabelSpanAllColumns. (#8318, #3565) 290e402a020 TreeNode, Tables: added ImGuiTreeNodeFlags_LabelSpanAllColumns. (#8318, #3565) 6fb7d442559 Backends: SDL2/SDL3: Comments. (#7672, #7670) 32cea853317 Debug Tools: Item Picker: Always available in menu. Tweak Demo Debug Options. (#2673, #1651) 00f12b9a09d InputText: Fixed not calling CallbackEdit on revert/clear with Escape key. (#8273) + rework comments. a604d4f717b Fixed IsItemDeactivated(), IsItemDeactivatedAfterEdit() to work when interrupted before/after the active id is submitted. (#5184, #5904, #6766, #8303, #8004) a28ffa81c4a Docs: added more references to IsKeyDown(), InFlags. (#8317) 1d962820d8b Error Handling: Turned common EndTable() and other TableXXX functions fail cases into recoverable errors. (#1651, #8314) 0b8ff4b2382 Backends, Examples: Vulkan: add IMGUI_IMPL_VULKAN_MINIMUM_IMAGE_SAMPLER_POOL_SIZE. use in descriptor pools sizes. (#6642) e7fb97208a8 Backends: Metal: Added missing IM_UNUSED (#8302) 596e09770d3 Backends: SDL3: Added ImGui_ImplSDL3_InitForSDLGPU() for consistency. (#8163, #7998, #7988) e7998492726 Backends: SDLGPU3: Added sdl_gpu backend (amends). (#8163, #7998, #7988) 8bbccf7a977 Backends: SDLGPU3: Added sdl_gpu backend. (#8163, #7998, #7988) 940d9540f3f Fixed MinGW builds uses UTF-8 friendly _wfopen(). (#8300) c7983115e9f Fonts: Further tweaks for Ellipsis ("...") character width when automatically created from a single comma character: use AdvanceX as min. 90094a871a5 Fonts: Fixed miscalculation of Ellipsis ("...") character width when automatically created from a single comma character. 1c67a3412e1 BeginChild: also caller to manually set ImGuiNextWindowDataFlags_HasChildFlags / ChildFlags. (#8280) 2b8545684ca Refactor: moved Window Focus related functions to a dedicated section. bbbdc70f26b Refactor: moved FindBlockingModal() in its section. e6a7c7689f5 Backends: Metal: Fixed memory leaks. (#8276, #8166) 0514332474f Avoid clang/gcc warnings: -Wnontrivial-memaccess in backends. (#8295, #8129, #8135) 3115ae08159 Demo: Font selector combo sets default focus. cec8ff1885d Backends: Vulkan: Fixed building with using VK_NO_PROTOTYPES. (#8180) f04d3cbdaaf Backends: DirectX10: Expose selected render state in ImGui_ImplDX10_RenderState, which you can access in 'void* platform_io.Renderer_RenderState' during draw callbacks. (#6969, #5834, #7468, #3590) af271e73303 Backends: DX11: Expose vertex constant buffer in ImGui_ImplDX11_RenderState. 93a93071a27 Examples: Add Win32+Vulkan example, amends. (#8180) 38e606a153b Examples: Add Win32+Vulkan example. (#8180) a2e21727c01 Backends: Vulkan: moved helpers to backend: ImGui_ImplVulkanH_SelectPhysicalDevice(), ImGui_ImplVulkanH_SelectQueueFamilyIndex(). (#8180) dbf76f62f9e Update issue_template.yml e7e898ea179 Tables: Fixed TableAngledHeadersRow() creating an infinite horizontal scrolling region when the table is hosted in a viewport with negative coordinates. d0021e16215 Backends: Metal: Fixed resource leak when using multiple contexts. (#7419) 2f1194a2961 Demo: Added label edition to Property Editor demo + fix an ID issue. (#8266) 80aafbc81b0 Data types: moved ImGuiDataType_String to public API as a convenience enum value only. (#8266) f169102c8ea Misc: fixed misc/cpp/imgui_stdlib.h/.cpp not supporting IMGUI_DISABLE. (#8294) a0f907933d8 Happy new year! c147a59bb0e Clarified alternative for ImGuiButtonFlags_Repeat being ImGuiItemFlags_ButtonRepeat. (#8293) 2d2c7d3f955 Backends: Allegro5: Avoid calling al_set_mouse_cursor() repeatedly since it appears to leak on on X11 (#8256). 87f3109c1af Fix capitalization of ImGuiID in comment. (#8283) 6982ce43f5b InputText: fixed badly broken clipboard copy/bug (#8254, #8242) 18929bd6d6c Internals: merge ScaleWindowsInViewport() from docking branch. 2a600bddcbe ImGuiDebugLogFlags_EventFont should not be set by default (had no effect on master tho) 006721fbd6b Added ImFontAtlas section index in comments + minor tweaks to DX12 backends. 7219fa65c02 Revert "Fonts: Allowing PushFont()/PopFont() to be called outside the imgui frame scope. (#3621)" 61d4bf95dc5 Fonts: Allowing PushFont()/PopFont() to be called outside the imgui frame scope. (#3621) d30e102f3ad Scrollbar, TestEngine: for consistency, scrollbars are registered in _Menu layer. 91e8f2b0feb Debug Tools: Debug Log: hovering 0xXXXXXXXX values in log is allowed even if a popup is blocking mouse access to the debug log window. (#5855) eed95027956 Error Handling: Fixed bugs recovering from within a table that created a child window, and from nested child windows. (#1651) fd932297703 Tables, MultiSelect: Fixed an issue where column width may be mismeasured when calling BeginMultiSelect() while inside a table. (#8250) 9b0e61aaaa7 InputText: sanity checks to e.g. detect non zero-terminated buffers + removed a redundant strlen() call during activation. ae839620b96 Docs: Updated EXAMPLES.md (#8246) 457fae24e7a Silence more zealous GCC warning. (#8241) cd6c83cdccb Fixes GCC warnings (#8241) 32f11402f96 InputText: use TextSrc more consistently to facilitate accessing user buffer in text processing code. (#8242) e900571ac24 InputText: Fixed issue when activating a ReadOnly field when the underlying value is being modified. (#8242) f31d53093b5 TestEngine: for consistency, title bar / window items are registered in _Menu layer. 13c4084362b Nav: Fixed an issue where Alt key would clear current active item on windows with the ImGuiWindowFlags_NoNavInputs flag. (#8231) f5f11e94be3 InputText: Fixed a bug where character replacements performed from a callback were not applied when pasting from clipbard. (#8229) 324d4bb1402 InputText: calling ReloadUserBuf doesn't clear undo stack. (#2890) 8237ab450e3 Drags, Sliders: store initial value on activation, as a convenience for some mods. (#8223) 4ad5496474b Drags: Added ImGuiSliderFlags_NoSpeedTweaks flag to disable keyboard modifiers altering the tweak speed. (#8223) f9f4e22f6f7 InputText: some tidying up. (#7925) 4cc464eadc1 BeginListBox(): Comments (#8220) 1d069cf4352 Fonts: store 0 for unset EllipsisChar/FallbackChar. Pull config in BuildLookupTable(). e487eb9da08 Backends: Vulkan: Fixed setting VkSwapchainCreateInfoKHR::preTransform for platforms not supporting VK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR. (#8222) f25665f3600 Version 1.91.7 WIP 993fa347495 Version 1.91.6 2ca83f0bc72 Fixed missing symbols when using IMGUI_DISABLE_DEMO_WINDOWS (e.g. with ImPlot) (#8221) c3ffd4c53e9 Misc: Added IMGUI_USE_LEGACY_CRC32_ADLER to use old tables. (#8169, #4933) d78e823449f InputText: added ImGuiInputTextFlags_ElideLeft. (#1442, #1440, #4391, #7208, #8216) d2645423de8 InputText: reactivating last activated InputText() doesn't restore horizontal scrolling. f3147f446a7 Backends: OpenGL3: call glGetString(GL_VERSION) even in GS ES 2.0 path. (#8197) 921c22f5adc Examples: GLFW+OpenGL3, SDL3+OpenGL3: Provide ES3 context creation code + failure handling. (#8197) 6b348622bb8 Examples: SDL2+OpenGL3: Provide ES3 context creation code + failure handling. (#8197) fce07bb1cb4 Don't enable SSE4 under Emscripten - Fix. (#8213, #8169, #4933) 53dd7552dcb Backends: DX12: let the user specifies the DepthStencilView format. (#8217) 2671f68f7f8 Don't enable SSE4 under Emscripten (#8213, #8169, #4933) 3f3c62a3c99 ScrollbarEx: clarify use of flags and make them optional. (#8215) 18e5d769fd7 Backends: DX10: create sampler outside of ImGui_ImplDX11_CreateFontsTexture(). 43fbd7ce840 Backends: standardized top of file comments. 566558b17c5 Replacing NULL with nullptr in examples/backends when they creeped back. (#6313, #7071, #4537) 6f6ac84228a Demo: Assets Browser: use correct axis for layout computation, to allow making items non-square. (#8207) 70b6ba42402 Clarify that IMGUI_USE_BGRA_PACKED_COLOR requires backend support. (#8201) 923ca4765a8 Backends: OpenGL3: Fix compile error with IMGUI_IMPL_OPENGL_ES2 and IMGUI_IMPL_OPENGL_DEBUG (#8197) 43c51eb12d1 Tables: fixed SetNextWindowScroll() value being ignored by BeginTable() during the first frame or when scrolling flags have changed. (#8196) ee2119d7cbe imgui_freetype: Fix build broken by 19a1f2a (#8107) 19a1f2a5d2c Fonts: fixed AddCustomRect() not being packed with TexGlyphPadding + not accounted in surface area. (#8107) 9b26743c6b3 SliderAngle: only write back to value v_rad on value_changed. (#8193) dda7672008e Backends: Vulkan: removed sizeof(ImTextureID) check. c1123fd8d05 Backends: Vulkan: small refactor to use a texture struct. 90dd510df1e Backends: DX11: create sampler outside of ImGui_ImplDX11_CreateFontsTexture(). 96877eb9c30 Backends: Vulkan: fixed build with VK_NO_PROTOTYPES. (#8172, #4867) 2d660108b27 Misc: amend crc32 to use _mm_crc32_u32. (#8169, #4933) 326dc95f9c7 Misc: use native crc32 instructions on SEE 4.2 targets. (#8169, #4933) e6dd8f626a1 Misc: changed CRC32 table to use crc32c polynomial in order to be compatible with SSE 4.2 instructions. (#8169, #4933) 61ab94d5534 Backends: Vulkan: Make descriptor pool optional (#8172, #4867) 9b273294377 Comments on ImageButton(). (#8165) + comments on Emscripten -sSINGLE_FILE option. (#8153) 5b7feebfd8f Backends: DX9: extract RGBA convert loop as we are going to need it more often. dfbf1b4f6b1 Backends: DX9: cache result of ImGui_ImplDX9_CheckFormatSupport() as we are going to need it more often. 20360e00ceb Merge miscellaneous small changes to reduce drift with texture update branch. 551b6c4d662 Tools: binary_to_compressed_c: added -u8/-u32/-base85 export options. d0e870aad2c Misc: changed embedded ProggyClean encoding to save a bit of binary space (~12kb to 9.5kb). (#8161) 5ae3dd52a07 Fonts: added IMGUI_DISABLE_DEFAULT_FONT macro. (#8161) eb0ad66d88d Demo: example tree used by Property Editor & Selection demos properly freed on app closure. (#8158) 142827f7d86 Backends: DX12: rework legacy path for handling ImGui_ImplDX12_Init() being called with space for a single descriptor. 08400f5be7f Backends: DX12: tidying up, added a ImGui_ImplDX12_Texture helper struct. 40b2286d16e (Breaking) Backends: DX12: changed ImGui_ImplDX12_Init() signature. Added ImGui_ImplDX12_InitInfo. Added support for Srv allocators. 3260ea69545 Examples: Win32+DX12: Tweaks. 8be0723fb7a Amend Changelog to better document how changing button behavior of InputInt/InputFloat step buttons affected some mis-uses (#8149) e97b97467e4 Error Handling: fixed cases where recoverable error handling would crash. (#1651) 3381ab423b3 Version 1.91.6 WIP + fixed typo in tooltip. f401021d5a5 Version 1.91.5 31b967f098d Fix 01d27a4 (sorry I cherry-picked from wrong branch) 01d27a4acde Internals: added IM_LIKELY(), IM_UNLIKELY() helper macros (yet unused). Added ImFontGetCharAdvanceX() macro. 419a9ada16e Ignore clang warning Wnontrivial-memaccess (#8129, #8135) 17bd417a3d1 AddCustomRectFontGlyph: added storage for Colored bool in ImFontAtlasCustomRect. (#8133) 3b683927ee6 imgui_freetype: Fixed a crash in build font atlas when using merged fonts and the first font in a merged set has no loaded glyph. (#8081) 3543dfda953 Docs: document removal of ImFont const qualifier as potentially breaking. d97bbf19042 Tabs, Style: made ImGuiCol_TabDimmedSelectedOverline alpha 0 (not visible) in default styles. df0776e931d (Breaking) Removed ImGuiKey_COUNT. (#4921) 738d6db3e6b (Breaking) Removed used of ImGuiKey_KeysData_SIZE, ImGuiKey_KeysData_OFFSET. (#4921) 6f287dd16d5 (Breaking) Removed pre-1.87 obsolete io.KeyMap[], io.KeysDown[], io.NavInputs[]. Remove IMGUI_DISABLE_OBSOLETE_KEYIO. (#4921) 57ab2b42260 Fixed unused function warning (#8130) ec2f1d69c8d Docs: word-wrap some the older changelogs. 63234f8dd0a InputText: Internals: rename CurLenA->TextLen, InitialTextA->TextToRevertTo. be2d006e2e7 Align warning blocks. Removed -Wunused-function, -Wmissing-prototypes from imgui_internal.h 88e232739bc Ignore clang warning Wnontrivial-memaccess (#8129) d4791f1bbef Fixed a comment typo. (#8128) 82d0584e7bb InputText: using CurLenA instead of TextA.Size for correctness. (#7925) 75f83de52ab InputText: fixed a bug (regression in 1.91.2) where modifying text buffer within a callback would sometimes prevents further appending to the buffer. (#7925) f77d22837c0 Examples: Android+OpenGL: Using ALooper_pollOnce() instead of ALooper_pollAll(). (#8013) 71c77c081ac Demo: added a "Windows" section. 772ca9e9a9d Log/Capture: added experimental io.ConfigWindowsCopyContentsWithCtrlC config option. f37a9a27e58 Log/Capture: reworked scope + decorating menus, tabs. a4fcc93f4af Log/Capture: renaming ImGuiLogType to ImGuiLogFlags 9a0dff1bc56 Buttons: using ImGuiItemFlags_ButtonRepeat makes default button behavior use PressedOnClick instead of PressedOnClickRelease when unspecified. 0bde57c25a9 Font, Misc: remove qualifier from most font functions. 3b8c7d0326d Backends: Win32: rework to add ImGui_ImplWin32_WndProcHandlerEx() not using current context (experimental). (#8069, #6293, #5856, #586) d67e2eea1a0 Backends: Win32: internal rename. 81b689b9693 Backends: OpenGL3: added additional debug GL_CALL enclosure for glCreateShader() calls. (#8104) 81cfe096578 Selectable, Style: selected Selectable() use _Header color instead of an arbitrary lerp between _Header and _HeaderHovered. (#8106, #1861) ccb6646baea Examples: added SDL3+Vulkan example. (#8084, #8085) 1039b7f543c Examples: added more build_win64.bat helpers. a908d73c16a Backends: avoid missing -Wmissing-declaration warning. (#8087, #7997) b4033b37ad7 Backends: WGPU: update for Dawn WGPU String usage. (#8082, #8083) a855bd8df3c Backends: SDL2: Replace SDL_Vulkan_GetDrawableSize() forward declaration with the actual include. (#8095, #7967, #3190) 06092a9756b Backends: SDL2, SDL3: SDL_EVENT_MOUSE_WHEEL event doesn't require dividing by 100.0f on Emscripten. (#4019, #6096, #1463) 062e580436e Fixed copy/paste error in DebugModeWindow() (#8094) 4994e75852a Backends: DX12: Unmap() call specify written range. 41f02825fc5 Version 1.91.5 WIP 99109c0b3b0 Amend Changelog, oops didn't get it in the previous commit. 83b64b8be22 Version 1.91.4 ab9ce2a927a Nav: added io.ConfigNavCursorVisibleAuto, io.ConfigNavCursorVisibleAlways. (#1074, #2048, #7237, #8059, #3200, #787) 3982cb35dcf Nav, Docs: consistently use "keyboard/gamepad" instead of sometimes "gamepad/keyboard". 1ff9768aa30 Nav: (Breaking) renamed ImGuiCol_NavHighlight to ImGuiCol_NavCursor. (#1074, #2048, #7237, #8059, #1712, #7370, #787) 634a7ed9886 Nav: added SetNavCursorVisible(). (#1074, #2048, #7237, #8059) 0bae2db77fd Internals: (Breaking) renamed NavDisableMouseHover to NavHighlightItemUnderNav. 0536ace2b6c Internals: (Breaking) renamed RenderNavHighlight() to RenderNavCursor(), ImGuiNavHighlightFlags to ImGuiNavRenderCursorFlags. (#1074, #2048, #7237, #8059, #1712, #7370, #787) 23b655f8e3a Internals: (Breaking) changed g.NavDisableHighlight to g.NavCursorVisible : same logic but inverted value. (#1074, #2048, #7237, #8059, #1712, #7370, #787) 7a56b411247 Nav: added io.ConfigNavEscapeClearFocusItem. (#8059, #2048, #1074, #3200) db26fe7ca8d Debug Tools: Metrics: Fixed a crash when browsing "InputText" section before using one. (#8071) 604f2fa84aa InputScalar: added an assert to clarify that ImGuiInputTextFlags_EnterReturnsTrue is not supported by InputFloat, InputInt etc. (#8065) 38617a5ad34 Internals: remove ImGuiInputTextFlags_NoMarkEdited and g.LockMarkEdited n favor of ImGuiItemFlags_NoMarkEdited. 0f6a463fae5 Internals: rename ImGuiTreeNodeStackData::InFlags and ImGuiNavItemData::InFlags to ItemFlags too. e6b5cafe65f Internals: rename ImGuiLastItemData::InFlags -> ItemFlags. ImGuiNextItemData::Flags -> HasFlags to avoid mistakes. 706438a43c3 Disabled: clicking a disabled item focuses parent window. Fix/amend 83ecc84. (#8064) 04d9a045570 imgui_freetype: Added support for plutosvg to render OpenType SVG fonts. (#7927, #7187 + #6591, #6607) 83ecc846dc4 Disabled: clicking a disabled item focuses parent window. (#8064) 67e5f3505d4 InvisibleButton: disable navigation properly + added ImGuiButtonFlags_EnableNav to enable navigation. (#8057) 971d243a872 Fixed typo (#8063) 49a9eee33f2 Commented out obsolete internals's SetItemUsingMouseWheel() (#2891), TreeNodeBehaviorIsOpen() (#4814, #5423, #282, #2958, #924) 50de550ecdd Tooltips: fixed incorrect tooltip positioning when using keyboard/gamepad navigation (1.91.3 regression). (#8036) 42f47590f98 Fixed ad37b79 breaking IsItemHovered()->IsItemFocused() passthrough for navigation. 97da66209cf Internals: removing ImGuiButtonFlags_Repeat (in favor of ImGuiItemFlags_ButtonRepeat), ImGuiButtonFlags_DontClosePopups (unused) 462d1674568 Nav: rectangle highlight not rendered for items with ImGuiItemFlags_NoNav. (#8057) ad37b79bca2 Nav: shallow tidying up. 626d358e55e Nav: fixed Ctrl+Tab so when starting with no focused window it starts from the top-most window. (#3200) b0010389011 Nav: added io.ConfigNavEscapeClearFocusWindow to clear focused window on Escape. (#3200) ba5161740ea Amend d885fe4, fixes default value of ConfigNavCaptureKeyboard. (#2517, #2009) d885fe4dd0c (Breaking) moved ImGuiConfigFlags_NavEnableSetMousePos -> io.ConfigNavMoveSetMousePos, ImGuiConfigFlags_NavNoCaptureKeyboard -> ConfigNavCaptureKeyboard. (#2517, #2009) 349af8766cb InputText: ensure mouse cursor is set regardless of whether keyboard mode is enabled or not. (#6417) 20ae8bd4c32 Error Handling: turned IsItemHovered()/IsWindowHovered() checks into IM_ASSERT_USER_ERROR. (#1651) c4bc6744824 IO: WantCaptureKeyboard is never set when ImGuiConfigFlags_NoKeyboard is enabled. (#4921) 98d52b7b26c DrawList: AddCallback() added an optional size parameter allowing to copy and store any amount of user data for usage by callbacks: (#6969, #4770, #7665) f29e505d94e CI: remove --disableLicenseExpirationCheck. a0b811dd373 Backends: SDLRenderer2/3: expose selected state in ImGui_ImplXXXX_RenderState structures during render loop. (#6969, #5834, #7468, #3590 + #7616) 9fbc3134591 InputText: amend 661bba0. (#8048) 661bba09ce1 InputText: fixed an issue with not declaring ownership of Delete/Backspace/Arrow keys. (#8048) f3d242a90d6 Tables: fixed initial auto-sizing issue with synched-instances. (#8045, #7218) c3629adbeb2 Backends: Metal: fixed ImTextureID cast. (#1641) 6b8accbfa1b Fixed building when defining ImTextureID to a multi-token name. (#1641) 92b94980c69 (Breaking) Default ImTextureID to use a Im64 instead of void* (#1641) 19b494df89f Examples: DirectX12: update Windows SDK version. f890d853816 Backends: Fixed typo in comments from old wip work 'io.BackendRendererRenderState' -> 'platform_io.Renderer_RenderState'. (#6969, #5834, #7468, #3590 42206b3d513 Backends: DX9, DX10, DX11, DX12, OpenGL, Vulkan, WGPU: Changed default texture sampler to Clamp instead of Repeat/Wrap. (#7468, #7511, #5999, #5502) 74dd38d27c9 Backends: Vulkan: fixed warnings when building in 32-bit mode. e94f95d82b9 Backends: DX11, DX12, Vulkan, WGPU: Expose some backend-specific render state usable for callbacks. (#6969, #5834, #7468, #3590) 9bd5d8a2405 Backends: misc renaming of locals. Use 'draw_list' instead of 'cmd_list'. Avoid using 'ctx'. 1dde20ff4a1 Version 1.91.4 WIP git-subtree-dir: external/imgui/imgui git-subtree-split: 5c1d2d1e4c562a2ed3efbc64476e703a655b45fd
859 lines
36 KiB
C++
859 lines
36 KiB
C++
// dear imgui: Renderer for WebGPU
|
|
// This needs to be used along with a Platform Binding (e.g. GLFW)
|
|
// (Please note that WebGPU is currently experimental, will not run on non-beta browsers, and may break.)
|
|
|
|
// Implemented features:
|
|
// [X] Renderer: User texture binding. Use 'WGPUTextureView' as ImTextureID. Read the FAQ about ImTextureID!
|
|
// [X] Renderer: Large meshes support (64k+ vertices) even with 16-bit indices (ImGuiBackendFlags_RendererHasVtxOffset).
|
|
// [X] Renderer: Expose selected render state for draw callbacks to use. Access in '(ImGui_ImplXXXX_RenderState*)GetPlatformIO().Renderer_RenderState'.
|
|
|
|
// You can use unmodified imgui_impl_* files in your project. See examples/ folder for examples of using this.
|
|
// Prefer including the entire imgui/ repository into your project (either as a copy or as a submodule), and only build the backends you need.
|
|
// 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
|
|
|
|
// CHANGELOG
|
|
// (minor and older changes stripped away, please see git history for details)
|
|
// 2024-10-14: Update Dawn support for change of string usages. (#8082, #8083)
|
|
// 2024-10-07: Expose selected render state in ImGui_ImplWGPU_RenderState, which you can access in 'void* platform_io.Renderer_RenderState' during draw callbacks.
|
|
// 2024-10-07: Changed default texture sampler to Clamp instead of Repeat/Wrap.
|
|
// 2024-09-16: Added support for optional IMGUI_IMPL_WEBGPU_BACKEND_DAWN / IMGUI_IMPL_WEBGPU_BACKEND_WGPU define to handle ever-changing native implementations. (#7977)
|
|
// 2024-01-22: Added configurable PipelineMultisampleState struct. (#7240)
|
|
// 2024-01-22: (Breaking) ImGui_ImplWGPU_Init() now takes a ImGui_ImplWGPU_InitInfo structure instead of variety of parameters, allowing for easier further changes.
|
|
// 2024-01-22: Fixed pipeline layout leak. (#7245)
|
|
// 2024-01-17: Explicitly fill all of WGPUDepthStencilState since standard removed defaults.
|
|
// 2023-07-13: Use WGPUShaderModuleWGSLDescriptor's code instead of source. use WGPUMipmapFilterMode_Linear instead of WGPUFilterMode_Linear. (#6602)
|
|
// 2023-04-11: Align buffer sizes. Use WGSL shaders instead of precompiled SPIR-V.
|
|
// 2023-04-11: Reorganized backend to pull data from a single structure to facilitate usage with multiple-contexts (all g_XXXX access changed to bd->XXXX).
|
|
// 2023-01-25: Revert automatic pipeline layout generation (see https://github.com/gpuweb/gpuweb/issues/2470)
|
|
// 2022-11-24: Fixed validation error with default depth buffer settings.
|
|
// 2022-11-10: Fixed rendering when a depth buffer is enabled. Added 'WGPUTextureFormat depth_format' parameter to ImGui_ImplWGPU_Init().
|
|
// 2022-10-11: Using 'nullptr' instead of 'NULL' as per our switch to C++11.
|
|
// 2021-11-29: Passing explicit buffer sizes to wgpuRenderPassEncoderSetVertexBuffer()/wgpuRenderPassEncoderSetIndexBuffer().
|
|
// 2021-08-24: Fixed for latest specs.
|
|
// 2021-05-24: Add support for draw_data->FramebufferScale.
|
|
// 2021-05-19: Replaced direct access to ImDrawCmd::TextureId with a call to ImDrawCmd::GetTexID(). (will become a requirement)
|
|
// 2021-05-16: Update to latest WebGPU specs (compatible with Emscripten 2.0.20 and Chrome Canary 92).
|
|
// 2021-02-18: Change blending equation to preserve alpha in output buffer.
|
|
// 2021-01-28: Initial version.
|
|
|
|
// When targeting native platforms (i.e. NOT emscripten), one of IMGUI_IMPL_WEBGPU_BACKEND_DAWN
|
|
// or IMGUI_IMPL_WEBGPU_BACKEND_WGPU must be provided. See imgui_impl_wgpu.h for more details.
|
|
#ifndef __EMSCRIPTEN__
|
|
#if defined(IMGUI_IMPL_WEBGPU_BACKEND_DAWN) == defined(IMGUI_IMPL_WEBGPU_BACKEND_WGPU)
|
|
#error exactly one of IMGUI_IMPL_WEBGPU_BACKEND_DAWN or IMGUI_IMPL_WEBGPU_BACKEND_WGPU must be defined!
|
|
#endif
|
|
#else
|
|
#if defined(IMGUI_IMPL_WEBGPU_BACKEND_DAWN) || defined(IMGUI_IMPL_WEBGPU_BACKEND_WGPU)
|
|
#error neither IMGUI_IMPL_WEBGPU_BACKEND_DAWN nor IMGUI_IMPL_WEBGPU_BACKEND_WGPU may be defined if targeting emscripten!
|
|
#endif
|
|
#endif
|
|
|
|
#include "imgui.h"
|
|
#ifndef IMGUI_DISABLE
|
|
#include "imgui_impl_wgpu.h"
|
|
#include <limits.h>
|
|
#include <webgpu/webgpu.h>
|
|
|
|
// Dear ImGui prototypes from imgui_internal.h
|
|
extern ImGuiID ImHashData(const void* data_p, size_t data_size, ImU32 seed = 0);
|
|
#define MEMALIGN(_SIZE,_ALIGN) (((_SIZE) + ((_ALIGN) - 1)) & ~((_ALIGN) - 1)) // Memory align (copied from IM_ALIGN() macro).
|
|
|
|
// WebGPU data
|
|
struct RenderResources
|
|
{
|
|
WGPUTexture FontTexture = nullptr; // Font texture
|
|
WGPUTextureView FontTextureView = nullptr; // Texture view for font texture
|
|
WGPUSampler Sampler = nullptr; // Sampler for the font texture
|
|
WGPUBuffer Uniforms = nullptr; // Shader uniforms
|
|
WGPUBindGroup CommonBindGroup = nullptr; // Resources bind-group to bind the common resources to pipeline
|
|
ImGuiStorage ImageBindGroups; // Resources bind-group to bind the font/image resources to pipeline (this is a key->value map)
|
|
WGPUBindGroup ImageBindGroup = nullptr; // Default font-resource of Dear ImGui
|
|
WGPUBindGroupLayout ImageBindGroupLayout = nullptr; // Cache layout used for the image bind group. Avoids allocating unnecessary JS objects when working with WebASM
|
|
};
|
|
|
|
struct FrameResources
|
|
{
|
|
WGPUBuffer IndexBuffer;
|
|
WGPUBuffer VertexBuffer;
|
|
ImDrawIdx* IndexBufferHost;
|
|
ImDrawVert* VertexBufferHost;
|
|
int IndexBufferSize;
|
|
int VertexBufferSize;
|
|
};
|
|
|
|
struct Uniforms
|
|
{
|
|
float MVP[4][4];
|
|
float Gamma;
|
|
};
|
|
|
|
struct ImGui_ImplWGPU_Data
|
|
{
|
|
ImGui_ImplWGPU_InitInfo initInfo;
|
|
WGPUDevice wgpuDevice = nullptr;
|
|
WGPUQueue defaultQueue = nullptr;
|
|
WGPUTextureFormat renderTargetFormat = WGPUTextureFormat_Undefined;
|
|
WGPUTextureFormat depthStencilFormat = WGPUTextureFormat_Undefined;
|
|
WGPURenderPipeline pipelineState = nullptr;
|
|
|
|
RenderResources renderResources;
|
|
FrameResources* pFrameResources = nullptr;
|
|
unsigned int numFramesInFlight = 0;
|
|
unsigned int frameIndex = UINT_MAX;
|
|
};
|
|
|
|
// Backend data stored in io.BackendRendererUserData to allow support for multiple Dear ImGui contexts
|
|
// It is STRONGLY preferred that you use docking branch with multi-viewports (== single Dear ImGui context + multiple windows) instead of multiple Dear ImGui contexts.
|
|
static ImGui_ImplWGPU_Data* ImGui_ImplWGPU_GetBackendData()
|
|
{
|
|
return ImGui::GetCurrentContext() ? (ImGui_ImplWGPU_Data*)ImGui::GetIO().BackendRendererUserData : nullptr;
|
|
}
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// SHADERS
|
|
//-----------------------------------------------------------------------------
|
|
|
|
static const char __shader_vert_wgsl[] = R"(
|
|
struct VertexInput {
|
|
@location(0) position: vec2<f32>,
|
|
@location(1) uv: vec2<f32>,
|
|
@location(2) color: vec4<f32>,
|
|
};
|
|
|
|
struct VertexOutput {
|
|
@builtin(position) position: vec4<f32>,
|
|
@location(0) color: vec4<f32>,
|
|
@location(1) uv: vec2<f32>,
|
|
};
|
|
|
|
struct Uniforms {
|
|
mvp: mat4x4<f32>,
|
|
gamma: f32,
|
|
};
|
|
|
|
@group(0) @binding(0) var<uniform> uniforms: Uniforms;
|
|
|
|
@vertex
|
|
fn main(in: VertexInput) -> VertexOutput {
|
|
var out: VertexOutput;
|
|
out.position = uniforms.mvp * vec4<f32>(in.position, 0.0, 1.0);
|
|
out.color = in.color;
|
|
out.uv = in.uv;
|
|
return out;
|
|
}
|
|
)";
|
|
|
|
static const char __shader_frag_wgsl[] = R"(
|
|
struct VertexOutput {
|
|
@builtin(position) position: vec4<f32>,
|
|
@location(0) color: vec4<f32>,
|
|
@location(1) uv: vec2<f32>,
|
|
};
|
|
|
|
struct Uniforms {
|
|
mvp: mat4x4<f32>,
|
|
gamma: f32,
|
|
};
|
|
|
|
@group(0) @binding(0) var<uniform> uniforms: Uniforms;
|
|
@group(0) @binding(1) var s: sampler;
|
|
@group(1) @binding(0) var t: texture_2d<f32>;
|
|
|
|
@fragment
|
|
fn main(in: VertexOutput) -> @location(0) vec4<f32> {
|
|
let color = in.color * textureSample(t, s, in.uv);
|
|
let corrected_color = pow(color.rgb, vec3<f32>(uniforms.gamma));
|
|
return vec4<f32>(corrected_color, color.a);
|
|
}
|
|
)";
|
|
|
|
static void SafeRelease(ImDrawIdx*& res)
|
|
{
|
|
if (res)
|
|
delete[] res;
|
|
res = nullptr;
|
|
}
|
|
static void SafeRelease(ImDrawVert*& res)
|
|
{
|
|
if (res)
|
|
delete[] res;
|
|
res = nullptr;
|
|
}
|
|
static void SafeRelease(WGPUBindGroupLayout& res)
|
|
{
|
|
if (res)
|
|
wgpuBindGroupLayoutRelease(res);
|
|
res = nullptr;
|
|
}
|
|
static void SafeRelease(WGPUBindGroup& res)
|
|
{
|
|
if (res)
|
|
wgpuBindGroupRelease(res);
|
|
res = nullptr;
|
|
}
|
|
static void SafeRelease(WGPUBuffer& res)
|
|
{
|
|
if (res)
|
|
wgpuBufferRelease(res);
|
|
res = nullptr;
|
|
}
|
|
static void SafeRelease(WGPUPipelineLayout& res)
|
|
{
|
|
if (res)
|
|
wgpuPipelineLayoutRelease(res);
|
|
res = nullptr;
|
|
}
|
|
static void SafeRelease(WGPURenderPipeline& res)
|
|
{
|
|
if (res)
|
|
wgpuRenderPipelineRelease(res);
|
|
res = nullptr;
|
|
}
|
|
static void SafeRelease(WGPUSampler& res)
|
|
{
|
|
if (res)
|
|
wgpuSamplerRelease(res);
|
|
res = nullptr;
|
|
}
|
|
static void SafeRelease(WGPUShaderModule& res)
|
|
{
|
|
if (res)
|
|
wgpuShaderModuleRelease(res);
|
|
res = nullptr;
|
|
}
|
|
static void SafeRelease(WGPUTextureView& res)
|
|
{
|
|
if (res)
|
|
wgpuTextureViewRelease(res);
|
|
res = nullptr;
|
|
}
|
|
static void SafeRelease(WGPUTexture& res)
|
|
{
|
|
if (res)
|
|
wgpuTextureRelease(res);
|
|
res = nullptr;
|
|
}
|
|
|
|
static void SafeRelease(RenderResources& res)
|
|
{
|
|
SafeRelease(res.FontTexture);
|
|
SafeRelease(res.FontTextureView);
|
|
SafeRelease(res.Sampler);
|
|
SafeRelease(res.Uniforms);
|
|
SafeRelease(res.CommonBindGroup);
|
|
SafeRelease(res.ImageBindGroup);
|
|
SafeRelease(res.ImageBindGroupLayout);
|
|
};
|
|
|
|
static void SafeRelease(FrameResources& res)
|
|
{
|
|
SafeRelease(res.IndexBuffer);
|
|
SafeRelease(res.VertexBuffer);
|
|
SafeRelease(res.IndexBufferHost);
|
|
SafeRelease(res.VertexBufferHost);
|
|
}
|
|
|
|
static WGPUProgrammableStageDescriptor ImGui_ImplWGPU_CreateShaderModule(const char* wgsl_source)
|
|
{
|
|
ImGui_ImplWGPU_Data* bd = ImGui_ImplWGPU_GetBackendData();
|
|
|
|
#ifdef IMGUI_IMPL_WEBGPU_BACKEND_DAWN
|
|
WGPUShaderSourceWGSL wgsl_desc = {};
|
|
wgsl_desc.chain.sType = WGPUSType_ShaderSourceWGSL;
|
|
wgsl_desc.code = { wgsl_source, WGPU_STRLEN };
|
|
#else
|
|
WGPUShaderModuleWGSLDescriptor wgsl_desc = {};
|
|
wgsl_desc.chain.sType = WGPUSType_ShaderModuleWGSLDescriptor;
|
|
wgsl_desc.code = wgsl_source;
|
|
#endif
|
|
|
|
WGPUShaderModuleDescriptor desc = {};
|
|
desc.nextInChain = reinterpret_cast<WGPUChainedStruct*>(&wgsl_desc);
|
|
|
|
WGPUProgrammableStageDescriptor stage_desc = {};
|
|
stage_desc.module = wgpuDeviceCreateShaderModule(bd->wgpuDevice, &desc);
|
|
#ifdef IMGUI_IMPL_WEBGPU_BACKEND_DAWN
|
|
stage_desc.entryPoint = { "main", WGPU_STRLEN };
|
|
#else
|
|
stage_desc.entryPoint = "main";
|
|
#endif
|
|
return stage_desc;
|
|
}
|
|
|
|
static WGPUBindGroup ImGui_ImplWGPU_CreateImageBindGroup(WGPUBindGroupLayout layout, WGPUTextureView texture)
|
|
{
|
|
ImGui_ImplWGPU_Data* bd = ImGui_ImplWGPU_GetBackendData();
|
|
WGPUBindGroupEntry image_bg_entries[] = { { nullptr, 0, 0, 0, 0, 0, texture } };
|
|
|
|
WGPUBindGroupDescriptor image_bg_descriptor = {};
|
|
image_bg_descriptor.layout = layout;
|
|
image_bg_descriptor.entryCount = sizeof(image_bg_entries) / sizeof(WGPUBindGroupEntry);
|
|
image_bg_descriptor.entries = image_bg_entries;
|
|
return wgpuDeviceCreateBindGroup(bd->wgpuDevice, &image_bg_descriptor);
|
|
}
|
|
|
|
static void ImGui_ImplWGPU_SetupRenderState(ImDrawData* draw_data, WGPURenderPassEncoder ctx, FrameResources* fr)
|
|
{
|
|
ImGui_ImplWGPU_Data* bd = ImGui_ImplWGPU_GetBackendData();
|
|
|
|
// Setup orthographic projection matrix into our constant buffer
|
|
// Our visible imgui space lies from draw_data->DisplayPos (top left) to draw_data->DisplayPos+data_data->DisplaySize (bottom right).
|
|
{
|
|
float L = draw_data->DisplayPos.x;
|
|
float R = draw_data->DisplayPos.x + draw_data->DisplaySize.x;
|
|
float T = draw_data->DisplayPos.y;
|
|
float B = draw_data->DisplayPos.y + draw_data->DisplaySize.y;
|
|
float mvp[4][4] =
|
|
{
|
|
{ 2.0f/(R-L), 0.0f, 0.0f, 0.0f },
|
|
{ 0.0f, 2.0f/(T-B), 0.0f, 0.0f },
|
|
{ 0.0f, 0.0f, 0.5f, 0.0f },
|
|
{ (R+L)/(L-R), (T+B)/(B-T), 0.5f, 1.0f },
|
|
};
|
|
wgpuQueueWriteBuffer(bd->defaultQueue, bd->renderResources.Uniforms, offsetof(Uniforms, MVP), mvp, sizeof(Uniforms::MVP));
|
|
float gamma;
|
|
switch (bd->renderTargetFormat)
|
|
{
|
|
case WGPUTextureFormat_ASTC10x10UnormSrgb:
|
|
case WGPUTextureFormat_ASTC10x5UnormSrgb:
|
|
case WGPUTextureFormat_ASTC10x6UnormSrgb:
|
|
case WGPUTextureFormat_ASTC10x8UnormSrgb:
|
|
case WGPUTextureFormat_ASTC12x10UnormSrgb:
|
|
case WGPUTextureFormat_ASTC12x12UnormSrgb:
|
|
case WGPUTextureFormat_ASTC4x4UnormSrgb:
|
|
case WGPUTextureFormat_ASTC5x5UnormSrgb:
|
|
case WGPUTextureFormat_ASTC6x5UnormSrgb:
|
|
case WGPUTextureFormat_ASTC6x6UnormSrgb:
|
|
case WGPUTextureFormat_ASTC8x5UnormSrgb:
|
|
case WGPUTextureFormat_ASTC8x6UnormSrgb:
|
|
case WGPUTextureFormat_ASTC8x8UnormSrgb:
|
|
case WGPUTextureFormat_BC1RGBAUnormSrgb:
|
|
case WGPUTextureFormat_BC2RGBAUnormSrgb:
|
|
case WGPUTextureFormat_BC3RGBAUnormSrgb:
|
|
case WGPUTextureFormat_BC7RGBAUnormSrgb:
|
|
case WGPUTextureFormat_BGRA8UnormSrgb:
|
|
case WGPUTextureFormat_ETC2RGB8A1UnormSrgb:
|
|
case WGPUTextureFormat_ETC2RGB8UnormSrgb:
|
|
case WGPUTextureFormat_ETC2RGBA8UnormSrgb:
|
|
case WGPUTextureFormat_RGBA8UnormSrgb:
|
|
gamma = 2.2f;
|
|
break;
|
|
default:
|
|
gamma = 1.0f;
|
|
}
|
|
wgpuQueueWriteBuffer(bd->defaultQueue, bd->renderResources.Uniforms, offsetof(Uniforms, Gamma), &gamma, sizeof(Uniforms::Gamma));
|
|
}
|
|
|
|
// Setup viewport
|
|
wgpuRenderPassEncoderSetViewport(ctx, 0, 0, draw_data->FramebufferScale.x * draw_data->DisplaySize.x, draw_data->FramebufferScale.y * draw_data->DisplaySize.y, 0, 1);
|
|
|
|
// Bind shader and vertex buffers
|
|
wgpuRenderPassEncoderSetVertexBuffer(ctx, 0, fr->VertexBuffer, 0, fr->VertexBufferSize * sizeof(ImDrawVert));
|
|
wgpuRenderPassEncoderSetIndexBuffer(ctx, fr->IndexBuffer, sizeof(ImDrawIdx) == 2 ? WGPUIndexFormat_Uint16 : WGPUIndexFormat_Uint32, 0, fr->IndexBufferSize * sizeof(ImDrawIdx));
|
|
wgpuRenderPassEncoderSetPipeline(ctx, bd->pipelineState);
|
|
wgpuRenderPassEncoderSetBindGroup(ctx, 0, bd->renderResources.CommonBindGroup, 0, nullptr);
|
|
|
|
// Setup blend factor
|
|
WGPUColor blend_color = { 0.f, 0.f, 0.f, 0.f };
|
|
wgpuRenderPassEncoderSetBlendConstant(ctx, &blend_color);
|
|
}
|
|
|
|
// Render function
|
|
// (this used to be set in io.RenderDrawListsFn and called by ImGui::Render(), but you can now call this directly from your main loop)
|
|
void ImGui_ImplWGPU_RenderDrawData(ImDrawData* draw_data, WGPURenderPassEncoder pass_encoder)
|
|
{
|
|
// Avoid rendering when minimized
|
|
int fb_width = (int)(draw_data->DisplaySize.x * draw_data->FramebufferScale.x);
|
|
int fb_height = (int)(draw_data->DisplaySize.y * draw_data->FramebufferScale.y);
|
|
if (fb_width <= 0 || fb_height <= 0 || draw_data->CmdListsCount == 0)
|
|
return;
|
|
|
|
// FIXME: Assuming that this only gets called once per frame!
|
|
// If not, we can't just re-allocate the IB or VB, we'll have to do a proper allocator.
|
|
ImGui_ImplWGPU_Data* bd = ImGui_ImplWGPU_GetBackendData();
|
|
bd->frameIndex = bd->frameIndex + 1;
|
|
FrameResources* fr = &bd->pFrameResources[bd->frameIndex % bd->numFramesInFlight];
|
|
|
|
// Create and grow vertex/index buffers if needed
|
|
if (fr->VertexBuffer == nullptr || fr->VertexBufferSize < draw_data->TotalVtxCount)
|
|
{
|
|
if (fr->VertexBuffer)
|
|
{
|
|
wgpuBufferDestroy(fr->VertexBuffer);
|
|
wgpuBufferRelease(fr->VertexBuffer);
|
|
}
|
|
SafeRelease(fr->VertexBufferHost);
|
|
fr->VertexBufferSize = draw_data->TotalVtxCount + 5000;
|
|
|
|
WGPUBufferDescriptor vb_desc =
|
|
{
|
|
nullptr,
|
|
"Dear ImGui Vertex buffer",
|
|
#ifdef IMGUI_IMPL_WEBGPU_BACKEND_DAWN
|
|
WGPU_STRLEN,
|
|
#endif
|
|
WGPUBufferUsage_CopyDst | WGPUBufferUsage_Vertex,
|
|
MEMALIGN(fr->VertexBufferSize * sizeof(ImDrawVert), 4),
|
|
false
|
|
};
|
|
fr->VertexBuffer = wgpuDeviceCreateBuffer(bd->wgpuDevice, &vb_desc);
|
|
if (!fr->VertexBuffer)
|
|
return;
|
|
|
|
fr->VertexBufferHost = new ImDrawVert[fr->VertexBufferSize];
|
|
}
|
|
if (fr->IndexBuffer == nullptr || fr->IndexBufferSize < draw_data->TotalIdxCount)
|
|
{
|
|
if (fr->IndexBuffer)
|
|
{
|
|
wgpuBufferDestroy(fr->IndexBuffer);
|
|
wgpuBufferRelease(fr->IndexBuffer);
|
|
}
|
|
SafeRelease(fr->IndexBufferHost);
|
|
fr->IndexBufferSize = draw_data->TotalIdxCount + 10000;
|
|
|
|
WGPUBufferDescriptor ib_desc =
|
|
{
|
|
nullptr,
|
|
"Dear ImGui Index buffer",
|
|
#ifdef IMGUI_IMPL_WEBGPU_BACKEND_DAWN
|
|
WGPU_STRLEN,
|
|
#endif
|
|
WGPUBufferUsage_CopyDst | WGPUBufferUsage_Index,
|
|
MEMALIGN(fr->IndexBufferSize * sizeof(ImDrawIdx), 4),
|
|
false
|
|
};
|
|
fr->IndexBuffer = wgpuDeviceCreateBuffer(bd->wgpuDevice, &ib_desc);
|
|
if (!fr->IndexBuffer)
|
|
return;
|
|
|
|
fr->IndexBufferHost = new ImDrawIdx[fr->IndexBufferSize];
|
|
}
|
|
|
|
// Upload vertex/index data into a single contiguous GPU buffer
|
|
ImDrawVert* vtx_dst = (ImDrawVert*)fr->VertexBufferHost;
|
|
ImDrawIdx* idx_dst = (ImDrawIdx*)fr->IndexBufferHost;
|
|
for (int n = 0; n < draw_data->CmdListsCount; n++)
|
|
{
|
|
const ImDrawList* draw_list = draw_data->CmdLists[n];
|
|
memcpy(vtx_dst, draw_list->VtxBuffer.Data, draw_list->VtxBuffer.Size * sizeof(ImDrawVert));
|
|
memcpy(idx_dst, draw_list->IdxBuffer.Data, draw_list->IdxBuffer.Size * sizeof(ImDrawIdx));
|
|
vtx_dst += draw_list->VtxBuffer.Size;
|
|
idx_dst += draw_list->IdxBuffer.Size;
|
|
}
|
|
int64_t vb_write_size = MEMALIGN((char*)vtx_dst - (char*)fr->VertexBufferHost, 4);
|
|
int64_t ib_write_size = MEMALIGN((char*)idx_dst - (char*)fr->IndexBufferHost, 4);
|
|
wgpuQueueWriteBuffer(bd->defaultQueue, fr->VertexBuffer, 0, fr->VertexBufferHost, vb_write_size);
|
|
wgpuQueueWriteBuffer(bd->defaultQueue, fr->IndexBuffer, 0, fr->IndexBufferHost, ib_write_size);
|
|
|
|
// Setup desired render state
|
|
ImGui_ImplWGPU_SetupRenderState(draw_data, pass_encoder, fr);
|
|
|
|
// Setup render state structure (for callbacks and custom texture bindings)
|
|
ImGuiPlatformIO& platform_io = ImGui::GetPlatformIO();
|
|
ImGui_ImplWGPU_RenderState render_state;
|
|
render_state.Device = bd->wgpuDevice;
|
|
render_state.RenderPassEncoder = pass_encoder;
|
|
platform_io.Renderer_RenderState = &render_state;
|
|
|
|
// Render command lists
|
|
// (Because we merged all buffers into a single one, we maintain our own offset into them)
|
|
int global_vtx_offset = 0;
|
|
int global_idx_offset = 0;
|
|
ImVec2 clip_scale = draw_data->FramebufferScale;
|
|
ImVec2 clip_off = draw_data->DisplayPos;
|
|
for (int n = 0; n < draw_data->CmdListsCount; n++)
|
|
{
|
|
const ImDrawList* draw_list = draw_data->CmdLists[n];
|
|
for (int cmd_i = 0; cmd_i < draw_list->CmdBuffer.Size; cmd_i++)
|
|
{
|
|
const ImDrawCmd* pcmd = &draw_list->CmdBuffer[cmd_i];
|
|
if (pcmd->UserCallback != nullptr)
|
|
{
|
|
// User callback, registered via ImDrawList::AddCallback()
|
|
// (ImDrawCallback_ResetRenderState is a special callback value used by the user to request the renderer to reset render state.)
|
|
if (pcmd->UserCallback == ImDrawCallback_ResetRenderState)
|
|
ImGui_ImplWGPU_SetupRenderState(draw_data, pass_encoder, fr);
|
|
else
|
|
pcmd->UserCallback(draw_list, pcmd);
|
|
}
|
|
else
|
|
{
|
|
// Bind custom texture
|
|
ImTextureID tex_id = pcmd->GetTexID();
|
|
ImGuiID tex_id_hash = ImHashData(&tex_id, sizeof(tex_id));
|
|
auto bind_group = bd->renderResources.ImageBindGroups.GetVoidPtr(tex_id_hash);
|
|
if (bind_group)
|
|
{
|
|
wgpuRenderPassEncoderSetBindGroup(pass_encoder, 1, (WGPUBindGroup)bind_group, 0, nullptr);
|
|
}
|
|
else
|
|
{
|
|
WGPUBindGroup image_bind_group = ImGui_ImplWGPU_CreateImageBindGroup(bd->renderResources.ImageBindGroupLayout, (WGPUTextureView)tex_id);
|
|
bd->renderResources.ImageBindGroups.SetVoidPtr(tex_id_hash, image_bind_group);
|
|
wgpuRenderPassEncoderSetBindGroup(pass_encoder, 1, image_bind_group, 0, nullptr);
|
|
}
|
|
|
|
// Project scissor/clipping rectangles into framebuffer space
|
|
ImVec2 clip_min((pcmd->ClipRect.x - clip_off.x) * clip_scale.x, (pcmd->ClipRect.y - clip_off.y) * clip_scale.y);
|
|
ImVec2 clip_max((pcmd->ClipRect.z - clip_off.x) * clip_scale.x, (pcmd->ClipRect.w - clip_off.y) * clip_scale.y);
|
|
|
|
// Clamp to viewport as wgpuRenderPassEncoderSetScissorRect() won't accept values that are off bounds
|
|
if (clip_min.x < 0.0f) { clip_min.x = 0.0f; }
|
|
if (clip_min.y < 0.0f) { clip_min.y = 0.0f; }
|
|
if (clip_max.x > fb_width) { clip_max.x = (float)fb_width; }
|
|
if (clip_max.y > fb_height) { clip_max.y = (float)fb_height; }
|
|
if (clip_max.x <= clip_min.x || clip_max.y <= clip_min.y)
|
|
continue;
|
|
|
|
// Apply scissor/clipping rectangle, Draw
|
|
wgpuRenderPassEncoderSetScissorRect(pass_encoder, (uint32_t)clip_min.x, (uint32_t)clip_min.y, (uint32_t)(clip_max.x - clip_min.x), (uint32_t)(clip_max.y - clip_min.y));
|
|
wgpuRenderPassEncoderDrawIndexed(pass_encoder, pcmd->ElemCount, 1, pcmd->IdxOffset + global_idx_offset, pcmd->VtxOffset + global_vtx_offset, 0);
|
|
}
|
|
}
|
|
global_idx_offset += draw_list->IdxBuffer.Size;
|
|
global_vtx_offset += draw_list->VtxBuffer.Size;
|
|
}
|
|
platform_io.Renderer_RenderState = nullptr;
|
|
}
|
|
|
|
static void ImGui_ImplWGPU_CreateFontsTexture()
|
|
{
|
|
// Build texture atlas
|
|
ImGui_ImplWGPU_Data* bd = ImGui_ImplWGPU_GetBackendData();
|
|
ImGuiIO& io = ImGui::GetIO();
|
|
unsigned char* pixels;
|
|
int width, height, size_pp;
|
|
io.Fonts->GetTexDataAsRGBA32(&pixels, &width, &height, &size_pp);
|
|
|
|
// Upload texture to graphics system
|
|
{
|
|
WGPUTextureDescriptor tex_desc = {};
|
|
#ifdef IMGUI_IMPL_WEBGPU_BACKEND_DAWN
|
|
tex_desc.label = { "Dear ImGui Font Texture", WGPU_STRLEN };
|
|
#else
|
|
tex_desc.label = "Dear ImGui Font Texture";
|
|
#endif
|
|
tex_desc.dimension = WGPUTextureDimension_2D;
|
|
tex_desc.size.width = width;
|
|
tex_desc.size.height = height;
|
|
tex_desc.size.depthOrArrayLayers = 1;
|
|
tex_desc.sampleCount = 1;
|
|
tex_desc.format = WGPUTextureFormat_RGBA8Unorm;
|
|
tex_desc.mipLevelCount = 1;
|
|
tex_desc.usage = WGPUTextureUsage_CopyDst | WGPUTextureUsage_TextureBinding;
|
|
bd->renderResources.FontTexture = wgpuDeviceCreateTexture(bd->wgpuDevice, &tex_desc);
|
|
|
|
WGPUTextureViewDescriptor tex_view_desc = {};
|
|
tex_view_desc.format = WGPUTextureFormat_RGBA8Unorm;
|
|
tex_view_desc.dimension = WGPUTextureViewDimension_2D;
|
|
tex_view_desc.baseMipLevel = 0;
|
|
tex_view_desc.mipLevelCount = 1;
|
|
tex_view_desc.baseArrayLayer = 0;
|
|
tex_view_desc.arrayLayerCount = 1;
|
|
tex_view_desc.aspect = WGPUTextureAspect_All;
|
|
bd->renderResources.FontTextureView = wgpuTextureCreateView(bd->renderResources.FontTexture, &tex_view_desc);
|
|
}
|
|
|
|
// Upload texture data
|
|
{
|
|
WGPUImageCopyTexture dst_view = {};
|
|
dst_view.texture = bd->renderResources.FontTexture;
|
|
dst_view.mipLevel = 0;
|
|
dst_view.origin = { 0, 0, 0 };
|
|
dst_view.aspect = WGPUTextureAspect_All;
|
|
WGPUTextureDataLayout layout = {};
|
|
layout.offset = 0;
|
|
layout.bytesPerRow = width * size_pp;
|
|
layout.rowsPerImage = height;
|
|
WGPUExtent3D size = { (uint32_t)width, (uint32_t)height, 1 };
|
|
wgpuQueueWriteTexture(bd->defaultQueue, &dst_view, pixels, (uint32_t)(width * size_pp * height), &layout, &size);
|
|
}
|
|
|
|
// Create the associated sampler
|
|
// (Bilinear sampling is required by default. Set 'io.Fonts->Flags |= ImFontAtlasFlags_NoBakedLines' or 'style.AntiAliasedLinesUseTex = false' to allow point/nearest sampling)
|
|
{
|
|
WGPUSamplerDescriptor sampler_desc = {};
|
|
sampler_desc.minFilter = WGPUFilterMode_Linear;
|
|
sampler_desc.magFilter = WGPUFilterMode_Linear;
|
|
sampler_desc.mipmapFilter = WGPUMipmapFilterMode_Linear;
|
|
sampler_desc.addressModeU = WGPUAddressMode_ClampToEdge;
|
|
sampler_desc.addressModeV = WGPUAddressMode_ClampToEdge;
|
|
sampler_desc.addressModeW = WGPUAddressMode_ClampToEdge;
|
|
sampler_desc.maxAnisotropy = 1;
|
|
bd->renderResources.Sampler = wgpuDeviceCreateSampler(bd->wgpuDevice, &sampler_desc);
|
|
}
|
|
|
|
// Store our identifier
|
|
static_assert(sizeof(ImTextureID) >= sizeof(bd->renderResources.FontTexture), "Can't pack descriptor handle into TexID, 32-bit not supported yet.");
|
|
io.Fonts->SetTexID((ImTextureID)bd->renderResources.FontTextureView);
|
|
}
|
|
|
|
static void ImGui_ImplWGPU_CreateUniformBuffer()
|
|
{
|
|
ImGui_ImplWGPU_Data* bd = ImGui_ImplWGPU_GetBackendData();
|
|
WGPUBufferDescriptor ub_desc =
|
|
{
|
|
nullptr,
|
|
"Dear ImGui Uniform buffer",
|
|
#ifdef IMGUI_IMPL_WEBGPU_BACKEND_DAWN
|
|
WGPU_STRLEN,
|
|
#endif
|
|
WGPUBufferUsage_CopyDst | WGPUBufferUsage_Uniform,
|
|
MEMALIGN(sizeof(Uniforms), 16),
|
|
false
|
|
};
|
|
bd->renderResources.Uniforms = wgpuDeviceCreateBuffer(bd->wgpuDevice, &ub_desc);
|
|
}
|
|
|
|
bool ImGui_ImplWGPU_CreateDeviceObjects()
|
|
{
|
|
ImGui_ImplWGPU_Data* bd = ImGui_ImplWGPU_GetBackendData();
|
|
if (!bd->wgpuDevice)
|
|
return false;
|
|
if (bd->pipelineState)
|
|
ImGui_ImplWGPU_InvalidateDeviceObjects();
|
|
|
|
// Create render pipeline
|
|
WGPURenderPipelineDescriptor graphics_pipeline_desc = {};
|
|
graphics_pipeline_desc.primitive.topology = WGPUPrimitiveTopology_TriangleList;
|
|
graphics_pipeline_desc.primitive.stripIndexFormat = WGPUIndexFormat_Undefined;
|
|
graphics_pipeline_desc.primitive.frontFace = WGPUFrontFace_CW;
|
|
graphics_pipeline_desc.primitive.cullMode = WGPUCullMode_None;
|
|
graphics_pipeline_desc.multisample = bd->initInfo.PipelineMultisampleState;
|
|
|
|
// Bind group layouts
|
|
WGPUBindGroupLayoutEntry common_bg_layout_entries[2] = {};
|
|
common_bg_layout_entries[0].binding = 0;
|
|
common_bg_layout_entries[0].visibility = WGPUShaderStage_Vertex | WGPUShaderStage_Fragment;
|
|
common_bg_layout_entries[0].buffer.type = WGPUBufferBindingType_Uniform;
|
|
common_bg_layout_entries[1].binding = 1;
|
|
common_bg_layout_entries[1].visibility = WGPUShaderStage_Fragment;
|
|
common_bg_layout_entries[1].sampler.type = WGPUSamplerBindingType_Filtering;
|
|
|
|
WGPUBindGroupLayoutEntry image_bg_layout_entries[1] = {};
|
|
image_bg_layout_entries[0].binding = 0;
|
|
image_bg_layout_entries[0].visibility = WGPUShaderStage_Fragment;
|
|
image_bg_layout_entries[0].texture.sampleType = WGPUTextureSampleType_Float;
|
|
image_bg_layout_entries[0].texture.viewDimension = WGPUTextureViewDimension_2D;
|
|
|
|
WGPUBindGroupLayoutDescriptor common_bg_layout_desc = {};
|
|
common_bg_layout_desc.entryCount = 2;
|
|
common_bg_layout_desc.entries = common_bg_layout_entries;
|
|
|
|
WGPUBindGroupLayoutDescriptor image_bg_layout_desc = {};
|
|
image_bg_layout_desc.entryCount = 1;
|
|
image_bg_layout_desc.entries = image_bg_layout_entries;
|
|
|
|
WGPUBindGroupLayout bg_layouts[2];
|
|
bg_layouts[0] = wgpuDeviceCreateBindGroupLayout(bd->wgpuDevice, &common_bg_layout_desc);
|
|
bg_layouts[1] = wgpuDeviceCreateBindGroupLayout(bd->wgpuDevice, &image_bg_layout_desc);
|
|
|
|
WGPUPipelineLayoutDescriptor layout_desc = {};
|
|
layout_desc.bindGroupLayoutCount = 2;
|
|
layout_desc.bindGroupLayouts = bg_layouts;
|
|
graphics_pipeline_desc.layout = wgpuDeviceCreatePipelineLayout(bd->wgpuDevice, &layout_desc);
|
|
|
|
// Create the vertex shader
|
|
WGPUProgrammableStageDescriptor vertex_shader_desc = ImGui_ImplWGPU_CreateShaderModule(__shader_vert_wgsl);
|
|
graphics_pipeline_desc.vertex.module = vertex_shader_desc.module;
|
|
graphics_pipeline_desc.vertex.entryPoint = vertex_shader_desc.entryPoint;
|
|
|
|
// Vertex input configuration
|
|
WGPUVertexAttribute attribute_desc[] =
|
|
{
|
|
{ WGPUVertexFormat_Float32x2, (uint64_t)offsetof(ImDrawVert, pos), 0 },
|
|
{ WGPUVertexFormat_Float32x2, (uint64_t)offsetof(ImDrawVert, uv), 1 },
|
|
{ WGPUVertexFormat_Unorm8x4, (uint64_t)offsetof(ImDrawVert, col), 2 },
|
|
};
|
|
|
|
WGPUVertexBufferLayout buffer_layouts[1];
|
|
buffer_layouts[0].arrayStride = sizeof(ImDrawVert);
|
|
buffer_layouts[0].stepMode = WGPUVertexStepMode_Vertex;
|
|
buffer_layouts[0].attributeCount = 3;
|
|
buffer_layouts[0].attributes = attribute_desc;
|
|
|
|
graphics_pipeline_desc.vertex.bufferCount = 1;
|
|
graphics_pipeline_desc.vertex.buffers = buffer_layouts;
|
|
|
|
// Create the pixel shader
|
|
WGPUProgrammableStageDescriptor pixel_shader_desc = ImGui_ImplWGPU_CreateShaderModule(__shader_frag_wgsl);
|
|
|
|
// Create the blending setup
|
|
WGPUBlendState blend_state = {};
|
|
blend_state.alpha.operation = WGPUBlendOperation_Add;
|
|
blend_state.alpha.srcFactor = WGPUBlendFactor_One;
|
|
blend_state.alpha.dstFactor = WGPUBlendFactor_OneMinusSrcAlpha;
|
|
blend_state.color.operation = WGPUBlendOperation_Add;
|
|
blend_state.color.srcFactor = WGPUBlendFactor_SrcAlpha;
|
|
blend_state.color.dstFactor = WGPUBlendFactor_OneMinusSrcAlpha;
|
|
|
|
WGPUColorTargetState color_state = {};
|
|
color_state.format = bd->renderTargetFormat;
|
|
color_state.blend = &blend_state;
|
|
color_state.writeMask = WGPUColorWriteMask_All;
|
|
|
|
WGPUFragmentState fragment_state = {};
|
|
fragment_state.module = pixel_shader_desc.module;
|
|
fragment_state.entryPoint = pixel_shader_desc.entryPoint;
|
|
fragment_state.targetCount = 1;
|
|
fragment_state.targets = &color_state;
|
|
|
|
graphics_pipeline_desc.fragment = &fragment_state;
|
|
|
|
// Create depth-stencil State
|
|
WGPUDepthStencilState depth_stencil_state = {};
|
|
depth_stencil_state.format = bd->depthStencilFormat;
|
|
#ifdef IMGUI_IMPL_WEBGPU_BACKEND_DAWN
|
|
depth_stencil_state.depthWriteEnabled = WGPUOptionalBool_False;
|
|
#else
|
|
depth_stencil_state.depthWriteEnabled = false;
|
|
#endif
|
|
depth_stencil_state.depthCompare = WGPUCompareFunction_Always;
|
|
depth_stencil_state.stencilFront.compare = WGPUCompareFunction_Always;
|
|
depth_stencil_state.stencilFront.failOp = WGPUStencilOperation_Keep;
|
|
depth_stencil_state.stencilFront.depthFailOp = WGPUStencilOperation_Keep;
|
|
depth_stencil_state.stencilFront.passOp = WGPUStencilOperation_Keep;
|
|
depth_stencil_state.stencilBack.compare = WGPUCompareFunction_Always;
|
|
depth_stencil_state.stencilBack.failOp = WGPUStencilOperation_Keep;
|
|
depth_stencil_state.stencilBack.depthFailOp = WGPUStencilOperation_Keep;
|
|
depth_stencil_state.stencilBack.passOp = WGPUStencilOperation_Keep;
|
|
|
|
// Configure disabled depth-stencil state
|
|
graphics_pipeline_desc.depthStencil = (bd->depthStencilFormat == WGPUTextureFormat_Undefined) ? nullptr : &depth_stencil_state;
|
|
|
|
bd->pipelineState = wgpuDeviceCreateRenderPipeline(bd->wgpuDevice, &graphics_pipeline_desc);
|
|
|
|
ImGui_ImplWGPU_CreateFontsTexture();
|
|
ImGui_ImplWGPU_CreateUniformBuffer();
|
|
|
|
// Create resource bind group
|
|
WGPUBindGroupEntry common_bg_entries[] =
|
|
{
|
|
{ nullptr, 0, bd->renderResources.Uniforms, 0, MEMALIGN(sizeof(Uniforms), 16), 0, 0 },
|
|
{ nullptr, 1, 0, 0, 0, bd->renderResources.Sampler, 0 },
|
|
};
|
|
|
|
WGPUBindGroupDescriptor common_bg_descriptor = {};
|
|
common_bg_descriptor.layout = bg_layouts[0];
|
|
common_bg_descriptor.entryCount = sizeof(common_bg_entries) / sizeof(WGPUBindGroupEntry);
|
|
common_bg_descriptor.entries = common_bg_entries;
|
|
bd->renderResources.CommonBindGroup = wgpuDeviceCreateBindGroup(bd->wgpuDevice, &common_bg_descriptor);
|
|
|
|
WGPUBindGroup image_bind_group = ImGui_ImplWGPU_CreateImageBindGroup(bg_layouts[1], bd->renderResources.FontTextureView);
|
|
bd->renderResources.ImageBindGroup = image_bind_group;
|
|
bd->renderResources.ImageBindGroupLayout = bg_layouts[1];
|
|
bd->renderResources.ImageBindGroups.SetVoidPtr(ImHashData(&bd->renderResources.FontTextureView, sizeof(ImTextureID)), image_bind_group);
|
|
|
|
SafeRelease(vertex_shader_desc.module);
|
|
SafeRelease(pixel_shader_desc.module);
|
|
SafeRelease(graphics_pipeline_desc.layout);
|
|
SafeRelease(bg_layouts[0]);
|
|
|
|
return true;
|
|
}
|
|
|
|
void ImGui_ImplWGPU_InvalidateDeviceObjects()
|
|
{
|
|
ImGui_ImplWGPU_Data* bd = ImGui_ImplWGPU_GetBackendData();
|
|
if (!bd->wgpuDevice)
|
|
return;
|
|
|
|
SafeRelease(bd->pipelineState);
|
|
SafeRelease(bd->renderResources);
|
|
|
|
ImGuiIO& io = ImGui::GetIO();
|
|
io.Fonts->SetTexID(0); // We copied g_pFontTextureView to io.Fonts->TexID so let's clear that as well.
|
|
|
|
for (unsigned int i = 0; i < bd->numFramesInFlight; i++)
|
|
SafeRelease(bd->pFrameResources[i]);
|
|
}
|
|
|
|
bool ImGui_ImplWGPU_Init(ImGui_ImplWGPU_InitInfo* init_info)
|
|
{
|
|
ImGuiIO& io = ImGui::GetIO();
|
|
IMGUI_CHECKVERSION();
|
|
IM_ASSERT(io.BackendRendererUserData == nullptr && "Already initialized a renderer backend!");
|
|
|
|
// Setup backend capabilities flags
|
|
ImGui_ImplWGPU_Data* bd = IM_NEW(ImGui_ImplWGPU_Data)();
|
|
io.BackendRendererUserData = (void*)bd;
|
|
#if defined(__EMSCRIPTEN__)
|
|
io.BackendRendererName = "imgui_impl_webgpu_emscripten";
|
|
#elif defined(IMGUI_IMPL_WEBGPU_BACKEND_DAWN)
|
|
io.BackendRendererName = "imgui_impl_webgpu_dawn";
|
|
#elif defined(IMGUI_IMPL_WEBGPU_BACKEND_WGPU)
|
|
io.BackendRendererName = "imgui_impl_webgpu_wgpu";
|
|
#else
|
|
io.BackendRendererName = "imgui_impl_webgpu";
|
|
#endif
|
|
io.BackendFlags |= ImGuiBackendFlags_RendererHasVtxOffset; // We can honor the ImDrawCmd::VtxOffset field, allowing for large meshes.
|
|
|
|
bd->initInfo = *init_info;
|
|
bd->wgpuDevice = init_info->Device;
|
|
bd->defaultQueue = wgpuDeviceGetQueue(bd->wgpuDevice);
|
|
bd->renderTargetFormat = init_info->RenderTargetFormat;
|
|
bd->depthStencilFormat = init_info->DepthStencilFormat;
|
|
bd->numFramesInFlight = init_info->NumFramesInFlight;
|
|
bd->frameIndex = UINT_MAX;
|
|
|
|
bd->renderResources.FontTexture = nullptr;
|
|
bd->renderResources.FontTextureView = nullptr;
|
|
bd->renderResources.Sampler = nullptr;
|
|
bd->renderResources.Uniforms = nullptr;
|
|
bd->renderResources.CommonBindGroup = nullptr;
|
|
bd->renderResources.ImageBindGroups.Data.reserve(100);
|
|
bd->renderResources.ImageBindGroup = nullptr;
|
|
bd->renderResources.ImageBindGroupLayout = nullptr;
|
|
|
|
// Create buffers with a default size (they will later be grown as needed)
|
|
bd->pFrameResources = new FrameResources[bd->numFramesInFlight];
|
|
for (unsigned int i = 0; i < bd->numFramesInFlight; i++)
|
|
{
|
|
FrameResources* fr = &bd->pFrameResources[i];
|
|
fr->IndexBuffer = nullptr;
|
|
fr->VertexBuffer = nullptr;
|
|
fr->IndexBufferHost = nullptr;
|
|
fr->VertexBufferHost = nullptr;
|
|
fr->IndexBufferSize = 10000;
|
|
fr->VertexBufferSize = 5000;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
void ImGui_ImplWGPU_Shutdown()
|
|
{
|
|
ImGui_ImplWGPU_Data* bd = ImGui_ImplWGPU_GetBackendData();
|
|
IM_ASSERT(bd != nullptr && "No renderer backend to shutdown, or already shutdown?");
|
|
ImGuiIO& io = ImGui::GetIO();
|
|
|
|
ImGui_ImplWGPU_InvalidateDeviceObjects();
|
|
delete[] bd->pFrameResources;
|
|
bd->pFrameResources = nullptr;
|
|
wgpuQueueRelease(bd->defaultQueue);
|
|
bd->wgpuDevice = nullptr;
|
|
bd->numFramesInFlight = 0;
|
|
bd->frameIndex = UINT_MAX;
|
|
|
|
io.BackendRendererName = nullptr;
|
|
io.BackendRendererUserData = nullptr;
|
|
io.BackendFlags &= ~ImGuiBackendFlags_RendererHasVtxOffset;
|
|
IM_DELETE(bd);
|
|
}
|
|
|
|
void ImGui_ImplWGPU_NewFrame()
|
|
{
|
|
ImGui_ImplWGPU_Data* bd = ImGui_ImplWGPU_GetBackendData();
|
|
if (!bd->pipelineState)
|
|
ImGui_ImplWGPU_CreateDeviceObjects();
|
|
}
|
|
|
|
//-----------------------------------------------------------------------------
|
|
|
|
#endif // #ifndef IMGUI_DISABLE
|