ImPlot (imgui-binding 1.86.6 API)

java.lang.Object
- imgui.extension.implot.ImPlot

public final class ImPlot
extends java.lang.Object

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`addColormap(java.lang.String name, ImVec4[] cols)` Add a new colormap.
`static void`	`annotate(double x, double y, ImVec2 pixOffset, ImVec4 color, java.lang.String... fmt)` Shows an annotation callout at a chosen point.
`static void`	`annotate(double x, double y, ImVec2 pixOffset, java.lang.String... fmt)` Shows an annotation callout at a chosen point.
`static void`	`annotateClamped(double x, double y, ImVec2 pixOffset, ImVec4 color, java.lang.String... fmt)` Shows an annotation callout at a chosen point, clamped inside the plot area.
`static void`	`annotateClamped(double x, double y, ImVec2 pixOffset, java.lang.String... fmt)` Shows an annotation callout at a chosen point, clamped inside the plot area.
`static boolean`	`beginDragDropSource(int keyMods, int dragDropFlags)` Turns the current plot's plotting area into a drag and drop source.
`static boolean`	`beginDragDropSourceItem(java.lang.String labelID, int dragDropFlags)` Turns an item in the current plot's legend into drag and drop source.
`static boolean`	`beginDragDropSourceX(int keyMods, int dragDropFlags)` Turns the current plot's X-axis into a drag and drop source.
`static boolean`	`beginDragDropSourceY(int yAxis, int keyMods, int dragDropFlags)` Turns the current plot's Y-axis into a drag and drop source.
`static boolean`	`beginDragDropTarget()` Turns the current plot's plotting area into a drag and drop target.
`static boolean`	`beginDragDropTargetLegend()` Turns the current plot's legend into a drag and drop target.
`static boolean`	`beginDragDropTargetX()` Turns the current plot's X-axis into a drag and drop target.
`static boolean`	`beginDragDropTargetY(int yAxis)` Turns the current plot's Y-Axis into a drag and drop target.
`static boolean`	`beginLegendPopup(java.lang.String labelID)` Begin a popup for a legend entry.
`static boolean`	`beginLegendPopup(java.lang.String labelID, int mouseButton)` Begin a popup for a legend entry.
`static boolean`	`beginPlot(java.lang.String titleID)` Starts a 2D plotting context.
`static boolean`	`beginPlot(java.lang.String titleID, java.lang.String xLabel, java.lang.String yLabel)` Starts a 2D plotting context.
`static boolean`	`beginPlot(java.lang.String titleID, java.lang.String xLabel, java.lang.String yLabel, ImVec2 size)` Starts a 2D plotting context.
`static boolean`	`beginPlot(java.lang.String titleID, java.lang.String xLabel, java.lang.String yLabel, ImVec2 size, int flags, int xFlags, int yFlags)` Starts a 2D plotting context.
`static boolean`	`beginPlot(java.lang.String titleID, java.lang.String xLabel, java.lang.String yLabel, ImVec2 size, int flags, int xFlags, int yFlags, int y2Flags, int y3Flags, java.lang.String y2Label, java.lang.String y3Label)` Starts a 2D plotting context.
`static void`	`bustColorCache()` When items in a plot sample their color from a colormap, the color is cached and does not change unless explicitly overriden.
`static void`	`bustColorCache(java.lang.String plotTableID)` When items in a plot sample their color from a colormap, the color is cached and does not change unless explicitly overriden.
`static boolean`	`colormapButton(java.lang.String label, int cmap)` Shows a button with a colormap gradient brackground.
`static void`	`colormapIcon(int colorMap)` Render icons similar to those that appear in legends (nifty for data lists).
`static void`	`colormapScale(java.lang.String label, double scaleMin, double scaleMax, int cmap)` Shows a vertical color scale with linear spaced ticks using the specified color map.
`static boolean`	`colormapSlider(java.lang.String label, float t, int cmap)` Shows a horizontal slider with a colormap gradient background.
`static ImPlotContext`	`createContext()` Creates a new ImPlot context.
`static void`	`destroyContext(ImPlotContext ctx)` Destroys an ImPlot context.
`static boolean`	`dragLineX(java.lang.String id, double xValue, boolean showLabel, ImVec4 color, float thickness)` Shows a draggable vertical guide line at an x-value.
`static boolean`	`dragLineY(java.lang.String id, double yValue, boolean showLabel, ImVec4 color, float thickness)` Shows a draggable horizontal guide line at a y-value.
`static boolean`	`dragPoint(java.lang.String id, double x, double y, boolean showLabel, ImVec4 color, float radius)` Shows a draggable point at x,y.
`static void`	`endDragDropSource()` Ends a drag and drop source.
`static void`	`endDragDropTarget()` Ends a drag and drop target.
`static void`	`endLegendPopup()` End a popup for a legend entry.
`static void`	`endPlot()` Only call EndPlot() if beginPlot() returns true! Typically called at the end of an if statement conditioned on BeginPlot().
`static void`	`fitNextPlotAxes()` This function MUST be called BEFORE beginPlot! Fits the next plot axes to all plotted data if they are unlocked (equivalent to double-clicks).
`static void`	`fitNextPlotAxes(boolean x, boolean y)` This function MUST be called BEFORE beginPlot! Fits the next plot axes to all plotted data if they are unlocked (equivalent to double-clicks).
`static void`	`fitNextPlotAxes(boolean x, boolean y, boolean y2, boolean y3)` This function MUST be called BEFORE beginPlot! Fits the next plot axes to all plotted data if they are unlocked (equivalent to double-clicks).
`static ImVec4`	`getColormapColor(int idx, int cmap)` Returns a color from a colormap given an index `>=` 0 (modulo will be performed).
`static int`	`getColormapCount()` Returns the number of available colormaps (i.e.
`static int`	`getColormapIndex(java.lang.String name)` Returns an index number for a colormap given a valid string name.
`static java.lang.String`	`getColormapName(int cmap)` Returns a string name for a colormap given an index.
`static int`	`getColormapSize(int cmap)` Returns the size of a colormap.
`static ImPlotContext`	`getCurrentContext()` Returns the current ImPlot context.
`static ImVec4`	`getLastItemColor()` Gets the last item primary color (i.e.
`static java.lang.String`	`getMarkerName(int idx)` Returns the null terminated string name for an ImPlotMarker.
`static ImDrawList`	`getPlotDrawList()` Get the plot draw list for custom rendering to the current plot area.
`static ImPlotLimits`	`getPlotLimits(int yAxis)` This function MUST be called BETWEEN begin/endPlot! The returned ImPlotLimits should be manually deallocated with destroy()! Returns the current plot axis range.
`static ImPlotPoint`	`getPlotMousePos(int yAxis)` This function MUST be called BETWEEN begin/endPlot! The returned ImPlotPoint should be manually deallocated with destroy()! Returns the mouse position in x,y coordinates of the current plot.
`static ImVec2`	`getPlotPos()` This function MUST be called BETWEEN begin/endPlot! Get the current Plot position (top-left) in pixels.
`static void`	`getPlotPos(ImVec2 vec)`
`static ImPlotLimits`	`getPlotQuery(int yAxis)` This function MUST be called BETWEEN begin/endPlot! The returned ImPlotLimits should be manually deallocated with destroy()! Returns the current plot query bounds.
`static ImPlotLimits`	`getPlotSelection(int yAxis)` This function MUST be called BETWEEN begin/endPlot! The returned ImPlotLimits should be manually deallocated with destroy()! Returns the current plot box selection bounds.
`static ImVec2`	`getPlotSize()` This function MUST be called BETWEEN begin/endPlot! Get the current Plot size in pixels.
`static void`	`getPlotSize(ImVec2 vec)` This function MUST be called BETWEEN begin/endPlot! Get the current Plot size in pixels.
`static ImPlotStyle`	`getStyle()` Provides access to plot style structure for permanant modifications to colors, sizes, etc.
`static java.lang.String`	`getStyleColorName(int idx)` Returns the string name for an ImPlotCol.
`static void`	`hideNextItem()` This function MUST be called BETWEEN begin/endPlot! Hides the next plot item.
`static void`	`hideNextItem(boolean hidden, int imguiCond)` This function MUST be called BETWEEN begin/endPlot! Hides the next plot item.
`static boolean`	`isLegendEntryHovered(java.lang.String labelID)` Returns true if a plot item legend entry is hovered.
`static boolean`	`isPlotHovered()` This function MUST be called BETWEEN begin/endPlot! Returns true if the plot area in the current plot is hovered.
`static boolean`	`isPlotQueried()` This function MUST be called BETWEEN begin/endPlot! Returns true if the current plot is being queried or has an active query.
`static boolean`	`isPlotSelected()` This function MUST be called BETWEEN begin/endPlot! Returns true if the current plot is being box selected.
`static boolean`	`isPlotXAxisHovered()` This function MUST be called BETWEEN begin/endPlot! Returns true if the XAxis plot area in the current plot is hovered.
`static boolean`	`isPlotYAxisHovered(int yAxis)` This function MUST be called BETWEEN begin/endPlot! Returns true if the YAxis[n] plot area in the current plot is hovered.
`static void`	`itemIcon(ImVec4 col)` Render icons similar to those that appear in legends (nifty for data lists).
`static void`	`linkNextPlotLimits(ImDouble xmin, ImDouble xmax, ImDouble ymin, ImDouble ymax)` This function MUST be called BEFORE beginPlot! Links the next plot limits to external values.
`static void`	`linkNextPlotLimits(ImDouble xmin, ImDouble xmax, ImDouble ymin, ImDouble ymax, ImDouble ymin2, ImDouble ymax2)` This function MUST be called BEFORE beginPlot! Links the next plot limits to external values.
`static void`	`linkNextPlotLimits(ImDouble xmin, ImDouble xmax, ImDouble ymin, ImDouble ymax, ImDouble ymin2, ImDouble ymax2, ImDouble ymin3, ImDouble ymax3)` This function MUST be called BEFORE beginPlot! Links the next plot limits to external values.
`static ImVec4`	`nextColormapColor()` Returns the next color from the current colormap and advances the colormap for the current plot.
`static ImPlotPoint`	`pixelsToPlot(float x, float y, int yAxis)` This function MUST be called BETWEEN begin/endPlot! The returned ImPlotPoint should be manually deallocated with destroy()! Convert pixels to a position in the current plot's coordinate system.
`static ImPlotPoint`	`pixelsToPlot(ImVec2 pix, int yAxis)` This function MUST be called BETWEEN begin/endPlot! Convert pixels to a position in the current plot's coordinate system.
`static void`	`plotBars(java.lang.String labelID, double[] xs, double[] ys, int size, float width, int offset)` Plots a vertical bar graph.
`static <T extends java.lang.Number> void`	`plotBars(java.lang.String labelID, T[] xs, T[] ys)` Plots a vertical bar graph.
`static <T extends java.lang.Number> void`	`plotBars(java.lang.String labelID, T[] xs, T[] ys, float width)` Plots a vertical bar graph.
`static <T extends java.lang.Number> void`	`plotBars(java.lang.String labelID, T[] xs, T[] ys, float width, int offset)` Plots a vertical bar graph.
`static void`	`plotBarsH(java.lang.String labelID, double[] xs, double[] ys, int size, float height, int offset)` Plots a horizontal bar graph.
`static <T extends java.lang.Number> void`	`plotBarsH(java.lang.String labelID, T[] xs, T[] ys)` Plots a horizontal bar graph.
`static <T extends java.lang.Number> void`	`plotBarsH(java.lang.String labelID, T[] xs, T[] ys, float height)` Plots a horizontal bar graph.
`static <T extends java.lang.Number> void`	`plotBarsH(java.lang.String labelID, T[] xs, T[] ys, float height, int offset)` Plots a horizontal bar graph.
`static void`	`plotDigital(java.lang.String labelID, double[] xs, double[] ys, int size)` Plots digital data.
`static <T extends java.lang.Number> void`	`plotDigital(java.lang.String labelID, T[] xs, T[] ys)` Plots digital data.
`static void`	`plotDummy(java.lang.String labelID)` Plots a dummy item (i.e.
`static void`	`plotErrorBars(java.lang.String labelID, double[] xs, double[] ys, double[] err, int size, int offset)` Plots vertical error bar.
`static <T extends java.lang.Number> void`	`plotErrorBars(java.lang.String labelID, T[] xs, T[] ys, T[] err)` Plots vertical error bar.
`static <T extends java.lang.Number> void`	`plotErrorBars(java.lang.String labelID, T[] xs, T[] ys, T[] err, int offset)` Plots vertical error bar.
`static void`	`plotErrorBarsH(java.lang.String labelID, double[] xs, double[] ys, double[] err, int size, int offset)` Plots horizontal error bar.
`static <T extends java.lang.Number> void`	`plotErrorBarsH(java.lang.String labelID, T[] xs, T[] ys, T[] err)` Plots horizontal error bar.
`static <T extends java.lang.Number> void`	`plotErrorBarsH(java.lang.String labelID, T[] xs, T[] ys, T[] err, int offset)` Plots horizontal error bar.
`static void`	`plotHeatmap(java.lang.String labelID, double[] values, int rows, int cols)` Plots a 2D heatmap chart.
`static <T extends java.lang.Number> void`	`plotHeatmap(java.lang.String labelID, T[][] values, int offset)` Plots a 2D heatmap chart.
`static double`	`plotHistogram(java.lang.String labelID, double[] values, int size)` Plots a horizontal histogram.
`static <T extends java.lang.Number> double`	`plotHistogram(java.lang.String labelID, T[] values)` Plots a horizontal histogram Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!
`static double`	`plotHistogram2D(java.lang.String labelID, double[] xs, double[] ys, int size)` Plots two dimensional, bivariate histogram as a heatmap.
`static <T extends java.lang.Number> double`	`plotHistogram2D(java.lang.String labelID, T[] xs, T[] ys)` Plots two dimensional, bivariate histogram as a heatmap Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!
`static void`	`plotHLines(java.lang.String labelID, double[] values, int size, int offset)` Plots infinite horizontal lines (e.g.
`static <T extends java.lang.Number> void`	`plotHLines(java.lang.String labelID, T[] values)` Plots infinite horizontal lines (e.g.
`static <T extends java.lang.Number> void`	`plotHLines(java.lang.String labelID, T[] values, int offset)` Plots infinite horizontal lines (e.g.
`static void`	`plotLine(java.lang.String labelID, double[] xs, double[] ys, int size, int offset)` Plots a standard 2D line plot.
`static <T extends java.lang.Number> void`	`plotLine(java.lang.String labelID, T[] xs, T[] ys)` Plots a standard 2D line plot.
`static <T extends java.lang.Number> void`	`plotLine(java.lang.String labelID, T[] xs, T[] ys, int offset)` Plots a standard 2D line plot.
`static <T extends java.lang.Number> void`	`plotPieChart(java.lang.String[] labelIDs, T[] values, double x, double y, double radius)` Plots a pie chart.
`static void`	`plotPieChart(java.lang.String labelIDsSs, int strLen, double[] values, int size, double x, double y, double radius)` Plots a pie chart.
`static void`	`plotScatter(java.lang.String labelID, double[] xs, double[] ys, int size, int offset)`
`static <T extends java.lang.Number> void`	`plotScatter(java.lang.String labelID, T[] xs, T[] ys)` Plots a standard 2D scatter plot.
`static <T extends java.lang.Number> void`	`plotScatter(java.lang.String labelID, T[] xs, T[] ys, int offset)` Plots a standard 2D scatter plot.
`static void`	`plotShaded(java.lang.String labelID, double[] xs, double[] ys1, double[] ys2, int size, int offset)` Plots a shaded (filled) region between two lines, or a line and a horizontal reference.
`static void`	`plotShaded(java.lang.String labelID, double[] xs, double[] ys, int size, int yRef, int offset)` Plots a shaded (filled) region between two lines, or a line and a horizontal reference.
`static <T extends java.lang.Number> void`	`plotShaded(java.lang.String labelID, T[] xs, T[] ys, int yRef)` Plots a shaded (filled) region between two lines, or a line and a horizontal reference.
`static <T extends java.lang.Number> void`	`plotShaded(java.lang.String labelID, T[] xs, T[] ys, int yRef, int offset)` Plots a shaded (filled) region between two lines, or a line and a horizontal reference.
`static <T extends java.lang.Number> void`	`plotShaded(java.lang.String labelID, T[] xs, T[] ys1, T[] ys2)` Plots a shaded (filled) region between two lines, or a line and a horizontal reference.
`static <T extends java.lang.Number> void`	`plotShaded(java.lang.String labelID, T[] xs, T[] ys1, T[] ys2, int offset)` Plots a shaded (filled) region between two lines, or a line and a horizontal reference.
`static void`	`plotStairs(java.lang.String labelID, double[] xs, double[] ys, int size, int offset)` Plots a a stairstep graph.
`static <T extends java.lang.Number> void`	`plotStairs(java.lang.String labelID, T[] xs, T[] ys)` Plots a a stairstep graph.
`static <T extends java.lang.Number> void`	`plotStairs(java.lang.String labelID, T[] xs, T[] ys, int offset)` Plots a a stairstep graph.
`static void`	`plotStems(java.lang.String labelID, double[] values, int size, int yRef, int offset)` Plots vertical stems.
`static <T extends java.lang.Number> void`	`plotStems(java.lang.String labelID, T[] values, int yRef)` Plots vertical stems.
`static <T extends java.lang.Number> void`	`plotStems(java.lang.String labelID, T[] values, int yRef, int offset)` Plots vertical stems.
`static void`	`plotText(java.lang.String text, double x, double y)` Plots a centered text label at point x,y
`static void`	`plotText(java.lang.String text, double x, double y, boolean vertical)` Plots a centered text label at point x,y
`static ImVec2`	`plotToPixels(double x, double y, int yAxis)` This function MUST be called BETWEEN begin/endPlot! Convert a position in the current plot's coordinate system to pixels.
`static ImVec2`	`plotToPixels(ImPlotPoint plt, int yAxis)` This function MUST be called BETWEEN begin/endPlot! Convert a position in the current plot's coordinate system to pixels.
`static void`	`plotVLines(java.lang.String labelID, double[] values, int size, int offset)` Plots infinite vertical lines (e.g.
`static <T extends java.lang.Number> void`	`plotVLines(java.lang.String labelID, T[] values)` Plots infinite vertical lines (e.g.
`static <T extends java.lang.Number> void`	`plotVLines(java.lang.String labelID, T[] values, int offset)` Plots infinite vertical lines (e.g.
`static void`	`popColormap()` Undo temporary colormap modification(s).
`static void`	`popColormap(int count)` Undo temporary colormap modification(s).
`static void`	`popPlotClipRect()` Pop plot clip rect.
`static void`	`popStyleColor()`
`static void`	`popStyleColor(int count)`
`static void`	`popStyleVar()` Undo temporary style variable modification(s).
`static void`	`popStyleVar(int count)` Undo temporary style variable modification(s).
`static void`	`pushColormap(int cmap)` Temporarily switch to one of the built-in (i.e.
`static void`	`pushColormap(java.lang.String name)` Push a colormap by string name.
`static void`	`pushPlotClipRect(float expand)` Push clip rect for rendering to current plot area.
`static void`	`pushStyleColor(int idx, ImVec4 col)` Temporarily modify a style color.
`static void`	`pushStyleColor(int idx, long col)` Temporarily modify a style color.
`static void`	`pushStyleVar(int idx, float val)` Temporarily modify a style variable of float type.
`static void`	`pushStyleVar(int idx, ImVec2 val)` Temporarily modify a style variable of ImVec2 type.
`static void`	`pushStyleVar(int idx, int val)` Temporarily modify a style variable of int type.
`static ImVec4`	`sampleColormap(float t, int cmap)` Sample a color from a colormap given t between 0 and 1
`static void`	`setCurrentContext(ImPlotContext ctx)` Sets the current ImPlot context.
`static void`	`setLegendLocation(int location, int orientation, boolean outside)` Set the location of the current plot's legend
`static void`	`setMousePosLocation(int location)` Set the location of the current plot's mouse position text
`static void`	`setNextPlotFormatX(java.lang.String fmt)` This function MUST be called BEFORE beginPlot! Set the format for numeric X axis labels (default="%g").
`static void`	`setNextPlotFormatY(java.lang.String fmt)` This function MUST be called BEFORE beginPlot! Set the format for numeric Y axis labels (default="%g").
`static void`	`setNextPlotFormatY(java.lang.String fmt, int yAxis)` This function MUST be called BEFORE beginPlot! Set the format for numeric Y axis labels (default="%g").
`static void`	`setNextPlotLimits(double xmin, double xmax, double ymin, double ymax, int imguicond)` This function MUST be called BEFORE beginPlot! Set the axes range limits of the next plot.
`static void`	`setNextPlotLimitsX(double xmin, double xmax, int imguicond)` This function MUST be called BEFORE beginPlot! Set the X axis range limits of the next plot.
`static void`	`setNextPlotLimitsY(double ymin, double ymax, int imguicond)` This function MUST be called BEFORE beginPlot! Set the Y axis range limits of the next plot.
`static void`	`setNextPlotTicksX(double xMin, double xMax, int nTicks)` This function MUST be called BEFORE beginPlot! Set the X axis ticks and optionally the labels for the next plot.
`static void`	`setNextPlotTicksX(double xMin, double xMax, int nTicks, java.lang.String[] labels, boolean keepDefault)` This function MUST be called BEFORE beginPlot! Set the X axis ticks and optionally the labels for the next plot.
`static void`	`setNextPlotTicksX(double xMin, double xMax, int nTicks, java.lang.String s1, java.lang.String s2, java.lang.String s3, java.lang.String s4, boolean keepDefault)` This function MUST be called BEFORE beginPlot! Set the X axis ticks and optionally the labels for the next plot.
`static void`	`setNextPlotTicksY(double xMin, double xMax, int nTicks)` This function MUST be called BEFORE beginPlot! Set the Y axis ticks and optionally the labels for the next plot.
`static void`	`setNextPlotTicksY(double xMin, double xMax, int nTicks, java.lang.String[] labels, boolean keepDefault)` This function MUST be called BEFORE beginPlot! Set the Y axis ticks and optionally the labels for the next plot.
`static void`	`setNextPlotTicksY(double xMin, double xMax, int nTicks, java.lang.String[] labels, boolean keepDefault, int yAxis)` This function MUST be called BEFORE beginPlot! Set the Y axis ticks and optionally the labels for the next plot.
`static void`	`setNextPlotTicksY(double xMin, double xMax, int nTicks, java.lang.String s1, java.lang.String s2, java.lang.String s3, java.lang.String s4, boolean keepDefault, int yAxis)` This function MUST be called BEFORE beginPlot! Set the Y axis ticks and optionally the labels for the next plot.
`static void`	`setPlotQuery(ImPlotLimits query, int yAxis)` This function MUST be called BETWEEN begin/endPlot! Set the current plot query bounds.
`static void`	`setPlotYAxis(int yAxis)` This function MUST be called BETWEEN begin/endPlot! Select which Y axis will be used for subsequent plot elements.
`static boolean`	`showColormapSelector(java.lang.String label)` Shows ImPlot colormap selector dropdown menu.
`static void`	`showDemoWindow(ImBoolean pOpen)` Shows the ImPlot demo window.
`static void`	`showMetricsWindow()` Shows ImPlot metrics/debug information window.
`static void`	`showStyleEditor()` Shows ImPlot style editor block (not a window).
`static boolean`	`showStyleSelector(java.lang.String label)` Shows ImPlot style selector dropdown menu.
`static void`	`showUserGuide()` Add basic help/info block for end users (not a window).
`static void`	`styleColorsAuto()` Style plot colors for current ImGui style (default).
`static void`	`styleColorsClassic()` Style plot colors for ImGui "Classic".
`static void`	`styleColorsDark()` Style plot colors for ImGui "Dark".
`static void`	`styleColorsLight()` Style plot colors for ImGui "Light".

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createContext
```
public static ImPlotContext createContext()
```
Creates a new ImPlot context. Call this after ImGui.createContext().

destroyContext
```
public static void destroyContext(ImPlotContext ctx)
```
Destroys an ImPlot context. Call this before ImGui.destroyContext(). NULL = destroy current context.

getCurrentContext
```
public static ImPlotContext getCurrentContext()
```
Returns the current ImPlot context. NULL if no context has ben set.

setCurrentContext

public static void setCurrentContext(ImPlotContext ctx)

Sets the current ImPlot context.

beginPlot
```
public static boolean beginPlot(java.lang.String titleID)
```
Starts a 2D plotting context. If this function returns true, EndPlot() MUST be called! You are encouraged to use the following convention: if (ImPlot.beginPlot(...)) { ImPlot.plotLine(...); ... ImPlot.endPlot(); } Important notes: - #titleID 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").

beginPlot
```
public static boolean beginPlot(java.lang.String titleID,
                                java.lang.String xLabel,
                                java.lang.String yLabel)
```
Starts a 2D plotting context. If this function returns true, EndPlot() MUST be called! You are encouraged to use the following convention: if (ImPlot.beginPlot(...)) { ImPlot.plotLine(...); ... ImPlot.endPlot(); } Important notes: - #titleID 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"). - If #xLabel and/or #yLabel are provided, axes labels will be displayed.

beginPlot
```
public static boolean beginPlot(java.lang.String titleID,
                                java.lang.String xLabel,
                                java.lang.String yLabel,
                                ImVec2 size)
```
Starts a 2D plotting context. If this function returns true, EndPlot() MUST be called! You are encouraged to use the following convention: if (ImPlot.beginPlot(...)) { ImPlot.plotLine(...); ... ImPlot.endPlot(); } Important notes: - #titleID 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"). - If #xLabel and/or #yLabel are provided, axes labels will be displayed. - #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 (default is 400x300 px).

beginPlot
```
public static boolean beginPlot(java.lang.String titleID,
                                java.lang.String xLabel,
                                java.lang.String yLabel,
                                ImVec2 size,
                                int flags,
                                int xFlags,
                                int yFlags)
```
Starts a 2D plotting context. If this function returns true, EndPlot() MUST be called! You are encouraged to use the following convention: if (ImPlot.beginPlot(...)) { ImPlot.plotLine(...); ... ImPlot.endPlot(); } Important notes: - #titleID 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"). - If #xLabel and/or #yLabel are provided, axes labels will be displayed. - #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 (default is 400x300 px). - See ImPlotFlags and ImPlotAxisFlags for more available options.

beginPlot
```
public static boolean beginPlot(java.lang.String titleID,
                                java.lang.String xLabel,
                                java.lang.String yLabel,
                                ImVec2 size,
                                int flags,
                                int xFlags,
                                int yFlags,
                                int y2Flags,
                                int y3Flags,
                                java.lang.String y2Label,
                                java.lang.String y3Label)
```
Starts a 2D plotting context. If this function returns true, EndPlot() MUST be called! You are encouraged to use the following convention: if (ImPlot.beginPlot(...)) { ImPlot.plotLine(...); ... ImPlot.endPlot(); } Important notes: - #titleID 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"). - If #xLabel and/or #yLabel are provided, axes labels will be displayed. - #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 (default is 400x300 px). - Auxiliary y-axes must be enabled with ImPlotFlags_YAxis2/3 to be displayed. - See ImPlotFlags and ImPlotAxisFlags for more available options.

endPlot
```
public static void endPlot()
```
Only call EndPlot() if beginPlot() returns true! Typically called at the end of an if statement conditioned on BeginPlot(). See example in beginPlot().

plotLine

public static <T extends java.lang.Number> void plotLine(java.lang.String labelID,
                                                         T[] xs,
                                                         T[] ys)

Plots a standard 2D line plot. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotLine

public static <T extends java.lang.Number> void plotLine(java.lang.String labelID,
                                                         T[] xs,
                                                         T[] ys,
                                                         int offset)

Plots a standard 2D line plot. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotLine

public static void plotLine(java.lang.String labelID,
                            double[] xs,
                            double[] ys,
                            int size,
                            int offset)

Plots a standard 2D line plot.

plotScatter

public static <T extends java.lang.Number> void plotScatter(java.lang.String labelID,
                                                            T[] xs,
                                                            T[] ys)

Plots a standard 2D scatter plot. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotScatter

public static <T extends java.lang.Number> void plotScatter(java.lang.String labelID,
                                                            T[] xs,
                                                            T[] ys,
                                                            int offset)

Plots a standard 2D scatter plot. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotScatter

public static void plotScatter(java.lang.String labelID,
                               double[] xs,
                               double[] ys,
                               int size,
                               int offset)

plotStairs
```
public static <T extends java.lang.Number> void plotStairs(java.lang.String labelID,
                                                           T[] xs,
                                                           T[] ys)
```
Plots a a stairstep graph. The y value is continued constantly from every x position, i.e. the interval [x[i], x[i+1]) has the value y[i]. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotStairs

public static <T extends java.lang.Number> void plotStairs(java.lang.String labelID,
                                                           T[] xs,
                                                           T[] ys,
                                                           int offset)

Plots a a stairstep graph. The y value is continued constantly from every x position, i.e. the interval [x[i], x[i+1]) has the value y[i]. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotStairs

public static void plotStairs(java.lang.String labelID,
                              double[] xs,
                              double[] ys,
                              int size,
                              int offset)

Plots a a stairstep graph. The y value is continued constantly from every x position, i.e. the interval [x[i], x[i+1]) has the value y[i].

plotShaded

public static <T extends java.lang.Number> void plotShaded(java.lang.String labelID,
                                                           T[] xs,
                                                           T[] ys,
                                                           int yRef)

Plots a shaded (filled) region between two lines, or a line and a horizontal reference. Set yRef (default 0) to +/-INFINITY for infinite fill extents. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotShaded

public static <T extends java.lang.Number> void plotShaded(java.lang.String labelID,
                                                           T[] xs,
                                                           T[] ys1,
                                                           T[] ys2)

Plots a shaded (filled) region between two lines, or a line and a horizontal reference. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotShaded

public static <T extends java.lang.Number> void plotShaded(java.lang.String labelID,
                                                           T[] xs,
                                                           T[] ys,
                                                           int yRef,
                                                           int offset)

plotShaded

public static <T extends java.lang.Number> void plotShaded(java.lang.String labelID,
                                                           T[] xs,
                                                           T[] ys1,
                                                           T[] ys2,
                                                           int offset)

Plots a shaded (filled) region between two lines, or a line and a horizontal reference. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotShaded

public static void plotShaded(java.lang.String labelID,
                              double[] xs,
                              double[] ys,
                              int size,
                              int yRef,
                              int offset)

Plots a shaded (filled) region between two lines, or a line and a horizontal reference. Set yRef (default 0) to +/-INFINITY for infinite fill extents.

plotShaded

public static void plotShaded(java.lang.String labelID,
                              double[] xs,
                              double[] ys1,
                              double[] ys2,
                              int size,
                              int offset)

Plots a shaded (filled) region between two lines, or a line and a horizontal reference.

plotBars

public static <T extends java.lang.Number> void plotBars(java.lang.String labelID,
                                                         T[] xs,
                                                         T[] ys)

Plots a vertical bar graph. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotBars

public static <T extends java.lang.Number> void plotBars(java.lang.String labelID,
                                                         T[] xs,
                                                         T[] ys,
                                                         float width)

Plots a vertical bar graph. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

Parameters:: width - is in X units

plotBars

public static <T extends java.lang.Number> void plotBars(java.lang.String labelID,
                                                         T[] xs,
                                                         T[] ys,
                                                         float width,
                                                         int offset)

Plots a vertical bar graph. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

Parameters:: width - is in X units

plotBars

public static void plotBars(java.lang.String labelID,
                            double[] xs,
                            double[] ys,
                            int size,
                            float width,
                            int offset)

Plots a vertical bar graph.

Parameters:: width - is in X units

plotBarsH

public static <T extends java.lang.Number> void plotBarsH(java.lang.String labelID,
                                                          T[] xs,
                                                          T[] ys)

Plots a horizontal bar graph. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotBarsH

public static <T extends java.lang.Number> void plotBarsH(java.lang.String labelID,
                                                          T[] xs,
                                                          T[] ys,
                                                          float height)

Plots a horizontal bar graph. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

Parameters:: height - is in Y units

plotBarsH

public static <T extends java.lang.Number> void plotBarsH(java.lang.String labelID,
                                                          T[] xs,
                                                          T[] ys,
                                                          float height,
                                                          int offset)

Plots a horizontal bar graph. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

Parameters:: height - is in Y units

plotBarsH

public static void plotBarsH(java.lang.String labelID,
                             double[] xs,
                             double[] ys,
                             int size,
                             float height,
                             int offset)

Plots a horizontal bar graph.

Parameters:: height - is in Y units

plotErrorBars

public static <T extends java.lang.Number> void plotErrorBars(java.lang.String labelID,
                                                              T[] xs,
                                                              T[] ys,
                                                              T[] err)

Plots vertical error bar. The labelID should be the same as the labelID of the associated line or bar plot. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotErrorBars

public static <T extends java.lang.Number> void plotErrorBars(java.lang.String labelID,
                                                              T[] xs,
                                                              T[] ys,
                                                              T[] err,
                                                              int offset)

plotErrorBars

public static void plotErrorBars(java.lang.String labelID,
                                 double[] xs,
                                 double[] ys,
                                 double[] err,
                                 int size,
                                 int offset)

Plots vertical error bar. The labelID should be the same as the labelID of the associated line or bar plot.

plotErrorBarsH

public static <T extends java.lang.Number> void plotErrorBarsH(java.lang.String labelID,
                                                               T[] xs,
                                                               T[] ys,
                                                               T[] err)

Plots horizontal error bar. The labelID should be the same as the labelID of the associated line or bar plot. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotErrorBarsH

public static <T extends java.lang.Number> void plotErrorBarsH(java.lang.String labelID,
                                                               T[] xs,
                                                               T[] ys,
                                                               T[] err,
                                                               int offset)

plotErrorBarsH

public static void plotErrorBarsH(java.lang.String labelID,
                                  double[] xs,
                                  double[] ys,
                                  double[] err,
                                  int size,
                                  int offset)

Plots horizontal error bar. The labelID should be the same as the labelID of the associated line or bar plot.

plotStems

public static <T extends java.lang.Number> void plotStems(java.lang.String labelID,
                                                          T[] values,
                                                          int yRef)

Plots vertical stems. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotStems

public static <T extends java.lang.Number> void plotStems(java.lang.String labelID,
                                                          T[] values,
                                                          int yRef,
                                                          int offset)

Plots vertical stems. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotStems

public static void plotStems(java.lang.String labelID,
                             double[] values,
                             int size,
                             int yRef,
                             int offset)

Plots vertical stems.

plotVLines
```
public static <T extends java.lang.Number> void plotVLines(java.lang.String labelID,
                                                           T[] values)
```
Plots infinite vertical lines (e.g. for references or asymptotes). Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotVLines

public static <T extends java.lang.Number> void plotVLines(java.lang.String labelID,
                                                           T[] values,
                                                           int offset)

Plots infinite vertical lines (e.g. for references or asymptotes). Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotVLines

public static void plotVLines(java.lang.String labelID,
                              double[] values,
                              int size,
                              int offset)

Plots infinite vertical lines (e.g. for references or asymptotes).

plotHLines
```
public static <T extends java.lang.Number> void plotHLines(java.lang.String labelID,
                                                           T[] values)
```
Plots infinite horizontal lines (e.g. for references or asymptotes). Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotHLines

public static <T extends java.lang.Number> void plotHLines(java.lang.String labelID,
                                                           T[] values,
                                                           int offset)

Plots infinite horizontal lines (e.g. for references or asymptotes). Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotHLines

public static void plotHLines(java.lang.String labelID,
                              double[] values,
                              int size,
                              int offset)

Plots infinite horizontal lines (e.g. for references or asymptotes).

plotPieChart

public static <T extends java.lang.Number> void plotPieChart(java.lang.String[] labelIDs,
                                                             T[] values,
                                                             double x,
                                                             double y,
                                                             double radius)

Plots a pie chart. If the sum of values > 1, each value will be normalized. Center and radius are in plot units. #label_fmt can be set to NULL for no labels. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotPieChart

public static void plotPieChart(java.lang.String labelIDsSs,
                                int strLen,
                                double[] values,
                                int size,
                                double x,
                                double y,
                                double radius)

Plots a pie chart. If the sum of values > 1, each value will be normalized. Center and radius are in plot units. #label_fmt can be set to NULL for no labels.

plotHeatmap

public static <T extends java.lang.Number> void plotHeatmap(java.lang.String labelID,
                                                            T[][] values,
                                                            int offset)

Plots a 2D heatmap chart. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

Parameters:: values - must have fixed dimensions (all arrays are same length)

plotHeatmap

public static void plotHeatmap(java.lang.String labelID,
                               double[] values,
                               int rows,
                               int cols)

Plots a 2D heatmap chart.

Parameters:: values - must have fixed dimensions (all arrays are same length)

plotHistogram

public static <T extends java.lang.Number> double plotHistogram(java.lang.String labelID,
                                                                T[] values)

Plots a horizontal histogram Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotHistogram

public static double plotHistogram(java.lang.String labelID,
                                   double[] values,
                                   int size)

Plots a horizontal histogram.

plotHistogram2D

public static <T extends java.lang.Number> double plotHistogram2D(java.lang.String labelID,
                                                                  T[] xs,
                                                                  T[] ys)

Plots two dimensional, bivariate histogram as a heatmap Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotHistogram2D

public static double plotHistogram2D(java.lang.String labelID,
                                     double[] xs,
                                     double[] ys,
                                     int size)

Plots two dimensional, bivariate histogram as a heatmap.

plotDigital
```
public static <T extends java.lang.Number> void plotDigital(java.lang.String labelID,
                                                            T[] xs,
                                                            T[] ys)
```
Plots digital data. Digital plots do not respond to y drag or zoom, and are always referenced to the bottom of the plot. Due to conversion from T to double, extremely large 64-bit integer (long) values may lose data!

plotDigital

public static void plotDigital(java.lang.String labelID,
                               double[] xs,
                               double[] ys,
                               int size)

Plots digital data. Digital plots do not respond to y drag or zoom, and are always referenced to the bottom of the plot.

plotText

public static void plotText(java.lang.String text,
                            double x,
                            double y)

Plots a centered text label at point x,y

plotText

public static void plotText(java.lang.String text,
                            double x,
                            double y,
                            boolean vertical)

Plots a centered text label at point x,y

plotDummy
```
public static void plotDummy(java.lang.String labelID)
```
Plots a dummy item (i.e. adds a legend entry colored by ImPlotCol_Line)

setNextPlotLimits

public static void setNextPlotLimits(double xmin,
                                     double xmax,
                                     double ymin,
                                     double ymax,
                                     int imguicond)

This function MUST be called BEFORE beginPlot! Set the axes range limits of the next plot. Call right before BeginPlot(). If ImGuiCond_Always is used, the axes limits will be locked.

setNextPlotLimitsX
```
public static void setNextPlotLimitsX(double xmin,
                                      double xmax,
                                      int imguicond)
```
This function MUST be called BEFORE beginPlot! Set the X axis range limits of the next plot. Call right before BeginPlot(). If ImGuiCond_Always is used, the X axis limits will be locked.

setNextPlotLimitsY
```
public static void setNextPlotLimitsY(double ymin,
                                      double ymax,
                                      int imguicond)
```
This function MUST be called BEFORE beginPlot! Set the Y axis range limits of the next plot. Call right before BeginPlot(). If ImGuiCond_Always is used, the Y axis limits will be locked.

linkNextPlotLimits

public static void linkNextPlotLimits(ImDouble xmin,
                                      ImDouble xmax,
                                      ImDouble ymin,
                                      ImDouble ymax)

This function MUST be called BEFORE beginPlot! Links the next plot limits to external values. Set to NULL for no linkage. The pointer data must remain valid until the matching call to EndPlot.

linkNextPlotLimits

public static void linkNextPlotLimits(ImDouble xmin,
                                      ImDouble xmax,
                                      ImDouble ymin,
                                      ImDouble ymax,
                                      ImDouble ymin2,
                                      ImDouble ymax2)

This function MUST be called BEFORE beginPlot! Links the next plot limits to external values. Set to NULL for no linkage. The pointer data must remain valid until the matching call to EndPlot.

linkNextPlotLimits

public static void linkNextPlotLimits(ImDouble xmin,
                                      ImDouble xmax,
                                      ImDouble ymin,
                                      ImDouble ymax,
                                      ImDouble ymin2,
                                      ImDouble ymax2,
                                      ImDouble ymin3,
                                      ImDouble ymax3)

This function MUST be called BEFORE beginPlot! Links the next plot limits to external values. Set to NULL for no linkage. The pointer data must remain valid until the matching call to EndPlot.

fitNextPlotAxes
```
public static void fitNextPlotAxes()
```
This function MUST be called BEFORE beginPlot! Fits the next plot axes to all plotted data if they are unlocked (equivalent to double-clicks).

fitNextPlotAxes
```
public static void fitNextPlotAxes(boolean x,
                                   boolean y)
```
This function MUST be called BEFORE beginPlot! Fits the next plot axes to all plotted data if they are unlocked (equivalent to double-clicks).

fitNextPlotAxes

public static void fitNextPlotAxes(boolean x,
                                   boolean y,
                                   boolean y2,
                                   boolean y3)

This function MUST be called BEFORE beginPlot! Fits the next plot axes to all plotted data if they are unlocked (equivalent to double-clicks).

setNextPlotTicksX

public static void setNextPlotTicksX(double xMin,
                                     double xMax,
                                     int nTicks)

This function MUST be called BEFORE beginPlot! Set the X axis ticks and optionally the labels for the next plot.

setNextPlotTicksX

public static void setNextPlotTicksX(double xMin,
                                     double xMax,
                                     int nTicks,
                                     java.lang.String[] labels,
                                     boolean keepDefault)

This function MUST be called BEFORE beginPlot! Set the X axis ticks and optionally the labels for the next plot. To keep the default ticks, set #keepDefault=true.

setNextPlotTicksX

public static void setNextPlotTicksX(double xMin,
                                     double xMax,
                                     int nTicks,
                                     java.lang.String s1,
                                     java.lang.String s2,
                                     java.lang.String s3,
                                     java.lang.String s4,
                                     boolean keepDefault)

This function MUST be called BEFORE beginPlot! Set the X axis ticks and optionally the labels for the next plot. To keep the default ticks, set #keepDefault=true.

setNextPlotTicksY

public static void setNextPlotTicksY(double xMin,
                                     double xMax,
                                     int nTicks)

This function MUST be called BEFORE beginPlot! Set the Y axis ticks and optionally the labels for the next plot.

setNextPlotTicksY

public static void setNextPlotTicksY(double xMin,
                                     double xMax,
                                     int nTicks,
                                     java.lang.String[] labels,
                                     boolean keepDefault)

This function MUST be called BEFORE beginPlot! Set the Y axis ticks and optionally the labels for the next plot. To keep the default ticks, set #keepDefault=true.

setNextPlotTicksY

public static void setNextPlotTicksY(double xMin,
                                     double xMax,
                                     int nTicks,
                                     java.lang.String[] labels,
                                     boolean keepDefault,
                                     int yAxis)

This function MUST be called BEFORE beginPlot! Set the Y axis ticks and optionally the labels for the next plot. To keep the default ticks, set #keepDefault=true.

setNextPlotTicksY

public static void setNextPlotTicksY(double xMin,
                                     double xMax,
                                     int nTicks,
                                     java.lang.String s1,
                                     java.lang.String s2,
                                     java.lang.String s3,
                                     java.lang.String s4,
                                     boolean keepDefault,
                                     int yAxis)

This function MUST be called BEFORE beginPlot! Set the Y axis ticks and optionally the labels for the next plot. To keep the default ticks, set #keepDefault=true.

setNextPlotFormatX
```
public static void setNextPlotFormatX(java.lang.String fmt)
```
This function MUST be called BEFORE beginPlot! Set the format for numeric X axis labels (default="%g"). Formated values will be doubles (i.e. don't supply %d, %i, etc.). Not applicable if ImPlotAxisFlags_Time enabled.

setNextPlotFormatY
```
public static void setNextPlotFormatY(java.lang.String fmt)
```
This function MUST be called BEFORE beginPlot! Set the format for numeric Y axis labels (default="%g"). Formated values will be doubles (i.e. don't supply %d, %i, etc.). Not applicable if ImPlotAxisFlags_Time enabled.

setNextPlotFormatY
```
public static void setNextPlotFormatY(java.lang.String fmt,
                                      int yAxis)
```
This function MUST be called BEFORE beginPlot! Set the format for numeric Y axis labels (default="%g"). Formated values will be doubles (i.e. don't supply %d, %i, etc.). Not applicable if ImPlotAxisFlags_Time enabled.

setPlotYAxis
```
public static void setPlotYAxis(int yAxis)
```
This function MUST be called BETWEEN begin/endPlot! Select which Y axis will be used for subsequent plot elements. The default is ImPlotYAxis_1, or the first (left) Y axis. Enable 2nd and 3rd axes with ImPlotFlags_YAxisX.

hideNextItem
```
public static void hideNextItem()
```
This function MUST be called BETWEEN begin/endPlot! Hides the next plot item.

hideNextItem
```
public static void hideNextItem(boolean hidden,
                                int imguiCond)
```
This function MUST be called BETWEEN begin/endPlot! Hides the next plot item. Use ImGuiCond. Always if you need to forcefully set this every frame (default ImGuiCond.Once).

pixelsToPlot
```
public static ImPlotPoint pixelsToPlot(ImVec2 pix,
                                       int yAxis)
```
This function MUST be called BETWEEN begin/endPlot! Convert pixels to a position in the current plot's coordinate system. A negative yAxis uses the current value of SetPlotYAxis (ImPlotYAxis_1 initially).

pixelsToPlot
```
public static ImPlotPoint pixelsToPlot(float x,
                                       float y,
                                       int yAxis)
```
This function MUST be called BETWEEN begin/endPlot! The returned ImPlotPoint should be manually deallocated with destroy()! Convert pixels to a position in the current plot's coordinate system. A negative yAxis uses the current value of SetPlotYAxis (ImPlotYAxis_1 initially).

plotToPixels
```
public static ImVec2 plotToPixels(ImPlotPoint plt,
                                  int yAxis)
```
This function MUST be called BETWEEN begin/endPlot! Convert a position in the current plot's coordinate system to pixels. A negative yAxis uses the current value of SetPlotYAxis (ImPlotYAxis_1 initially).

plotToPixels
```
public static ImVec2 plotToPixels(double x,
                                  double y,
                                  int yAxis)
```
This function MUST be called BETWEEN begin/endPlot! Convert a position in the current plot's coordinate system to pixels. A negative yAxis uses the current value of SetPlotYAxis (ImPlotYAxis_1 initially).

getPlotPos
```
public static ImVec2 getPlotPos()
```
This function MUST be called BETWEEN begin/endPlot! Get the current Plot position (top-left) in pixels.

getPlotPos

public static void getPlotPos(ImVec2 vec)

getPlotSize
```
public static ImVec2 getPlotSize()
```
This function MUST be called BETWEEN begin/endPlot! Get the current Plot size in pixels.

getPlotSize
```
public static void getPlotSize(ImVec2 vec)
```
This function MUST be called BETWEEN begin/endPlot! Get the current Plot size in pixels.

isPlotHovered
```
public static boolean isPlotHovered()
```
This function MUST be called BETWEEN begin/endPlot! Returns true if the plot area in the current plot is hovered.

isPlotXAxisHovered
```
public static boolean isPlotXAxisHovered()
```
This function MUST be called BETWEEN begin/endPlot! Returns true if the XAxis plot area in the current plot is hovered.

isPlotYAxisHovered
```
public static boolean isPlotYAxisHovered(int yAxis)
```
This function MUST be called BETWEEN begin/endPlot! Returns true if the YAxis[n] plot area in the current plot is hovered.

getPlotMousePos
```
public static ImPlotPoint getPlotMousePos(int yAxis)
```
This function MUST be called BETWEEN begin/endPlot! The returned ImPlotPoint should be manually deallocated with destroy()! Returns the mouse position in x,y coordinates of the current plot. A negative yAxis uses the current value of SetPlotYAxis (ImPlotYAxis_1 initially).

getPlotLimits
```
public static ImPlotLimits getPlotLimits(int yAxis)
```
This function MUST be called BETWEEN begin/endPlot! The returned ImPlotLimits should be manually deallocated with destroy()! Returns the current plot axis range. A negative yAxis uses the current value of SetPlotYAxis (ImPlotYAxis_1 initially).

isPlotSelected
```
public static boolean isPlotSelected()
```
This function MUST be called BETWEEN begin/endPlot! Returns true if the current plot is being box selected.

getPlotSelection
```
public static ImPlotLimits getPlotSelection(int yAxis)
```
This function MUST be called BETWEEN begin/endPlot! The returned ImPlotLimits should be manually deallocated with destroy()! Returns the current plot box selection bounds.

isPlotQueried
```
public static boolean isPlotQueried()
```
This function MUST be called BETWEEN begin/endPlot! Returns true if the current plot is being queried or has an active query. Query must be enabled with ImPlotFlags_Query.

getPlotQuery
```
public static ImPlotLimits getPlotQuery(int yAxis)
```
This function MUST be called BETWEEN begin/endPlot! The returned ImPlotLimits should be manually deallocated with destroy()! Returns the current plot query bounds. Query must be enabled with ImPlotFlags_Query.

setPlotQuery
```
public static void setPlotQuery(ImPlotLimits query,
                                int yAxis)
```
This function MUST be called BETWEEN begin/endPlot! Set the current plot query bounds. Query must be enabled with ImPlotFlags_Query.

annotate

public static void annotate(double x,
                            double y,
                            ImVec2 pixOffset,
                            java.lang.String... fmt)

Shows an annotation callout at a chosen point. Uses default color

annotate

public static void annotate(double x,
                            double y,
                            ImVec2 pixOffset,
                            ImVec4 color,
                            java.lang.String... fmt)

Shows an annotation callout at a chosen point.

annotateClamped

public static void annotateClamped(double x,
                                   double y,
                                   ImVec2 pixOffset,
                                   java.lang.String... fmt)

Shows an annotation callout at a chosen point, clamped inside the plot area. Uses default color

annotateClamped

public static void annotateClamped(double x,
                                   double y,
                                   ImVec2 pixOffset,
                                   ImVec4 color,
                                   java.lang.String... fmt)

Shows an annotation callout at a chosen point, clamped inside the plot area.

dragLineX

public static boolean dragLineX(java.lang.String id,
                                double xValue,
                                boolean showLabel,
                                ImVec4 color,
                                float thickness)

Shows a draggable vertical guide line at an x-value.

dragLineY

public static boolean dragLineY(java.lang.String id,
                                double yValue,
                                boolean showLabel,
                                ImVec4 color,
                                float thickness)

Shows a draggable horizontal guide line at a y-value.

dragPoint

public static boolean dragPoint(java.lang.String id,
                                double x,
                                double y,
                                boolean showLabel,
                                ImVec4 color,
                                float radius)

Shows a draggable point at x,y.

setLegendLocation

public static void setLegendLocation(int location,
                                     int orientation,
                                     boolean outside)

Set the location of the current plot's legend

setMousePosLocation
```
public static void setMousePosLocation(int location)
```
Set the location of the current plot's mouse position text

isLegendEntryHovered
```
public static boolean isLegendEntryHovered(java.lang.String labelID)
```
Returns true if a plot item legend entry is hovered.

beginLegendPopup

public static boolean beginLegendPopup(java.lang.String labelID)

Begin a popup for a legend entry.

beginLegendPopup

public static boolean beginLegendPopup(java.lang.String labelID,
                                       int mouseButton)

Begin a popup for a legend entry.

endLegendPopup
```
public static void endLegendPopup()
```
End a popup for a legend entry.

beginDragDropTarget
```
public static boolean beginDragDropTarget()
```
Turns the current plot's plotting area into a drag and drop target. Don't forget to call EndDragDropTarget!

beginDragDropTargetX
```
public static boolean beginDragDropTargetX()
```
Turns the current plot's X-axis into a drag and drop target. Don't forget to call EndDragDropTarget!

beginDragDropTargetY
```
public static boolean beginDragDropTargetY(int yAxis)
```
Turns the current plot's Y-Axis into a drag and drop target. Don't forget to call EndDragDropTarget!

beginDragDropTargetLegend
```
public static boolean beginDragDropTargetLegend()
```
Turns the current plot's legend into a drag and drop target. Don't forget to call EndDragDropTarget!

endDragDropTarget
```
public static void endDragDropTarget()
```
Ends a drag and drop target.

beginDragDropSource
```
public static boolean beginDragDropSource(int keyMods,
                                          int dragDropFlags)
```
Turns the current plot's plotting area into a drag and drop source. Don't forget to call EndDragDropSource!

beginDragDropSourceX

public static boolean beginDragDropSourceX(int keyMods,
                                           int dragDropFlags)

Turns the current plot's X-axis into a drag and drop source. Don't forget to call EndDragDropSource!

beginDragDropSourceY

public static boolean beginDragDropSourceY(int yAxis,
                                           int keyMods,
                                           int dragDropFlags)

Turns the current plot's Y-axis into a drag and drop source. Don't forget to call EndDragDropSource!

beginDragDropSourceItem

public static boolean beginDragDropSourceItem(java.lang.String labelID,
                                              int dragDropFlags)

Turns an item in the current plot's legend into drag and drop source. Don't forget to call EndDragDropSource!

endDragDropSource
```
public static void endDragDropSource()
```
Ends a drag and drop source.

getStyle
```
public static ImPlotStyle getStyle()
```
Provides access to plot style structure for permanant modifications to colors, sizes, etc.

styleColorsAuto
```
public static void styleColorsAuto()
```
Style plot colors for current ImGui style (default).

styleColorsClassic
```
public static void styleColorsClassic()
```
Style plot colors for ImGui "Classic".

styleColorsDark
```
public static void styleColorsDark()
```
Style plot colors for ImGui "Dark".

styleColorsLight
```
public static void styleColorsLight()
```
Style plot colors for ImGui "Light".

pushStyleColor

public static void pushStyleColor(int idx,
                                  long col)

Temporarily modify a style color. Don't forget to call PopStyleColor!

pushStyleColor

public static void pushStyleColor(int idx,
                                  ImVec4 col)

Temporarily modify a style color. Don't forget to call PopStyleColor!

popStyleColor
```
public static void popStyleColor()
```

popStyleColor

public static void popStyleColor(int count)

pushStyleVar
```
public static void pushStyleVar(int idx,
                                float val)
```
Temporarily modify a style variable of float type. Don't forget to call PopStyleVar!

pushStyleVar
```
public static void pushStyleVar(int idx,
                                int val)
```
Temporarily modify a style variable of int type. Don't forget to call PopStyleVar!

pushStyleVar

public static void pushStyleVar(int idx,
                                ImVec2 val)

Temporarily modify a style variable of ImVec2 type. Don't forget to call PopStyleVar!

popStyleVar
```
public static void popStyleVar()
```
Undo temporary style variable modification(s). Undo multiple pushes at once by increasing count.

popStyleVar
```
public static void popStyleVar(int count)
```
Undo temporary style variable modification(s). Undo multiple pushes at once by increasing count.

getLastItemColor
```
public static ImVec4 getLastItemColor()
```
Gets the last item primary color (i.e. its legend icon color)

getStyleColorName

public static java.lang.String getStyleColorName(int idx)

Returns the string name for an ImPlotCol.

getMarkerName
```
public static java.lang.String getMarkerName(int idx)
```
Returns the null terminated string name for an ImPlotMarker.

addColormap
```
public static int addColormap(java.lang.String name,
                              ImVec4[] cols)
```
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! Colormaps are considered to be qualitative (i.e. discrete).

getColormapCount
```
public static int getColormapCount()
```
Returns the number of available colormaps (i.e. the built-in + user-added count).

getColormapName
```
public static java.lang.String getColormapName(int cmap)
```
Returns a string name for a colormap given an index.

getColormapIndex
```
public static int getColormapIndex(java.lang.String name)
```
Returns an index number for a colormap given a valid string name. Returns -1 if the name is invalid.

pushColormap
```
public static void pushColormap(int cmap)
```
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!

pushColormap
```
public static void pushColormap(java.lang.String name)
```
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!

popColormap
```
public static void popColormap()
```
Undo temporary colormap modification(s). Undo multiple pushes at once by increasing count.

popColormap
```
public static void popColormap(int count)
```
Undo temporary colormap modification(s). Undo multiple pushes at once by increasing count.

nextColormapColor
```
public static ImVec4 nextColormapColor()
```
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!

getColormapSize

public static int getColormapSize(int cmap)

Returns the size of a colormap.

getColormapColor

public static ImVec4 getColormapColor(int idx,
                                      int cmap)

Returns a color from a colormap given an index >= 0 (modulo will be performed).

sampleColormap

public static ImVec4 sampleColormap(float t,
                                    int cmap)

Sample a color from a colormap given t between 0 and 1

colormapScale

public static void colormapScale(java.lang.String label,
                                 double scaleMin,
                                 double scaleMax,
                                 int cmap)

Shows a vertical color scale with linear spaced ticks using the specified color map. Use double hashes to hide label (e.g. "##NoLabel").

colormapSlider

public static boolean colormapSlider(java.lang.String label,
                                     float t,
                                     int cmap)

Shows a horizontal slider with a colormap gradient background.

colormapButton

public static boolean colormapButton(java.lang.String label,
                                     int cmap)

Shows a button with a colormap gradient brackground.

bustColorCache
```
public static void bustColorCache()
```
When items in a plot sample their color from a colormap, the color is cached and does not change unless explicitly overriden. 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 NULL, 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).

bustColorCache
```
public static void bustColorCache(java.lang.String plotTableID)
```
When items in a plot sample their color from a colormap, the color is cached and does not change unless explicitly overriden. 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 NULL, 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).

itemIcon
```
public static void itemIcon(ImVec4 col)
```
Render icons similar to those that appear in legends (nifty for data lists).

colormapIcon
```
public static void colormapIcon(int colorMap)
```
Render icons similar to those that appear in legends (nifty for data lists).

getPlotDrawList
```
public static ImDrawList getPlotDrawList()
```
Get the plot draw list for custom rendering to the current plot area. Call between Begin/EndPlot.

pushPlotClipRect
```
public static void pushPlotClipRect(float expand)
```
Push clip rect for rendering to current plot area. The rect can be expanded or contracted by #expand pixels. Call between Begin/EndPlot.

popPlotClipRect
```
public static void popPlotClipRect()
```
Pop plot clip rect. Call between Begin/EndPlot.

showStyleSelector

public static boolean showStyleSelector(java.lang.String label)

Shows ImPlot style selector dropdown menu.

showColormapSelector

public static boolean showColormapSelector(java.lang.String label)

Shows ImPlot colormap selector dropdown menu.

showStyleEditor
```
public static void showStyleEditor()
```
Shows ImPlot style editor block (not a window).

showUserGuide
```
public static void showUserGuide()
```
Add basic help/info block for end users (not a window).

showMetricsWindow
```
public static void showMetricsWindow()
```
Shows ImPlot metrics/debug information window.

showDemoWindow

public static void showDemoWindow(ImBoolean pOpen)

Shows the ImPlot demo window.

Class ImPlot

Method Summary

Methods inherited from class java.lang.Object

Method Detail

createContext

destroyContext

getCurrentContext

setCurrentContext

beginPlot

beginPlot

beginPlot

beginPlot

beginPlot

endPlot

plotLine

plotLine

plotLine

plotScatter

plotScatter

plotScatter

plotStairs

plotStairs

plotStairs

plotShaded

plotShaded

plotShaded

plotShaded

plotShaded

plotShaded

plotBars

plotBars

plotBars

plotBars

plotBarsH

plotBarsH

plotBarsH

plotBarsH

plotErrorBars

plotErrorBars

plotErrorBars

plotErrorBarsH

plotErrorBarsH

plotErrorBarsH

plotStems

plotStems

plotStems

plotVLines

plotVLines

plotVLines

plotHLines

plotHLines

plotHLines

plotPieChart

plotPieChart

plotHeatmap

plotHeatmap

plotHistogram

plotHistogram

plotHistogram2D

plotHistogram2D

plotDigital

plotDigital

plotText

plotText

plotDummy

setNextPlotLimits

setNextPlotLimitsX

setNextPlotLimitsY

linkNextPlotLimits

linkNextPlotLimits

linkNextPlotLimits

fitNextPlotAxes

fitNextPlotAxes

fitNextPlotAxes

setNextPlotTicksX

setNextPlotTicksX

setNextPlotTicksX

setNextPlotTicksY

setNextPlotTicksY

setNextPlotTicksY