// dear imgui: standalone example application for Android + Vulkan // 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 // Important note to the reader who wish to integrate imgui_impl_vulkan.cpp/.h in their own engine/app. // - Common ImGui_ImplVulkan_XXX functions and structures are used to interface with imgui_impl_vulkan.cpp/.h. // You will use those if you want to use this rendering backend in your engine/app. // - Helper ImGui_ImplVulkanH_XXX functions and structures are only used by this example (main.cpp) and by // the backend itself (imgui_impl_vulkan.cpp), but should PROBABLY NOT be used by your own engine/app code. // Read comments in imgui_impl_vulkan.h. #include "imgui.h" #include "imgui_impl_vulkan.h" #include "imgui_impl_android.h" #include #include #include #include #include #include #define CALL_VK(func) \ if (VK_SUCCESS != (func)) { \ __android_log_print(ANDROID_LOG_ERROR, "ImGuiVulkan", \ "Vulkan error. File[%s], line[%d]", __FILE__, \ __LINE__); \ assert(false); \ } // Forward declarations of helper functions static void Init(struct android_app *app); static void Shutdown(); static int ShowSoftKeyboardInput(); static int PollUnicodeChars(); static int GetAssetData(const char *filename, void **out_data); // Data static struct android_app *g_App = nullptr; static VkAllocationCallbacks *g_Allocator = nullptr; static VkInstance g_Instance = VK_NULL_HANDLE; static VkPhysicalDevice g_PhysicalDevice = VK_NULL_HANDLE; static VkDevice g_Device = VK_NULL_HANDLE; static uint32_t g_QueueFamily = (uint32_t) -1; static VkQueue g_Queue = VK_NULL_HANDLE; static VkPipelineCache g_PipelineCache = VK_NULL_HANDLE; static VkDescriptorPool g_DescriptorPool = VK_NULL_HANDLE; static ImGui_ImplVulkanH_Window g_MainWindowData; static uint32_t g_MinImageCount = 2; static bool g_SwapChainRebuild = false; static bool g_Initialized = false; static std::string g_IniFilename; static void check_vk_result(VkResult err) { if (err == VK_SUCCESS) return; __android_log_print(ANDROID_LOG_ERROR, "ImGuiVulkan", "Error: VkResult = %d\n", err); if (err < 0) abort(); } #ifndef NDEBUG static VkDebugUtilsMessengerEXT g_DebugMessenger = VK_NULL_HANDLE; static VKAPI_ATTR VkBool32 VKAPI_CALL debugCallback( VkDebugUtilsMessageSeverityFlagBitsEXT messageSeverity, VkDebugUtilsMessageTypeFlagsEXT messageTypes, const VkDebugUtilsMessengerCallbackDataEXT *callbackData, void *userData) { const char validation[] = "Validation"; const char performance[] = "Performance"; const char error[] = "ERROR"; const char warning[] = "WARNING"; const char unknownType[] = "UNKNOWN_TYPE"; const char unknownSeverity[] = "UNKNOWN_SEVERITY"; const char *typeString = unknownType; const char *severityString = unknownSeverity; const char *messageIdName = callbackData->pMessageIdName; int32_t messageIdNumber = callbackData->messageIdNumber; const char *message = callbackData->pMessage; android_LogPriority priority = ANDROID_LOG_UNKNOWN; if (messageSeverity & VK_DEBUG_UTILS_MESSAGE_SEVERITY_ERROR_BIT_EXT) { severityString = error; priority = ANDROID_LOG_ERROR; } else if (messageSeverity & VK_DEBUG_UTILS_MESSAGE_SEVERITY_WARNING_BIT_EXT) { severityString = warning; priority = ANDROID_LOG_WARN; } if (messageTypes & VK_DEBUG_UTILS_MESSAGE_TYPE_VALIDATION_BIT_EXT) { typeString = validation; } else if (messageTypes & VK_DEBUG_UTILS_MESSAGE_TYPE_PERFORMANCE_BIT_EXT) { typeString = performance; } __android_log_print(priority, "ImGuiVulkan", "%s %s: [%s] Code %i : %s", typeString, severityString, messageIdName, messageIdNumber, message); return VK_FALSE; } #endif // NDEBUG static bool IsExtensionAvailable(const ImVector &properties, const char *extension) { for (const VkExtensionProperties &p: properties) if (strcmp(p.extensionName, extension) == 0) return true; return false; } static void SetupVulkan(ImVector instance_extensions) { VkResult err; // Create Vulkan Instance { VkInstanceCreateInfo createInfo = {}; createInfo.sType = VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO; // Enumerate available extensions uint32_t properties_count; ImVector properties; vkEnumerateInstanceExtensionProperties(nullptr, &properties_count, nullptr); properties.resize(properties_count); CALL_VK(vkEnumerateInstanceExtensionProperties(nullptr, &properties_count, properties.Data)); // Enable required extensions if (IsExtensionAvailable(properties, VK_KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_EXTENSION_NAME)) instance_extensions.push_back(VK_KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_EXTENSION_NAME); #ifdef VK_KHR_PORTABILITY_ENUMERATION_EXTENSION_NAME if (IsExtensionAvailable(properties, VK_KHR_PORTABILITY_ENUMERATION_EXTENSION_NAME)) { instance_extensions.push_back(VK_KHR_PORTABILITY_ENUMERATION_EXTENSION_NAME); createInfo.flags |= VK_INSTANCE_CREATE_ENUMERATE_PORTABILITY_BIT_KHR; } #endif // Enabling validation layers #ifndef NDEBUG const char *layers[] = {"VK_LAYER_KHRONOS_validation"}; createInfo.enabledLayerCount = 1; createInfo.ppEnabledLayerNames = layers; instance_extensions.push_back(VK_EXT_DEBUG_UTILS_EXTENSION_NAME); #endif // Create Vulkan Instance createInfo.enabledExtensionCount = instance_extensions.Size; createInfo.ppEnabledExtensionNames = instance_extensions.Data; CALL_VK(vkCreateInstance(&createInfo, g_Allocator, &g_Instance)); // Setup the debug report callback #ifndef NDEBUG auto vkCreateDebugUtilsMessengerEXT = (PFN_vkCreateDebugUtilsMessengerEXT) vkGetInstanceProcAddr(g_Instance, "vkCreateDebugUtilsMessengerEXT"); IM_ASSERT(vkCreateDebugUtilsMessengerEXT != nullptr); VkDebugUtilsMessengerCreateInfoEXT debugUtilsCi{}; debugUtilsCi.sType = VK_STRUCTURE_TYPE_DEBUG_UTILS_MESSENGER_CREATE_INFO_EXT; debugUtilsCi.messageSeverity = VK_DEBUG_UTILS_MESSAGE_SEVERITY_ERROR_BIT_EXT | VK_DEBUG_UTILS_MESSAGE_SEVERITY_WARNING_BIT_EXT | VK_DEBUG_UTILS_MESSAGE_SEVERITY_INFO_BIT_EXT; debugUtilsCi.messageType = VK_DEBUG_UTILS_MESSAGE_TYPE_GENERAL_BIT_EXT | VK_DEBUG_UTILS_MESSAGE_TYPE_VALIDATION_BIT_EXT | VK_DEBUG_UTILS_MESSAGE_TYPE_PERFORMANCE_BIT_EXT; debugUtilsCi.pfnUserCallback = debugCallback; debugUtilsCi.pUserData = nullptr; CALL_VK(vkCreateDebugUtilsMessengerEXT(g_Instance, &debugUtilsCi, g_Allocator, &g_DebugMessenger)); #endif } // Select Physical Device (GPU) g_PhysicalDevice = ImGui_ImplVulkanH_SelectPhysicalDevice(g_Instance); IM_ASSERT(g_PhysicalDevice != VK_NULL_HANDLE); // Select graphics queue family g_QueueFamily = ImGui_ImplVulkanH_SelectQueueFamilyIndex(g_PhysicalDevice); IM_ASSERT(g_QueueFamily != (uint32_t) -1); // Create Logical Device (with 1 queue) { ImVector device_extensions; device_extensions.push_back(VK_KHR_SWAPCHAIN_EXTENSION_NAME); // Enumerate physical device extension uint32_t properties_count; ImVector properties; vkEnumerateDeviceExtensionProperties(g_PhysicalDevice, nullptr, &properties_count, nullptr); properties.resize(properties_count); CALL_VK(vkEnumerateDeviceExtensionProperties(g_PhysicalDevice, nullptr, &properties_count, properties.Data)); #ifdef VK_KHR_PORTABILITY_SUBSET_EXTENSION_NAME if (IsExtensionAvailable(properties, VK_KHR_PORTABILITY_SUBSET_EXTENSION_NAME)) device_extensions.push_back(VK_KHR_PORTABILITY_SUBSET_EXTENSION_NAME); #endif const float queue_priority[] = {1.0f}; VkDeviceQueueCreateInfo queue_info[1] = {}; queue_info[0].sType = VK_STRUCTURE_TYPE_DEVICE_QUEUE_CREATE_INFO; queue_info[0].queueFamilyIndex = g_QueueFamily; queue_info[0].queueCount = 1; queue_info[0].pQueuePriorities = queue_priority; VkDeviceCreateInfo create_info = {}; create_info.sType = VK_STRUCTURE_TYPE_DEVICE_CREATE_INFO; create_info.queueCreateInfoCount = sizeof(queue_info) / sizeof(queue_info[0]); create_info.pQueueCreateInfos = queue_info; create_info.enabledExtensionCount = (uint32_t) device_extensions.Size; create_info.ppEnabledExtensionNames = device_extensions.Data; CALL_VK(vkCreateDevice(g_PhysicalDevice, &create_info, g_Allocator, &g_Device)); vkGetDeviceQueue(g_Device, g_QueueFamily, 0, &g_Queue); } // Create Descriptor Pool // If you wish to load e.g. additional textures you may need to alter pools sizes and maxSets. { VkDescriptorPoolSize pool_sizes[] = { {VK_DESCRIPTOR_TYPE_SAMPLED_IMAGE, IMGUI_IMPL_VULKAN_MINIMUM_SAMPLED_IMAGE_POOL_SIZE}, {VK_DESCRIPTOR_TYPE_SAMPLER, IMGUI_IMPL_VULKAN_MINIMUM_SAMPLER_POOL_SIZE}, }; VkDescriptorPoolCreateInfo pool_info = {}; pool_info.sType = VK_STRUCTURE_TYPE_DESCRIPTOR_POOL_CREATE_INFO; pool_info.flags = VK_DESCRIPTOR_POOL_CREATE_FREE_DESCRIPTOR_SET_BIT; pool_info.maxSets = 0; for (VkDescriptorPoolSize &pool_size: pool_sizes) pool_info.maxSets += pool_size.descriptorCount; pool_info.poolSizeCount = (uint32_t) IM_COUNTOF(pool_sizes); pool_info.pPoolSizes = pool_sizes; CALL_VK(vkCreateDescriptorPool(g_Device, &pool_info, g_Allocator, &g_DescriptorPool)); } } // All the ImGui_ImplVulkanH_XXX structures/functions are optional helpers used by the demo. // Your real engine/app may not use them. static void SetupVulkanWindow(ImGui_ImplVulkanH_Window *wd, VkSurfaceKHR surface, int width, int height) { // Check for WSI support VkBool32 res; vkGetPhysicalDeviceSurfaceSupportKHR(g_PhysicalDevice, g_QueueFamily, surface, &res); if (res != VK_TRUE) { __android_log_print( ANDROID_LOG_ERROR, "Vulkan", "No WSI support on physical device" ); abort(); } // Select Surface Format const VkFormat requestSurfaceImageFormat[] = {VK_FORMAT_B8G8R8A8_UNORM, VK_FORMAT_R8G8B8A8_UNORM, VK_FORMAT_B8G8R8_UNORM, VK_FORMAT_R8G8B8_UNORM}; const VkColorSpaceKHR requestSurfaceColorSpace = VK_COLORSPACE_SRGB_NONLINEAR_KHR; wd->Surface = surface; wd->SurfaceFormat = ImGui_ImplVulkanH_SelectSurfaceFormat(g_PhysicalDevice, wd->Surface, requestSurfaceImageFormat, (size_t) IM_COUNTOF(requestSurfaceImageFormat), requestSurfaceColorSpace); // Select Present Mode #ifdef APP_USE_UNLIMITED_FRAME_RATE VkPresentModeKHR present_modes[] = { VK_PRESENT_MODE_MAILBOX_KHR, VK_PRESENT_MODE_IMMEDIATE_KHR, VK_PRESENT_MODE_FIFO_KHR }; #else VkPresentModeKHR present_modes[] = {VK_PRESENT_MODE_FIFO_KHR}; #endif wd->PresentMode = ImGui_ImplVulkanH_SelectPresentMode(g_PhysicalDevice, wd->Surface, &present_modes[0], IM_COUNTOF(present_modes)); //__android_log_print(ANDROID_LOG_INFO, "ImGuiVulkan", "Selected PresentMode = %d\n", wd->PresentMode); // Create SwapChain, RenderPass, Framebuffer, etc. IM_ASSERT(g_MinImageCount >= 2); ImGui_ImplVulkanH_CreateOrResizeWindow(g_Instance, g_PhysicalDevice, g_Device, wd, g_QueueFamily, g_Allocator, width, height, g_MinImageCount, 0); } static void CleanupVulkan() { vkDestroyDescriptorPool(g_Device, g_DescriptorPool, g_Allocator); #ifndef NDEBUG // Remove the debug utils callback auto vkDestroyDebugUtilsMessengerEXT = (PFN_vkDestroyDebugUtilsMessengerEXT) vkGetInstanceProcAddr(g_Instance, "vkDestroyDebugUtilsMessengerEXT"); vkDestroyDebugUtilsMessengerEXT(g_Instance, g_DebugMessenger, g_Allocator); #endif vkDestroyDevice(g_Device, g_Allocator); vkDestroyInstance(g_Instance, g_Allocator); } static void CleanupVulkanWindow(ImGui_ImplVulkanH_Window *wd) { ImGui_ImplVulkanH_DestroyWindow(g_Instance, g_Device, wd, g_Allocator); vkDestroySurfaceKHR(g_Instance, wd->Surface, g_Allocator); } static void FrameRender(ImGui_ImplVulkanH_Window *wd, ImDrawData *draw_data) { VkSemaphore image_acquired_semaphore = wd->FrameSemaphores[wd->SemaphoreIndex].ImageAcquiredSemaphore; VkSemaphore render_complete_semaphore = wd->FrameSemaphores[wd->SemaphoreIndex].RenderCompleteSemaphore; VkResult err = vkAcquireNextImageKHR(g_Device, wd->Swapchain, UINT64_MAX, image_acquired_semaphore, VK_NULL_HANDLE, &wd->FrameIndex); if (err == VK_ERROR_OUT_OF_DATE_KHR || err == VK_SUBOPTIMAL_KHR) g_SwapChainRebuild = true; if (err == VK_ERROR_OUT_OF_DATE_KHR) return; if (err != VK_SUBOPTIMAL_KHR) check_vk_result(err); ImGui_ImplVulkanH_Frame *fd = &wd->Frames[wd->FrameIndex]; { CALL_VK(vkWaitForFences(g_Device, 1, &fd->Fence, VK_TRUE, UINT64_MAX)); // wait indefinitely instead of periodically checking CALL_VK(vkResetFences(g_Device, 1, &fd->Fence)); } { CALL_VK(vkResetCommandPool(g_Device, fd->CommandPool, 0)); VkCommandBufferBeginInfo info = {}; info.sType = VK_STRUCTURE_TYPE_COMMAND_BUFFER_BEGIN_INFO; info.flags |= VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT; CALL_VK(vkBeginCommandBuffer(fd->CommandBuffer, &info)); } { VkRenderPassBeginInfo info = {}; info.sType = VK_STRUCTURE_TYPE_RENDER_PASS_BEGIN_INFO; info.renderPass = wd->RenderPass; info.framebuffer = fd->Framebuffer; info.renderArea.extent.width = wd->Width; info.renderArea.extent.height = wd->Height; info.clearValueCount = 1; info.pClearValues = &wd->ClearValue; vkCmdBeginRenderPass(fd->CommandBuffer, &info, VK_SUBPASS_CONTENTS_INLINE); } // Record dear imgui primitives into command buffer ImGui_ImplVulkan_RenderDrawData(draw_data, fd->CommandBuffer); // Submit command buffer vkCmdEndRenderPass(fd->CommandBuffer); { VkPipelineStageFlags wait_stage = VK_PIPELINE_STAGE_COLOR_ATTACHMENT_OUTPUT_BIT; VkSubmitInfo info = {}; info.sType = VK_STRUCTURE_TYPE_SUBMIT_INFO; info.waitSemaphoreCount = 1; info.pWaitSemaphores = &image_acquired_semaphore; info.pWaitDstStageMask = &wait_stage; info.commandBufferCount = 1; info.pCommandBuffers = &fd->CommandBuffer; info.signalSemaphoreCount = 1; info.pSignalSemaphores = &render_complete_semaphore; CALL_VK(vkEndCommandBuffer(fd->CommandBuffer)); CALL_VK(vkQueueSubmit(g_Queue, 1, &info, fd->Fence)); } } static void FramePresent(ImGui_ImplVulkanH_Window *wd) { if (g_SwapChainRebuild) return; VkSemaphore render_complete_semaphore = wd->FrameSemaphores[wd->SemaphoreIndex].RenderCompleteSemaphore; VkPresentInfoKHR info = {}; info.sType = VK_STRUCTURE_TYPE_PRESENT_INFO_KHR; info.waitSemaphoreCount = 1; info.pWaitSemaphores = &render_complete_semaphore; info.swapchainCount = 1; info.pSwapchains = &wd->Swapchain; info.pImageIndices = &wd->FrameIndex; VkResult err = vkQueuePresentKHR(g_Queue, &info); if (err == VK_ERROR_OUT_OF_DATE_KHR || err == VK_SUBOPTIMAL_KHR) g_SwapChainRebuild = true; if (err == VK_ERROR_OUT_OF_DATE_KHR) return; if (err != VK_SUBOPTIMAL_KHR) check_vk_result(err); wd->SemaphoreIndex = (wd->SemaphoreIndex + 1) % wd->SemaphoreCount; // Now we can use the next set of semaphores } extern "C" { static void Init(struct android_app *app) { if (g_Initialized) return; g_App = app; ANativeWindow_acquire(app->window); ImVector extensions; extensions.push_back(VK_KHR_SURFACE_EXTENSION_NAME); extensions.push_back(VK_KHR_ANDROID_SURFACE_EXTENSION_NAME); SetupVulkan(extensions); // Create Window Surface VkSurfaceKHR surface; VkAndroidSurfaceCreateInfoKHR createInfo{ .sType = VK_STRUCTURE_TYPE_ANDROID_SURFACE_CREATE_INFO_KHR, .pNext = nullptr, .flags = 0, .window = app->window, }; CALL_VK(vkCreateAndroidSurfaceKHR(g_Instance, &createInfo, g_Allocator, &surface)); // Create Framebuffers int w = ANativeWindow_getWidth(app->window); int h = ANativeWindow_getHeight(app->window); ImGui_ImplVulkanH_Window *wd = &g_MainWindowData; SetupVulkanWindow(wd, surface, w, h); // Setup Dear ImGui context IMGUI_CHECKVERSION(); ImGui::CreateContext(); ImGuiIO &io = ImGui::GetIO(); // Redirect loading/saving of .ini file to our location. // Make sure 'g_IniFilename' persists while we use Dear ImGui. g_IniFilename = std::string(app->activity->internalDataPath) + "/imgui.ini"; io.IniFilename = g_IniFilename.c_str(); // Setup Dear ImGui style ImGui::StyleColorsDark(); //ImGui::StyleColorsLight(); // Setup scaling float main_scale = AConfiguration_getDensity(app->config) / 160.0f; ImGuiStyle &style = ImGui::GetStyle(); style.ScaleAllSizes(main_scale); // Bake a fixed style scale. (until we have a solution for dynamic style scaling, changing this requires resetting Style + calling this again) style.FontScaleDpi = main_scale; // Set initial font scale. (in docking branch: using io.ConfigDpiScaleFonts=true automatically overrides this for every window depending on the current monitor) // Setup Platform/Renderer backends ImGui_ImplAndroid_Init(app->window); ImGui_ImplVulkan_InitInfo init_info = {}; //init_info.ApiVersion = VK_API_VERSION_1_3; // Pass in your value of VkApplicationInfo::apiVersion, otherwise will default to header version. init_info.Instance = g_Instance; init_info.PhysicalDevice = g_PhysicalDevice; init_info.Device = g_Device; init_info.QueueFamily = g_QueueFamily; init_info.Queue = g_Queue; init_info.PipelineCache = g_PipelineCache; init_info.DescriptorPool = g_DescriptorPool; init_info.MinImageCount = g_MinImageCount; init_info.ImageCount = wd->ImageCount; init_info.Allocator = g_Allocator; init_info.PipelineInfoMain.RenderPass = wd->RenderPass; init_info.PipelineInfoMain.Subpass = 0; init_info.PipelineInfoMain.MSAASamples = VK_SAMPLE_COUNT_1_BIT; init_info.CheckVkResultFn = check_vk_result; ImGui_ImplVulkan_Init(&init_info); // Load Fonts // - If fonts are not explicitly loaded, Dear ImGui will select an embedded font: either AddFontDefaultVector() or AddFontDefaultBitmap(). // This selection is based on (style.FontSizeBase * style.FontScaleMain * style.FontScaleDpi) reaching a small threshold. // - You can load multiple fonts and use ImGui::PushFont()/PopFont() to select them. // - If a file cannot be loaded, AddFont functions will return a nullptr. Please handle those errors in your code (e.g. use an assertion, display an error and quit). // - Read 'docs/FONTS.md' for more instructions and details. // - Use '#define IMGUI_ENABLE_FREETYPE' in your imconfig file to use FreeType for higher quality font rendering. // - Remember that in C/C++ if you want to include a backslash \ in a string literal you need to write a double backslash \\ ! // - Android: The TTF files have to be placed into the assets/ directory (android/app/src/main/assets), we use our GetAssetData() helper to retrieve them. //style.FontSizeBase = 20.0f; //io.Fonts->AddFontDefaultVector(); //io.Fonts->AddFontDefaultBitmap(); // Important: when calling AddFontFromMemoryTTF(), ownership of font_data is transferred by Dear ImGui by default (deleted is handled by Dear ImGui), unless we set FontDataOwnedByAtlas=false in ImFontConfig //void* font_data; //int font_data_size; //ImFont* font; //font_data_size = GetAssetData("segoeui.ttf", &font_data); //font = io.Fonts->AddFontFromMemoryTTF(font_data, font_data_size); //IM_ASSERT(font != nullptr); //font_data_size = GetAssetData("DroidSans.ttf", &font_data); //font = io.Fonts->AddFontFromMemoryTTF(font_data, font_data_size); //IM_ASSERT(font != nullptr); //font_data_size = GetAssetData("Roboto-Medium.ttf", &font_data); //font = io.Fonts->AddFontFromMemoryTTF(font_data, font_data_size); //IM_ASSERT(font != nullptr); //font_data_size = GetAssetData("Cousine-Regular.ttf", &font_data); //font = io.Fonts->AddFontFromMemoryTTF(font_data, font_data_size); //IM_ASSERT(font != nullptr); //font_data_size = GetAssetData("ArialUni.ttf", &font_data); //font = io.Fonts->AddFontFromMemoryTTF(font_data, font_data_size); //IM_ASSERT(font != nullptr); g_Initialized = true; } static void Shutdown() { if (!g_Initialized) return; CALL_VK(vkDeviceWaitIdle(g_Device)); ImGui_ImplVulkan_Shutdown(); ImGui_ImplAndroid_Shutdown(); ImGui::DestroyContext(); CleanupVulkanWindow(&g_MainWindowData); CleanupVulkan(); ANativeWindow_release(g_App->window); g_Initialized = false; } static void handleAppCmd(struct android_app *app, int32_t appCmd) { switch (appCmd) { case APP_CMD_SAVE_STATE: break; case APP_CMD_INIT_WINDOW: Init(app); break; case APP_CMD_TERM_WINDOW: Shutdown(); break; case APP_CMD_GAINED_FOCUS: case APP_CMD_LOST_FOCUS: break; } } static int32_t handleInputEvent(struct android_app *app, AInputEvent *inputEvent) { return ImGui_ImplAndroid_HandleInputEvent(inputEvent); } /*! * This the main entry point for a native activity */ void android_main(struct android_app *pApp) { pApp->onAppCmd = handleAppCmd; pApp->onInputEvent = handleInputEvent; // This sets up a typical game/event loop. It will run until the app is destroyed. do { // Process all pending events before running game logic. bool done = false; while (!done) { // 0 is non-blocking. int timeout = g_Initialized ? 0 : -1; int events; android_poll_source *pSource; int result = ALooper_pollOnce(timeout, nullptr, &events, reinterpret_cast(&pSource)); switch (result) { case ALOOPER_POLL_TIMEOUT: [[clang::fallthrough]]; case ALOOPER_POLL_WAKE: // No events occurred before the timeout or explicit wake. Stop checking for events. done = true; break; case ALOOPER_EVENT_ERROR: __android_log_print(ANDROID_LOG_INFO, "ImGuiVulkan", "ALooper_pollOnce returned an error"); break; case ALOOPER_POLL_CALLBACK: break; default: if (pSource) { pSource->process(pApp, pSource); } } } if (g_Initialized) { // Our state // (we use static, which essentially makes the variable globals, as a convenience to keep the example code easy to follow) static bool show_demo_window = true; static bool show_another_window = false; static ImVec4 clear_color = ImVec4(0.45f, 0.55f, 0.60f, 1.00f); // Poll and handle events (inputs, window resize, etc.) // You can read the io.WantCaptureMouse, io.WantCaptureKeyboard flags to tell if dear imgui wants to use your inputs. // - When io.WantCaptureMouse is true, do not dispatch mouse input data to your main application, or clear/overwrite your copy of the mouse data. // - When io.WantCaptureKeyboard is true, do not dispatch keyboard input data to your main application, or clear/overwrite your copy of the keyboard data. // Generally you may always pass all inputs to dear imgui, and hide them from your application based on those two flags. // Process game input ImGuiIO &io = ImGui::GetIO(); // Poll Unicode characters via JNI // FIXME: do not call this every frame because of JNI overhead PollUnicodeChars(); // Open on-screen (soft) input if requested by Dear ImGui static bool WantTextInputLast = false; if (io.WantTextInput && !WantTextInputLast) ShowSoftKeyboardInput(); WantTextInputLast = io.WantTextInput; // Resize swap chain? int fb_width = ANativeWindow_getWidth(pApp->window), fb_height = ANativeWindow_getHeight(pApp->window); if (fb_width > 0 && fb_height > 0 && (g_SwapChainRebuild || g_MainWindowData.Width != fb_width || g_MainWindowData.Height != fb_height)) { ImGui_ImplVulkan_SetMinImageCount(g_MinImageCount); ImGui_ImplVulkanH_CreateOrResizeWindow(g_Instance, g_PhysicalDevice, g_Device, &g_MainWindowData, g_QueueFamily, g_Allocator, fb_width, fb_height, g_MinImageCount, 0); g_MainWindowData.FrameIndex = 0; g_SwapChainRebuild = false; } // Start the Dear ImGui frame ImGui_ImplVulkan_NewFrame(); ImGui_ImplAndroid_NewFrame(); ImGui::NewFrame(); // 1. Show the big demo window (Most of the sample code is in ImGui::ShowDemoWindow()! You can browse its code to learn more about Dear ImGui!). if (show_demo_window) ImGui::ShowDemoWindow(&show_demo_window); // 2. Show a simple window that we create ourselves. We use a Begin/End pair to create a named window. { static float f = 0.0f; static int counter = 0; ImGui::Begin("Hello, world!"); // Create a window called "Hello, world!" and append into it. ImGui::Text("This is some useful text."); // Display some text (you can use a format strings too) ImGui::Checkbox("Demo Window", &show_demo_window); // Edit bools storing our window open/close state ImGui::Checkbox("Another Window", &show_another_window); ImGui::SliderFloat("float", &f, 0.0f, 1.0f); // Edit 1 float using a slider from 0.0f to 1.0f ImGui::ColorEdit3("clear color", (float *) &clear_color); // Edit 3 floats representing a color if (ImGui::Button("Button")) // Buttons return true when clicked (most widgets return true when edited/activated) counter++; ImGui::SameLine(); ImGui::Text("counter = %d", counter); ImGui::Text("Application average %.3f ms/frame (%.1f FPS)", 1000.0f / io.Framerate, io.Framerate); ImGui::End(); } // 3. Show another simple window. if (show_another_window) { ImGui::Begin("Another Window", &show_another_window); // Pass a pointer to our bool variable (the window will have a closing button that will clear the bool when clicked) ImGui::Text("Hello from another window!"); if (ImGui::Button("Close Me")) show_another_window = false; ImGui::End(); } // Rendering ImGui::Render(); ImGui_ImplVulkanH_Window *wd = &g_MainWindowData; ImDrawData *draw_data = ImGui::GetDrawData(); const bool is_minimized = (draw_data->DisplaySize.x <= 0.0f || draw_data->DisplaySize.y <= 0.0f); if (!is_minimized) { wd->ClearValue.color.float32[0] = clear_color.x * clear_color.w; wd->ClearValue.color.float32[1] = clear_color.y * clear_color.w; wd->ClearValue.color.float32[2] = clear_color.z * clear_color.w; wd->ClearValue.color.float32[3] = clear_color.w; FrameRender(wd, draw_data); FramePresent(wd); } } } while (!pApp->destroyRequested); // shutdown() should have been called already while processing the // app command APP_CMD_TERM_WINDOW. But we play save here if (g_Initialized) Shutdown(); } } // Helper functions // Unfortunately, there is no way to show the on-screen input from native code. // Therefore, we call ShowSoftKeyboardInput() of the main activity implemented in MainActivity.kt via JNI. static int ShowSoftKeyboardInput() { JavaVM *java_vm = g_App->activity->vm; JNIEnv *java_env = nullptr; jint jni_return = java_vm->GetEnv((void **) &java_env, JNI_VERSION_1_6); if (jni_return == JNI_ERR) return -1; jni_return = java_vm->AttachCurrentThread(&java_env, nullptr); if (jni_return != JNI_OK) return -2; jclass native_activity_clazz = java_env->GetObjectClass(g_App->activity->clazz); if (native_activity_clazz == nullptr) return -3; jmethodID method_id = java_env->GetMethodID(native_activity_clazz, "showSoftInput", "()V"); if (method_id == nullptr) return -4; java_env->CallVoidMethod(g_App->activity->clazz, method_id); jni_return = java_vm->DetachCurrentThread(); if (jni_return != JNI_OK) return -5; return 0; } // Unfortunately, the native KeyEvent implementation has no getUnicodeChar() function. // Therefore, we implement the processing of KeyEvents in MainActivity.kt and poll // the resulting Unicode characters here via JNI and send them to Dear ImGui. static int PollUnicodeChars() { JavaVM *java_vm = g_App->activity->vm; JNIEnv *java_env = nullptr; jint jni_return = java_vm->GetEnv((void **) &java_env, JNI_VERSION_1_6); if (jni_return == JNI_ERR) return -1; jni_return = java_vm->AttachCurrentThread(&java_env, nullptr); if (jni_return != JNI_OK) return -2; jclass native_activity_clazz = java_env->GetObjectClass(g_App->activity->clazz); if (native_activity_clazz == nullptr) return -3; jmethodID method_id = java_env->GetMethodID(native_activity_clazz, "pollUnicodeChar", "()I"); if (method_id == nullptr) return -4; // Send the actual characters to Dear ImGui ImGuiIO &io = ImGui::GetIO(); jint unicode_character; while ((unicode_character = java_env->CallIntMethod(g_App->activity->clazz, method_id)) != 0) io.AddInputCharacter(unicode_character); jni_return = java_vm->DetachCurrentThread(); if (jni_return != JNI_OK) return -5; return 0; } // Helper to retrieve data placed into the assets/ directory (android/app/src/main/assets) static int GetAssetData(const char *filename, void **outData) { int num_bytes = 0; AAsset *asset_descriptor = AAssetManager_open(g_App->activity->assetManager, filename, AASSET_MODE_BUFFER); if (asset_descriptor) { num_bytes = AAsset_getLength(asset_descriptor); *outData = IM_ALLOC(num_bytes); int64_t num_bytes_read = AAsset_read(asset_descriptor, *outData, num_bytes); AAsset_close(asset_descriptor); IM_ASSERT(num_bytes_read == num_bytes); } return num_bytes; }