Files
fn_registry/cpp/functions/viz/plot_static.md
T
egutierrez 3f622561ce feat(cpp/viz): static-plot primitive + tooltips + rotated labels + card compacta
Nuevo primitivo compartido:
- cpp/functions/viz/plot_static.h: header-only con flags ImPlotFlags /
  ImPlotAxisFlags agrupados (NoFrame|NoMenus|NoBoxSelect|NoMouseText +
  Lock|NoInitialFit|NoHighlight) para visualizacion estatica en
  dashboards. Lo usan todos los charts de viz/.

Charts refactorizados a v1.1 con parametro `height` explicito (rompe el
feedback loop con contenedores AutoResizeY que producia vibracion al
redimensionar) y ejes pineados con ImPlotCond_Always:
- bar_chart v1.2: tooltip al hover (label + valor) + auto-rotacion de
  labels a 45 cuando no caben horizontalmente (medidos con CalcTextSize
  vs ancho del plot). Los labels rotados se dibujan manualmente con
  ImDrawList::PrimQuadUV + ImFontBaked::FindGlyph (API ImGui 1.92+).
- pie_chart v1.1: tooltip por slice (detecta cual via atan2 desde centro
  en sentido CCW matematico, que es como ImPlot dibuja los slices desde
  angle0=90) con label + valor + porcentaje. Aspect 1:1 mantenido.
- line_plot, scatter_plot, histogram v1.1: ejes pineados con limites
  calculados de min/max + 5% headroom (histogram usa AutoFit por los
  bins dinamicos, con Lock para bloquear pan/zoom).

kpi_card v1.2: card mas compacta — altura 78px (antes 108), font scale
1.4x (antes 1.8x), padding sm (antes md). Apto para densidades altas
de KPIs en dashboards.

fullscreen_window v0.2: NoScrollbar|NoScrollWithMouse para eliminar el
scrollbar fugaz que aparecia cuando el contenido excedia por 1-2px la
ventana, reflow de ancho y vibracion visible al redimensionar.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 21:31:00 +02:00

63 lines
2.5 KiB
Markdown

---
name: plot_static
kind: component
lang: cpp
domain: viz
version: "1.0.0"
purity: pure
signature: "namespace plot_static { constexpr ImPlotFlags kPlotFlags; constexpr ImPlotAxisFlags kAxisFlags; constexpr ImPlotAxisFlags kAxisFlagsHidden; }"
description: "Flags compartidos para graficos de visualizacion estatica (dashboards). Sin inputs, sin auto-fit, ejes lock. Header-only, sin .cpp"
tags: [implot, dashboard, static, lock, locked-axes, flags]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: ""
imports: [implot]
tested: false
tests: []
test_file_path: ""
file_path: "cpp/functions/viz/plot_static.h"
framework: imgui
params: []
output: "Header-only con constantes ImPlotFlags/ImPlotAxisFlags agrupadas"
---
# plot_static
Header-only con constantes para configurar cualquier plot de ImPlot como *static visualization* (dashboard mode): sin pan/zoom, sin auto-fit, sin menus, sin highlight al hover.
Sirve de base para todos los graficos atomicos de `cpp/functions/viz/` (bar_chart, pie_chart, line_plot, scatter_plot, histogram, heatmap, candlestick). Usarlo garantiza que cualquier chart en un dashboard quede congelado entre frames — ImPlot por defecto deja pan/zoom + auto-fit del primer frame, y en un dashboard eso produce:
- Barras "deslizandose" al abrir la ventana (auto-fit animation).
- Ejes vibrando al redimensionar (ticks recalculan rangos).
- Menus al right-click (ruido).
## Constantes
| Constante | Combina | Para |
|-----------|---------|------|
| `kPlotFlags` | `NoInputs | NoFrame | NoMenus | NoBoxSelect | NoMouseText` | Plot canvas puro, sin interaccion |
| `kAxisFlags` | `NoMenus | Lock | NoInitialFit | NoHighlight` | Ejes visibles pero pineados |
| `kAxisFlagsHidden` | `kAxisFlags + NoDecorations + NoGridLines` | Pies, heatmaps (ejes decorativos) |
## Ejemplo
```cpp
#include "viz/plot_static.h"
if (ImPlot::BeginPlot("##chart", ImVec2(-1, 200), plot_static::kPlotFlags)) {
ImPlot::SetupAxes(nullptr, nullptr,
plot_static::kAxisFlags,
plot_static::kAxisFlags);
ImPlot::SetupAxisLimits(ImAxis_X1, 0.0, 100.0, ImPlotCond_Always);
ImPlot::SetupAxisLimits(ImAxis_Y1, 0.0, y_max, ImPlotCond_Always);
ImPlot::PlotLine("series", xs, ys, count);
ImPlot::EndPlot();
}
```
## Regla
**Cualquier grafico nuevo en `cpp/functions/viz/` pensado para dashboards debe usar estos flags.** Si el grafico es interactivo (permite zoom, pan, selection) usar flags de ImPlot directamente en lugar de estos.