Announcements and New Features (2020)

[epezent]

Announcements of changes and new features will be posted here. Click Subscribe to the right to receive updates!

PLEASE DO NOT COMMENT ... EMOJIS ARE WELCOME :)

[epezent]

Filled Plots (v0.3 - 6/1/2020)

ImPlot::PlotLines can now be filled by pushing a color for ImPlotCol_Fill. The plot will be filled to the x-axis zero, and zero-crossings are appropriately handled.

[epezent]

Support for double (v0.3 - 6/1/2020)

The public API has been extended to support double precision data. Internally, ImPlot is also now using double precision to handle axes and scaling, which improves stability during extreme zooming and panning. Users of the previous float API should be unaffected and can continue as they were.

[epezent]

Colormaps and Heatmaps (v0.3 - 6/2/2020)

ImPlot now provides several built-in colormaps (previously "palettes").

Heatmap Charts have been added. An optional utility function can be used to render a colormap scale. (Note the artifacting below is due to GIF compression. See the demo for a better representation.).

[epezent]

User Defined Ticks (v0.3 - 6/3/2020)

Users can now add custom ticks to any axis. The ticks can optionally be decorated with a custom string label. The default generated ticks will be hidden by default, but can be kept if desired.

[epezent]

16-bit Indices (v0.3 - 6/7/2020)

Issues related to data truncation and glitching when using 16-bit indices have been resolved by #41 and ocornut/imgui@f6120f8

Therefore it is important that you are using the latest version of ImGui to avoid glitching. 32-bit indices continue to work as before.

Moving forward, we recommend that users stick to 16-bit indices if possible. You may see a slight performance boost from this, and it is recommended by ImGui for compatibility's sake.

Special thanks to @sergeyn and @ocornut for their work on this.

[epezent]

Horizontal Error Bars (v0.3 - 6/8/2020)

@ChiefSeaBiscuit has added support for horizontal error bars.

[epezent]

PlotShaded (v0.4 - 6/14/2020)

• PlotShaded has been introduced. This allows regions between two lines or a line and a horizontal reference to be filled. Note that this replaces the previous Fill Plots implementation above Announcements and New Features (2020) #48 (comment)
• ImPlotStyleVar_FillAlpha was added so that the alpha of fills (e.g. shaded regions, bar fills, pie charts, marker fills) can be easily modified.
• Plot items with the same label_id will be grouped together in the legend, appearing as one item. This can be seen on the Filled Line Plots, Shaded Plots, and Error Bars demos.
• The flags ImPlotAxisFlag_Adaptive and ImPlotFlags_Cull were removed. Adaptive grid divisions were always the default, regardless of this flag, thus it is no longer needed. Culling is done by default where possible, as there's little reason not to.

[epezent]

ImPlotInputMap (v0.4 - 6/15/2020)

@JaapSuter has added support for input remapping. The current input mapping can be retrieved and modified with ImPlotInputMap& GetInputMap() where:

struct ImPlotInputMap {
    ImGuiMouseButton PanButton;             // LMB      enables panning when held
    ImGuiKeyModFlags PanMod;                // none     optional modifier that must be held for panning
    ImGuiMouseButton FitButton;             // LMB      fits visible data when double clicked
    ImGuiMouseButton ContextMenuButton;     // RMB      opens plot context menu (if enabled) when double clicked
    ImGuiMouseButton BoxSelectButton;       // RMB      begins box selection when pressed and confirms selection when released
    ImGuiKeyModFlags BoxSelectMod;          // none     optional modifier that must be held for box selection
    ImGuiMouseButton BoxSelectCancelButton; // LMB      cancels active box selection when pressed
    ImGuiMouseButton QueryButton;           // MMB      begins query selection when pressed and end query selection when released
    ImGuiKeyModFlags QueryMod;              // none     optional modifier that must be held for query selection
    ImGuiKeyModFlags QueryToggleMod;        // Ctrl     when held, active box selections turn into queries
    ImGuiKeyModFlags HorizontalMod;         // Alt      expands active box selection/query horizontally to plot edge when held
    ImGuiKeyModFlags VerticalMod;           // Shift    expands active box selection/query vertically to plot edge when held
    ImPlotInputMap();
};

This is somewhat experimental, and it may not enable all desired input approaches. If you find that you need more control/options, please submit an Issue or PR.

[epezent]

Invisible Legend Entries (v0.4 - 6/23/2020)

Plot items with labels entirely prefixed with ## will no longer display an entry in the legend. This can be used to plot data that you don't want displayed in the legend. The data will continue to respond to double-clicks for fitting.

ImPlot::PlotLine("MyData1",x,y);    // displays "MyData1" in legend
ImPlot::PlotLine("MyData##2",x,y);  // displays "MyData" in legend
ImPlot::PlotLine("##MyData3",x,y);  // no legend entry displayed

[epezent]

Axis Hovering (v0.4 - 7/26/2020)

Axes can now be checked to see if they are hovered with IsPlotXAxisHovered and IsPlotYAxisHovered. If a drag and drop payload is available, a drag and drop rect will be drawn around hovered y-axes. As a result, drag and drop to specific y-axes is now possible (see demo for example code):

On a similar note, IsLegendEntryHovered has been introduced.

Special thanks to @ozlb!