65 lines
2.8 KiB
Markdown
65 lines
2.8 KiB
Markdown
---
|
|
name: pie_chart
|
|
kind: component
|
|
lang: cpp
|
|
domain: viz
|
|
version: "1.1.0"
|
|
purity: pure
|
|
signature: "void pie_chart(const char* title, const char* const* labels, const float* values, int count, float radius = 0.0f, float height = 200.0f)"
|
|
description: "Pie/donut chart con ImPlot, ejes pineados, altura explicita y tooltip por slice al pasar el mouse"
|
|
tags: [implot, chart, visualization, gpu, pie, donut, tooltip, locked-axes]
|
|
uses_functions: ["plot_static_cpp_viz"]
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: ""
|
|
imports: [implot]
|
|
tested: true
|
|
tests:
|
|
- "slice_at returns -1 outside radius"
|
|
- "slice_at on cursor at center returns first slice"
|
|
- "slice_at directly above center returns first slice"
|
|
- "slice_at right of center hits second slice (CCW)"
|
|
- "slice_at single slice always returns 0"
|
|
- "slice_at right at radius edge"
|
|
- "slice_at unequal slices distributes proportionally"
|
|
test_file_path: "cpp/tests/test_pie_chart_math.cpp"
|
|
file_path: "cpp/functions/viz/pie_chart.cpp"
|
|
framework: imgui
|
|
params:
|
|
- name: title
|
|
desc: "Titulo del grafico (se usa tambien como id interno del plot)"
|
|
- name: labels
|
|
desc: "Array de etiquetas para cada segmento del pie"
|
|
- name: values
|
|
desc: "Array de valores numericos para cada segmento"
|
|
- name: count
|
|
desc: "Numero de segmentos (longitud de labels y values)"
|
|
- name: radius
|
|
desc: "Radio del pie (0 = auto 0.4). Positivo = radio explicito. Negativo = modo donut con outer radius = |radius|"
|
|
- name: height
|
|
desc: "Altura del plot en pixeles (default 200). Explicita para evitar feedback loops con contenedores AutoResizeY"
|
|
output: "Renderiza el pie en el frame ImGui actual; muestra tooltip con label + valor + % al pasar por encima de un slice"
|
|
notes: "scaffolding/demo en primitives_gallery"
|
|
---
|
|
|
|
# pie_chart
|
|
|
|
Wrapper atomico sobre `ImPlot::PlotPieChart` configurado para visualizacion estatica en dashboards. Modo pie (`radius >= 0`) o donut (`radius < 0`).
|
|
|
|
## v1.1 (2026-04-24)
|
|
|
|
- **Altura explicita** (`height`): necesaria para evitar vibracion en contenedores con `AutoResizeY`. Ver `viz/plot_static.h`.
|
|
- **Flags compartidos** desde `plot_static::kPlotFlags` + `kAxisFlagsHidden` (axis decorations off): sin pan/zoom, sin menus, sin auto-fit, sin highlight al hover.
|
|
- **Tooltip por slice**: calcula que slice esta bajo el cursor usando `atan2(mouse - center)` (ImPlot dibuja slices en sentido CCW matematico desde angulo 90°, arriba) y muestra `label + valor + porcentaje`.
|
|
- Aspect 1:1 mantenido con `ImPlotFlags_Equal` para que el pie no se deforme en paneles rectangulares.
|
|
|
|
## Ejemplo
|
|
|
|
```cpp
|
|
const char* labels[] = {"Pure", "Impure"};
|
|
float values[] = {412, 187};
|
|
pie_chart("##purity", labels, values, 2); // pie normal, h=200
|
|
pie_chart("##purity", labels, values, 2, -0.4f, 260.0f); // donut, h=260
|
|
```
|