fn_registry/cpp/functions/viz/gauge.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, tested, tests, test_file_path, file_path, framework, params, output, notes

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	tested	tests	test_file_path	file_path	framework	params	output	notes
gauge	component	cpp	viz	1.0.0	pure	void gauge(const char* label, float value, float min_val, float max_val, float radius = 60.0f)	Renderiza un indicador circular tipo gauge/velocimetro usando ImGui draw primitives	imgui visualization gauge kpi dashboard pendiente-usar				false		imgui	false			cpp/functions/viz/gauge.cpp	imgui	name desc label Etiqueta del gauge, se muestra centrada debajo del valor numerico name desc value Valor actual a mostrar en el gauge name desc min_val Valor minimo de la escala (extremo izquierdo del arco) name desc max_val Valor maximo de la escala (extremo derecho del arco) name desc radius Radio del gauge en pixels (default 60.0)	Renderiza el gauge en el frame ImGui actual, reservando espacio con ImGui::Dummy	scaffolding/demo en primitives_gallery

gauge

Indicador circular tipo gauge/velocimetro construido sobre ImGui draw primitives. No requiere ImPlot.

El arco ocupa 240 grados (de 150deg a 390deg en sentido horario). El color del arco de valor interpolado de verde (minimo) a amarillo (mitad) a rojo (maximo). Una aguja blanca apunta al valor actual.

Debe llamarse dentro del render callback de fn::run_app (o cualquier contexto con un frame ImGui activo).

Ejemplo

// KPI card con gauge de temperatura
gauge("CPU Temp", 72.5f, 0.0f, 100.0f, 50.0f);

// Gauge grande para dashboard principal
gauge("Velocidad", 3200.0f, 0.0f, 5000.0f, 80.0f);

Notas

• El arco de fondo es gris oscuro (IM_COL32(60,60,60,220)), 6px de grosor.
• La aguja tiene longitud del 75% del radio para evitar solapar el arco.
• Usa solo float; no ofrece overload double porque ImGui DrawList trabaja en coordenadas de pantalla (float).
• El espacio reservado es diameter x (diameter + line_height) para incluir la etiqueta.