meltygui-imgui 2.0.0.post3__cp313-cp313-win_amd64.whl

meltygui_imgui/enums_internal.pxd

@@ -0,0 +1,200 @@
+cdef extern from "imgui_internal.h":
+    
+    ctypedef enum ImGuiItemFlags_:
+        ImGuiItemFlags_None                     #
+        ImGuiItemFlags_NoTabStop                # false
+        ImGuiItemFlags_ButtonRepeat             # false    # Button() will return true multiple times based on io.KeyRepeatDelay and io.KeyRepeatRate settings.
+        ImGuiItemFlags_Disabled                 # false    # [BETA] Disable interactions but doesn't affect visuals yet. See github.com/ocornut/meltygui_imgui/issues/211
+        ImGuiItemFlags_NoNav                    # false
+        ImGuiItemFlags_NoNavDefaultFocus        # false
+        ImGuiItemFlags_SelectableDontClosePopup # false    # MenuItem/Selectable() automatically closes current Popup window
+        ImGuiItemFlags_MixedValue               # false    # [BETA] Represent a mixed/indeterminate value, generally multi-selection where values differ. Currently only supported by Checkbox() (later should support all sorts of widgets)
+        ImGuiItemFlags_ReadOnly                 # false    # [ALPHA] Allow hovering interactions but underlying value is not changed.
+        ImGuiItemFlags_Default_                 #
+        
+        
+    ctypedef enum ImGuiItemStatusFlags_:
+        ImGuiItemStatusFlags_None               #
+        ImGuiItemStatusFlags_HoveredRect        #
+        ImGuiItemStatusFlags_HasDisplayRect     #
+        ImGuiItemStatusFlags_Edited             # Value exposed by item was edited in the current frame (should match the bool return value of most widgets)
+        ImGuiItemStatusFlags_ToggledSelection   # Set when Selectable(), TreeNode() reports toggling a selection. We can't report "Selected" because reporting the change allows us to handle clipping with less issues.
+        ImGuiItemStatusFlags_ToggledOpen        # Set when TreeNode() reports toggling their open state.
+        ImGuiItemStatusFlags_HasDeactivated     # Set if the widget/group is able to provide data for the ImGuiItemStatusFlags_Deactivated flag.
+        ImGuiItemStatusFlags_Deactivated        # Only valid if ImGuiItemStatusFlags_HasDeactivated is set.
+
+    ctypedef enum ImGuiButtonFlagsPrivate_:
+        ImGuiButtonFlags_PressedOnClick         # return true on click (mouse down event)
+        ImGuiButtonFlags_PressedOnClickRelease  # [Default] return true on click + release on same item <-- this is what the majority of Button are using
+        ImGuiButtonFlags_PressedOnClickReleaseAnywhere # return true on click + release even if the release event is not done while hovering the item
+        ImGuiButtonFlags_PressedOnRelease       # return true on release (default requires click+release)
+        ImGuiButtonFlags_PressedOnDoubleClick   # return true on double-click (default requires click+release)
+        ImGuiButtonFlags_PressedOnDragDropHold  # return true when held into while we are drag and dropping another item (used by e.g. tree nodes, collapsing headers)
+        ImGuiButtonFlags_Repeat                 # hold to repeat
+        ImGuiButtonFlags_FlattenChildren        # allow interactions even if a child window is overlapping
+        ImGuiButtonFlags_AllowItemOverlap       # require previous frame HoveredId to either match id or be null before being usable, use along with SetItemAllowOverlap()
+        ImGuiButtonFlags_DontClosePopups        # disable automatically closing parent popup on press // [UNUSED]
+        ImGuiButtonFlags_Disabled               # disable interactions
+        ImGuiButtonFlags_AlignTextBaseLine      # vertically align button to match text baseline - ButtonEx() only // FIXME: Should be removed and handled by SmallButton(), not possible currently because of DC.CursorPosPrevLine
+        ImGuiButtonFlags_NoKeyModifiers         # disable mouse interaction if a key modifier is held
+        ImGuiButtonFlags_NoHoldingActiveId      # don't set ActiveId while holding the mouse (ImGuiButtonFlags_PressedOnClick only)
+        ImGuiButtonFlags_NoNavFocus             # don't override navigation focus when activated
+        ImGuiButtonFlags_NoHoveredOnFocus       # don't report as hovered when nav focus is on this item
+        ImGuiButtonFlags_PressedOnMask_         = ImGuiButtonFlags_PressedOnClick | ImGuiButtonFlags_PressedOnClickRelease | ImGuiButtonFlags_PressedOnClickReleaseAnywhere | ImGuiButtonFlags_PressedOnRelease | ImGuiButtonFlags_PressedOnDoubleClick | ImGuiButtonFlags_PressedOnDragDropHold
+        ImGuiButtonFlags_PressedOnDefault_      = ImGuiButtonFlags_PressedOnClickRelease
+        
+    ctypedef enum ImGuiSliderFlagsPrivate_:
+        ImGuiSliderFlags_Vertical               # Should this slider be orientated vertically?
+        ImGuiSliderFlags_ReadOnly               #
+        
+    ctypedef enum ImGuiSelectableFlagsPrivate_:
+        # NB: need to be in sync with last value of ImGuiSelectableFlags_
+        ImGuiSelectableFlags_NoHoldingActiveID      #
+        ImGuiSelectableFlags_SelectOnClick          # Override button behavior to react on Click (default is Click+Release)
+        ImGuiSelectableFlags_SelectOnRelease        # Override button behavior to react on Release (default is Click+Release)
+        ImGuiSelectableFlags_SpanAvailWidth         # Span all avail width even if we declared less for layout purpose. FIXME: We may be able to remove this (added in 6251d379, 2bcafc86 for menus)
+        ImGuiSelectableFlags_DrawHoveredWhenHeld    # Always show active when held, even is not hovered. This concept could probably be renamed/formalized somehow.
+        ImGuiSelectableFlags_SetNavIdOnHover        # Set Nav/Focus ID on mouse hover (used by MenuItem)
+        ImGuiSelectableFlags_NoPadWithHalfSpacing   # Disable padding each side with ItemSpacing * 0.5f
+
+    ctypedef enum ImGuiTreeNodeFlagsPrivate_:
+        ImGuiTreeNodeFlags_ClipLabelForTrailingButton
+    
+    ctypedef enum ImGuiSeparatorFlags_:
+        ImGuiSeparatorFlags_None                #
+        ImGuiSeparatorFlags_Horizontal          # Axis default to current layout type, so generally Horizontal unless e.g. in a menu bar
+        ImGuiSeparatorFlags_Vertical            #
+        ImGuiSeparatorFlags_SpanAllColumns      #
+    
+    ctypedef enum ImGuiTextFlags_:
+        ImGuiTextFlags_None
+        ImGuiTextFlags_NoWidthForLargeClippedText
+    
+    ctypedef enum ImGuiTooltipFlags_:
+        ImGuiTooltipFlags_None
+        ImGuiTooltipFlags_OverridePreviousTooltip  # Override will clear/ignore previously submitted tooltip (defaults to append)
+        
+    # FIXME: this is in development, not exposed/functional as a generic feature yet.
+    # Horizontal/Vertical enums are fixed to 0/1 so they may be used to index ImVec2
+    ctypedef enum ImGuiLayoutType_:
+        ImGuiLayoutType_Horizontal
+        ImGuiLayoutType_Vertical
+    
+    ctypedef enum ImGuiLogType:
+        ImGuiLogType_None
+        ImGuiLogType_TTY
+        ImGuiLogType_File
+        ImGuiLogType_Buffer
+        ImGuiLogType_Clipboard
+    
+    # X/Y enums are fixed to 0/1 so they may be used to index ImVec2
+    ctypedef enum ImGuiAxis:
+        ImGuiAxis_None
+        ImGuiAxis_X
+        ImGuiAxis_Y
+    
+    ctypedef enum ImGuiPlotType:
+        ImGuiPlotType_Lines
+        ImGuiPlotType_Histogram
+    
+    ctypedef enum ImGuiInputSource:
+        ImGuiInputSource_None
+        ImGuiInputSource_Mouse
+        ImGuiInputSource_Keyboard
+        ImGuiInputSource_Gamepad
+        ImGuiInputSource_Nav            # Stored in g.ActiveIdSource only
+        ImGuiInputSource_COUNT
+    
+    # FIXME-NAV: Clarify/expose various repeat delay/rate
+    ctypedef enum ImGuiInputReadMode:
+        ImGuiInputReadMode_Down
+        ImGuiInputReadMode_Pressed
+        ImGuiInputReadMode_Released
+        ImGuiInputReadMode_Repeat
+        ImGuiInputReadMode_RepeatSlow
+        ImGuiInputReadMode_RepeatFast
+    
+    ctypedef enum ImGuiNavHighlightFlags_:
+        ImGuiNavHighlightFlags_None         
+        ImGuiNavHighlightFlags_TypeDefault  
+        ImGuiNavHighlightFlags_TypeThin     
+        ImGuiNavHighlightFlags_AlwaysDraw   # Draw rectangular highlight if (g.NavId == id) _even_ when using the mouse.
+        ImGuiNavHighlightFlags_NoRounding   
+    
+    ctypedef enum ImGuiNavDirSourceFlags_:
+        ImGuiNavDirSourceFlags_None      
+        ImGuiNavDirSourceFlags_Keyboard  
+        ImGuiNavDirSourceFlags_PadDPad   
+        ImGuiNavDirSourceFlags_PadLStick 
+    
+    ctypedef enum ImGuiNavMoveFlags_:
+        ImGuiNavMoveFlags_None                  #
+        ImGuiNavMoveFlags_LoopX                 # On failed request, restart from opposite side
+        ImGuiNavMoveFlags_LoopY                 #
+        ImGuiNavMoveFlags_WrapX                 # On failed request, request from opposite side one line down (when NavDir==right) or one line up (when NavDir==left)
+        ImGuiNavMoveFlags_WrapY                 # This is not super useful for provided for completeness
+        ImGuiNavMoveFlags_AllowCurrentNavId     # Allow scoring and considering the current NavId as a move target candidate. This is used when the move source is offset (e.g. pressing PageDown actually needs to send a Up move request, if we are pressing PageDown from the bottom-most item we need to stay in place)
+        ImGuiNavMoveFlags_AlsoScoreVisibleSet   # Store alternate result in NavMoveResultLocalVisibleSet that only comprise elements that are already fully visible.
+        ImGuiNavMoveFlags_ScrollToEdge          #
+    
+    ctypedef enum ImGuiNavForward:
+        ImGuiNavForward_None
+        ImGuiNavForward_ForwardQueued
+        ImGuiNavForward_ForwardActive
+    
+    ctypedef enum ImGuiNavLayer:
+        ImGuiNavLayer_Main  # Main scrolling layer
+        ImGuiNavLayer_Menu  # Menu layer (access with Alt/ImGuiNavInput_Menu)
+        ImGuiNavLayer_COUNT
+    
+    ctypedef enum ImGuiPopupPositionPolicy:
+        ImGuiPopupPositionPolicy_Default
+        ImGuiPopupPositionPolicy_ComboBox
+        ImGuiPopupPositionPolicy_Tooltip
+    
+    ctypedef enum ImGuiNextWindowDataFlags_:
+        ImGuiNextWindowDataFlags_None               
+        ImGuiNextWindowDataFlags_HasPos             
+        ImGuiNextWindowDataFlags_HasSize            
+        ImGuiNextWindowDataFlags_HasContentSize     
+        ImGuiNextWindowDataFlags_HasCollapsed       
+        ImGuiNextWindowDataFlags_HasSizeConstraint  
+        ImGuiNextWindowDataFlags_HasFocus           
+        ImGuiNextWindowDataFlags_HasBgAlpha         
+        ImGuiNextWindowDataFlags_HasScroll          
+    
+    ctypedef enum ImGuiNextItemDataFlags_:
+        ImGuiNextItemDataFlags_None     
+        ImGuiNextItemDataFlags_HasWidth 
+        ImGuiNextItemDataFlags_HasOpen  
+    
+    ctypedef enum ImGuiOldColumnFlags_:
+        # Default: 0
+        ImGuiOldColumnFlags_None                   #
+        ImGuiOldColumnFlags_NoBorder               # Disable column dividers
+        ImGuiOldColumnFlags_NoResize               # Disable resizing columns when clicking on the dividers
+        ImGuiOldColumnFlags_NoPreserveWidths       # Disable column width preservation when adjusting columns
+        ImGuiOldColumnFlags_NoForceWithinWindow    # Disable forcing columns to fit within window
+        ImGuiOldColumnFlags_GrowParentContentsSize # (WIP) Restore pre-1.51 behavior of extending the parent window contents size but _without affecting the columns width at all_. Will eventually remove.
+    
+    ctypedef enum ImGuiContextHookType:
+        ImGuiContextHookType_NewFramePre 
+        ImGuiContextHookType_NewFramePost 
+        ImGuiContextHookType_EndFramePre 
+        ImGuiContextHookType_EndFramePost 
+        ImGuiContextHookType_RenderPre 
+        ImGuiContextHookType_RenderPost 
+        ImGuiContextHookType_Shutdown
+
+    
+    ctypedef enum ImGuiTabBarFlagsPrivate_:
+        ImGuiTabBarFlags_DockNode                   # Part of a dock node [we don't use this in the master branch but it facilitate branch syncing to keep this around]
+        ImGuiTabBarFlags_IsFocused                  #
+        ImGuiTabBarFlags_SaveSettings               # FIXME: Settings are handled by the docking system, this only request the tab bar to mark settings dirty when reordering tabs
+        
+    ctypedef enum ImGuiTabItemFlagsPrivate_:
+        ImGuiTabItemFlags_NoCloseButton             # Track whether p_open was set or not (we'll need this info on the next frame to recompute ContentWidth during layout)
+        ImGuiTabItemFlags_Button                    # Used by TabItemButton, change the tab item behavior to mimic a button
+        
+        
+        

meltygui_imgui/extra.py

@@ -0,0 +1,36 @@
+"""
+This module provides extra utilities that are not part of core ImGui C++ API
+but are useful in Python application.
+
+"""
+from . import core
+
+__all__ = (
+    "text_ansi",
+    "text_ansi_colored",
+    "font",
+    "styled",
+    "istyled",
+    "colored",
+    "vertex_buffer_vertex_pos_offset",
+    "vertex_buffer_vertex_uv_offset",
+    "vertex_buffer_vertex_col_offset",
+    "vertex_buffer_vertex_size",
+    "index_buffer_index_size",
+)
+
+text_ansi = core._ansifeed_text_ansi
+text_ansi_colored = core._ansifeed_text_ansi_colored
+
+font = core._py_font
+styled = core._py_styled
+#: istyled
+istyled = core._py_istyled
+colored = core._py_colored
+scoped = core._py_scoped
+
+vertex_buffer_vertex_pos_offset = core._py_vertex_buffer_vertex_pos_offset
+vertex_buffer_vertex_uv_offset = core._py_vertex_buffer_vertex_uv_offset
+vertex_buffer_vertex_col_offset = core._py_vertex_buffer_vertex_col_offset
+vertex_buffer_vertex_size = core._py_vertex_buffer_vertex_size
+index_buffer_index_size = core._py_index_buffer_index_size

meltygui_imgui/integrations/__init__.py

@@ -0,0 +1,13 @@
+# -*- coding: utf-8 -*-
+from __future__ import absolute_import
+
+
+def compute_fb_scale(window_size, frame_buffer_size):
+    win_width, win_height = window_size
+    fb_width, fb_height = frame_buffer_size
+
+    # future: remove floats after dropping py27 support
+    if win_width != 0 and win_height != 0:
+        return float(fb_width) / win_width, float(fb_height) / win_height
+
+    return 1., 1.

meltygui_imgui/integrations/base.py

@@ -0,0 +1,33 @@
+import meltygui_imgui
+
+
+class BaseOpenGLRenderer(object):
+    def __init__(self):
+        if not meltygui_imgui.get_current_context():
+            raise RuntimeError(
+                "No valid ImGui context. Use meltygui_imgui.create_context() first and/or "
+                "meltygui_imgui.set_current_context()."
+            )
+        self.io = meltygui_imgui.get_io()
+
+        self._font_texture = None
+
+        self.io.delta_time = 1.0 / 60.0
+
+        self._create_device_objects()
+        self.refresh_font_texture()
+
+    def render(self, draw_data):
+        raise NotImplementedError
+
+    def refresh_font_texture(self):
+        raise NotImplementedError
+
+    def _create_device_objects(self):
+        raise NotImplementedError
+
+    def _invalidate_device_objects(self):
+        raise NotImplementedError
+
+    def shutdown(self):
+        self._invalidate_device_objects()

meltygui_imgui/integrations/cocos2d.py

@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*-
+from __future__ import absolute_import
+
+import cocos
+
+import meltygui_imgui
+
+from .import compute_fb_scale
+from .pyglet import PygletMixin
+from .opengl import FixedPipelineRenderer
+
+
+class ImguiLayer(PygletMixin, cocos.layer.Layer):
+    is_event_handler = True
+
+    def __init__(self):
+        super(ImguiLayer, self).__init__()
+
+        window_size = cocos.director.director.window.get_size()
+        viewport_size = cocos.director.director.window.get_viewport_size()
+
+        self.io = meltygui_imgui.get_io()
+        self.io.display_size = window_size
+        self.io.display_fb_scale = compute_fb_scale(window_size, viewport_size)
+
+        self.renderer = FixedPipelineRenderer()
+        self._map_keys()

meltygui_imgui/integrations/glfw.py

@@ -0,0 +1,133 @@
+# -*- coding: utf-8 -*-
+from __future__ import absolute_import
+
+import glfw
+import meltygui_imgui
+
+from . import compute_fb_scale
+from .opengl import ProgrammablePipelineRenderer
+
+class GlfwRenderer(ProgrammablePipelineRenderer):
+    def __init__(self, window, attach_callbacks:bool=True):
+        super(GlfwRenderer, self).__init__()
+        self.window = window
+
+        if attach_callbacks:
+            glfw.set_key_callback(self.window, self.keyboard_callback)
+            glfw.set_cursor_pos_callback(self.window, self.mouse_callback)
+            glfw.set_window_size_callback(self.window, self.resize_callback)
+            glfw.set_char_callback(self.window, self.char_callback)
+            glfw.set_scroll_callback(self.window, self.scroll_callback)
+
+        self.io.display_size = glfw.get_framebuffer_size(self.window)
+        self.io.get_clipboard_text_fn = self._get_clipboard_text
+        self.io.set_clipboard_text_fn = self._set_clipboard_text
+
+        self._map_keys()
+        self._gui_time = None
+
+    def _get_clipboard_text(self):
+        return glfw.get_clipboard_string(self.window)
+
+    def _set_clipboard_text(self, text):
+        glfw.set_clipboard_string(self.window, text)
+
+    def _map_keys(self):
+        key_map = self.io.key_map
+
+        key_map[meltygui_imgui.KEY_TAB] = glfw.KEY_TAB
+        key_map[meltygui_imgui.KEY_LEFT_ARROW] = glfw.KEY_LEFT
+        key_map[meltygui_imgui.KEY_RIGHT_ARROW] = glfw.KEY_RIGHT
+        key_map[meltygui_imgui.KEY_UP_ARROW] = glfw.KEY_UP
+        key_map[meltygui_imgui.KEY_DOWN_ARROW] = glfw.KEY_DOWN
+        key_map[meltygui_imgui.KEY_PAGE_UP] = glfw.KEY_PAGE_UP
+        key_map[meltygui_imgui.KEY_PAGE_DOWN] = glfw.KEY_PAGE_DOWN
+        key_map[meltygui_imgui.KEY_HOME] = glfw.KEY_HOME
+        key_map[meltygui_imgui.KEY_END] = glfw.KEY_END
+        key_map[meltygui_imgui.KEY_INSERT] = glfw.KEY_INSERT
+        key_map[meltygui_imgui.KEY_DELETE] = glfw.KEY_DELETE
+        key_map[meltygui_imgui.KEY_BACKSPACE] = glfw.KEY_BACKSPACE
+        key_map[meltygui_imgui.KEY_SPACE] = glfw.KEY_SPACE
+        key_map[meltygui_imgui.KEY_ENTER] = glfw.KEY_ENTER
+        key_map[meltygui_imgui.KEY_ESCAPE] = glfw.KEY_ESCAPE
+        key_map[meltygui_imgui.KEY_PAD_ENTER] = glfw.KEY_KP_ENTER
+        key_map[meltygui_imgui.KEY_A] = glfw.KEY_A
+        key_map[meltygui_imgui.KEY_C] = glfw.KEY_C
+        key_map[meltygui_imgui.KEY_V] = glfw.KEY_V
+        key_map[meltygui_imgui.KEY_X] = glfw.KEY_X
+        key_map[meltygui_imgui.KEY_Y] = glfw.KEY_Y
+        key_map[meltygui_imgui.KEY_Z] = glfw.KEY_Z
+
+    def keyboard_callback(self, window, key, scancode, action, mods):
+        # perf: local for faster access
+        io = self.io
+
+        if action == glfw.PRESS:
+            io.keys_down[key] = True
+        elif action == glfw.RELEASE:
+            io.keys_down[key] = False
+
+        io.key_ctrl = (
+            io.keys_down[glfw.KEY_LEFT_CONTROL] or
+            io.keys_down[glfw.KEY_RIGHT_CONTROL]
+        )
+
+        io.key_alt = (
+            io.keys_down[glfw.KEY_LEFT_ALT] or
+            io.keys_down[glfw.KEY_RIGHT_ALT]
+        )
+
+        io.key_shift = (
+            io.keys_down[glfw.KEY_LEFT_SHIFT] or
+            io.keys_down[glfw.KEY_RIGHT_SHIFT]
+        )
+
+        io.key_super = (
+            io.keys_down[glfw.KEY_LEFT_SUPER] or
+            io.keys_down[glfw.KEY_RIGHT_SUPER]
+        )
+
+    def char_callback(self, window, char):
+        io = meltygui_imgui.get_io()
+
+        if 0 < char < 0x10000:
+            io.add_input_character(char)
+
+    def resize_callback(self, window, width, height):
+        self.io.display_size = width, height
+
+    def mouse_callback(self, *args, **kwargs):
+        pass
+
+    def scroll_callback(self, window, x_offset, y_offset):
+        self.io.mouse_wheel_horizontal = x_offset
+        self.io.mouse_wheel = y_offset
+
+    def process_inputs(self):
+        io = meltygui_imgui.get_io()
+
+        window_size = glfw.get_window_size(self.window)
+        fb_size = glfw.get_framebuffer_size(self.window)
+
+        io.display_size = window_size
+        io.display_fb_scale = compute_fb_scale(window_size, fb_size)
+        io.delta_time = 1.0/60
+
+        if glfw.get_window_attrib(self.window, glfw.FOCUSED):
+            io.mouse_pos = glfw.get_cursor_pos(self.window)
+        else:
+            io.mouse_pos = -1, -1
+
+        io.mouse_down[0] = glfw.get_mouse_button(self.window, 0)
+        io.mouse_down[1] = glfw.get_mouse_button(self.window, 1)
+        io.mouse_down[2] = glfw.get_mouse_button(self.window, 2)
+
+        current_time = glfw.get_time()
+
+        if self._gui_time:
+            self.io.delta_time = current_time - self._gui_time
+        else:
+            self.io.delta_time = 1. / 60.
+        if(io.delta_time <= 0.0): io.delta_time = 1./ 1000.
+
+        self._gui_time = current_time