EditorImgui.h

Go to the documentation of this file.

#pragma once
 
#if EDITOR
#include "EngineTypes.h"
#include "PolyphaseAPI.h"
 
#include <cstdint>
#include <vector>
#include "imgui.h"
#include "misc/cpp/imgui_stdlib.h"
 
class Object;
class Property;
struct AssetStub;
 
typedef void(*FileBrowserCallbackFP)(const std::vector<std::string>& filePaths);
 
 
void EditorImguiInit();
void EditorImguiDraw();
 
inline bool EditorShortcutModDown()
{
    return ImGui::IsKeyDown(ImGuiMod_Shortcut);
}
 
ImFont* GetEditorTerminalFont();
 
// Queues a rebuild of the editor font atlas at 15px * textScale (0.75 - 2.0).
// Applied at the start of the next frame.
void RequestEditorFontRebuild(float textScale);
float GetEditorTextScale();
 
// 1.0, or the display's backing scale on Retina Macs.
float GetDefaultEditorInterfaceScale();
// Sets EngineConfig::mEditorInterfaceScale (clamped 0.5 - 3.0) and writes Config.ini.
void ApplyEditorInterfaceScale(float scale);
 
void EditorImguiShutdown();
void EditorImguiPreShutdown();
 
void EditorImguiGetViewport(uint32_t& x, uint32_t& y, uint32_t& width, uint32_t& height);
bool EditorIsInterfaceVisible();
bool EditorImguiIsViewportHovered();
void EditorImguiGetViewportRect(float* outX, float* outY, float* outW, float* outH);
void EditorOpenFileBrowser(FileBrowserCallbackFP callback, bool folderMode);
void EditorSetFileBrowserDir(const std::string& dir);
void EditorShowUnsavedAssetsModal(const std::vector<AssetStub*>& unsavedStubs);
 
void EditorShowAlert(const char* title, const char* message);
 
POLYPHASE_API void DrawAssetProperty(Property& prop, uint32_t index, Object* owner, PropertyOwnerType ownerType);
 
void InvalidateAddNodeMenuCache();
 
void InvalidateScriptPickerCache();
 
// Animated progress modal for long-running editor operations (scene save,
// asset save, enter/exit PIE, reload scripts). Long synchronous work in
// these paths would otherwise freeze the UI; calling Pump() at safe
// checkpoints renders one editor frame so the modal animates and the
// status label updates. Only valid to call from non-ImGui contexts -- i.e.
// from the deferred-end-of-frame dispatcher in EditorMain.cpp after
// EditorImguiDraw has returned. Begin/SetStatus/Step/End perform their
// own (throttled) pump.
namespace EditorProgress
{
    // Open the modal. status text is shown immediately. If cancellable is
    // true a Cancel button is rendered; loops should poll WasCancelled().
    void Begin(const char* title, const char* status, bool cancellable = false);
 
    // Update the status label and pump a frame (subject to ~60Hz throttle).
    void SetStatus(const char* msg);
 
    // Set the progress bar. Negative = indeterminate sine marquee; 0..1 =
    // determinate fill. No pump (use SetStatus or Step to redraw).
    void SetFraction(float f);
 
    // Convenience for "Step N of M" loops: updates label + determinate
    // fraction + pumps.
    void Step(const char* msg, int done, int total);
 
    // Force-render one editor frame. Throttled to ~60Hz; ignored when not
    // active. Asserts if called inside an ImGui frame scope.
    void Pump();
 
    // Close the modal and render one final frame.
    void End();
 
    bool IsActive();
    bool WasCancelled();
}
 
#endif