############################################################################### # This file is a part of Dear ImGui Bundle, NOT a part of ImPlot # ----------------------------------------------------------------------------- # implot/__init__.pyi is the equivalent of implot.h, using the bindings # provided by Dear ImGui Bundle. # # It is automatically generated (using https://pthom.github.io/litgen/), # and is generally very close to the C++ version. Comments, docs are identical. ############################################################################### # ruff: noqa: B008, F821, F811 from typing import Any, Optional, Tuple, List, overload import numpy as np import enum from . import internal as internal from imgui_bundle import imgui from imgui_bundle.imgui import ( ImVec2, ImVec2Like, ImVec4, ImVec4Like, MouseButton, ImU32, DragDropFlags, ImDrawList, ImTextureRef, WindowFlags, ) ImGui_Context = imgui.internal.Context ################################################## # Manually inserted code (typedefs, etc.) ################################################## """ //----------------------------------------------------------------------------- // [SECTION] Enums and Types //----------------------------------------------------------------------------- // Forward declarations struct ImPlotContext; // ImPlot context (opaque struct, see implot_internal.h) // Enums/Flags typedef int ImAxis; // -> enum ImAxis_ typedef int ImPlotFlags; // -> enum ImPlotFlags_ typedef int ImPlotAxisFlags; // -> enum ImPlotAxisFlags_ typedef int ImPlotSubplotFlags; // -> enum ImPlotSubplotFlags_ typedef int ImPlotLegendFlags; // -> enum ImPlotLegendFlags_ typedef int ImPlotMouseTextFlags; // -> enum ImPlotMouseTextFlags_ typedef int ImPlotDragToolFlags; // -> ImPlotDragToolFlags_ typedef int ImPlotColormapScaleFlags; // -> ImPlotColormapScaleFlags_ typedef int ImPlotItemFlags; // -> ImPlotItemFlags_ typedef int ImPlotLineFlags; // -> ImPlotLineFlags_ typedef int ImPlotScatterFlags; // -> ImPlotScatterFlags typedef int ImPlotStairsFlags; // -> ImPlotStairsFlags_ typedef int ImPlotShadedFlags; // -> ImPlotShadedFlags_ typedef int ImPlotBarsFlags; // -> ImPlotBarsFlags_ typedef int ImPlotBarGroupsFlags; // -> ImPlotBarGroupsFlags_ typedef int ImPlotErrorBarsFlags; // -> ImPlotErrorBarsFlags_ typedef int ImPlotStemsFlags; // -> ImPlotStemsFlags_ typedef int ImPlotInfLinesFlags; // -> ImPlotInfLinesFlags_ typedef int ImPlotPieChartFlags; // -> ImPlotPieChartFlags_ typedef int ImPlotHeatmapFlags; // -> ImPlotHeatmapFlags_ typedef int ImPlotHistogramFlags; // -> ImPlotHistogramFlags_ typedef int ImPlotDigitalFlags; // -> ImPlotDigitalFlags_ typedef int ImPlotImageFlags; // -> ImPlotImageFlags_ typedef int ImPlotTextFlags; // -> ImPlotTextFlags_ typedef int ImPlotDummyFlags; // -> ImPlotDummyFlags_ typedef int ImPlotCond; // -> enum ImPlotCond_ typedef int ImPlotCol; // -> enum ImPlotCol_ typedef int ImPlotStyleVar; // -> enum ImPlotStyleVar_ typedef int ImPlotScale; // -> enum ImPlotScale_ typedef int ImPlotMarker; // -> enum ImPlotMarker_ typedef int ImPlotColormap; // -> enum ImPlotColormap_ typedef int ImPlotLocation; // -> enum ImPlotLocation_ typedef int ImPlotBin; // -> enum ImPlotBin_ """ ImAxis = int # -> enum ImAxis_ Flags = int # -> enum Flags_ AxisFlags = int # -> enum AxisFlags_ SubplotFlags = int # -> enum SubplotFlags_ LegendFlags = int # -> enum LegendFlags_ MouseTextFlags = int # -> enum MouseTextFlags_ DragToolFlags = int # -> DragToolFlags_ ColormapScaleFlags = int # -> ColormapScaleFlags_ ItemFlags = int # -> ItemFlags_ LineFlags = int # -> LineFlags_ ScatterFlags = int # -> ScatterFlags StairsFlags = int # -> StairsFlags_ ShadedFlags = int # -> ShadedFlags_ BarsFlags = int # -> BarsFlags_ BarGroupsFlags = int # -> BarGroupsFlags_ ErrorBarsFlags = int # -> ErrorBarsFlags_ StemsFlags = int # -> StemsFlags_ InfLinesFlags = int # -> InfLinesFlags_ PieChartFlags = int # -> PieChartFlags_ HeatmapFlags = int # -> HeatmapFlags_ HistogramFlags = int # -> HistogramFlags_ DigitalFlags = int # -> DigitalFlags_ ImageFlags = int # -> ImageFlags_ TextFlags = int # -> TextFlags_ DummyFlags = int # -> DummyFlags_ Cond = int # -> enum Cond_ Col = int # -> enum Col_ StyleVar = int # -> enum StyleVar_ Scale = int # -> enum Scale_ Marker = int # -> enum Marker_ Colormap = int # -> enum Colormap_ Location = int # -> enum Location_ Bin = int # -> enum Bin_ # ImPlotContext is an opaque structure Context = Any # IMPLOT_AUTO = -1 # Deduce variable automatically IMPLOT_AUTO_COL = ImVec4(0, 0, 0, -1) # Deduce color automatically AUTO = IMPLOT_AUTO AUTO_COL = IMPLOT_AUTO_COL version: str # VoidPtr = Any ImTextureID = VoidPtr Bin_Sturges = Bin_.sturges Marker_None = Marker_.none ItemFlags_None = ItemFlags_.none # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! AUTOGENERATED CODE !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! # // Autogenerated code below! Do not edit! #################### #################### # MIT License # Copyright (c) 2020-2024 Evan Pezent # Copyright (c) 2025-2026 Breno Cunha Queiroz # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # The above copyright notice and this permission notice shall be included in all # copies or substantial portions of the Software. # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE # SOFTWARE. # ImPlot v1.1 WIP # Table of Contents: # # [SECTION] Macros and Defines # [SECTION] Enums and Types # [SECTION] Callbacks # [SECTION] Contexts # [SECTION] Begin/End Plot # [SECTION] Begin/End Subplot # [SECTION] Setup # [SECTION] SetNext # [SECTION] Plot Items # [SECTION] Plot Tools # [SECTION] Plot Utils # [SECTION] Legend Utils # [SECTION] Drag and Drop # [SECTION] Styling # [SECTION] Colormaps # [SECTION] Input Mapping # [SECTION] Miscellaneous # [SECTION] Demo # [SECTION] Obsolete API # #ifndef IMGUI_DISABLE # # IMGUI_BUNDLE_PYTHON_API is defined when building the python bindings. # #ifdef IMGUI_BUNDLE_PYTHON_API # class BoxedValue: # double value; /* original C++ signature */ value: float # BoxedValue(double value = double()); /* original C++ signature */ def __init__(self, value: float = float()) -> None: """Auto-generated default constructor with named params""" pass # #endif # # [/ADAPT_IMGUI_BUNDLE] # ----------------------------------------------------------------------------- # [SECTION] Macros and Defines # ----------------------------------------------------------------------------- # Define attributes of all API symbols declarations (e.g. for DLL under Windows) # Using ImPlot via a shared library is not recommended, because we don't guarantee # backward nor forward ABI compatibility and also function call overhead. If you # do use ImPlot as a DLL, be sure to call SetImGuiContext (see Miscellaneous section). # ----------------------------------------------------------------------------- # [SECTION] Enums and Types # ----------------------------------------------------------------------------- # Forward declarations # Enums/Flags class ImAxis_(enum.IntFlag): """Axis indices. The values assigned may change; NEVER hardcode these.""" # horizontal axes # ImAxis_X1 = 0, /* original C++ signature */ x1 = enum.auto() # (= 0) # enabled by default # ImAxis_X2, /* original C++ signature */ x2 = enum.auto() # (= 1) # disabled by default # ImAxis_X3, /* original C++ signature */ x3 = enum.auto() # (= 2) # disabled by default # vertical axes # ImAxis_Y1, /* original C++ signature */ y1 = enum.auto() # (= 3) # enabled by default # ImAxis_Y2, /* original C++ signature */ y2 = enum.auto() # (= 4) # disabled by default # ImAxis_Y3, /* original C++ signature */ y3 = enum.auto() # (= 5) # disabled by default # ImAxis_COUNT /* original C++ signature */ # } # bookkeeping count = enum.auto() # (= 6) class Prop_(enum.IntFlag): """Plotting properties. These provide syntactic sugar for creating ImPlotSpecs from (ImPlotProp,value) pairs. See ImPlotSpec documentation.""" # ImPlotProp_LineColor, /* original C++ signature */ line_color = ( enum.auto() ) # (= 0) # line color (applies to lines, bar edges); IMPLOT_AUTO_COL will use next Colormap color or current item color # ImPlotProp_LineColors, /* original C++ signature */ line_colors = enum.auto() # (= 1) # array of colors for each line; if None, use LineColor for all lines # ImPlotProp_LineWeight, /* original C++ signature */ line_weight = enum.auto() # (= 2) # line weight in pixels (applies to lines, bar edges, marker edges) # ImPlotProp_FillColor, /* original C++ signature */ fill_color = ( enum.auto() ) # (= 3) # fill color (applies to shaded regions, bar faces); IMPLOT_AUTO_COL will use next Colormap color or current item color # ImPlotProp_FillColors, /* original C++ signature */ fill_colors = enum.auto() # (= 4) # array of colors for each fill; if None, use FillColor for all fills # ImPlotProp_FillAlpha, /* original C++ signature */ fill_alpha = ( enum.auto() ) # (= 5) # alpha multiplier (applies to FillColor, FillColors, MarkerFillColor, and MarkerFillColors) # ImPlotProp_Marker, /* original C++ signature */ marker = enum.auto() # (= 6) # marker type; specify ImPlotMarker_Auto to use the next unused marker # ImPlotProp_MarkerSize, /* original C++ signature */ marker_size = enum.auto() # (= 7) # size of markers (radius) *in pixels* # ImPlotProp_MarkerSizes, /* original C++ signature */ marker_sizes = enum.auto() # (= 8) # array of sizes for each marker; if None, use MarkerSize for all markers # ImPlotProp_MarkerLineColor, /* original C++ signature */ marker_line_color = enum.auto() # (= 9) # marker edge color; IMPLOT_AUTO_COL will use LineColor # ImPlotProp_MarkerLineColors, /* original C++ signature */ marker_line_colors = ( enum.auto() ) # (= 10) # array of colors for each marker edge; if None, use MarkerLineColor for all markers # ImPlotProp_MarkerFillColor, /* original C++ signature */ marker_fill_color = enum.auto() # (= 11) # marker face color; IMPLOT_AUTO_COL will use LineColor # ImPlotProp_MarkerFillColors, /* original C++ signature */ marker_fill_colors = ( enum.auto() ) # (= 12) # array of colors for each marker face; if None, use MarkerFillColor for all markers # ImPlotProp_Size, /* original C++ signature */ size = enum.auto() # (= 13) # size of error bar whiskers (width or height), and digital bars (height) *in pixels* # ImPlotProp_Offset, /* original C++ signature */ offset = enum.auto() # (= 14) # data index offset # ImPlotProp_Stride, /* original C++ signature */ stride = ( enum.auto() ) # (= 15) # data stride in bytes; IMPLOT_AUTO will result in sizeof(T) where T is the type passed to PlotX # ImPlotProp_Flags /* original C++ signature */ flags = ( enum.auto() ) # (= 16) # optional item flags; can be composed from common ImPlotItemFlags and/or specialized ImPlotXFlags class Flags_(enum.IntFlag): """Options for plots (see BeginPlot).""" # ImPlotFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotFlags_NoTitle = 1 << 0, /* original C++ signature */ no_title = ( enum.auto() ) # (= 1 << 0) # the plot title will not be displayed (titles are also hidden if preceded by double hashes, e.g. "##MyPlot") # ImPlotFlags_NoLegend = 1 << 1, /* original C++ signature */ no_legend = enum.auto() # (= 1 << 1) # the legend will not be displayed # ImPlotFlags_NoMouseText = 1 << 2, /* original C++ signature */ no_mouse_text = ( enum.auto() ) # (= 1 << 2) # the mouse position, in plot coordinates, will not be displayed inside of the plot # ImPlotFlags_NoInputs = 1 << 3, /* original C++ signature */ no_inputs = enum.auto() # (= 1 << 3) # the user will not be able to interact with the plot # ImPlotFlags_NoMenus = 1 << 4, /* original C++ signature */ no_menus = enum.auto() # (= 1 << 4) # the user will not be able to open context menus # ImPlotFlags_NoBoxSelect = 1 << 5, /* original C++ signature */ no_box_select = enum.auto() # (= 1 << 5) # the user will not be able to box-select # ImPlotFlags_NoFrame = 1 << 6, /* original C++ signature */ no_frame = enum.auto() # (= 1 << 6) # the ImGui frame will not be rendered # ImPlotFlags_Equal = 1 << 7, /* original C++ signature */ equal = enum.auto() # (= 1 << 7) # x and y axes pairs will be constrained to have the same units/pixel # ImPlotFlags_Crosshairs = 1 << 8, /* original C++ signature */ crosshairs = enum.auto() # (= 1 << 8) # the default mouse cursor will be replaced with a crosshair when hovered # ImPlotFlags_CanvasOnly = ImPlotFlags_NoTitle | ImPlotFlags_NoLegend | ImPlotFlags_NoMenus | ImPlotFlags_NoBoxSelect | ImPlotFlags_NoMouseText /* original C++ signature */ # } canvas_only = ( enum.auto() ) # (= Flags_NoTitle | Flags_NoLegend | Flags_NoMenus | Flags_NoBoxSelect | Flags_NoMouseText) class AxisFlags_(enum.IntFlag): """Options for plot axes (see SetupAxis).""" # ImPlotAxisFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotAxisFlags_NoLabel = 1 << 0, /* original C++ signature */ no_label = ( enum.auto() ) # (= 1 << 0) # the axis label will not be displayed (axis labels are also hidden if the supplied string name is None) # ImPlotAxisFlags_NoGridLines = 1 << 1, /* original C++ signature */ no_grid_lines = enum.auto() # (= 1 << 1) # no grid lines will be displayed # ImPlotAxisFlags_NoTickMarks = 1 << 2, /* original C++ signature */ no_tick_marks = enum.auto() # (= 1 << 2) # no tick marks will be displayed # ImPlotAxisFlags_NoTickLabels = 1 << 3, /* original C++ signature */ no_tick_labels = enum.auto() # (= 1 << 3) # no text labels will be displayed # ImPlotAxisFlags_NoInitialFit = 1 << 4, /* original C++ signature */ no_initial_fit = ( enum.auto() ) # (= 1 << 4) # axis will not be initially fit to data extents on the first rendered frame # ImPlotAxisFlags_NoMenus = 1 << 5, /* original C++ signature */ no_menus = enum.auto() # (= 1 << 5) # the user will not be able to open context menus with right-click # ImPlotAxisFlags_NoSideSwitch = 1 << 6, /* original C++ signature */ no_side_switch = enum.auto() # (= 1 << 6) # the user will not be able to switch the axis side by dragging it # ImPlotAxisFlags_NoHighlight = 1 << 7, /* original C++ signature */ no_highlight = enum.auto() # (= 1 << 7) # the axis will not have its background highlighted when hovered or held # ImPlotAxisFlags_Opposite = 1 << 8, /* original C++ signature */ opposite = ( enum.auto() ) # (= 1 << 8) # axis ticks and labels will be rendered on the conventionally opposite side (i.e, right or top) # ImPlotAxisFlags_Foreground = 1 << 9, /* original C++ signature */ foreground = ( enum.auto() ) # (= 1 << 9) # grid lines will be displayed in the foreground (i.e. on top of data) instead of the background # ImPlotAxisFlags_Invert = 1 << 10, /* original C++ signature */ invert = enum.auto() # (= 1 << 10) # the axis will be inverted # ImPlotAxisFlags_AutoFit = 1 << 11, /* original C++ signature */ auto_fit = enum.auto() # (= 1 << 11) # axis will be auto-fitting to data extents # ImPlotAxisFlags_RangeFit = 1 << 12, /* original C++ signature */ range_fit = ( enum.auto() ) # (= 1 << 12) # axis will only fit points if the point is in the visible range of the **orthogonal** axis # ImPlotAxisFlags_PanStretch = 1 << 13, /* original C++ signature */ pan_stretch = ( enum.auto() ) # (= 1 << 13) # panning in a locked or constrained state will cause the axis to stretch if possible # ImPlotAxisFlags_LockMin = 1 << 14, /* original C++ signature */ lock_min = enum.auto() # (= 1 << 14) # the axis minimum value will be locked when panning/zooming # ImPlotAxisFlags_LockMax = 1 << 15, /* original C++ signature */ lock_max = enum.auto() # (= 1 << 15) # the axis maximum value will be locked when panning/zooming # ImPlotAxisFlags_Lock = ImPlotAxisFlags_LockMin | ImPlotAxisFlags_LockMax, /* original C++ signature */ lock = enum.auto() # (= AxisFlags_LockMin | AxisFlags_LockMax) # ImPlotAxisFlags_NoDecorations = ImPlotAxisFlags_NoLabel | ImPlotAxisFlags_NoGridLines | ImPlotAxisFlags_NoTickMarks | ImPlotAxisFlags_NoTickLabels, /* original C++ signature */ no_decorations = ( enum.auto() ) # (= AxisFlags_NoLabel | AxisFlags_NoGridLines | AxisFlags_NoTickMarks | AxisFlags_NoTickLabels) # ImPlotAxisFlags_AuxDefault = ImPlotAxisFlags_NoGridLines | ImPlotAxisFlags_Opposite /* original C++ signature */ # } aux_default = enum.auto() # (= AxisFlags_NoGridLines | AxisFlags_Opposite) class SubplotFlags_(enum.IntFlag): """Options for subplots (see BeginSubplot)""" # ImPlotSubplotFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotSubplotFlags_NoTitle = 1 << 0, /* original C++ signature */ no_title = ( enum.auto() ) # (= 1 << 0) # the subplot title will not be displayed (titles are also hidden if preceded by double hashes, e.g. "##MySubplot") # ImPlotSubplotFlags_NoLegend = 1 << 1, /* original C++ signature */ no_legend = ( enum.auto() ) # (= 1 << 1) # the legend will not be displayed (only applicable if ImPlotSubplotFlags_ShareItems is enabled) # ImPlotSubplotFlags_NoMenus = 1 << 2, /* original C++ signature */ no_menus = enum.auto() # (= 1 << 2) # the user will not be able to open context menus with right-click # ImPlotSubplotFlags_NoResize = 1 << 3, /* original C++ signature */ no_resize = enum.auto() # (= 1 << 3) # resize splitters between subplot cells will be not be provided # ImPlotSubplotFlags_NoAlign = 1 << 4, /* original C++ signature */ no_align = enum.auto() # (= 1 << 4) # subplot edges will not be aligned vertically or horizontally # ImPlotSubplotFlags_ShareItems = 1 << 5, /* original C++ signature */ share_items = ( enum.auto() ) # (= 1 << 5) # items across all subplots will be shared and rendered into a single legend entry # ImPlotSubplotFlags_LinkRows = 1 << 6, /* original C++ signature */ link_rows = ( enum.auto() ) # (= 1 << 6) # link the y-axis limits of all plots in each row (does not apply to auxiliary axes) # ImPlotSubplotFlags_LinkCols = 1 << 7, /* original C++ signature */ link_cols = ( enum.auto() ) # (= 1 << 7) # link the x-axis limits of all plots in each column (does not apply to auxiliary axes) # ImPlotSubplotFlags_LinkAllX = 1 << 8, /* original C++ signature */ link_all_x = ( enum.auto() ) # (= 1 << 8) # link the x-axis limits in every plot in the subplot (does not apply to auxiliary axes) # ImPlotSubplotFlags_LinkAllY = 1 << 9, /* original C++ signature */ link_all_y = ( enum.auto() ) # (= 1 << 9) # link the y-axis limits in every plot in the subplot (does not apply to auxiliary axes) # ImPlotSubplotFlags_ColMajor = 1 << 10 /* original C++ signature */ col_major = ( enum.auto() ) # (= 1 << 10) # subplots are added in column major order instead of the default row major order class LegendFlags_(enum.IntFlag): """Options for legends (see SetupLegend)""" # ImPlotLegendFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotLegendFlags_NoButtons = 1 << 0, /* original C++ signature */ no_buttons = enum.auto() # (= 1 << 0) # legend icons will not function as hide/show buttons # ImPlotLegendFlags_NoHighlightItem = 1 << 1, /* original C++ signature */ no_highlight_item = ( enum.auto() ) # (= 1 << 1) # plot items will not be highlighted when their legend entry is hovered # ImPlotLegendFlags_NoHighlightAxis = 1 << 2, /* original C++ signature */ no_highlight_axis = ( enum.auto() ) # (= 1 << 2) # axes will not be highlighted when legend entries are hovered (only relevant if x/y-axis count > 1) # ImPlotLegendFlags_NoMenus = 1 << 3, /* original C++ signature */ no_menus = enum.auto() # (= 1 << 3) # the user will not be able to open context menus with right-click # ImPlotLegendFlags_Outside = 1 << 4, /* original C++ signature */ outside = enum.auto() # (= 1 << 4) # legend will be rendered outside of the plot area # ImPlotLegendFlags_Horizontal = 1 << 5, /* original C++ signature */ horizontal = enum.auto() # (= 1 << 5) # legend entries will be displayed horizontally # ImPlotLegendFlags_Sort = 1 << 6, /* original C++ signature */ sort = enum.auto() # (= 1 << 6) # legend entries will be displayed in alphabetical order # ImPlotLegendFlags_Reverse = 1 << 7, /* original C++ signature */ reverse = enum.auto() # (= 1 << 7) # legend entries will be displayed in reverse order class MouseTextFlags_(enum.IntFlag): """Options for mouse hover text (see SetupMouseText)""" # ImPlotMouseTextFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotMouseTextFlags_NoAuxAxes = 1 << 0, /* original C++ signature */ no_aux_axes = enum.auto() # (= 1 << 0) # only show the mouse position for primary axes # ImPlotMouseTextFlags_NoFormat = 1 << 1, /* original C++ signature */ no_format = enum.auto() # (= 1 << 1) # axes label formatters won't be used to render text # ImPlotMouseTextFlags_ShowAlways = 1 << 2, /* original C++ signature */ show_always = enum.auto() # (= 1 << 2) # always display mouse position even if plot not hovered class DragToolFlags_(enum.IntFlag): """Options for DragPoint, DragLine, DragRect""" # ImPlotDragToolFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotDragToolFlags_NoCursors = 1 << 0, /* original C++ signature */ no_cursors = enum.auto() # (= 1 << 0) # drag tools won't change cursor icons when hovered or held # ImPlotDragToolFlags_NoFit = 1 << 1, /* original C++ signature */ no_fit = enum.auto() # (= 1 << 1) # the drag tool won't be considered for plot fits # ImPlotDragToolFlags_NoInputs = 1 << 2, /* original C++ signature */ no_inputs = enum.auto() # (= 1 << 2) # lock the tool from user inputs # ImPlotDragToolFlags_Delayed = 1 << 3, /* original C++ signature */ delayed = ( enum.auto() ) # (= 1 << 3) # tool rendering will be delayed one frame; useful when applying position-constraints class ColormapScaleFlags_(enum.IntFlag): """Flags for ColormapScale""" # ImPlotColormapScaleFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotColormapScaleFlags_NoLabel = 1 << 0, /* original C++ signature */ no_label = enum.auto() # (= 1 << 0) # the colormap axis label will not be displayed # ImPlotColormapScaleFlags_Opposite = 1 << 1, /* original C++ signature */ opposite = enum.auto() # (= 1 << 1) # render the colormap label and tick labels on the opposite side # ImPlotColormapScaleFlags_Invert = 1 << 2, /* original C++ signature */ invert = ( enum.auto() ) # (= 1 << 2) # invert the colormap bar and axis scale (this only affects rendering; if you only want to reverse the scale mapping, make scale_min > scale_max) class ItemFlags_(enum.IntFlag): """Flags for ANY PlotX function. Used by setting ImPlotSpec::Flags.""" # ImPlotItemFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # ImPlotItemFlags_NoLegend = 1 << 0, /* original C++ signature */ no_legend = enum.auto() # (= 1 << 0) # the item won't have a legend entry displayed # ImPlotItemFlags_NoFit = 1 << 1, /* original C++ signature */ no_fit = enum.auto() # (= 1 << 1) # the item won't be considered for plot fits class LineFlags_(enum.IntFlag): """Flags for PlotLine. Used by setting ImPlotSpec::Flags.""" # ImPlotLineFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotLineFlags_Segments = 1 << 10, /* original C++ signature */ segments = enum.auto() # (= 1 << 10) # a line segment will be rendered from every two consecutive points # ImPlotLineFlags_Loop = 1 << 11, /* original C++ signature */ loop = enum.auto() # (= 1 << 11) # the last and first point will be connected to form a closed loop # ImPlotLineFlags_SkipNaN = 1 << 12, /* original C++ signature */ skip_nan = enum.auto() # (= 1 << 12) # NaNs values will be skipped instead of rendered as missing data # ImPlotLineFlags_NoClip = 1 << 13, /* original C++ signature */ no_clip = enum.auto() # (= 1 << 13) # markers (if displayed) on the edge of a plot will not be clipped # ImPlotLineFlags_Shaded = 1 << 14, /* original C++ signature */ shaded = ( enum.auto() ) # (= 1 << 14) # a filled region between the line and horizontal origin will be rendered; use PlotShaded for more advanced cases class ScatterFlags_(enum.IntFlag): """Flags for PlotScatter. Used by setting ImPlotSpec::Flags.""" # ImPlotScatterFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotScatterFlags_NoClip = 1 << 10, /* original C++ signature */ no_clip = enum.auto() # (= 1 << 10) # markers on the edge of a plot will not be clipped class BubblesFlags_(enum.IntFlag): """Flags for PlotBubbles. Used by setting ImPlotSpec::Flags.""" # ImPlotBubblesFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default class PolygonFlags_(enum.IntFlag): """Flags for PlotPolygon. Used by setting ImPlotSpec::Flags.""" # ImPlotPolygonFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default (closed, convex polygon) # ImPlotPolygonFlags_Concave = 1 << 10, /* original C++ signature */ concave = enum.auto() # (= 1 << 10) # use concave polygon filling (slower but supports concave shapes) class StairsFlags_(enum.IntFlag): """Flags for PlotStairs. Used by setting ImPlotSpec::Flags.""" # ImPlotStairsFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotStairsFlags_PreStep = 1 << 10, /* original C++ signature */ pre_step = ( enum.auto() ) # (= 1 << 10) # the y value is continued constantly to the left from every x position, i.e. the interval (x[i-1], x[i]] has the value y[i] # ImPlotStairsFlags_Shaded = 1 << 11 /* original C++ signature */ shaded = ( enum.auto() ) # (= 1 << 11) # a filled region between the stairs and horizontal origin will be rendered; use PlotShaded for more advanced cases class ShadedFlags_(enum.IntFlag): """Flags for PlotShaded (placeholder). Used by setting ImPlotSpec::Flags.""" # ImPlotShadedFlags_None = 0 /* original C++ signature */ none = enum.auto() # (= 0) # default class BarsFlags_(enum.IntFlag): """Flags for PlotBars. Used by setting ImPlotSpec::Flags.""" # ImPlotBarsFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotBarsFlags_Horizontal = 1 << 10, /* original C++ signature */ horizontal = enum.auto() # (= 1 << 10) # bars will be rendered horizontally on the current y-axis class BarGroupsFlags_(enum.IntFlag): """Flags for PlotBarGroups. Used by setting ImPlotSpec::Flags.""" # ImPlotBarGroupsFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotBarGroupsFlags_Horizontal = 1 << 10, /* original C++ signature */ horizontal = enum.auto() # (= 1 << 10) # bar groups will be rendered horizontally on the current y-axis # ImPlotBarGroupsFlags_Stacked = 1 << 11, /* original C++ signature */ stacked = enum.auto() # (= 1 << 11) # items in a group will be stacked on top of each other class ErrorBarsFlags_(enum.IntFlag): """Flags for PlotErrorBars. Used by setting ImPlotSpec::Flags.""" # ImPlotErrorBarsFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotErrorBarsFlags_Horizontal = 1 << 10, /* original C++ signature */ horizontal = enum.auto() # (= 1 << 10) # error bars will be rendered horizontally on the current y-axis class StemsFlags_(enum.IntFlag): """Flags for PlotStems. Used by setting ImPlotSpec::Flags.""" # ImPlotStemsFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotStemsFlags_Horizontal = 1 << 10, /* original C++ signature */ horizontal = enum.auto() # (= 1 << 10) # stems will be rendered horizontally on the current y-axis class InfLinesFlags_(enum.IntFlag): """Flags for PlotInfLines. Used by setting ImPlotSpec::Flags.""" # ImPlotInfLinesFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotInfLinesFlags_Horizontal = 1 << 10 /* original C++ signature */ horizontal = enum.auto() # (= 1 << 10) # lines will be rendered horizontally on the current y-axis class PieChartFlags_(enum.IntFlag): """Flags for PlotPieChart. Used by setting ImPlotSpec::Flags.""" # ImPlotPieChartFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotPieChartFlags_Normalize = 1 << 10, /* original C++ signature */ normalize = ( enum.auto() ) # (= 1 << 10) # force normalization of pie chart values (i.e. always make a full circle if sum < 0) # ImPlotPieChartFlags_IgnoreHidden = 1 << 11, /* original C++ signature */ ignore_hidden = ( enum.auto() ) # (= 1 << 11) # ignore hidden slices when drawing the pie chart (as if they were not there) # ImPlotPieChartFlags_Exploding = 1 << 12, /* original C++ signature */ exploding = enum.auto() # (= 1 << 12) # explode legend-hovered slice # ImPlotPieChartFlags_NoSliceBorder = 1 << 13 /* original C++ signature */ no_slice_border = enum.auto() # (= 1 << 13) # do not draw slice borders class HeatmapFlags_(enum.IntFlag): """Flags for PlotHeatmap. Used by setting ImPlotSpec::Flags.""" # ImPlotHeatmapFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotHeatmapFlags_ColMajor = 1 << 10, /* original C++ signature */ col_major = enum.auto() # (= 1 << 10) # data will be read in column major order class HistogramFlags_(enum.IntFlag): """Flags for PlotHistogram and PlotHistogram2D. Used by setting ImPlotSpec::Flags.""" # ImPlotHistogramFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotHistogramFlags_Horizontal = 1 << 10, /* original C++ signature */ horizontal = ( enum.auto() ) # (= 1 << 10) # histogram bars will be rendered horizontally (not supported by PlotHistogram2D) # ImPlotHistogramFlags_Cumulative = 1 << 11, /* original C++ signature */ cumulative = ( enum.auto() ) # (= 1 << 11) # each bin will contain its count plus the counts of all previous bins (not supported by PlotHistogram2D) # ImPlotHistogramFlags_Density = 1 << 12, /* original C++ signature */ density = ( enum.auto() ) # (= 1 << 12) # counts will be normalized, i.e. the PDF will be visualized, or the CDF will be visualized if Cumulative is also set # ImPlotHistogramFlags_NoOutliers = 1 << 13, /* original C++ signature */ no_outliers = ( enum.auto() ) # (= 1 << 13) # exclude values outside the specified histogram range from the count toward normalizing and cumulative counts # ImPlotHistogramFlags_ColMajor = 1 << 14 /* original C++ signature */ col_major = enum.auto() # (= 1 << 14) # data will be read in column major order (not supported by PlotHistogram) class DigitalFlags_(enum.IntFlag): """Flags for PlotDigital (placeholder). Used by setting ImPlotSpec::Flags.""" # ImPlotDigitalFlags_None = 0 /* original C++ signature */ none = enum.auto() # (= 0) # default class ImageFlags_(enum.IntFlag): """Flags for PlotImage (placeholder). Used by setting ImPlotSpec::Flags.""" # ImPlotImageFlags_None = 0 /* original C++ signature */ none = enum.auto() # (= 0) # default class TextFlags_(enum.IntFlag): """Flags for PlotText. Used by setting ImPlotSpec::Flags.""" # ImPlotTextFlags_None = 0, /* original C++ signature */ none = enum.auto() # (= 0) # default # ImPlotTextFlags_Vertical = 1 << 10 /* original C++ signature */ vertical = enum.auto() # (= 1 << 10) # text will be rendered vertically class DummyFlags_(enum.IntFlag): """Flags for PlotDummy (placeholder). Used by setting ImPlotSpec::Flags.""" # ImPlotDummyFlags_None = 0 /* original C++ signature */ none = enum.auto() # (= 0) # default class Cond_(enum.IntFlag): """Represents a condition for SetupAxisLimits etc. (same as ImGuiCond, but we only support a subset of those enums)""" # ImPlotCond_None = ImGuiCond_None, /* original C++ signature */ none = enum.auto() # (= Cond_None) # No condition (always set the variable), same as _Always # ImPlotCond_Always = ImGuiCond_Always, /* original C++ signature */ always = enum.auto() # (= Cond_Always) # No condition (always set the variable) # ImPlotCond_Once = ImGuiCond_Once, /* original C++ signature */ once = enum.auto() # (= Cond_Once) # Set the variable once per runtime session (only the first call will succeed) class Col_(enum.IntFlag): """Plot styling colors.""" # ImPlotCol_FrameBg, /* original C++ signature */ frame_bg = enum.auto() # (= 0) # plot frame background color (defaults to ImGuiCol_FrameBg) # ImPlotCol_PlotBg, /* original C++ signature */ plot_bg = enum.auto() # (= 1) # plot area background color (defaults to ImGuiCol_WindowBg) # ImPlotCol_PlotBorder, /* original C++ signature */ plot_border = enum.auto() # (= 2) # plot area border color (defaults to ImGuiCol_Border) # ImPlotCol_LegendBg, /* original C++ signature */ legend_bg = enum.auto() # (= 3) # legend background color (defaults to ImGuiCol_PopupBg) # ImPlotCol_LegendBorder, /* original C++ signature */ legend_border = enum.auto() # (= 4) # legend border color (defaults to ImPlotCol_PlotBorder) # ImPlotCol_LegendText, /* original C++ signature */ legend_text = enum.auto() # (= 5) # legend text color (defaults to ImPlotCol_InlayText) # ImPlotCol_TitleText, /* original C++ signature */ title_text = enum.auto() # (= 6) # plot title text color (defaults to ImGuiCol_Text) # ImPlotCol_InlayText, /* original C++ signature */ inlay_text = enum.auto() # (= 7) # color of text appearing inside of plots (defaults to ImGuiCol_Text) # ImPlotCol_AxisText, /* original C++ signature */ axis_text = enum.auto() # (= 8) # axis label and tick labels color (defaults to ImGuiCol_Text) # ImPlotCol_AxisGrid, /* original C++ signature */ axis_grid = enum.auto() # (= 9) # axis grid color (defaults to 25% ImPlotCol_AxisText) # ImPlotCol_AxisTick, /* original C++ signature */ axis_tick = enum.auto() # (= 10) # axis tick color (defaults to AxisGrid) # ImPlotCol_AxisBg, /* original C++ signature */ axis_bg = enum.auto() # (= 11) # background color of axis hover region (defaults to transparent) # ImPlotCol_AxisBgHovered, /* original C++ signature */ axis_bg_hovered = enum.auto() # (= 12) # axis hover color (defaults to ImGuiCol_ButtonHovered) # ImPlotCol_AxisBgActive, /* original C++ signature */ axis_bg_active = enum.auto() # (= 13) # axis active color (defaults to ImGuiCol_ButtonActive) # ImPlotCol_Selection, /* original C++ signature */ selection = enum.auto() # (= 14) # box-selection color (defaults to yellow) # ImPlotCol_Crosshairs, /* original C++ signature */ crosshairs = enum.auto() # (= 15) # crosshairs color (defaults to ImPlotCol_PlotBorder) # ImPlotCol_COUNT /* original C++ signature */ # } count = enum.auto() # (= 16) class StyleVar_(enum.IntFlag): """Plot styling variables.""" # ImPlotStyleVar_PlotDefaultSize, /* original C++ signature */ plot_default_size = enum.auto() # (= 0) # ImVec2, default size used when ImVec2(0,0) is passed to BeginPlot # ImPlotStyleVar_PlotMinSize, /* original C++ signature */ plot_min_size = enum.auto() # (= 1) # ImVec2, minimum size plot frame can be when shrunk # ImPlotStyleVar_PlotBorderSize, /* original C++ signature */ plot_border_size = enum.auto() # (= 2) # float, thickness of border around plot area # ImPlotStyleVar_MinorAlpha, /* original C++ signature */ minor_alpha = enum.auto() # (= 3) # float, alpha multiplier applied to minor axis grid lines # ImPlotStyleVar_MajorTickLen, /* original C++ signature */ major_tick_len = enum.auto() # (= 4) # ImVec2, major tick lengths for X and Y axes # ImPlotStyleVar_MinorTickLen, /* original C++ signature */ minor_tick_len = enum.auto() # (= 5) # ImVec2, minor tick lengths for X and Y axes # ImPlotStyleVar_MajorTickSize, /* original C++ signature */ major_tick_size = enum.auto() # (= 6) # ImVec2, line thickness of major ticks # ImPlotStyleVar_MinorTickSize, /* original C++ signature */ minor_tick_size = enum.auto() # (= 7) # ImVec2, line thickness of minor ticks # ImPlotStyleVar_MajorGridSize, /* original C++ signature */ major_grid_size = enum.auto() # (= 8) # ImVec2, line thickness of major grid lines # ImPlotStyleVar_MinorGridSize, /* original C++ signature */ minor_grid_size = enum.auto() # (= 9) # ImVec2, line thickness of minor grid lines # ImPlotStyleVar_PlotPadding, /* original C++ signature */ plot_padding = ( enum.auto() ) # (= 10) # ImVec2, padding between widget frame and plot area, labels, or outside legends (i.e. main padding) # ImPlotStyleVar_LabelPadding, /* original C++ signature */ label_padding = enum.auto() # (= 11) # ImVec2, padding between axes labels, tick labels, and plot edge # ImPlotStyleVar_LegendPadding, /* original C++ signature */ legend_padding = enum.auto() # (= 12) # ImVec2, legend padding from plot edges # ImPlotStyleVar_LegendInnerPadding, /* original C++ signature */ legend_inner_padding = enum.auto() # (= 13) # ImVec2, legend inner padding from legend edges # ImPlotStyleVar_LegendSpacing, /* original C++ signature */ legend_spacing = enum.auto() # (= 14) # ImVec2, spacing between legend entries # ImPlotStyleVar_MousePosPadding, /* original C++ signature */ mouse_pos_padding = enum.auto() # (= 15) # ImVec2, padding between plot edge and interior info text # ImPlotStyleVar_AnnotationPadding, /* original C++ signature */ annotation_padding = enum.auto() # (= 16) # ImVec2, text padding around annotation labels # ImPlotStyleVar_FitPadding, /* original C++ signature */ fit_padding = ( enum.auto() ) # (= 17) # ImVec2, additional fit padding as a percentage of the fit extents (e.g. ImVec2(0.1,0.1) adds 10% to the fit extents of X and Y) # ImPlotStyleVar_DigitalPadding, /* original C++ signature */ digital_padding = enum.auto() # (= 18) # float, digital plot padding from bottom in pixels # ImPlotStyleVar_DigitalSpacing, /* original C++ signature */ digital_spacing = enum.auto() # (= 19) # float, digital plot spacing gap in pixels # ImPlotStyleVar_COUNT /* original C++ signature */ # } count = enum.auto() # (= 20) class Scale_(enum.IntFlag): """Axis scale""" # ImPlotScale_Linear = 0, /* original C++ signature */ linear = enum.auto() # (= 0) # default linear scale # ImPlotScale_Time, /* original C++ signature */ time = enum.auto() # (= 1) # date/time scale # ImPlotScale_Log10, /* original C++ signature */ log10 = enum.auto() # (= 2) # base 10 logarithmic scale # ImPlotScale_SymLog, /* original C++ signature */ sym_log = enum.auto() # (= 3) # symmetric log scale class Marker_(enum.IntFlag): """Marker specifications.""" # ImPlotMarker_None = -2, /* original C++ signature */ none = enum.auto() # (= -2) # no marker # ImPlotMarker_Auto = -1, /* original C++ signature */ auto = enum.auto() # (= -1) # automatic marker selection # ImPlotMarker_Circle, /* original C++ signature */ circle = enum.auto() # (= 0) # a circle marker (default) # ImPlotMarker_Square, /* original C++ signature */ square = enum.auto() # (= 1) # a square maker # ImPlotMarker_Diamond, /* original C++ signature */ diamond = enum.auto() # (= 2) # a diamond marker # ImPlotMarker_Up, /* original C++ signature */ up = enum.auto() # (= 3) # an upward-pointing triangle marker # ImPlotMarker_Down, /* original C++ signature */ down = enum.auto() # (= 4) # an downward-pointing triangle marker # ImPlotMarker_Left, /* original C++ signature */ left = enum.auto() # (= 5) # an leftward-pointing triangle marker # ImPlotMarker_Right, /* original C++ signature */ right = enum.auto() # (= 6) # an rightward-pointing triangle marker # ImPlotMarker_Cross, /* original C++ signature */ cross = enum.auto() # (= 7) # a cross marker (not fill-able) # ImPlotMarker_Plus, /* original C++ signature */ plus = enum.auto() # (= 8) # a plus marker (not fill-able) # ImPlotMarker_Asterisk, /* original C++ signature */ asterisk = enum.auto() # (= 9) # a asterisk marker (not fill-able) # ImPlotMarker_COUNT /* original C++ signature */ # } count = enum.auto() # (= 10) class Colormap_(enum.IntFlag): """Built-in colormaps""" # ImPlotColormap_Deep = 0, /* original C++ signature */ deep = enum.auto() # (= 0) # a.k.a. seaborn deep (qual=True, n=10) (default) # ImPlotColormap_Dark = 1, /* original C++ signature */ dark = enum.auto() # (= 1) # a.k.a. matplotlib "Set1" (qual=True, n=9 ) # ImPlotColormap_Pastel = 2, /* original C++ signature */ pastel = enum.auto() # (= 2) # a.k.a. matplotlib "Pastel1" (qual=True, n=9 ) # ImPlotColormap_Paired = 3, /* original C++ signature */ paired = enum.auto() # (= 3) # a.k.a. matplotlib "Paired" (qual=True, n=12) # ImPlotColormap_Viridis = 4, /* original C++ signature */ viridis = enum.auto() # (= 4) # a.k.a. matplotlib "viridis" (qual=False, n=11) # ImPlotColormap_Plasma = 5, /* original C++ signature */ plasma = enum.auto() # (= 5) # a.k.a. matplotlib "plasma" (qual=False, n=11) # ImPlotColormap_Hot = 6, /* original C++ signature */ hot = enum.auto() # (= 6) # a.k.a. matplotlib/MATLAB "hot" (qual=False, n=11) # ImPlotColormap_Cool = 7, /* original C++ signature */ cool = enum.auto() # (= 7) # a.k.a. matplotlib/MATLAB "cool" (qual=False, n=11) # ImPlotColormap_Pink = 8, /* original C++ signature */ pink = enum.auto() # (= 8) # a.k.a. matplotlib/MATLAB "pink" (qual=False, n=11) # ImPlotColormap_Jet = 9, /* original C++ signature */ jet = enum.auto() # (= 9) # a.k.a. MATLAB "jet" (qual=False, n=11) # ImPlotColormap_Twilight = 10, /* original C++ signature */ twilight = enum.auto() # (= 10) # a.k.a. matplotlib "twilight" (qual=False, n=11) # ImPlotColormap_RdBu = 11, /* original C++ signature */ rd_bu = enum.auto() # (= 11) # red/blue, Color Brewer (qual=False, n=11) # ImPlotColormap_BrBG = 12, /* original C++ signature */ br_bg = enum.auto() # (= 12) # brown/blue-green, Color Brewer (qual=False, n=11) # ImPlotColormap_PiYG = 13, /* original C++ signature */ pi_yg = enum.auto() # (= 13) # pink/yellow-green, Color Brewer (qual=False, n=11) # ImPlotColormap_Spectral = 14, /* original C++ signature */ spectral = enum.auto() # (= 14) # color spectrum, Color Brewer (qual=False, n=11) # ImPlotColormap_Greys = 15, /* original C++ signature */ greys = enum.auto() # (= 15) # white/black (qual=False, n=2 ) class Location_(enum.IntFlag): """Used to position items on a plot (e.g. legends, labels, etc.)""" # ImPlotLocation_Center = 0, /* original C++ signature */ center = enum.auto() # (= 0) # center-center # ImPlotLocation_North = 1 << 0, /* original C++ signature */ north = enum.auto() # (= 1 << 0) # top-center # ImPlotLocation_South = 1 << 1, /* original C++ signature */ south = enum.auto() # (= 1 << 1) # bottom-center # ImPlotLocation_West = 1 << 2, /* original C++ signature */ west = enum.auto() # (= 1 << 2) # center-left # ImPlotLocation_East = 1 << 3, /* original C++ signature */ east = enum.auto() # (= 1 << 3) # center-right # ImPlotLocation_NorthWest = ImPlotLocation_North | ImPlotLocation_West, /* original C++ signature */ north_west = enum.auto() # (= Location_North | Location_West) # top-left # ImPlotLocation_NorthEast = ImPlotLocation_North | ImPlotLocation_East, /* original C++ signature */ north_east = enum.auto() # (= Location_North | Location_East) # top-right # ImPlotLocation_SouthWest = ImPlotLocation_South | ImPlotLocation_West, /* original C++ signature */ south_west = enum.auto() # (= Location_South | Location_West) # bottom-left # ImPlotLocation_SouthEast = ImPlotLocation_South | ImPlotLocation_East /* original C++ signature */ south_east = enum.auto() # (= Location_South | Location_East) # bottom-right class Bin_(enum.IntFlag): """Enums for different automatic histogram binning methods (k = bin count or w = bin width)""" # ImPlotBin_Sqrt = -1, /* original C++ signature */ sqrt = enum.auto() # (= -1) # k = sqrt(n) # ImPlotBin_Sturges = -2, /* original C++ signature */ sturges = enum.auto() # (= -2) # k = 1 + log2(n) # ImPlotBin_Rice = -3, /* original C++ signature */ rice = enum.auto() # (= -3) # k = 2 * cbrt(n) # ImPlotBin_Scott = -4, /* original C++ signature */ scott = enum.auto() # (= -4) # w = 3.49 * sigma / cbrt(n) class Spec: """Plot item styling specification. Provide these to PlotX functions to override styling, specify offsetting or stride, or set optional flags. This struct can be used in the following ways: 1. By declaring and defining a struct instance: ImPlotSpec spec; spec.LineColor = ImVec4(1,0,0,1); spec.LineWeight = 2.0; spec.Marker = ImPlotMarker_Circle; spec.Flags = ImPlotItemFlags_NoLegend | ImPlotLineFlags_Segments; ImPlot::PlotLine("MyLine", xs, ys, 100, spec); 2. Inline using (ImPlotProp,value) pairs (order does NOT matter): ImPlot::PlotLine("MyLine", xs, ys, 100, { ImPlotProp_LineColor, ImVec4(1,0,0,1), ImPlotProp_LineWeight, 2.0, ImPlotProp_Marker, ImPlotMarker_Circle, ImPlotProp_Flags, ImPlotItemFlags_NoLegend | ImPlotLineFlags_Segments }); """ # ImVec4 LineColor = IMPLOT_AUTO_COL; /* original C++ signature */ line_color: ImVec4 = ( IMPLOT_AUTO_COL # line color (applies to lines, bar edges); IMPLOT_AUTO_COL will use next Colormap color or current item color ) # float LineWeight = 1.0f; /* original C++ signature */ line_weight: float = 1.0 # line weight in pixels (applies to lines, bar edges, marker edges) # ImVec4 FillColor = IMPLOT_AUTO_COL; /* original C++ signature */ fill_color: ImVec4 = ( IMPLOT_AUTO_COL # fill color (applies to shaded regions, bar faces); IMPLOT_AUTO_COL will use next Colormap color or current item color ) # float FillAlpha = 1.0f; /* original C++ signature */ fill_alpha: float = ( 1.0 # alpha multiplier (applies to FillColor, FillColors, MarkerFillColor, and MarkerFillColors) ) # ImPlotMarker Marker = ImPlotMarker_None; /* original C++ signature */ marker: Marker = Marker_None # marker type; specify ImPlotMarker_Auto to use the next unused marker # float MarkerSize = 4; /* original C++ signature */ marker_size: float = 4 # size of markers (radius) *in pixels* # ImVec4 MarkerLineColor = IMPLOT_AUTO_COL; /* original C++ signature */ marker_line_color: ImVec4 = IMPLOT_AUTO_COL # marker edge color; IMPLOT_AUTO_COL will use LineColor # ImVec4 MarkerFillColor = IMPLOT_AUTO_COL; /* original C++ signature */ marker_fill_color: ImVec4 = IMPLOT_AUTO_COL # marker face color; IMPLOT_AUTO_COL will use LineColor # float Size = 4; /* original C++ signature */ size: float = 4 # size of error bar whiskers (width or height), and digital bars (height) *in pixels* # int Offset = 0; /* original C++ signature */ offset: int = 0 # data index offset # int Stride = IMPLOT_AUTO; /* original C++ signature */ stride: int = ( IMPLOT_AUTO # data stride in bytes; IMPLOT_AUTO will result in sizeof(T) where T is the type passed to PlotX ) # ImPlotItemFlags Flags = ImPlotItemFlags_None; /* original C++ signature */ flags: ItemFlags = ( ItemFlags_None # optional item flags; can be composed from common ImPlotItemFlags and/or specialized ImPlotXFlags ) # ImPlotSpec(ImVec4 LineColor = IMPLOT_AUTO_COL, float LineWeight = 1.0f, ImVec4 FillColor = IMPLOT_AUTO_COL, float FillAlpha = 1.0f, ImPlotMarker Marker = ImPlotMarker_None, float MarkerSize = 4, ImVec4 MarkerLineColor = IMPLOT_AUTO_COL, ImVec4 MarkerFillColor = IMPLOT_AUTO_COL, float Size = 4, int Offset = 0, int Stride = IMPLOT_AUTO, ImPlotItemFlags Flags = ImPlotItemFlags_None); /* original C++ signature */ def __init__( self, line_color: Optional[ImVec4Like] = None, line_weight: float = 1.0, fill_color: Optional[ImVec4Like] = None, fill_alpha: float = 1.0, marker: Optional[Marker] = None, marker_size: float = 4, marker_line_color: Optional[ImVec4Like] = None, marker_fill_color: Optional[ImVec4Like] = None, size: float = 4, offset: int = 0, stride: int = IMPLOT_AUTO, flags: ItemFlags = ItemFlags_None, ) -> None: """Auto-generated default constructor with named params Python bindings defaults: If any of the params below is None, then its default value below will be used: * LineColor: IMPLOT_AUTO_COL * FillColor: IMPLOT_AUTO_COL * Marker: Marker_None * MarkerLineColor: IMPLOT_AUTO_COL * MarkerFillColor: IMPLOT_AUTO_COL """ pass line_colors: Optional[np.ndarray] = ( None # array of colors (np.uint32) for each line. Must have the same length as the data arrays. If None, use LineColor for all lines. ) fill_colors: Optional[np.ndarray] = ( None # array of colors (np.uint32) for each fill. Must have the same length as the data arrays. If None, use FillColor for all fills. ) marker_line_colors: Optional[np.ndarray] = ( None # array of colors (np.uint32) for each marker edge. Must have the same length as the data arrays. If None, use MarkerLineColor for all markers. ) marker_fill_colors: Optional[np.ndarray] = ( None # array of colors (np.uint32) for each marker face. Must have the same length as the data arrays. If None, use MarkerFillColor for all markers. ) marker_sizes: Optional[np.ndarray] = ( None # array of sizes (np.float32) for each marker. Must have the same length as the data arrays. If None, use MarkerSize for all markers. ) class Point: # double x, /* original C++ signature */ x: float # y; /* original C++ signature */ y: float # constexpr ImPlotPoint() : x(0.0), y(0.0) { } /* original C++ signature */ @overload def __init__(self) -> None: pass # constexpr ImPlotPoint(double _x, double _y) : x(_x), y(_y) { } /* original C++ signature */ @overload def __init__(self, _x: float, _y: float) -> None: pass # constexpr ImPlotPoint(const ImVec2& p) : x((double)p.x), y((double)p.y) { } /* original C++ signature */ @overload def __init__(self, p: ImVec2Like) -> None: pass # IMPLOT_API double& operator[] (size_t idx) { IM_ASSERT(idx == 0 || idx == 1); return ((double*)(void*)(char*)this)[idx]; } /* original C++ signature */ def __getitem__(self, idx: int) -> float: pass class Range: """Range defined by a min/max value.""" # double Min, /* original C++ signature */ min: float # Max; /* original C++ signature */ max: float # constexpr ImPlotRange() : Min(0.0), Max(0.0) { } /* original C++ signature */ @overload def __init__(self) -> None: pass # constexpr ImPlotRange(double _min, double _max) : Min(_min), Max(_max) { } /* original C++ signature */ @overload def __init__(self, _min: float, _max: float) -> None: pass # IMPLOT_API bool Contains(double value) const { return value >= Min && value <= Max; } /* original C++ signature */ def contains(self, value: float) -> bool: pass # IMPLOT_API double Size() const { return Max - Min; } /* original C++ signature */ def size(self) -> float: pass # IMPLOT_API double Clamp(double value) const { return (value < Min) ? Min : (value > Max) ? Max : value; } /* original C++ signature */ def clamp(self, value: float) -> float: pass class Rect: """Combination of two range limits for X and Y axes. Also an AABB defined by Min()/Max().""" # ImPlotRange X, /* original C++ signature */ x: Range # Y; /* original C++ signature */ y: Range # constexpr ImPlotRect() : X(0.0,0.0), Y(0.0,0.0) { } /* original C++ signature */ @overload def __init__(self) -> None: pass # constexpr ImPlotRect(double x_min, double x_max, double y_min, double y_max) : X(x_min, x_max), Y(y_min, y_max) { } /* original C++ signature */ @overload def __init__(self, x_min: float, x_max: float, y_min: float, y_max: float) -> None: pass # IMPLOT_API bool Contains(const ImPlotPoint& p) const { return Contains(p.x, p.y); } /* original C++ signature */ @overload def contains(self, p: Point) -> bool: pass # IMPLOT_API bool Contains(double x, double y) const { return X.Contains(x) && Y.Contains(y); } /* original C++ signature */ @overload def contains(self, x: float, y: float) -> bool: pass # IMPLOT_API ImPlotPoint Size() const { return ImPlotPoint(X.Size(), Y.Size()); } /* original C++ signature */ def size(self) -> Point: pass # IMPLOT_API ImPlotPoint Clamp(const ImPlotPoint& p) const { return Clamp(p.x, p.y); } /* original C++ signature */ @overload def clamp(self, p: Point) -> Point: pass # IMPLOT_API ImPlotPoint Clamp(double x, double y) const { return ImPlotPoint(X.Clamp(x),Y.Clamp(y)); } /* original C++ signature */ @overload def clamp(self, x: float, y: float) -> Point: pass # IMPLOT_API ImPlotPoint Min() const { return ImPlotPoint(X.Min, Y.Min); } /* original C++ signature */ def min(self) -> Point: pass # IMPLOT_API ImPlotPoint Max() const { return ImPlotPoint(X.Max, Y.Max); } /* original C++ signature */ def max(self) -> Point: pass class Style: """Plot style structure (has support for copy.copy) """ # plot styling # ImVec2 PlotDefaultSize; /* original C++ signature */ plot_default_size: ImVec2 # = 400,300 default size used when ImVec2(0,0) is passed to BeginPlot # ImVec2 PlotMinSize; /* original C++ signature */ plot_min_size: ImVec2 # = 200,150 minimum size plot frame can be when shrunk # float PlotBorderSize; /* original C++ signature */ plot_border_size: float # = 1, line thickness of border around plot area # float MinorAlpha; /* original C++ signature */ minor_alpha: float # = 0.25 alpha multiplier applied to minor axis grid lines # ImVec2 MajorTickLen; /* original C++ signature */ major_tick_len: ImVec2 # = 10,10 major tick lengths for X and Y axes # ImVec2 MinorTickLen; /* original C++ signature */ minor_tick_len: ImVec2 # = 5,5 minor tick lengths for X and Y axes # ImVec2 MajorTickSize; /* original C++ signature */ major_tick_size: ImVec2 # = 1,1 line thickness of major ticks # ImVec2 MinorTickSize; /* original C++ signature */ minor_tick_size: ImVec2 # = 1,1 line thickness of minor ticks # ImVec2 MajorGridSize; /* original C++ signature */ major_grid_size: ImVec2 # = 1,1 line thickness of major grid lines # ImVec2 MinorGridSize; /* original C++ signature */ minor_grid_size: ImVec2 # = 1,1 line thickness of minor grid lines # plot padding # ImVec2 PlotPadding; /* original C++ signature */ plot_padding: ( ImVec2 # = 10,10 padding between widget frame and plot area, labels, or outside legends (i.e. main padding) ) # ImVec2 LabelPadding; /* original C++ signature */ label_padding: ImVec2 # = 5,5 padding between axes labels, tick labels, and plot edge # ImVec2 LegendPadding; /* original C++ signature */ legend_padding: ImVec2 # = 10,10 legend padding from plot edges # ImVec2 LegendInnerPadding; /* original C++ signature */ legend_inner_padding: ImVec2 # = 5,5 legend inner padding from legend edges # ImVec2 LegendSpacing; /* original C++ signature */ legend_spacing: ImVec2 # = 5,0 spacing between legend entries # ImVec2 MousePosPadding; /* original C++ signature */ mouse_pos_padding: ImVec2 # = 10,10 padding between plot edge and interior mouse location text # ImVec2 AnnotationPadding; /* original C++ signature */ annotation_padding: ImVec2 # = 2,2 text padding around annotation labels # ImVec2 FitPadding; /* original C++ signature */ fit_padding: ImVec2 # = 0,0 additional fit padding as a percentage of the fit extents (e.g. ImVec2(0.1,0.1) adds 10% to the fit extents of X and Y) # float DigitalPadding; /* original C++ signature */ digital_padding: float # = 20, digital plot padding from bottom in pixels # float DigitalSpacing; /* original C++ signature */ digital_spacing: float # = 4, digital plot spacing gap in pixels # [ADAPT_IMGUI_BUNDLE] # #ifdef IMGUI_BUNDLE_PYTHON_API # # python adapter for ImPlotStyle::Colors[ImPlotCol_COUNT] # You can query and modify those values (0 <= idxColor < implot.Col_.count) # inline IMPLOT_API ImVec4& Color_(size_t idxColor) { IM_ASSERT( (idxColor >=0) && (idxColor < ImPlotCol_COUNT)); return Colors[idxColor]; } /* original C++ signature */ def color_(self, idx_color: int) -> ImVec4: """Array of styling colors (index from implot.Col_.xxx)""" pass # inline IMPLOT_API void SetColor_(size_t idxColor, ImVec4 color) { IM_ASSERT( (idxColor >=0) && (idxColor < ImPlotCol_COUNT)); Colors[idxColor] = color; } /* original C++ signature */ def set_color_(self, idx_color: int, color: ImVec4Like) -> None: """Array of styling colors (index from implot.Col_.xxx)""" pass # #endif # # [/ADAPT_IMGUI_BUNDLE] # colormap # ImPlotColormap Colormap; /* original C++ signature */ colormap: Colormap # The current colormap. Set this to either an ImPlotColormap_ enum or an index returned by AddColormap. # settings/flags # bool UseLocalTime; /* original C++ signature */ use_local_time: ( bool # = False, axis labels will be formatted for your timezone when ImPlotAxisFlag_Time is enabled ) # bool UseISO8601; /* original C++ signature */ use_iso8601: bool # = False, dates will be formatted according to ISO 8601 where applicable (e.g. YYYY-MM-DD, YYYY-MM, --MM-DD, etc.) # bool Use24HourClock; /* original C++ signature */ use24_hour_clock: bool # = False, times will be formatted using a 24 hour clock # IMPLOT_API ImPlotStyle(); /* original C++ signature */ def __init__(self) -> None: pass # Support for legacy versions class InputMap: """Input mapping structure. Default values listed. See also MapInputDefault, MapInputReverse.""" # ImGuiMouseButton Pan; /* original C++ signature */ pan: MouseButton # LMB enables panning when held, # int PanMod; /* original C++ signature */ pan_mod: int # none optional modifier that must be held for panning/fitting # ImGuiMouseButton Fit; /* original C++ signature */ fit: MouseButton # LMB initiates fit when double clicked # ImGuiMouseButton Select; /* original C++ signature */ select: MouseButton # RMB begins box selection when pressed and confirms selection when released # ImGuiMouseButton SelectCancel; /* original C++ signature */ select_cancel: MouseButton # LMB cancels active box selection when pressed; cannot be same as Select # int SelectMod; /* original C++ signature */ select_mod: int # none optional modifier that must be held for box selection # int SelectHorzMod; /* original C++ signature */ select_horz_mod: int # Alt expands active box selection horizontally to plot edge when held # int SelectVertMod; /* original C++ signature */ select_vert_mod: int # Shift expands active box selection vertically to plot edge when held # ImGuiMouseButton Menu; /* original C++ signature */ menu: MouseButton # RMB opens context menus (if enabled) when clicked # int OverrideMod; /* original C++ signature */ override_mod: int # Ctrl when held, all input is ignored; used to enable axis/plots as DND sources # int ZoomMod; /* original C++ signature */ zoom_mod: int # none optional modifier that must be held for scroll wheel zooming # float ZoomRate; /* original C++ signature */ zoom_rate: ( float # 0.1 zoom rate for scroll (e.g. 0.1 = 10% plot range every scroll click); make negative to invert ) # IMPLOT_API ImPlotInputMap(); /* original C++ signature */ def __init__(self) -> None: pass # ----------------------------------------------------------------------------- # [SECTION] Callbacks # ----------------------------------------------------------------------------- # ----------------------------------------------------------------------------- # [SECTION] Contexts # ----------------------------------------------------------------------------- # IMPLOT_API ImPlotContext* CreateContext(); /* original C++ signature */ def create_context() -> Context: """Creates a new ImPlot context. Call this after ImGui::CreateContext.""" pass # IMPLOT_API void DestroyContext(ImPlotContext* ctx = nullptr); /* original C++ signature */ def destroy_context(ctx: Optional[Context] = None) -> None: """Destroys an ImPlot context. Call this before ImGui::DestroyContext. None = destroy current context.""" pass # IMPLOT_API ImPlotContext* GetCurrentContext(); /* original C++ signature */ def get_current_context() -> Context: """Returns the current ImPlot context. None if no context has ben set.""" pass # IMPLOT_API void SetCurrentContext(ImPlotContext* ctx); /* original C++ signature */ def set_current_context(ctx: Context) -> None: """Sets the current ImPlot context.""" pass # IMPLOT_API void SetImGuiContext(ImGuiContext* ctx); /* original C++ signature */ def set_imgui_context(ctx: ImGui_Context) -> None: """Sets the current **ImGui** context. This is ONLY necessary if you are compiling ImPlot as a DLL (not recommended) separate from your ImGui compilation. It sets the global variable GImGui, which is not shared across DLL boundaries. See GImGui documentation in imgui.cpp for more details. """ pass # ----------------------------------------------------------------------------- # [SECTION] Begin/End Plot # ----------------------------------------------------------------------------- # IMPLOT_API bool BeginPlot(const char* title_id, const ImVec2& size=ImVec2(-1,0), ImPlotFlags flags=0); /* original C++ signature */ def begin_plot(title_id: str, size: Optional[ImVec2Like] = None, flags: Flags = 0) -> bool: """Starts a 2D plotting context. If this function returns True, EndPlot() MUST be called! You are encouraged to use the following convention: if (BeginPlot(...)) { PlotLine(...); ... EndPlot(); } Important notes: - #title_id must be unique to the current ImGui ID scope. If you need to avoid ID collisions or don't want to display a title in the plot, use double hashes (e.g. "MyPlot##HiddenIdText" or "##NoTitle"). - #size is the **frame** size of the plot widget, not the plot area. The default size of plots (i.e. when ImVec2(0,0)) can be modified in your ImPlotStyle. Python bindings defaults: If size is None, then its default value will be: ImVec2(-1,0) """ pass # IMPLOT_API void EndPlot(); /* original C++ signature */ def end_plot() -> None: """Only call EndPlot() if BeginPlot() returns True! Typically called at the end of an if statement conditioned on BeginPlot(). See example above. """ pass # ----------------------------------------------------------------------------- # [SECTION] Begin/End Subplots # ----------------------------------------------------------------------------- # Starts a subdivided plotting context. If the function returns True, # EndSubplots() MUST be called! Call BeginPlot/EndPlot AT MOST [rows*cols] # times in between the beginning and end of the subplot context. Plots are # added in row major order. # # Example: # # if (BeginSubplots("My Subplot",2,3,ImVec2(800,400)) { # for (int i = 0; i < 6; ++i) { # if (BeginPlot(...)) { # ImPlot::PlotLine(...); # ... # EndPlot(); # } # } # EndSubplots(); # } # # Produces: # # [0] | [1] | [2] # ----|-----|---- # [3] | [4] | [5] # # Important notes: # # - #title_id must be unique to the current ImGui ID scope. If you need to avoid ID # collisions or don't want to display a title in the plot, use double hashes # (e.g. "MySubplot##HiddenIdText" or "##NoTitle"). # - #rows and #cols must be greater than 0. # - #size is the size of the entire grid of subplots, not the individual plots # - #row_ratios and #col_ratios must have AT LEAST #rows and #cols elements, # respectively. These are the sizes of the rows and columns expressed in ratios. # If the user adjusts the dimensions, the arrays are updated with new ratios. # # Important notes regarding BeginPlot from inside of BeginSubplots: # # - The #title_id parameter of _BeginPlot_ (see above) does NOT have to be # unique when called inside of a subplot context. Subplot IDs are hashed # for your convenience so you don't have call PushID or generate unique title # strings. Simply pass an empty string to BeginPlot unless you want to title # each subplot. # - The #size parameter of _BeginPlot_ (see above) is ignored when inside of a # subplot context. The actual size of the subplot will be based on the # #size value you pass to _BeginSubplots_ and #row/#col_ratios if provided. # #ifdef IMGUI_BUNDLE_PYTHON_API # class SubplotsRowColRatios: # std::vector row_ratios; /* original C++ signature */ row_ratios: List[float] # std::vector col_ratios; /* original C++ signature */ col_ratios: List[float] # SubplotsRowColRatios(std::vector row_ratios = std::vector(), std::vector col_ratios = std::vector()); /* original C++ signature */ def __init__(self, row_ratios: Optional[List[float]] = None, col_ratios: Optional[List[float]] = None) -> None: """Auto-generated default constructor with named params Python bindings defaults: If any of the params below is None, then its default value below will be used: * row_ratios: List[float]() * col_ratios: List[float]() """ pass # IMPLOT_API inline bool BeginSubplotsWithRatios(const char* title_id, /* original C++ signature */ # int rows, # int cols, # const ImVec2& size, # ImPlotSubplotFlags flags = 0, # SubplotsRowColRatios* row_col_ratios = nullptr) # { # if (row_col_ratios == nullptr) # return BeginSubplots(title_id, rows, cols, size, flags, nullptr , nullptr); # return BeginSubplots(title_id, rows, cols, size, flags, row_col_ratios->row_ratios.data(), row_col_ratios->col_ratios.data()); # } def begin_subplots( title_id: str, rows: int, cols: int, size: ImVec2Like, flags: SubplotFlags = 0, row_col_ratios: Optional[SubplotsRowColRatios] = None, ) -> bool: pass # #endif # # IMPLOT_API void EndSubplots(); /* original C++ signature */ def end_subplots() -> None: """Only call EndSubplots() if BeginSubplots() returns True! Typically called at the end of an if statement conditioned on BeginSubplots(). See example above. """ pass # ----------------------------------------------------------------------------- # [SECTION] Setup # ----------------------------------------------------------------------------- # The following API allows you to setup and customize various aspects of the # current plot. The functions should be called immediately after BeginPlot # and before any other API calls. Typical usage is as follows: # if (BeginPlot(...)) { 1) begin a new plot # SetupAxis(ImAxis_X1, "My X-Axis"); 2) make Setup calls # SetupAxis(ImAxis_Y1, "My Y-Axis"); # SetupLegend(ImPlotLocation_North); # ... # SetupFinish(); 3) [optional] explicitly finish setup # PlotLine(...); 4) plot items # ... # EndPlot(); 5) end the plot # } # # Important notes: # # - Always call Setup code at the top of your BeginPlot conditional statement. # - Setup is locked once you start plotting or explicitly call SetupFinish. # Do NOT call Setup code after you begin plotting or after you make # any non-Setup API calls (e.g. utils like PlotToPixels also lock Setup) # - Calling SetupFinish is OPTIONAL, but probably good practice. If you do not # call it yourself, then the first subsequent plotting or utility function will # call it for you. # IMPLOT_API void SetupAxis(ImAxis axis, const char* label=nullptr, ImPlotAxisFlags flags=0); /* original C++ signature */ def setup_axis(axis: ImAxis, label: Optional[str] = None, flags: AxisFlags = 0) -> None: """Enables an axis or sets the label and/or flags for an existing axis. Leave #label = None for no label.""" pass # IMPLOT_API void SetupAxisLimits(ImAxis axis, double v_min, double v_max, ImPlotCond cond = ImPlotCond_Once); /* original C++ signature */ def setup_axis_limits(axis: ImAxis, v_min: float, v_max: float, cond: Optional[Cond] = None) -> None: """Sets an axis range limits. If ImPlotCond_Always is used, the axes limits will be locked. Inversion with v_min > v_max is not supported; use SetupAxisLimits instead. Python bindings defaults: If cond is None, then its default value will be: Cond_Once """ pass # #ifdef IMGUI_BUNDLE_PYTHON_API # # IMPLOT_API inline void SetupAxisLinks(ImAxis axis, BoxedValue* link_min, BoxedValue* link_max) { SetupAxisLinks(axis, &link_min->value, &link_max->value); } /* original C++ signature */ def setup_axis_links(axis: ImAxis, link_min: BoxedValue, link_max: BoxedValue) -> None: """Links an axis range limits to external values. Use BoxedValue to transmit values (which will be updated after EndPlot).""" pass # #endif # # IMPLOT_API void SetupAxisFormat(ImAxis axis, const char* fmt); /* original C++ signature */ def setup_axis_format(axis: ImAxis, fmt: str) -> None: """Sets the format of numeric axis labels via formatter specifier (default="%g"). Formatted values will be double (i.e. use %f).""" pass # IMPLOT_API void SetupAxisScale(ImAxis axis, ImPlotScale scale); /* original C++ signature */ def setup_axis_scale(axis: ImAxis, scale: Scale) -> None: """Sets an axis' scale using built-in options.""" pass # IMPLOT_API void SetupAxisLimitsConstraints(ImAxis axis, double v_min, double v_max); /* original C++ signature */ def setup_axis_limits_constraints(axis: ImAxis, v_min: float, v_max: float) -> None: """Sets an axis' limits constraints.""" pass # IMPLOT_API void SetupAxisZoomConstraints(ImAxis axis, double z_min, double z_max); /* original C++ signature */ def setup_axis_zoom_constraints(axis: ImAxis, z_min: float, z_max: float) -> None: """Sets an axis' zoom constraints.""" pass # IMPLOT_API void SetupAxes(const char* x_label, const char* y_label, ImPlotAxisFlags x_flags=0, ImPlotAxisFlags y_flags=0); /* original C++ signature */ def setup_axes(x_label: str, y_label: str, x_flags: AxisFlags = 0, y_flags: AxisFlags = 0) -> None: """Sets the label and/or flags for primary X and Y axes (shorthand for two calls to SetupAxis).""" pass # IMPLOT_API void SetupAxesLimits(double x_min, double x_max, double y_min, double y_max, ImPlotCond cond = ImPlotCond_Once); /* original C++ signature */ def setup_axes_limits(x_min: float, x_max: float, y_min: float, y_max: float, cond: Optional[Cond] = None) -> None: """Sets the primary X and Y axes range limits. If ImPlotCond_Always is used, the axes limits will be locked (shorthand for two calls to SetupAxisLimits). Python bindings defaults: If cond is None, then its default value will be: Cond_Once """ pass # IMPLOT_API void SetupLegend(ImPlotLocation location, ImPlotLegendFlags flags=0); /* original C++ signature */ def setup_legend(location: Location, flags: LegendFlags = 0) -> None: """Sets up the plot legend. This can also be called immediately after BeginSubplots when using ImPlotSubplotFlags_ShareItems.""" pass # IMPLOT_API void SetupMouseText(ImPlotLocation location, ImPlotMouseTextFlags flags=0); /* original C++ signature */ def setup_mouse_text(location: Location, flags: MouseTextFlags = 0) -> None: """Set the location of the current plot's mouse position text (default = South|East).""" pass # IMPLOT_API void SetupFinish(); /* original C++ signature */ def setup_finish() -> None: """Explicitly finalize plot setup. Once you call this, you cannot make anymore Setup calls for the current plot! Note that calling this function is OPTIONAL; it will be called by the first subsequent setup-locking API call. """ pass # ----------------------------------------------------------------------------- # [SECTION] SetNext # ----------------------------------------------------------------------------- # Though you should default to the `Setup` API above, there are some scenarios # where (re)configuring a plot or axis before `BeginPlot` is needed (e.g. if # using a preceding button or slider widget to change the plot limits). In # this case, you can use the `SetNext` API below. While this is not as feature # rich as the Setup API, most common needs are provided. These functions can be # called anywhere except for inside of `Begin/EndPlot`. For example: # if (ImGui::Button("Center Plot")) # ImPlot::SetNextPlotLimits(-1,1,-1,1); # if (ImPlot::BeginPlot(...)) { # ... # ImPlot::EndPlot(); # } # # Important notes: # # - You must still enable non-default axes with SetupAxis for these functions # to work properly. # IMPLOT_API void SetNextAxisLimits(ImAxis axis, double v_min, double v_max, ImPlotCond cond = ImPlotCond_Once); /* original C++ signature */ def set_next_axis_limits(axis: ImAxis, v_min: float, v_max: float, cond: Optional[Cond] = None) -> None: """Sets an upcoming axis range limits. If ImPlotCond_Always is used, the axes limits will be locked. Python bindings defaults: If cond is None, then its default value will be: Cond_Once """ pass # #ifdef IMGUI_BUNDLE_PYTHON_API # # IMPLOT_API inline void SetNextAxisLinks(ImAxis axis, BoxedValue* link_min, BoxedValue* link_max) { SetNextAxisLinks(axis, &link_min->value, &link_max->value); } /* original C++ signature */ def set_next_axis_links(axis: ImAxis, link_min: BoxedValue, link_max: BoxedValue) -> None: """Links an upcoming axis range limits to external values. Use BoxedValue to transmit values (which will be updated after EndPlot).""" pass # #endif # # IMPLOT_API void SetNextAxisToFit(ImAxis axis); /* original C++ signature */ def set_next_axis_to_fit(axis: ImAxis) -> None: """Set an upcoming axis to auto fit to its data.""" pass # IMPLOT_API void SetNextAxesLimits(double x_min, double x_max, double y_min, double y_max, ImPlotCond cond = ImPlotCond_Once); /* original C++ signature */ def set_next_axes_limits(x_min: float, x_max: float, y_min: float, y_max: float, cond: Optional[Cond] = None) -> None: """Sets the upcoming primary X and Y axes range limits. If ImPlotCond_Always is used, the axes limits will be locked (shorthand for two calls to SetupAxisLimits). Python bindings defaults: If cond is None, then its default value will be: Cond_Once """ pass # IMPLOT_API void SetNextAxesToFit(); /* original C++ signature */ def set_next_axes_to_fit() -> None: """Sets all upcoming axes to auto fit to their data.""" pass # ----------------------------------------------------------------------------- # [SECTION] Plot Items # ----------------------------------------------------------------------------- # The main plotting API is provided below. Call these functions between # Begin/EndPlot and after any Setup API calls. Each plots data on the current # x and y axes, which can be changed with `SetAxis/Axes`. # # The templated functions are explicitly instantiated in implot_items.cpp. # They are not intended to be used generically with custom types. You will get # a linker error if you try! All functions support the following scalar types: # # float, double, ImS8, ImU8, ImS16, ImU16, ImS32, ImU32, ImS64, ImU64 # # # If you need to plot custom or non-homogenous data you have a few options: # # 1. If your data is a simple struct/class (e.g. Vector2), you can use striding in your ImPlotSpec. # This is the most performant option if applicable. # # struct Vector2 { float X, Y; }; # ... # Vector2 data[42]; # ImPlot::PlotLine("line", &data[0].x, &data[0].y, 42, {ImPlotProp_Stride, sizeof(Vector2}); # # 2. Write a custom getter C function or C++ lambda and pass it and optionally your data to # an ImPlot function post-fixed with a G (e.g. PlotScatterG). This has a slight performance # cost, but probably not enough to worry about unless your data is very large. Examples: # # ImPlotPoint MyDataGetter(int idx, None* data) { # MyData* my_data = (MyData*)data; # ImPlotPoint p; # p.x = my_data->GetTime(idx); # p.y = my_data->GetValue(idx); # return p # } # ... # auto my_lambda = [](int idx, None*) { # double t = idx / 999.0; # return ImPlotPoint(t, 0.5+0.5*std::sin(2*PI*10*t)); # }; # ... # if (ImPlot::BeginPlot("MyPlot")) { # MyData my_data; # ImPlot::PlotScatterG("scatter", MyDataGetter, &my_data, my_data.Size()); # ImPlot::PlotLineG("line", my_lambda, None, 1000); # ImPlot::EndPlot(); # } # # NB: All types are converted to double before plotting. You may lose information # if you try plotting extremely large 64-bit integral types. Proceed with caution! # Plots a standard 2D line plot. # IMPLOT_TMP void PlotLine(const char* label_id, const T* values, int count, double xscale=1, double xstart=0, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_line( label_id: str, values: np.ndarray, xscale: float = 1, xstart: float = 0, spec: Optional[Spec] = None ) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP void PlotLine(const char* label_id, const T* xs, const T* ys, int count, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_line(label_id: str, xs: np.ndarray, ys: np.ndarray, spec: Optional[Spec] = None) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # Plots a standard 2D scatter plot. Default marker is ImPlotMarker_Circle. # IMPLOT_TMP void PlotScatter(const char* label_id, const T* values, int count, double xscale=1, double xstart=0, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_scatter( label_id: str, values: np.ndarray, xscale: float = 1, xstart: float = 0, spec: Optional[Spec] = None ) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP void PlotScatter(const char* label_id, const T* xs, const T* ys, int count, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_scatter(label_id: str, xs: np.ndarray, ys: np.ndarray, spec: Optional[Spec] = None) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # Plots a bubble graph. #szs are the radius of each bubble in plot units. # IMPLOT_TMP void PlotBubbles(const char* label_id, const T* values, const T* szs, int count, double xscale=1, double xstart=0, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_bubbles( label_id: str, values: np.ndarray, szs: np.ndarray, xscale: float = 1, xstart: float = 0, spec: Optional[Spec] = None, ) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP void PlotBubbles(const char* label_id, const T* xs, const T* ys, const T* szs, int count, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_bubbles(label_id: str, xs: np.ndarray, ys: np.ndarray, szs: np.ndarray, spec: Optional[Spec] = None) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP void PlotPolygon(const char* label_id, const T* xs, const T* ys, int count, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ def plot_polygon(label_id: str, xs: np.ndarray, ys: np.ndarray, spec: Optional[Spec] = None) -> None: """Plots a polygon. Points are specified in counter-clockwise order. If concave, make sure to set the Concave flag. Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # Plots a a stairstep graph. The y value is continued constantly to the right from every x position, i.e. the interval [x[i], x[i+1]) has the value y[i] # IMPLOT_TMP void PlotStairs(const char* label_id, const T* values, int count, double xscale=1, double xstart=0, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_stairs( label_id: str, values: np.ndarray, xscale: float = 1, xstart: float = 0, spec: Optional[Spec] = None ) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP void PlotStairs(const char* label_id, const T* xs, const T* ys, int count, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_stairs(label_id: str, xs: np.ndarray, ys: np.ndarray, spec: Optional[Spec] = None) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # Plots a shaded (filled) region between two lines, or a line and a horizontal reference. Set yref to +/-INFINITY for infinite fill extents. # IMPLOT_TMP void PlotShaded(const char* label_id, const T* values, int count, double yref=0, double xscale=1, double xstart=0, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_shaded( label_id: str, values: np.ndarray, yref: float = 0, xscale: float = 1, xstart: float = 0, spec: Optional[Spec] = None, ) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP void PlotShaded(const char* label_id, const T* xs, const T* ys, int count, double yref=0, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_shaded(label_id: str, xs: np.ndarray, ys: np.ndarray, yref: float = 0, spec: Optional[Spec] = None) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP void PlotShaded(const char* label_id, const T* xs, const T* ys1, const T* ys2, int count, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_shaded(label_id: str, xs: np.ndarray, ys1: np.ndarray, ys2: np.ndarray, spec: Optional[Spec] = None) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # Plots a bar graph. Vertical by default. #bar_size and #shift are in plot units. # IMPLOT_TMP void PlotBars(const char* label_id, const T* values, int count, double bar_size=0.67, double shift=0, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_bars( label_id: str, values: np.ndarray, bar_size: float = 0.67, shift: float = 0, spec: Optional[Spec] = None ) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP void PlotBars(const char* label_id, const T* xs, const T* ys, int count, double bar_size, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_bars(label_id: str, xs: np.ndarray, ys: np.ndarray, bar_size: float, spec: Optional[Spec] = None) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # #ifdef IMGUI_BUNDLE_PYTHON_API # # IMPLOT_TMP void PlotBarGroups(const std::vector& label_ids, const T* values, int count, double group_size=0.67, double shift=0, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ def plot_bar_groups( label_ids: List[str], values: np.ndarray, group_size: float = 0.67, shift: float = 0, spec: Optional[Spec] = None ) -> None: """Plots a group of bars. - values should be a **1 dimension** numpy array of values. - label_ids should be a list of strings corresponding to bars labels Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # #endif # # Plots vertical error bar. The label_id should be the same as the label_id of the associated line or bar plot. # IMPLOT_TMP void PlotErrorBars(const char* label_id, const T* xs, const T* ys, const T* err, int count, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_error_bars( label_id: str, xs: np.ndarray, ys: np.ndarray, err: np.ndarray, spec: Optional[Spec] = None ) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP void PlotErrorBars(const char* label_id, const T* xs, const T* ys, const T* neg, const T* pos, int count, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_error_bars( label_id: str, xs: np.ndarray, ys: np.ndarray, neg: np.ndarray, pos: np.ndarray, spec: Optional[Spec] = None ) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # Plots stems. Vertical by default. # IMPLOT_TMP void PlotStems(const char* label_id, const T* values, int count, double ref=0, double scale=1, double start=0, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_stems( label_id: str, values: np.ndarray, ref: float = 0, scale: float = 1, start: float = 0, spec: Optional[Spec] = None ) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP void PlotStems(const char* label_id, const T* xs, const T* ys, int count, double ref=0, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ @overload def plot_stems(label_id: str, xs: np.ndarray, ys: np.ndarray, ref: float = 0, spec: Optional[Spec] = None) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP void PlotInfLines(const char* label_id, const T* values, int count, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ def plot_inf_lines(label_id: str, values: np.ndarray, spec: Optional[Spec] = None) -> None: """Plots infinite vertical or horizontal lines (e.g. for references or asymptotes). Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # Plots a pie chart. Center and radius are in plot units. #label_fmt can be set to None for no labels. # IMPLOT_TMP void PlotPieChart(const char* const label_ids[], const T* values, int count, double x, double y, double radius, const char* label_fmt="%.1f", double angle0=90, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ def plot_pie_chart( label_ids: List[str], values: np.ndarray, x: float, y: float, radius: float, label_fmt: str = "%.1", angle0: float = 90, spec: Optional[Spec] = None, ) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # IMPLOT_TMP double PlotHistogram(const char* label_id, const T* values, int count, int bins=ImPlotBin_Sturges, double bar_scale=1.0, ImPlotRange range=ImPlotRange(), const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ def plot_histogram( label_id: str, values: np.ndarray, bins: int = Bin_Sturges, bar_scale: float = 1.0, range: Optional[Range] = None, spec: Optional[Spec] = None, ) -> float: """Plots a horizontal histogram. #bins can be a positive integer or an ImPlotBin_ method. If #range is left unspecified, the min/max of #values will be used as the range. Otherwise, outlier values outside of the range are not binned. The largest bin count or density is returned. Python bindings defaults: If any of the params below is None, then its default value below will be used: * range: Range() * spec: Spec() """ pass # IMPLOT_TMP double PlotHistogram2D(const char* label_id, const T* xs, const T* ys, int count, int x_bins=ImPlotBin_Sturges, int y_bins=ImPlotBin_Sturges, ImPlotRect range=ImPlotRect(), const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ def plot_histogram_2d( label_id: str, xs: np.ndarray, ys: np.ndarray, x_bins: int = Bin_Sturges, y_bins: int = Bin_Sturges, range: Optional[Rect] = None, spec: Optional[Spec] = None, ) -> float: """Plots two dimensional, bivariate histogram as a heatmap. #x_bins and #y_bins can be a positive integer or an ImPlotBin. If #range is left unspecified, the min/max of #xs an #ys will be used as the ranges. Otherwise, outlier values outside of range are not binned. The largest bin count or density is returned. Python bindings defaults: If any of the params below is None, then its default value below will be used: * range: Rect() * spec: Spec() """ pass # Plots digital data. Digital plots do not respond to y drag or zoom, and are always referenced to the bottom of the plot. # IMPLOT_TMP void PlotDigital(const char* label_id, const T* xs, const T* ys, int count, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ def plot_digital(label_id: str, xs: np.ndarray, ys: np.ndarray, spec: Optional[Spec] = None) -> None: """Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # #ifdef IMGUI_HAS_TEXTURES # # IMPLOT_API void PlotImage(const char* label_id, ImTextureRef tex_ref, const ImPlotPoint& bounds_min, const ImPlotPoint& bounds_max, const ImVec2& uv0 = ImVec2(0, 0), const ImVec2& uv1 = ImVec2(1, 1), const ImVec4& tint_col = ImVec4(1, 1, 1, 1), const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ def plot_image( label_id: str, tex_ref: ImTextureRef, bounds_min: Point, bounds_max: Point, uv0: Optional[ImVec2Like] = None, uv1: Optional[ImVec2Like] = None, tint_col: Optional[ImVec4Like] = None, spec: Optional[Spec] = None, ) -> None: """Plots an axis-aligned image. #bounds_min/bounds_max are in plot coordinates (y-up) and #uv0/uv1 are in texture coordinates (y-down). Python bindings defaults: If any of the params below is None, then its default value below will be used: * uv0: ImVec2(0, 0) * uv1: ImVec2(1, 1) * tint_col: ImVec4(1, 1, 1, 1) * spec: Spec() """ pass # #endif # # IMPLOT_API void PlotText(const char* text, double x, double y, const ImVec2& pix_offset=ImVec2(0,0), const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ def plot_text( text: str, x: float, y: float, pix_offset: Optional[ImVec2Like] = None, spec: Optional[Spec] = None ) -> None: """Plots a centered text label at point x,y with an optional pixel offset. Text color can be changed with ImPlot::PushStyleColor(ImPlotCol_InlayText, ...). Python bindings defaults: If any of the params below is None, then its default value below will be used: * pix_offset: ImVec2(0,0) * spec: Spec() """ pass # IMPLOT_API void PlotDummy(const char* label_id, const ImPlotSpec& spec=ImPlotSpec()); /* original C++ signature */ def plot_dummy(label_id: str, spec: Optional[Spec] = None) -> None: """Plots a dummy item (i.e. adds a legend entry colored by ImPlotCol_Line) Python bindings defaults: If spec is None, then its default value will be: Spec() """ pass # ----------------------------------------------------------------------------- # [SECTION] Plot Tools # ----------------------------------------------------------------------------- # The following can be used to render interactive elements and/or annotations. # Like the item plotting functions above, they apply to the current x and y # axes, which can be changed with `SetAxis/SetAxes`. These functions return True # when user interaction causes the provided coordinates to change. Additional # user interactions can be retrieved through the optional output parameters. # IMPLOT_API bool DragPoint(int id, double* x, double* y, const ImVec4& col, float size = 4, ImPlotDragToolFlags flags = 0, bool* out_clicked = nullptr, bool* out_hovered = nullptr, bool* out_held = nullptr); /* original C++ signature */ def drag_point( id_: int, x: float, y: float, col: ImVec4Like, size: float = 4, flags: DragToolFlags = 0, out_clicked: Optional[bool] = None, out_hovered: Optional[bool] = None, out_held: Optional[bool] = None, ) -> Tuple[bool, float, float, Optional[bool], Optional[bool], Optional[bool]]: """Shows a draggable point at x,y. #col defaults to ImGuiCol_Text.""" pass # IMPLOT_API bool DragLineX(int id, double* x, const ImVec4& col, float thickness = 1, ImPlotDragToolFlags flags = 0, bool* out_clicked = nullptr, bool* out_hovered = nullptr, bool* out_held = nullptr); /* original C++ signature */ def drag_line_x( id_: int, x: float, col: ImVec4Like, thickness: float = 1, flags: DragToolFlags = 0, out_clicked: Optional[bool] = None, out_hovered: Optional[bool] = None, out_held: Optional[bool] = None, ) -> Tuple[bool, float, Optional[bool], Optional[bool], Optional[bool]]: """Shows a draggable vertical guide line at an x-value. #col defaults to ImGuiCol_Text.""" pass # IMPLOT_API bool DragLineY(int id, double* y, const ImVec4& col, float thickness = 1, ImPlotDragToolFlags flags = 0, bool* out_clicked = nullptr, bool* out_hovered = nullptr, bool* out_held = nullptr); /* original C++ signature */ def drag_line_y( id_: int, y: float, col: ImVec4Like, thickness: float = 1, flags: DragToolFlags = 0, out_clicked: Optional[bool] = None, out_hovered: Optional[bool] = None, out_held: Optional[bool] = None, ) -> Tuple[bool, float, Optional[bool], Optional[bool], Optional[bool]]: """Shows a draggable horizontal guide line at a y-value. #col defaults to ImGuiCol_Text.""" pass # IMPLOT_API bool DragRect(int id, double* x1, double* y1, double* x2, double* y2, const ImVec4& col, ImPlotDragToolFlags flags = 0, bool* out_clicked = nullptr, bool* out_hovered = nullptr, bool* out_held = nullptr); /* original C++ signature */ def drag_rect( id_: int, x1: float, y1: float, x2: float, y2: float, col: ImVec4Like, flags: DragToolFlags = 0, out_clicked: Optional[bool] = None, out_hovered: Optional[bool] = None, out_held: Optional[bool] = None, ) -> Tuple[bool, float, float, float, float, Optional[bool], Optional[bool], Optional[bool]]: """Shows a draggable and resizeable rectangle.""" pass # Shows an annotation callout at a chosen point. Clamping keeps annotations in the plot area. Annotations are always rendered on top. # IMPLOT_API void Annotation(double x, double y, const ImVec4& col, const ImVec2& pix_offset, bool clamp, bool round = false); /* original C++ signature */ @overload def annotation(x: float, y: float, col: ImVec4Like, pix_offset: ImVec2Like, clamp: bool, round: bool = False) -> None: pass # IMPLOT_API void Annotation(double x, double y, const ImVec4& col, const ImVec2& pix_offset, bool clamp, const char* fmt, ...) ; /* original C++ signature */ @overload def annotation(x: float, y: float, col: ImVec4Like, pix_offset: ImVec2Like, clamp: bool, fmt: str) -> None: pass # Shows a x-axis tag at the specified coordinate value. # IMPLOT_API void TagX(double x, const ImVec4& col, bool round = false); /* original C++ signature */ @overload def tag_x(x: float, col: ImVec4Like, round: bool = False) -> None: pass # IMPLOT_API void TagX(double x, const ImVec4& col, const char* fmt, ...) ; /* original C++ signature */ @overload def tag_x(x: float, col: ImVec4Like, fmt: str) -> None: pass # Shows a y-axis tag at the specified coordinate value. # IMPLOT_API void TagY(double y, const ImVec4& col, bool round = false); /* original C++ signature */ @overload def tag_y(y: float, col: ImVec4Like, round: bool = False) -> None: pass # IMPLOT_API void TagY(double y, const ImVec4& col, const char* fmt, ...) ; /* original C++ signature */ @overload def tag_y(y: float, col: ImVec4Like, fmt: str) -> None: pass # ----------------------------------------------------------------------------- # [SECTION] Plot Utils # ----------------------------------------------------------------------------- # Select which axis/axes will be used for subsequent plot elements. # IMPLOT_API void SetAxis(ImAxis axis); /* original C++ signature */ def set_axis(axis: ImAxis) -> None: pass # IMPLOT_API void SetAxes(ImAxis x_axis, ImAxis y_axis); /* original C++ signature */ def set_axes(x_axis: ImAxis, y_axis: ImAxis) -> None: pass # Convert pixels to a position in the current plot's coordinate system. Passing IMPLOT_AUTO uses the current axes. # IMPLOT_API ImPlotPoint PixelsToPlot(const ImVec2& pix, ImAxis x_axis = IMPLOT_AUTO, ImAxis y_axis = IMPLOT_AUTO); /* original C++ signature */ @overload def pixels_to_plot(pix: ImVec2Like, x_axis: Optional[ImAxis] = None, y_axis: Optional[ImAxis] = None) -> Point: """Python bindings defaults: If any of the params below is None, then its default value below will be used: * x_axis: IMPLOT_AUTO * y_axis: IMPLOT_AUTO """ pass # IMPLOT_API ImPlotPoint PixelsToPlot(float x, float y, ImAxis x_axis = IMPLOT_AUTO, ImAxis y_axis = IMPLOT_AUTO); /* original C++ signature */ @overload def pixels_to_plot(x: float, y: float, x_axis: Optional[ImAxis] = None, y_axis: Optional[ImAxis] = None) -> Point: """Python bindings defaults: If any of the params below is None, then its default value below will be used: * x_axis: IMPLOT_AUTO * y_axis: IMPLOT_AUTO """ pass # Convert a position in the current plot's coordinate system to pixels. Passing IMPLOT_AUTO uses the current axes. # IMPLOT_API ImVec2 PlotToPixels(const ImPlotPoint& plt, ImAxis x_axis = IMPLOT_AUTO, ImAxis y_axis = IMPLOT_AUTO); /* original C++ signature */ @overload def plot_to_pixels(plt: Point, x_axis: Optional[ImAxis] = None, y_axis: Optional[ImAxis] = None) -> ImVec2: """Python bindings defaults: If any of the params below is None, then its default value below will be used: * x_axis: IMPLOT_AUTO * y_axis: IMPLOT_AUTO """ pass # IMPLOT_API ImVec2 PlotToPixels(double x, double y, ImAxis x_axis = IMPLOT_AUTO, ImAxis y_axis = IMPLOT_AUTO); /* original C++ signature */ @overload def plot_to_pixels(x: float, y: float, x_axis: Optional[ImAxis] = None, y_axis: Optional[ImAxis] = None) -> ImVec2: """Python bindings defaults: If any of the params below is None, then its default value below will be used: * x_axis: IMPLOT_AUTO * y_axis: IMPLOT_AUTO """ pass # IMPLOT_API ImVec2 GetPlotPos(); /* original C++ signature */ def get_plot_pos() -> ImVec2: """Get the current Plot position (top-left) in pixels.""" pass # IMPLOT_API ImVec2 GetPlotSize(); /* original C++ signature */ def get_plot_size() -> ImVec2: """Get the current Plot size in pixels.""" pass # IMPLOT_API ImPlotPoint GetPlotMousePos(ImAxis x_axis = IMPLOT_AUTO, ImAxis y_axis = IMPLOT_AUTO); /* original C++ signature */ def get_plot_mouse_pos(x_axis: Optional[ImAxis] = None, y_axis: Optional[ImAxis] = None) -> Point: """Returns the mouse position in x,y coordinates of the current plot. Passing IMPLOT_AUTO uses the current axes. Python bindings defaults: If any of the params below is None, then its default value below will be used: * x_axis: IMPLOT_AUTO * y_axis: IMPLOT_AUTO """ pass # IMPLOT_API ImPlotRect GetPlotLimits(ImAxis x_axis = IMPLOT_AUTO, ImAxis y_axis = IMPLOT_AUTO); /* original C++ signature */ def get_plot_limits(x_axis: Optional[ImAxis] = None, y_axis: Optional[ImAxis] = None) -> Rect: """Returns the current plot axis range. Python bindings defaults: If any of the params below is None, then its default value below will be used: * x_axis: IMPLOT_AUTO * y_axis: IMPLOT_AUTO """ pass # IMPLOT_API bool IsPlotHovered(); /* original C++ signature */ def is_plot_hovered() -> bool: """Returns True if the plot area in the current plot is hovered.""" pass # IMPLOT_API bool IsAxisHovered(ImAxis axis); /* original C++ signature */ def is_axis_hovered(axis: ImAxis) -> bool: """Returns True if the axis label area in the current plot is hovered.""" pass # IMPLOT_API bool IsSubplotsHovered(); /* original C++ signature */ def is_subplots_hovered() -> bool: """Returns True if the bounding frame of a subplot is hovered.""" pass # IMPLOT_API bool IsPlotSelected(); /* original C++ signature */ def is_plot_selected() -> bool: """Returns True if the current plot is being box selected.""" pass # IMPLOT_API ImPlotRect GetPlotSelection(ImAxis x_axis = IMPLOT_AUTO, ImAxis y_axis = IMPLOT_AUTO); /* original C++ signature */ def get_plot_selection(x_axis: Optional[ImAxis] = None, y_axis: Optional[ImAxis] = None) -> Rect: """Returns the current plot box selection bounds. Passing IMPLOT_AUTO uses the current axes. Python bindings defaults: If any of the params below is None, then its default value below will be used: * x_axis: IMPLOT_AUTO * y_axis: IMPLOT_AUTO """ pass # IMPLOT_API void CancelPlotSelection(); /* original C++ signature */ def cancel_plot_selection() -> None: """Cancels a the current plot box selection.""" pass # IMPLOT_API void HideNextItem(bool hidden = true, ImPlotCond cond = ImPlotCond_Once); /* original C++ signature */ def hide_next_item(hidden: bool = True, cond: Optional[Cond] = None) -> None: """Hides or shows the next plot item (i.e. as if it were toggled from the legend). Use ImPlotCond_Always if you need to forcefully set this every frame. Python bindings defaults: If cond is None, then its default value will be: Cond_Once """ pass # Use the following around calls to Begin/EndPlot to align l/r/t/b padding. # Consider using Begin/EndSubplots first. They are more feature rich and # accomplish the same behaviour by default. The functions below offer lower # level control of plot alignment. # IMPLOT_API bool BeginAlignedPlots(const char* group_id, bool vertical = true); /* original C++ signature */ def begin_aligned_plots(group_id: str, vertical: bool = True) -> bool: """Align axis padding over multiple plots in a single row or column. #group_id must be unique. If this function returns True, EndAlignedPlots() must be called. """ pass # IMPLOT_API void EndAlignedPlots(); /* original C++ signature */ def end_aligned_plots() -> None: """Only call EndAlignedPlots() if BeginAlignedPlots() returns True!""" pass # ----------------------------------------------------------------------------- # [SECTION] Legend Utils # ----------------------------------------------------------------------------- # IMPLOT_API bool BeginLegendPopup(const char* label_id, ImGuiMouseButton mouse_button=1); /* original C++ signature */ def begin_legend_popup(label_id: str, mouse_button: MouseButton = 1) -> bool: """Begin a popup for a legend entry.""" pass # IMPLOT_API void EndLegendPopup(); /* original C++ signature */ def end_legend_popup() -> None: """End a popup for a legend entry.""" pass # IMPLOT_API bool IsLegendEntryHovered(const char* label_id); /* original C++ signature */ def is_legend_entry_hovered(label_id: str) -> bool: """Returns True if a plot item legend entry is hovered.""" pass # ----------------------------------------------------------------------------- # [SECTION] Drag and Drop # ----------------------------------------------------------------------------- # IMPLOT_API bool BeginDragDropTargetPlot(); /* original C++ signature */ def begin_drag_drop_target_plot() -> bool: """Turns the current plot's plotting area into a drag and drop target. Don't forget to call EndDragDropTarget!""" pass # IMPLOT_API bool BeginDragDropTargetAxis(ImAxis axis); /* original C++ signature */ def begin_drag_drop_target_axis(axis: ImAxis) -> bool: """Turns the current plot's X-axis into a drag and drop target. Don't forget to call EndDragDropTarget!""" pass # IMPLOT_API bool BeginDragDropTargetLegend(); /* original C++ signature */ def begin_drag_drop_target_legend() -> bool: """Turns the current plot's legend into a drag and drop target. Don't forget to call EndDragDropTarget!""" pass # IMPLOT_API void EndDragDropTarget(); /* original C++ signature */ def end_drag_drop_target() -> None: """Ends a drag and drop target (currently just an alias for ImGui::EndDragDropTarget).""" pass # NB: By default, plot and axes drag and drop *sources* require holding the Ctrl modifier to initiate the drag. # You can change the modifier if desired. If ImGuiMod_None is provided, the axes will be locked from panning. # IMPLOT_API bool BeginDragDropSourcePlot(ImGuiDragDropFlags flags=0); /* original C++ signature */ def begin_drag_drop_source_plot(flags: DragDropFlags = 0) -> bool: """Turns the current plot's plotting area into a drag and drop source. You must hold Ctrl. Don't forget to call EndDragDropSource!""" pass # IMPLOT_API bool BeginDragDropSourceAxis(ImAxis axis, ImGuiDragDropFlags flags=0); /* original C++ signature */ def begin_drag_drop_source_axis(axis: ImAxis, flags: DragDropFlags = 0) -> bool: """Turns the current plot's X-axis into a drag and drop source. You must hold Ctrl. Don't forget to call EndDragDropSource!""" pass # IMPLOT_API bool BeginDragDropSourceItem(const char* label_id, ImGuiDragDropFlags flags=0); /* original C++ signature */ def begin_drag_drop_source_item(label_id: str, flags: DragDropFlags = 0) -> bool: """Turns an item in the current plot's legend into drag and drop source. Don't forget to call EndDragDropSource!""" pass # IMPLOT_API void EndDragDropSource(); /* original C++ signature */ def end_drag_drop_source() -> None: """Ends a drag and drop source (currently just an alias for ImGui::EndDragDropSource).""" pass # ----------------------------------------------------------------------------- # [SECTION] Styling # ----------------------------------------------------------------------------- # Styling colors in ImPlot works similarly to styling colors in ImGui, but # with one important difference. Like ImGui, all style colors are stored in an # indexable array in ImPlotStyle. You can permanently modify these values through # GetStyle().Colors, or temporarily modify them with Push/Pop functions below. # However, by default all style colors in ImPlot default to a special color # IMPLOT_AUTO_COL. IMPLOT_AUTO_COL tells ImPlot to set that color from color data # in your **ImGuiStyle**. The ImGuiCol_ that these style colors default to are # detailed above, and in general have been mapped to produce plots visually # consistent with your current ImGui style. Of course, you are free to # manually set these colors to whatever you like, and further can Push/Pop # them around individual plots for plot-specific styling (e.g. coloring axes). # Provides access to plot style structure for permanent modifications to colors, sizes, etc. # IMPLOT_API ImPlotStyle& GetStyle(); /* original C++ signature */ def get_style() -> Style: pass # IMPLOT_API void SetStyle(const ImPlotStyle& style); /* original C++ signature */ def set_style(style: Style) -> None: pass # IMPLOT_API void StyleColorsAuto(ImPlotStyle* dst = nullptr); /* original C++ signature */ def style_colors_auto(dst: Optional[Style] = None) -> None: """Style plot colors for current ImGui style (default).""" pass # IMPLOT_API void StyleColorsClassic(ImPlotStyle* dst = nullptr); /* original C++ signature */ def style_colors_classic(dst: Optional[Style] = None) -> None: """Style plot colors for ImGui "Classic".""" pass # IMPLOT_API void StyleColorsDark(ImPlotStyle* dst = nullptr); /* original C++ signature */ def style_colors_dark(dst: Optional[Style] = None) -> None: """Style plot colors for ImGui "Dark".""" pass # IMPLOT_API void StyleColorsLight(ImPlotStyle* dst = nullptr); /* original C++ signature */ def style_colors_light(dst: Optional[Style] = None) -> None: """Style plot colors for ImGui "Light".""" pass # Use PushStyleX to temporarily modify your ImPlotStyle. The modification # will last until the matching call to PopStyleX. You MUST call a pop for # every push, otherwise you will leak memory! This behaves just like ImGui. # Temporarily modify a style color. Don't forget to call PopStyleColor! # IMPLOT_API void PushStyleColor(ImPlotCol idx, ImU32 col); /* original C++ signature */ @overload def push_style_color(idx: Col, col: ImU32) -> None: pass # IMPLOT_API void PushStyleColor(ImPlotCol idx, const ImVec4& col); /* original C++ signature */ @overload def push_style_color(idx: Col, col: ImVec4Like) -> None: pass # IMPLOT_API void PopStyleColor(int count = 1); /* original C++ signature */ def pop_style_color(count: int = 1) -> None: """Undo temporary style color modification(s). Undo multiple pushes at once by increasing count.""" pass # IMPLOT_API void PushStyleVar(ImPlotStyleVar idx, int val); /* original C++ signature */ @overload def push_style_var(idx: StyleVar, val: int) -> None: """Temporarily modify a style variable of int type. Don't forget to call PopStyleVar!""" pass # IMPLOT_API void PushStyleVar(ImPlotStyleVar idx, float val); /* original C++ signature */ @overload def push_style_var(idx: StyleVar, val: float) -> None: """Temporarily modify a style variable of float type. Don't forget to call PopStyleVar!""" pass # IMPLOT_API void PushStyleVar(ImPlotStyleVar idx, const ImVec2& val); /* original C++ signature */ @overload def push_style_var(idx: StyleVar, val: ImVec2Like) -> None: """Temporarily modify a style variable of ImVec2 type. Don't forget to call PopStyleVar!""" pass # IMPLOT_API void PopStyleVar(int count = 1); /* original C++ signature */ def pop_style_var(count: int = 1) -> None: """Undo temporary style variable modification(s). Undo multiple pushes at once by increasing count.""" pass # IMPLOT_API ImVec4 GetLastItemColor(); /* original C++ signature */ def get_last_item_color() -> ImVec4: """Gets the last item primary color (i.e. its legend icon color)""" pass # IMPLOT_API const char* GetStyleColorName(ImPlotCol idx); /* original C++ signature */ def get_style_color_name(idx: Col) -> str: """Returns the null terminated string name for an ImPlotCol.""" pass # IMPLOT_API const char* GetMarkerName(ImPlotMarker idx); /* original C++ signature */ def get_marker_name(idx: Marker) -> str: """Returns the null terminated string name for an ImPlotMarker.""" pass # IMPLOT_API ImPlotMarker NextMarker(); /* original C++ signature */ def next_marker() -> Marker: """Returns the next marker and advances the marker for the current plot. You need to call this between Begin/EndPlot!""" pass # ----------------------------------------------------------------------------- # [SECTION] Colormaps # ----------------------------------------------------------------------------- # Item styling is based on colormaps when the relevant ImPlotCol_XXX is set to # IMPLOT_AUTO_COL (default). Several built-in colormaps are available. You can # add and then push/pop your own colormaps as well. To permanently set a colormap, # modify the Colormap index member of your ImPlotStyle. # Colormap data will be ignored and a custom color will be used if you have done one of the following: # 1) Modified an item style color in your ImPlotStyle to anything other than IMPLOT_AUTO_COL. # 2) Pushed an item style color using PushStyleColor(). # 3) Set the next item style with a SetNextXXXStyle function. # Add a new colormap. The color data will be copied. The colormap can be used by pushing either the returned index or the # string name with PushColormap. The colormap name must be unique and the size must be greater than 1. You will receive # an assert otherwise! By default colormaps are considered to be qualitative (i.e. discrete). If you want to create a # continuous colormap, set #qual=False. This will treat the colors you provide as keys, and ImPlot will build a linearly # interpolated lookup table. The memory footprint of this table will be exactly ((size-1)*255+1)*4 bytes. # IMPLOT_API int GetColormapCount(); /* original C++ signature */ def get_colormap_count() -> int: """Returns the number of available colormaps (i.e. the built-in + user-added count).""" pass # IMPLOT_API const char* GetColormapName(ImPlotColormap cmap); /* original C++ signature */ def get_colormap_name(cmap: Colormap) -> str: """Returns a null terminated string name for a colormap given an index. Returns None if index is invalid.""" pass # IMPLOT_API ImPlotColormap GetColormapIndex(const char* name); /* original C++ signature */ def get_colormap_index(name: str) -> Colormap: """Returns an index number for a colormap given a valid string name. Returns -1 if name is invalid.""" pass # IMPLOT_API void PushColormap(ImPlotColormap cmap); /* original C++ signature */ @overload def push_colormap(cmap: Colormap) -> None: """Temporarily switch to one of the built-in (i.e. ImPlotColormap_XXX) or user-added colormaps (i.e. a return value of AddColormap). Don't forget to call PopColormap!""" pass # IMPLOT_API void PushColormap(const char* name); /* original C++ signature */ @overload def push_colormap(name: str) -> None: """Push a colormap by string name. Use built-in names such as "Default", "Deep", "Jet", etc. or a string you provided to AddColormap. Don't forget to call PopColormap!""" pass # IMPLOT_API void PopColormap(int count = 1); /* original C++ signature */ def pop_colormap(count: int = 1) -> None: """Undo temporary colormap modification(s). Undo multiple pushes at once by increasing count.""" pass # IMPLOT_API ImVec4 NextColormapColor(); /* original C++ signature */ def next_colormap_color() -> ImVec4: """Returns the next color from the current colormap and advances the colormap for the current plot. Can also be used with no return value to skip colors if desired. You need to call this between Begin/EndPlot! """ pass # Colormap utils. If cmap = IMPLOT_AUTO (default), the current colormap is assumed. # Pass an explicit colormap index (built-in or user-added) to specify otherwise. # IMPLOT_API int GetColormapSize(ImPlotColormap cmap = IMPLOT_AUTO); /* original C++ signature */ def get_colormap_size(cmap: Optional[Colormap] = None) -> int: """Returns the size of a colormap. Python bindings defaults: If cmap is None, then its default value will be: IMPLOT_AUTO """ pass # IMPLOT_API ImVec4 GetColormapColor(int idx, ImPlotColormap cmap = IMPLOT_AUTO); /* original C++ signature */ def get_colormap_color(idx: int, cmap: Optional[Colormap] = None) -> ImVec4: """Returns a color from a colormap given an index >= 0 (modulo will be performed). Python bindings defaults: If cmap is None, then its default value will be: IMPLOT_AUTO """ pass # IMPLOT_API ImVec4 SampleColormap(float t, ImPlotColormap cmap = IMPLOT_AUTO); /* original C++ signature */ def sample_colormap(t: float, cmap: Optional[Colormap] = None) -> ImVec4: """Sample a color from the current colormap given t between 0 and 1. Python bindings defaults: If cmap is None, then its default value will be: IMPLOT_AUTO """ pass # IMPLOT_API void ColormapScale(const char* label, double scale_min, double scale_max, const ImVec2& size = ImVec2(0,0), const char* format = "%g", ImPlotColormapScaleFlags flags = 0, ImPlotColormap cmap = IMPLOT_AUTO); /* original C++ signature */ def colormap_scale( label: str, scale_min: float, scale_max: float, size: Optional[ImVec2Like] = None, format: str = "%g", flags: ColormapScaleFlags = 0, cmap: Optional[Colormap] = None, ) -> None: """Shows a vertical color scale with linear spaced ticks using the specified color map. Use double hashes to hide label (e.g. "##NoLabel"). If scale_min > scale_max, the scale to color mapping will be reversed. Python bindings defaults: If any of the params below is None, then its default value below will be used: * size: ImVec2(0,0) * cmap: IMPLOT_AUTO """ pass # IMPLOT_API bool ColormapSlider(const char* label, float* t, ImVec4* out = nullptr, const char* format = "", ImPlotColormap cmap = IMPLOT_AUTO); /* original C++ signature */ def colormap_slider( label: str, t: float, out: Optional[ImVec4Like] = None, format: str = "", cmap: Optional[Colormap] = None ) -> Tuple[bool, float]: """Shows a horizontal slider with a colormap gradient background. Optionally returns the color sampled at t in [0 1]. Python bindings defaults: If cmap is None, then its default value will be: IMPLOT_AUTO """ pass # IMPLOT_API bool ColormapButton(const char* label, const ImVec2& size = ImVec2(0,0), ImPlotColormap cmap = IMPLOT_AUTO); /* original C++ signature */ def colormap_button(label: str, size: Optional[ImVec2Like] = None, cmap: Optional[Colormap] = None) -> bool: """Shows a button with a colormap gradient background. Python bindings defaults: If any of the params below is None, then its default value below will be used: * size: ImVec2(0,0) * cmap: IMPLOT_AUTO """ pass # IMPLOT_API void BustColorCache(const char* plot_title_id = nullptr); /* original C++ signature */ def bust_color_cache(plot_title_id: Optional[str] = None) -> None: """When items in a plot sample their color from a colormap, the color is cached and does not change unless explicitly overridden. Therefore, if you change the colormap after the item has already been plotted, item colors will NOT update. If you need item colors to resample the new colormap, then use this function to bust the cached colors. If #plot_title_id is None, then every item in EVERY existing plot will be cache busted. Otherwise only the plot specified by #plot_title_id will be busted. For the latter, this function must be called in the same ImGui ID scope that the plot is in. You should rarely if ever need this function, but it is available for applications that require runtime colormap swaps (e.g. Heatmaps demo). """ pass # ----------------------------------------------------------------------------- # [SECTION] Input Mapping # ----------------------------------------------------------------------------- # IMPLOT_API ImPlotInputMap& GetInputMap(); /* original C++ signature */ def get_input_map() -> InputMap: """Provides access to input mapping structure for permanent modifications to controls for pan, select, etc.""" pass # IMPLOT_API void MapInputDefault(ImPlotInputMap* dst = nullptr); /* original C++ signature */ def map_input_default(dst: Optional[InputMap] = None) -> None: """Default input mapping: pan = LMB drag, box select = RMB drag, fit = LMB double click, context menu = RMB click, zoom = scroll.""" pass # IMPLOT_API void MapInputReverse(ImPlotInputMap* dst = nullptr); /* original C++ signature */ def map_input_reverse(dst: Optional[InputMap] = None) -> None: """Reverse input mapping: pan = RMB drag, box select = LMB drag, fit = LMB double click, context menu = RMB click, zoom = scroll.""" pass # ----------------------------------------------------------------------------- # [SECTION] Miscellaneous # ----------------------------------------------------------------------------- # Render icons similar to those that appear in legends (nifty for data lists). # IMPLOT_API void ItemIcon(const ImVec4& col); /* original C++ signature */ @overload def item_icon(col: ImVec4Like) -> None: pass # IMPLOT_API void ItemIcon(ImU32 col); /* original C++ signature */ @overload def item_icon(col: ImU32) -> None: pass # IMPLOT_API void ColormapIcon(ImPlotColormap cmap); /* original C++ signature */ def colormap_icon(cmap: Colormap) -> None: pass # IMPLOT_API ImDrawList* GetPlotDrawList(); /* original C++ signature */ def get_plot_draw_list() -> ImDrawList: """Get the plot draw list for custom rendering to the current plot area. Call between Begin/EndPlot.""" pass # IMPLOT_API void PushPlotClipRect(float expand=0); /* original C++ signature */ def push_plot_clip_rect(expand: float = 0) -> None: """Push clip rect for rendering to current plot area. The rect can be expanded or contracted by #expand pixels. Call between Begin/EndPlot.""" pass # IMPLOT_API void PopPlotClipRect(); /* original C++ signature */ def pop_plot_clip_rect() -> None: """Pop plot clip rect. Call between Begin/EndPlot.""" pass # IMPLOT_API bool ShowStyleSelector(const char* label); /* original C++ signature */ def show_style_selector(label: str) -> bool: """Shows ImPlot style selector dropdown menu.""" pass # IMPLOT_API bool ShowColormapSelector(const char* label); /* original C++ signature */ def show_colormap_selector(label: str) -> bool: """Shows ImPlot colormap selector dropdown menu.""" pass # IMPLOT_API bool ShowInputMapSelector(const char* label); /* original C++ signature */ def show_input_map_selector(label: str) -> bool: """Shows ImPlot input map selector dropdown menu.""" pass # IMPLOT_API void ShowStyleEditor(ImPlotStyle* ref = nullptr); /* original C++ signature */ def show_style_editor(ref: Optional[Style] = None) -> None: """Shows ImPlot style editor block (not a window).""" pass # IMPLOT_API void ShowUserGuide(); /* original C++ signature */ def show_user_guide() -> None: """Add basic help/info block for end users (not a window).""" pass # IMPLOT_API void ShowMetricsWindow(bool* p_popen = nullptr); /* original C++ signature */ def show_metrics_window(p_popen: Optional[bool] = None) -> Optional[bool]: """Shows ImPlot metrics/debug information window.""" pass # ----------------------------------------------------------------------------- # [SECTION] Demo # ----------------------------------------------------------------------------- # IMPLOT_API void ShowDemoWindow(bool* p_open = nullptr); /* original C++ signature */ def show_demo_window(p_open: Optional[bool] = None) -> Optional[bool]: """Shows the ImPlot demo window (add implot_demo.cpp to your sources!)""" pass # IMPLOT_API void ShowDemoWindow_MaybeDocked(bool create_window, bool* p_open = NULL, ImGuiWindowFlags initial_extra_flags = 0, ImVec2 window_pos = ImVec2(0, 0), ImVec2 window_size = ImVec2(0, 0)); /* original C++ signature */ def show_demo_window_maybe_docked( create_window: bool, p_open: Optional[bool] = None, initial_extra_flags: WindowFlags = 0, window_pos: Optional[ImVec2Like] = None, window_size: Optional[ImVec2Like] = None, ) -> Optional[bool]: """Bundle: ShowDemoWindow_MaybeDocked is ShowDemoWindow, but can be used without creating an ImGui window. Python bindings defaults: If any of the params below is None, then its default value below will be used: * window_pos: ImVec2(0, 0) * window_size: ImVec2(0, 0) """ pass # ----------------------------------------------------------------------------- # [SECTION] Obsolete API # ----------------------------------------------------------------------------- # The following functions will be removed! Keep your copy of implot up to date! # Occasionally set '#define IMPLOT_DISABLE_OBSOLETE_FUNCTIONS' to stay ahead. # If you absolutely must use these functions and do not want to receive compiler # warnings, set '#define IMPLOT_DISABLE_OBSOLETE_WARNINGS'. # #endif #################### #################### # # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! AUTOGENERATED CODE END !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ############################################################################### # MANUAL BINDINGS BELOW ############################################################################### # Add a new colormap. The color data will be copied. The colormap can be used by pushing either the returned index or the # string name with PushColormap. The colormap name must be unique and the size must be greater than 1. You will receive # an assert otherwise! By default, colormaps are considered to be qualitative (i.e. discrete). If you want to create a # continuous colormap, set #qual=False. This will treat the colors you provide as keys, and ImPlot will build a linearly # interpolated lookup table. The memory footprint of this table will be exactly ((size-1)*255+1)*4 bytes. # # Warning: # The colormap 'cols' must either be a 1D array of type uint32 (if using hexadecimal colors), # or a 2D (Nx4 ->RGBA) array of type float32 (if using float values between 0 and 1) def add_colormap(name: str, cols: np.ndarray, qual: bool = True) -> Colormap: pass # Sets an axis' ticks and optionally the labels for the next plot. To keep the default ticks, set #keep_default=true. # IMPLOT_API void SetupAxisTicks(ImAxis axis, double v_min, double v_max, int n_ticks, const char* const labels[]=nullptr, bool keep_default=false); @overload def setup_axis_ticks( axis: ImAxis, v_min: float, v_max: float, n_ticks: int, labels: List[str] | None = None, keep_default: bool = False, ) -> None: pass # Sets an axis' ticks and optionally the labels for the next plot. To keep the default ticks, set #keep_default=true. # IMPLOT_API void SetupAxisTicks(ImAxis axis, const double* values, int n_ticks, const char* const labels[]=nullptr, bool keep_default=false); @overload def setup_axis_ticks( axis: ImAxis, values: List[float], labels: List[str] | None = None, keep_default: bool = False, ) -> None: pass # Plots a 2D heatmap chart. Values are expected to be in row-major order by default. Leave #scale_min and scale_max both at 0 for automatic color scaling, or set them to a predefined range. #label_fmt can be set to NULL for no labels. # IMPLOT_TMP void PlotHeatmap(const char* label_id, const T* values, int rows, int cols, double scale_min=0, double scale_max=0, const char* label_fmt="%.1f", const ImPlotPoint& bounds_min=ImPlotPoint(0,0), const ImPlotPoint& bounds_max=ImPlotPoint(1,1), ImPlotHeatmapFlags flags=0); /* original C++ signature */ def plot_heatmap( label_id: str, values: np.ndarray, scale_min: float = 0.0, scale_max: float = 0.0, label_fmt: str = "%.1f", bounds_min: Point = Point(0, 0), bounds_max: Point = Point(1, 1), spec: Spec = Spec(), ) -> None: pass # ============================================================================ # OBSOLETED in v0.18 (from February 2026) # ============================================================================ # The following functions have been REMOVED. Use Spec objects instead: # # set_next_line_style(col, weight) # -> Use: spec=implot.Spec(line_color=col, line_weight=weight) # # set_next_fill_style(col, alpha_mod) # -> Use: spec=implot.Spec(fill_color=col, fill_alpha=alpha_mod) # # set_next_marker_style(marker, size, fill, weight, outline) # -> Use: spec=implot.Spec(marker=marker, marker_size=size, # marker_fill_color=fill, line_weight=weight, # marker_line_color=outline) # # set_next_error_bar_style(col, size, weight) # -> Use: spec=implot.Spec(line_color=col, size=size, line_weight=weight) # # Example migration: # # OLD (removed): # implot.set_next_line_style(ImVec4(1,0,0,1), 2.0) # implot.plot_line("data", xs, ys) # # # NEW: # implot.plot_line("data", xs, ys, # spec=implot.Spec(line_color=ImVec4(1,0,0,1), # line_weight=2.0)) # ============================================================================