Inno.Editor.ImGui
Section titled “Inno.Editor.ImGui”
- Scoped Editor UI primitives, shared semantic metrics, pointer-free drawing and interaction rendering bridges.
Scoped Editor UI primitives, shared semantic metrics, pointer-free drawing and interaction rendering bridges.
Use an active UI session
Section titled “Use an active UI session”Build consistent controls explains synchronous session/context ownership, borrowed draw lists/fonts, one-scale metrics, constrained layouts, shared forms/cards/menus/dialogs, input capture and native hit testing. This library does not own Scene, Selection or panel business state.
Host and script facades are distinct. The selected logical API exposes pointer-free calls and neutral options, not userdata, backend texture IDs or internal pointer helpers. The engine-authored facade is documented here; upstream native/binding member mirrors remain outside scope.
Preserve balanced presentation and retirement
Section titled “Preserve balanced presentation and retirement”Runtime-owned scopes unwind through failures; individual extensions are quarantined without corrupting the surrounding draw stack. Pending interaction retirement retains its owner and cannot authorize native-context disposal. Current-frame/session validation applies even when a draw-list value is copied.
Palette supplies generic semantic colors and metrics supply shared geometry; domain owners interpret asset and Shader categories. Gesture and dialog state stays session-owned and neutral. Existing real-context widget regressions cover geometry/input boundaries, while product/device and complete visual journeys remain separate evidence.
Host examples
Section titled “Host examples”These use the actual host contracts and borrowed live dependencies. They do not initialize a product or establish lifecycle/device acceptance.
using Inno.Editor.ImGui;
public static class Example0{ static void DrawEngineLabel() { ImGui.Text(ImGuiIcon.Inno + " InnoEngine"); }}using System;using Inno.Editor.ImGui;using Inno.Editor.ImGui.ImGuiWidget;
public static class Example1{ static bool DrawCardHeader( string id, string title, bool enabled, float trailingControlWidth, Action drawLeadingControl, Action drawTrailingControl, Action drawContextMenu ) { return EditorUiSession.current.widgets.CollapsingCard(id, title, drawLeadingControl: drawLeadingControl, drawTrailingControl: drawTrailingControl, defaultOpen: true, dimmed: !enabled, trailingControlWidth: trailingControlWidth, drawContextMenu: drawContextMenu); }}using System;using Inno.Editor.ImGui;using Inno.Editor.ImGui;using Inno.Editor.ImGui.ImGuiWidget;
public static class Example2{ static void DrawOpenCardBody( bool open, string id, bool enabled, Action drawContent ) { if (!open) return; try { EditorUiSession.current.widgets.CardBody(id, drawContent: drawContent, dimmed: !enabled); } finally { ImGui.TreePop(); } }}Script examples
Section titled “Script examples”Source boundary
Section titled “Source boundary”Source project. Declarations, script selection and runtime behavior require separate matching evidence.
API reference
Section titled “API reference”Types and exact member contracts retain the engine-owned declarations and captured XML.
Logical script references
Section titled “Logical script references”The compiler-selected script declarations are separate from this project’s host CLR surface. Read the script calling guide and the associated module contracts before using a projected member.
Source project facts
Section titled “Source project facts”Project: Inno.Editor.ImGui
Source: src/composition/editor/presentation/Inno.Editor.ImGui/Inno.Editor.ImGui.csproj
| Type | API | Description |
|---|---|---|
| EditorDragDropRenderer | engine | Bridges managed editor drag sessions to the native ImGui payload API. |
| EditorDrawList | engine | A pointer-free drawing borrow valid only in its original window, UI session and frame. |
| EditorDropWidgetResult | engine | Reports the preview and delivery state of an ImGui editor drop target. |
| EditorGameInputCapture | engine | Routes platform input to the Play session only while the visible Game View owns focus. |
| EditorIconCatalog | engine | Describes the host’s complete standard glyph vocabulary as immutable presentation values. |
| EditorMenuRenderer | engine | Renders immutable editor menu models through ImGui. |
| EditorPalette | engine | Defines the complete editor color palette in one theme surface. |
| EditorStyleMetrics | engine | Defines reusable layout metrics and separates owned frame values from requested style changes. |
| EditorUiInput | engine | Copies frame input facts used by presentation without exposing native input storage. |
| EditorUiLayout | engine | Copies the presentation metrics needed by custom layouts without retaining native style memory. |
| EditorUiSession | engine | Owns editor controls and transient presentation state for one host, independently from other ImGui contexts. |
| ImGui | engine | Provides pointer-free controls within the active Editor UI session. Provides frame-bounded drawing access and copied presentation values. Reads copied input values from the active Editor UI session. Provides scoped layout operations without exposing native context storage. Presents tables through the active Editor UI context. Copies presentation values and creates frame-bounded drawing borrows. Exposes a script-safe, pointer-free subset of Dear ImGui for custom Editor tools. Every call is valid only while an Editor drawing callback is active. |
| ImGuiButtonFlags | engine | Defines the supported button flags choices at the Editor presentation boundary. |
| ImGuiChildFlags | engine | Defines the supported child flags choices at the Editor presentation boundary. |
| ImGuiCol | engine | Defines the supported col choices at the Editor presentation boundary. |
| ImGuiColorEditFlags | engine | Defines the supported color edit flags choices at the Editor presentation boundary. |
| ImGuiComboFlags | engine | Defines the supported combo flags choices at the Editor presentation boundary. |
| ImGuiCond | engine | Defines the supported cond choices at the Editor presentation boundary. |
| ImGuiEditorRuntime | engine | Presents the backend-independent editor interaction runtime through ImGui. |
| ImGuiFocusedFlags | engine | Defines the supported focused flags choices at the Editor presentation boundary. |
| ImGuiFont | engine | Uses the host’s context-owned font catalog without exposing backend types to Editor features. |
| ImGuiFontScope | engine | Restores a font push only in its original session, frame and native stack position. |
| ImGuiFontStyle | engine | Chooses composable font emphasis while leaving actual font ownership with the presentation host. |
| ImGuiHoveredFlags | engine | Defines the supported hovered flags choices at the Editor presentation boundary. |
| ImGuiIcon | engine | Provides the standard Editor glyph vocabulary; extension controls may also supply their own glyph text. |
| ImGuiInputTextFlags | engine | Defines the supported input text flags choices at the Editor presentation boundary. |
| ImGuiKey | engine | Defines the supported key choices at the Editor presentation boundary. |
| ImGuiMouseButton | engine | Defines the supported mouse button choices at the Editor presentation boundary. |
| ImGuiMouseCursor | engine | Defines the supported mouse cursor choices at the Editor presentation boundary. |
| ImGuiPopupFlags | engine | Defines the supported popup flags choices at the Editor presentation boundary. |
| ImGuiSelectableFlags | engine | Defines the supported selectable flags choices at the Editor presentation boundary. |
| ImGuiSliderFlags | engine | Defines the supported slider flags choices at the Editor presentation boundary. |
| ImGuiStyleVar | engine | Defines the supported style var choices at the Editor presentation boundary. |
| ImGuiTabBarFlags | engine | Defines the supported tab bar flags choices at the Editor presentation boundary. |
| ImGuiTabItemFlags | engine | Defines the supported tab item flags choices at the Editor presentation boundary. |
| ImGuiTableBgTarget | engine | Defines the supported table bg target choices at the Editor presentation boundary. |
| ImGuiTableColumnFlags | engine | Defines the supported table column flags choices at the Editor presentation boundary. |
| ImGuiTableFlags | engine | Defines the supported table flags choices at the Editor presentation boundary. |
| ImGuiTableRowFlags | engine | Defines the supported table row flags choices at the Editor presentation boundary. |
| ImGuiTreeNodeFlags | engine | Defines the supported tree node flags choices at the Editor presentation boundary. |
| DialogLayout | engine | Carries a measured dialog layout. Only its required extent is public; drawing mechanics remain owned by the widget. |
| DialogPresentation | engine | Describes immutable content for a measured message dialog. Actions are returned to its owner, never retained as callbacks. |
| ImGuiWidget | engine | Provides reusable editor controls and rendering helpers built on the native ImGui API. Submits fixed-height content through the native clipper while retaining explicitly active rows. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides reusable editor controls and rendering helpers built on the native ImGui API. Presents measured message dialogs through the owning editor UI session. Provides reusable editor controls and rendering helpers built on the native ImGui API. Owns session-local controls, native adaptation and reversible edit gestures. Owns session-local controls, native adaptation and reversible edit gestures. Provides standard help box presentation in the Editor UI. Provides reusable editor controls and rendering helpers built on the native ImGui API. Owns and retires transient controls by session and stable presentation owner. Presents mixed values using the same controls and shared History. Reusable editor widgets built on top of T:Inno.Editor.ImGui.ImGui. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides reusable editor controls and rendering helpers built on the native ImGui API. Applies ordered selection gestures through the authoritative interaction owner. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides session-owned numeric trend presentation over borrowed sample buffers. |
| InlineRenamePresentation | engine | Describes the view-owned geometry used to present an active inline rename action. |
| InlineRenameResult | engine | Describes the outcome of an inline rename control. |
| ListNavigationResult | engine | Carries frame-local list navigation intents over visible indices without owning objects or selection state. |
| TransformGizmoOperation | engine | Chooses the transform handles rendered by the viewport presenter. |
| TransformGizmoOptions | engine | Supplies frame-local matrices and interaction policy without native handles. |
| TransformGizmoResult | engine | Returns copied manipulation output; the domain owner decides how to apply and record it. |
| TransformGizmoSpace | engine | Chooses how the manipulation axes are oriented. |
| TreeNodeDrawContext | engine | Provides the native geometry of a tree row while its custom content is being drawn. |
| TreeNodeOptions | engine | Configures an interactive tree row. |
| TreeNodeResult | engine | Describes interaction state produced by a tree row. |
| ImGuiWindowFlags | engine | Defines the supported window flags choices at the Editor presentation boundary. |
| DialogLayout | Editor | Carries a measured dialog layout. Only its required extent is public; drawing mechanics remain owned by the widget. |
| DialogPresentation | Editor | Describes immutable content for a measured message dialog. Actions are returned to its owner, never retained as callbacks. |
| EditorDrawList | Editor | A pointer-free drawing borrow valid only in its original window, UI session and frame. |
| EditorPalette | Editor | Defines the complete editor color palette in one theme surface. |
| EditorStyleMetrics | Editor | Defines reusable layout metrics and separates owned frame values from requested style changes. |
| EditorUiInput | Editor | Copies frame input facts used by presentation without exposing native input storage. |
| EditorUiLayout | Editor | Copies the presentation metrics needed by custom layouts without retaining native style memory. |
| EditorUiSession | Editor | Owns editor controls and transient presentation state for one host, independently from other ImGui contexts. |
| ImGui | Editor | Provides pointer-free controls within the active Editor UI session. Provides frame-bounded drawing access and copied presentation values. Reads copied input values from the active Editor UI session. Provides scoped layout operations without exposing native context storage. Presents tables through the active Editor UI context. Copies presentation values and creates frame-bounded drawing borrows. Exposes a script-safe, pointer-free subset of Dear ImGui for custom Editor tools. Every call is valid only while an Editor drawing callback is active. |
| ImGuiButtonFlags | Editor | Defines the supported button flags choices at the Editor presentation boundary. |
| ImGuiChildFlags | Editor | Defines the supported child flags choices at the Editor presentation boundary. |
| ImGuiCol | Editor | Defines the supported col choices at the Editor presentation boundary. |
| ImGuiColorEditFlags | Editor | Defines the supported color edit flags choices at the Editor presentation boundary. |
| ImGuiComboFlags | Editor | Defines the supported combo flags choices at the Editor presentation boundary. |
| ImGuiCond | Editor | Defines the supported cond choices at the Editor presentation boundary. |
| ImGuiFocusedFlags | Editor | Defines the supported focused flags choices at the Editor presentation boundary. |
| ImGuiFont | Editor | Uses the host’s context-owned font catalog without exposing backend types to Editor features. |
| ImGuiFontScope | Editor | Restores a font push only in its original session, frame and native stack position. |
| ImGuiFontStyle | Editor | Chooses composable font emphasis while leaving actual font ownership with the presentation host. |
| ImGuiHoveredFlags | Editor | Defines the supported hovered flags choices at the Editor presentation boundary. |
| ImGuiIcon | Editor | Provides the standard Editor glyph vocabulary; extension controls may also supply their own glyph text. |
| ImGuiInputTextFlags | Editor | Defines the supported input text flags choices at the Editor presentation boundary. |
| ImGuiKey | Editor | Defines the supported key choices at the Editor presentation boundary. |
| ImGuiMouseButton | Editor | Defines the supported mouse button choices at the Editor presentation boundary. |
| ImGuiMouseCursor | Editor | Defines the supported mouse cursor choices at the Editor presentation boundary. |
| ImGuiPopupFlags | Editor | Defines the supported popup flags choices at the Editor presentation boundary. |
| ImGuiSelectableFlags | Editor | Defines the supported selectable flags choices at the Editor presentation boundary. |
| ImGuiSliderFlags | Editor | Defines the supported slider flags choices at the Editor presentation boundary. |
| ImGuiStyleVar | Editor | Defines the supported style var choices at the Editor presentation boundary. |
| ImGuiTabBarFlags | Editor | Defines the supported tab bar flags choices at the Editor presentation boundary. |
| ImGuiTabItemFlags | Editor | Defines the supported tab item flags choices at the Editor presentation boundary. |
| ImGuiTableBgTarget | Editor | Defines the supported table bg target choices at the Editor presentation boundary. |
| ImGuiTableColumnFlags | Editor | Defines the supported table column flags choices at the Editor presentation boundary. |
| ImGuiTableFlags | Editor | Defines the supported table flags choices at the Editor presentation boundary. |
| ImGuiTableRowFlags | Editor | Defines the supported table row flags choices at the Editor presentation boundary. |
| ImGuiTreeNodeFlags | Editor | Defines the supported tree node flags choices at the Editor presentation boundary. |
| ImGuiWidget | Editor | Provides reusable editor controls and rendering helpers built on the native ImGui API. Submits fixed-height content through the native clipper while retaining explicitly active rows. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides reusable editor controls and rendering helpers built on the native ImGui API. Presents measured message dialogs through the owning editor UI session. Provides reusable editor controls and rendering helpers built on the native ImGui API. Owns session-local controls, native adaptation and reversible edit gestures. Owns session-local controls, native adaptation and reversible edit gestures. Provides standard help box presentation in the Editor UI. Provides reusable editor controls and rendering helpers built on the native ImGui API. Owns and retires transient controls by session and stable presentation owner. Presents mixed values using the same controls and shared History. Reusable editor widgets built on top of T:InnoEditor.ImGui.ImGui. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides reusable editor controls and rendering helpers built on the native ImGui API. Applies ordered selection gestures through the authoritative interaction owner. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides reusable editor controls and rendering helpers built on the native ImGui API. Provides session-owned numeric trend presentation over borrowed sample buffers. |
| ImGuiWindowFlags | Editor | Defines the supported window flags choices at the Editor presentation boundary. |
| InlineRenameResult | Editor | Describes the outcome of an inline rename control. |
| ListNavigationResult | Editor | Carries frame-local list navigation intents over visible indices without owning objects or selection state. |
| TransformGizmoOperation | Editor | Chooses the transform handles rendered by the viewport presenter. |
| TransformGizmoOptions | Editor | Supplies frame-local matrices and interaction policy without native handles. |
| TransformGizmoResult | Editor | Returns copied manipulation output; the domain owner decides how to apply and record it. |
| TransformGizmoSpace | Editor | Chooses how the manipulation axes are oriented. |
| TreeNodeDrawContext | Editor | Provides the native geometry of a tree row while its custom content is being drawn. |
| TreeNodeOptions | Editor | Configures an interactive tree row. |
| TreeNodeResult | Editor | Describes interaction state produced by a tree row. |