Skip to content

Feat: ImPlot3DSpec #169

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
brenocq merged 11 commits into from
Feb 14, 2026
Merged

Feat: ImPlot3DSpec #169

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
06f3fd8
feat: add ImPlot3DSpec and ImPlot3DProp_X
brenocq Feb 2, 2026
aa71f53
feat!: update begin item to use ImPlot3DSpec
brenocq Feb 2, 2026
6f3bdf5
feat!: update public API to use ImPlot3DSpec
brenocq Feb 3, 2026
4ab791a
refactor: rename ImPlot3DProp_Size to ImPlot3DProp_MarkerSize
brenocq Feb 3, 2026
410ea11
feat: add MarkerLineColor and MarkerFillColor properties
brenocq Feb 3, 2026
9a6f166
docs: add SetNextXXX to obsolete API section
brenocq Feb 12, 2026
1fdcdb0
style: fix ImProp typo
brenocq Feb 12, 2026
b190770
docs: fix code in SetNextXXX migration guide
brenocq Feb 12, 2026
0bc3c71
docs: update code block in SetNextXXX migration guide
brenocq Feb 12, 2026
a0f0516
merge: branch 'main' into feat/spec
brenocq Feb 14, 2026
a759265
fix: auto FillColor
brenocq Feb 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
85 changes: 57 additions & 28 deletions implot3d.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,50 @@ Below is a change-log of API breaking changes only. If you are using one of the
When you are not sure about an old symbol or function name, try using the Search/Find function of your IDE to look for comments or references in all
implot3d files. You can read releases logs https://github.com/brenocq/implot3d/releases for more details.

- 2026/02/03 (0.4) - ImPlotSpec was made the default and _only_ way of styling plot items. The SetNextXXXStyle functions have been removed.
- SetNextLineStyle has been removed, styling should be set via ImPlot3DSpec.
```cpp
// Before
ImPlot3D::SetNextLineStyle(line_color, line_weight);
ImPlot3D::PlotLine("Line", xs, ys, zs, count);

// After
ImPlot3DSpec spec;
spec.LineColor = line_color;
spec.LineWeight = line_weight;
ImPlot3D::PlotLine("Line", xs, ys, zs, count, spec);
```
- SetNextFillStyle has been removed, styling should be set via ImPlot3DSpec.
```cpp
// Before
ImPlot3D::SetNextFillStyle(fill_color, fill_alpha);
ImPlot3D::PlotTriangle("Triangle", xs, ys, zs, count);

// After
ImPlot3DSpec spec;
spec.FillColor = fill_color;
spec.FillAlpha = fill_alpha;
ImPlot3D::PlotTriangle("Triangle", xs, ys, zs, count, spec);
```
- SetNextMarkerStyle has been removed, styling should be set via ImPlot3DSpec.
```cpp
// Before:
ImPlot3D::SetNextMarkerStyle(marker, marker_size, fill_color, line_weight, marker_outline_color);
ImPlot3D::PlotScatter("Scatter", xs, ys, zs, count);

// After
ImPlot3DSpec spec;
spec.LineWeight = line_weight;
spec.Marker = marker;
spec.MarkerSize = marker_size;
spec.MarkerLineColor = marker_outline_color;
spec.MarkerFillColor = fill_color;
ImPlot3D::PlotScatter("Scatter", xs, ys, zs, count, spec);
```
- Flags, Offset and Stride should also be set via ImPlot3DSpec now.
- 2026/02/02 (0.4) - Item colors removed from ImPlot3DCol_, it's no longer possible to push/pop individual item colors.
- 2026/02/02 (0.4) - ImPlot3DStyle::MarkerWeight was removed. The marker line weight is now controlled by ImPlot3DStyle::LineWeight.

- 2025/11/15 (0.3) - Renamed GetPlotPos() -> GetPlotRectPos() and GetPlotSize() -> GetPlotRectSize() for clarity in 3D context.
Old functions are marked as deprecated and will be removed in v1.0.
- 2025/10/22 (0.3) - **IMPORTANT** All plot coordinate types migrated from float to double precision to fix sorting issues with large values:
Expand Down Expand Up @@ -2733,11 +2777,10 @@ struct ImPlot3DStyleVarInfo {

static const ImPlot3DStyleVarInfo GPlot3DStyleVarInfo[] = {
// Item style
{ImGuiDataType_Float, 1, (ImU32)offsetof(ImPlot3DStyle, LineWeight)}, // ImPlot3DStyleVar_LineWeight
{ImGuiDataType_S32, 1, (ImU32)offsetof(ImPlot3DStyle, Marker)}, // ImPlot3DStyleVar_Marker
{ImGuiDataType_Float, 1, (ImU32)offsetof(ImPlot3DStyle, MarkerSize)}, // ImPlot3DStyleVar_MarkerSize
{ImGuiDataType_Float, 1, (ImU32)offsetof(ImPlot3DStyle, MarkerWeight)}, // ImPlot3DStyleVar_MarkerWeight
{ImGuiDataType_Float, 1, (ImU32)offsetof(ImPlot3DStyle, FillAlpha)}, // ImPlot3DStyleVar_FillAlpha
{ImGuiDataType_Float, 1, (ImU32)offsetof(ImPlot3DStyle, LineWeight)}, // ImPlot3DStyleVar_LineWeight
{ImGuiDataType_S32, 1, (ImU32)offsetof(ImPlot3DStyle, Marker)}, // ImPlot3DStyleVar_Marker
{ImGuiDataType_Float, 1, (ImU32)offsetof(ImPlot3DStyle, MarkerSize)}, // ImPlot3DStyleVar_MarkerSize
{ImGuiDataType_Float, 1, (ImU32)offsetof(ImPlot3DStyle, FillAlpha)}, // ImPlot3DStyleVar_FillAlpha

// Plot style
{ImGuiDataType_Float, 2, (ImU32)offsetof(ImPlot3DStyle, PlotDefaultSize)}, // ImPlot3DStyleVar_Plot3DDefaultSize
Expand Down Expand Up @@ -2765,10 +2808,6 @@ void StyleColorsAuto(ImPlot3DStyle* dst) {
ImPlot3DStyle* style = dst ? dst : &ImPlot3D::GetStyle();
ImVec4* colors = style->Colors;

colors[ImPlot3DCol_Line] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_Fill] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_MarkerOutline] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_MarkerFill] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_TitleText] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_InlayText] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_FrameBg] = IMPLOT3D_AUTO_COL;
Expand All @@ -2786,10 +2825,6 @@ void StyleColorsDark(ImPlot3DStyle* dst) {
ImPlot3DStyle* style = dst ? dst : &ImPlot3D::GetStyle();
ImVec4* colors = style->Colors;

colors[ImPlot3DCol_Line] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_Fill] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_MarkerOutline] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_MarkerFill] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_TitleText] = ImVec4(1.00f, 1.00f, 1.00f, 1.00f);
colors[ImPlot3DCol_InlayText] = ImVec4(1.00f, 1.00f, 1.00f, 1.00f);
colors[ImPlot3DCol_FrameBg] = ImVec4(1.00f, 1.00f, 1.00f, 0.07f);
Expand All @@ -2807,10 +2842,6 @@ void StyleColorsLight(ImPlot3DStyle* dst) {
ImPlot3DStyle* style = dst ? dst : &ImPlot3D::GetStyle();
ImVec4* colors = style->Colors;

colors[ImPlot3DCol_Line] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_Fill] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_MarkerOutline] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_MarkerFill] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_TitleText] = ImVec4(0.00f, 0.00f, 0.00f, 1.00f);
colors[ImPlot3DCol_InlayText] = ImVec4(0.00f, 0.00f, 0.00f, 1.00f);
colors[ImPlot3DCol_FrameBg] = ImVec4(1.00f, 1.00f, 1.00f, 1.00f);
Expand All @@ -2828,10 +2859,6 @@ void StyleColorsClassic(ImPlot3DStyle* dst) {
ImPlot3DStyle* style = dst ? dst : &ImPlot3D::GetStyle();
ImVec4* colors = style->Colors;

colors[ImPlot3DCol_Line] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_Fill] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_MarkerOutline] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_MarkerFill] = IMPLOT3D_AUTO_COL;
colors[ImPlot3DCol_TitleText] = ImVec4(0.90f, 0.90f, 0.90f, 1.00f);
colors[ImPlot3DCol_InlayText] = ImVec4(0.90f, 0.90f, 0.90f, 1.00f);
colors[ImPlot3DCol_FrameBg] = ImVec4(0.43f, 0.43f, 0.43f, 0.39f);
Expand Down Expand Up @@ -2970,6 +2997,14 @@ ImVec4 GetStyleColorVec4(ImPlot3DCol idx) { return IsColorAuto(idx) ? GetAutoCol

ImU32 GetStyleColorU32(ImPlot3DCol idx) { return ImGui::ColorConvertFloat4ToU32(ImPlot3D::GetStyleColorVec4(idx)); }

ImPlot3DMarker NextMarker() {
ImPlot3DContext& gp = *GImPlot3D;
IM_ASSERT_USER_ERROR(gp.CurrentItems != nullptr, "NextMarker() needs to be called between BeginPlot() and EndPlot()!");
const int idx = gp.CurrentItems->MarkerIdx % ImPlot3DMarker_COUNT;
++gp.CurrentItems->MarkerIdx;
return idx;
}

//------------------------------------------------------------------------------
// [SECTION] Colormaps
//------------------------------------------------------------------------------
Expand Down Expand Up @@ -3218,10 +3253,6 @@ bool IsColorAuto(ImPlot3DCol idx) { return IsColorAuto(GImPlot3D->Style.Colors[i

ImVec4 GetAutoColor(ImPlot3DCol idx) {
switch (idx) {
case ImPlot3DCol_Line: return IMPLOT3D_AUTO_COL; // Plot dependent
case ImPlot3DCol_Fill: return IMPLOT3D_AUTO_COL; // Plot dependent
case ImPlot3DCol_MarkerOutline: return IMPLOT3D_AUTO_COL; // Plot dependent
case ImPlot3DCol_MarkerFill: return IMPLOT3D_AUTO_COL; // Plot dependent
case ImPlot3DCol_TitleText: return ImGui::GetStyleColorVec4(ImGuiCol_Text);
case ImPlot3DCol_InlayText: return ImGui::GetStyleColorVec4(ImGuiCol_Text);
case ImPlot3DCol_FrameBg: return ImGui::GetStyleColorVec4(ImGuiCol_FrameBg);
Expand All @@ -3239,8 +3270,7 @@ ImVec4 GetAutoColor(ImPlot3DCol idx) {

const char* GetStyleColorName(ImPlot3DCol idx) {
static const char* color_names[ImPlot3DCol_COUNT] = {
"Line", "Fill", "MarkerOutline", "MarkerFill", "TitleText", "InlayText", "FrameBg", "PlotBg",
"PlotBorder", "LegendBg", "LegendBorder", "LegendText", "AxisText", "AxisGrid", "AxisTick",
"TitleText", "InlayText", "FrameBg", "PlotBg", "PlotBorder", "LegendBg", "LegendBorder", "LegendText", "AxisText", "AxisGrid", "AxisTick",
};
return color_names[idx];
}
Expand Down Expand Up @@ -3838,7 +3868,6 @@ ImPlot3DStyle::ImPlot3DStyle() {
LineWeight = 1.0f;
Marker = ImPlot3DMarker_None;
MarkerSize = 4.0f;
MarkerWeight = 1.0f;
FillAlpha = 1.0f;
// Plot style
PlotDefaultSize = ImVec2(400, 400);
Expand Down
Loading