v0.3

[brenocq]

Hello everyone! I hope you're having a good time with ImPlot3D.

After almost one year in the making, I'm happy to announce ImPlot3D v0.3 🎉.

This release brings a massive leap in precision for large-scale data, adds exciting new features like image plotting and log scales, and includes numerous fixes and improvements. A special thank you to everyone who contributed to v0.3!

On a personal note, I have recently stepped up as a maintainer for ImPlot. I want to thank @epezent for his trust and for this incredible opportunity (read more about the transition in epezent/implot#643).

This is an exciting time for the ecosystem as we work to align and improve both libraries. I invite you to get involved with both ImPlot and ImPlot3D - report bugs, suggest new features, open PRs.

❤️ Sponsor the Project I have also enabled GitHub Sponsors. Your support allows me to dedicate focused time to the health of the ImPlot/ImPlot3D ecosystem and directly contributes to my future academic studies in robotics and XR. If you find these tools valuable to your work, please consider becoming a sponsor.

🚀 New Features

• Feat: PlotImage API by @brenocq in Feat: PlotImage API #79 (requested by @dcnieho)
  • The demo below was implemented by @pthom in imgui_bundle

• Feat: Axis log scale by @brenocq in Feat: Axis log scale #156 (requested by @fecaltransplant, @AhmedLilah)

• Feat: Add ImPlot3DFlags_Equal flag for equal axis scaling by @brenocq in Feat: Add ImPlot3DFlags_Equal flag for equal axis scaling #142

• Feat: Add metrics window by @ACvanWyk in Feat: Add metrics window #125

• Feat: ImPlot3D Flags for disabling user inputs by @chrissanrow in feat: ImPlot3D Flags for disabling user input (pan/rotate/zoom/all) #153
  • ImPlot3DFlags_NoRotate
  • ImPlot3DFlags_NoPan
  • ImPlot3DFlags_NoZoom
  • ImPlot3DFlags_NoInputs

• Feat: Axis constraints by @brenocq in Feat: Axis constraints #120

📸 New Demos

The documentation was improved in #154 and new demos were also added.

• Legend options demo

• Auto-fitting data demo

• Mouse picking demo

• Custom overlay demo

• Custom per-point style

• Config tab (Highly inspired by ImPlot's)

• About window with build information (Highly inspired by ImGui's)

🐛 Bug Fixes | 🛠️ Chores

• Chore: Add vcpkg mention to the documentation by @RT2Code in Chore: Add vcpkg mention to the documentation #69
• Chore: Add an integer encoded version number (IMPLOT3D_VERSION_NUM) by @micb25 in Chore: Add an integer encoded version number (IMPLOT3D_VERSION_NUM) #73
• Fix: Division by zero in ImRemap01 function by @adamsepp in Fix: Division by zero in ImRemap01 function #75
• Chore: AddTextRotated: fix for incoming ImGui v1.92 by @pthom in Chore: AddTextRotated: fix for incoming ImGui v1.92 #78
• Fix: Consider axis inversion before calculating Z position for Z-order by @adamsepp in Fix: Consider axis inversion before calculating Z position for Z-order #80
• Chore: Remove Glad by @brenocq in Chore: Remove Glad #83 (suggested by @ocornut)
• Perf: Flags to plot without lines/fill/markers by @brenocq in Perf: Flags to plot without lines/fill/markers #88 (proposed by @fecaltransplant)
• Fix: Drawing conflict with overlapping windows by @brenocq in Fix: Drawing conflict with overlapping windows #89 (reported by @Analysiszaj)
• Docs: Upgrade README roadmap by @brenocq in Docs: Upgrade README roadmap #117
• Fix: Quad sorting by @brenocq in Fix: Quad sorting #118 (reported by @epezent)
• Fix: Inverted rotation when plot is upside down by @brenocq in Fix: Inverted rotation when plot is upside down #136 (reported by @AhmedLilah)
• Fix: Plot overlapping with title by @brenocq in Fix: Plot overlapping with title #138 (reported by @JBoschma)
• Fix: Inconsistent rotation direction by @brenocq in Fix: Inconsistent rotation direction #147
• Fix: Wrong fit to data when ImPlot3DFlags_Equal is enabled by @brenocq in Fix: Wrong fit to data when ImPlot3DFlags_Equal is enabled #148
• Fix!: Triangle sorting with large values (migration to double) by @brenocq in Fix!: Triangle sorting with large values (migration to double) #152 (reported by @HeresJ0nny)
• Docs: Improve documentation by @brenocq in Docs: Improve documentation #154 (suggested by @epezent)
• Chore: Set minimum required C++ to C++11 by @brenocq (suggested by @oktonion)

⚠️ Breaking Changes

As ImPlot3D is in early development, breaking changes may occur in the first few releases as the public API stabilizes.

To ensure ImPlot3D is ready for complex, real-world datasets, all plot coordinates have been migrated from float to double precision.
While most users won't need to change their code (as C++ handles implicit conversions), advanced users who directly interact with the following types and function signatures may need to update:

• Struct Members: ImPlot3DPoint, ImPlot3DRange, ImPlot3DQuat, ImPlot3DTick::PlotPos, ImPlot3DAxis::NDCScale.
• Draw List: ImDrawList3D::ZBuffer and ImDrawList3D::_ZWritePtr are now using double.
• Functions: SetupBoxRotation, SetupBoxInitialRotation, SetupBoxScale, and PlotText now accept double parameters.

Additionally, the functions GetPlotPos() and GetPlotSize() have been renamed to GetPlotRectPos() and GetPlotRectSize() for clarity within the 3D context. The old functions are now deprecated and will be removed in future versions.

See implot3d.cpp for the full list of changes.

🎉 New Contributors

• @RT2Code made their first contribution in Chore: Add vcpkg mention to the documentation #69
• @micb25 made their first contribution in Chore: Add an integer encoded version number (IMPLOT3D_VERSION_NUM) #73
• @adamsepp made their first contribution in Fix: Division by zero in ImRemap01 function #75
• @ACvanWyk made their first contribution in Feat: Add metrics window #125
• @chrissanrow made their first contribution in feat: ImPlot3D Flags for disabling user input (pan/rotate/zoom/all) #153

Full Changelog: v0.2...v0.3

---

This discussion was created from the release v0.3.

[renanbomtempo]

You guys are doing amazing progress! Thank you all so much for this incredible tool! ❤️

[brenocq]

Obrigado Renan! :)

[AhmedLilah]

amazing contributions @brenocq .

hopefully by next release I would have finished some of the other features 😂

[brenocq]

Thanks Ahmed! No rush at all 😂