egutierrez
96fcd05511
Auditoria del issue 0044: 9 archivos .md de cpp/functions/viz/ con uses_functions actualizado. Resuelve dependencias detectadas via #include: plot_static (consumido por bar_chart, histogram, line_plot, pie_chart, scatter_plot), gl_loader, gl_framebuffer, gl_shader, graph_force_layout, graph_renderer, graph_spatial_hash, orbit_camera, sparkline y tokens. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
48 lines
1.7 KiB
Markdown
48 lines
1.7 KiB
Markdown
---
|
|
name: histogram
|
|
kind: component
|
|
lang: cpp
|
|
domain: viz
|
|
version: "1.1.0"
|
|
purity: pure
|
|
signature: "void histogram(const char* title, const float* values, int count, int bins = -1, float height = 200.0f)"
|
|
description: "Histograma con bins automaticos, ejes lock (con AutoFit para bins dinamicos) y altura explicita"
|
|
tags: [implot, chart, visualization, gpu, histogram, distribution, locked-axes]
|
|
uses_functions: ["plot_static_cpp_viz"]
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: ""
|
|
imports: [implot]
|
|
tested: false
|
|
tests: []
|
|
test_file_path: ""
|
|
file_path: "cpp/functions/viz/histogram.cpp"
|
|
framework: imgui
|
|
params:
|
|
- name: title
|
|
desc: "Titulo del histograma / id interno"
|
|
- name: values
|
|
desc: "Array de valores numericos a distribuir en bins"
|
|
- name: count
|
|
desc: "Numero de valores en el array"
|
|
- name: bins
|
|
desc: "Numero de bins. -1 = automatico via regla de Sturges (ImPlotBin_Sturges). Positivo = numero explicito"
|
|
- name: height
|
|
desc: "Altura del plot en pixeles (default 200). Explicita para evitar feedback loops con AutoResizeY"
|
|
output: "Renderiza el histograma en el frame ImGui actual"
|
|
notes: "scaffolding/demo en primitives_gallery"
|
|
---
|
|
|
|
# histogram
|
|
|
|
Wrapper atomico sobre `ImPlot::PlotHistogram` con seleccion automatica del numero de bins.
|
|
|
|
## v1.1
|
|
|
|
- **Altura explicita** (`height`).
|
|
- **Ejes con Lock + AutoFit**: a diferencia de bar_chart/line_plot/scatter_plot, histogram necesita el primer fit para decidir limites segun los bins calculados internamente por ImPlot. `AutoFit` hace ese ajuste pero `Lock` bloquea pan/zoom posterior.
|
|
- Resto de flags estaticos via `plot_static::kPlotFlags`.
|
|
|
|
Cuando `bins == -1` usa `ImPlotBin_Sturges` (`ceil(log2(n)) + 1`).
|