implot-rs

Rust bindings for ImPlot, built by running bindgen on cimplot.

The bindings are currently based on ImPlot version 0.7. See the status section below for detailed information on implementation status.

Important note: As long as the code is pre-1.0 release, the API is expected to have breaking changes between minor versions. Patch versions should be backwards compatible. After 1.0, semver will be followed more properly.

Requirements

imgui-rs requires minimum Rust version 1.40, so this project does as well by extension. The sys crate compiles implot, so a C++ compiler will also be required.

Examples

Examples are being built in the implot-examples crate in this repo. To try them out, clone the repo, change into the implot-examples directory and try for example

  cargo run --example line_plots

Documentation

For released versions, see . Make sure you are looking at the right release, since the API is still changing. For the master branch, can build it yourself however by cloning this repo and then doing

  cargo doc --open

An effort is made to document everything as it is being added. Feel free to open an issue if documentation is unclear or lacking.

Implementation status

Currently a work in progress, coverage of the C++ API is increased steadily. The author is open to collaboration, if you'd like to help, feel free to reach out via a Github issue.

At this point, raw bindings are working in implot-sys, and more idiomatic interfaces for plot creation as well a subset of the functionality for plots are implemented.

• "BeginPlot"
  • Basic hello world
  • Plot flags
• Plotting functionality
  • Line plot
  • Text plot
  • Scatter plot
  • Bar plot
    • Vertical
    • Horizontal
  • Shaded plot
  • Stem plots
  • Images
  • Error bar plot
    • Vertical
    • Horizontal
  • Heatmap
  • Pie chart
  • Digital data
• Plot customization
  • Axis flags
  • Styling colors
  • Styling variables
  • Colormaps
• Plot querying
  • is hovered
  • mouse position in plot
  • plot limits
  • is queried
  • get plot query
  • are axes hovered
  • Choice of y axis
• Utils
  • Plot limit setting
  • imgui-rs style safe push/pop stacks
  • Plot tick setting
  • Input remapping
  • Set Y axis setting for subsequent elements
  • Set non-default Y axis ticks and labels
  • Plot position and size reading
  • Pixel to plot position
  • Plot to pixel position
  • Push/pop plotclip rect (?)

Developer documentation

Design approach

This repo tries to follow the approaches and style used in imgui-rs somewhat closely, because implot is to be used within imgui programs, and hence keeping the interfaces and design philosophies close should make it easier to do that.

If you spot any design inconsistencies or paper cuts, feel free to open an issue.