v0.2

After nearly two months of work, I’m excited to release ImPlot3D v0.2 🎉! This update brings new APIs, better interactions, and many bug fixes, all thanks to the incredible contributions and feedback from the community.

A huge thank you to everyone who helped shape this release! Special thanks to:

• @epezent for the detailed feedback in #24.
• @ocornut for featuring ImPlot3D in the ImGui v1.91.8 release.
• @pthom for the Python bindings in imgui-bundle and online demo.
• @sonoro1234 for the C bindings in cimplot3d and Lua bindings in LuaJIT-ImGui.
• @HeresJ0nny for suggesting new features and setting up the custom ticks API.
• @Poooel for adding new ImPlot3D flags (Invert and NoMenus).
• @dimateos for improving .gitignore and actively participating in discussions.
• @floooh for the MacOS fixes and GitHub CI.
• @Lumengine for fixing Windows compilation issues.
• @bratpilz for ensuring compatibility with IMGUI_DISABLE_OBSOLETE_FUNCTIONS.

🚀 Features

• GitHub CI script for Linux/MacOS/Windows by @floooh in #8

• Custom value range for colormaps by @brenocq in #12 (feature request from @HeresJ0nny)

• Online demo by @pthom (discussion #25)

• Plane context menu by @brenocq in #29 (feedback from @epezent in #24)

• Weight cursor position when zooming by @brenocq in #30 (feedback from @epezent in #24)

• Add clipping flag to plot context menu by @brenocq in #31 (feedback from @epezent in #24)

• New ImPlot3DAxisFlags_Invert and ImPlot3DFlags_NoMenus flags by @Poooel in #40

• Bindings to other languages

  • Python: imgui-bundle thanks to @pthom (discussion #45)
  • C: cimplot3d thanks to @sonoro1234 (discussion #52)
  • Lua: LuaJIT-ImGui thanks to @sonoro1234 (discussion #52)

• Box scaling (custom aspect ratios) by @brenocq in #46 (feedback from @epezent in #24)

• Add SetupAxisTicks for configuring custom ticks by @HeresJ0nny in #55

• API to set current rotation and initial rotation by @brenocq in #61

🐛 Bug fixes | 🛠️ Chores

• Compression of README GIFs by @gezeta-id and @brenocq in #6
• Fix example build and run on MacOS by @floooh in #7
• Fix Windows compilation errors by @Lumengine in #11. @michaelkamau, @floooh, and @khurramjaved96 also reported this bug in #4, #5, and #10
• README feature tracking & progress overview by @brenocq in #23

• Fix mouse position flag not working by @brenocq in #31
• Fix compatability with IMGUI_DISABLE_OBSOLETE_FUNCTIONS by @bratpilz in #42
• Minor warning fix by @pthom in #43
• Warning fixes by @brenocq in #53
• Fix min/max lock & axis transformation by @brenocq in #54
• Add common IDE cache folders to gitignored by @dimateos in #56
• Display avatars in discussion cards by @brenocq in #59
• Fix auto fit giggle by @brenocq in #60 (reported by @dimateos in #47)
• Fix ImGuiColorEditFlags_AlphaPreview disappearing after imgui 19173 by @sonoro1234 in #64

🎉 New Contributors

• @floooh made their first contribution in #8
• @Lumengine made their first contribution in #11
• @Poooel made their first contribution in #40
• @bratpilz made their first contribution in #42
• @pthom made their first contribution in #43
• @HeresJ0nny made their first contribution in #55
• @dimateos made their first contribution in #56
• @sonoro1234 made their first contribution in #64

Full Changelog: v0.1...v0.2

v0.1

I’m thrilled to share the v0.1 release of ImPlot3D! 🎉 This is the very first public version of ImPlot3D, and it’s fresh out of the oven! While it already supports interactive 3D plotting, this release is just the beginning.

🚀 Features

• Core 3D Plotting Functions:
  • PlotScatter: Plot individual 3D points.
  • PlotLine: Draw lines in 3D space.
  • PlotTriangle: Render triangles with fill support.
  • PlotQuad: Render quads (two triangles) for surfaces.
  • PlotSurface: Plot structured surfaces with X/Y grids.
  • PlotMesh: Display custom meshes using vertices and indices.
  • PlotText: Annotate your 3D plots with centered text labels.
• Interactivity:
  • Rotate, pan, and zoom plots using the mouse or touchpad.
  • Reset the camera view with double-click interactions.
  • Smooth camera rotation animations.
• Customization:
  • Control line styles, colors, and marker styles.
  • Apply colormaps to surfaces, lines, and markers.
  • Flexible axis setup with SetupAxes and SetupAxesLimits.

⚠️ Your Feedback Matters!

This is v0.1, the very first step for ImPlot3D, and it’s far from perfect. Your input will shape its future! Whether you find bugs 🐞, think of missing features 💡, or create something amazing with it 🎨 — I want to hear from you.

• 🐞 Spotted a bug? Open an issue and let’s squash it.
• 💡 Need something new? Share your ideas for features or improvements.
• 🎨 Built something cool? Expose it in our Gallery!

Your feedback will help refine and grow ImPlot3D into the tool it’s meant to be. Let’s build this together! 🚀