fn_registry/cpp/functions/gfx/gpu_compute_program.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

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
gpu_compute_program	function	cpp	gfx	1.0.0	impure	ComputeCompileResult compile_compute(const std::string& user_body, int local_size_x, const std::string& preamble); ComputeCompileResult compile_compute_2d(const std::string& user_body, int local_size_x, int local_size_y, const std::string& preamble); void delete_compute_program(unsigned int program)	Compila compute shaders GLSL 4.3 prepending automaticamente #version, layout(local_size_*) y un preamble opcional. Devuelve CompileResult con program GL listo o err_msg/err_line. Pareja para fragments de gl_shader pero para computes.	opengl compute shader glsl compile gpu gfx	gl_loader_cpp_gfx			false	error_go_core	GL/gl.h GL/glext.h regex	false			cpp/functions/gfx/gpu_compute_program.cpp	opengl	name desc user_body Cuerpo del compute shader: declaraciones de SSBOs (layout std430 binding=N), uniforms, helpers y void main(). NO debe llevar #version ni layout(local_size_*). name desc local_size_x Numero de invocaciones por workgroup en X. Defaults: 64 (1D), 8 (2D). name desc local_size_y Variante 2D: invocaciones por workgroup en Y. Default 8. name desc preamble GLSL opcional inyectado entre layout y user_body. Aqui se inyectan los snippets de gpu_rng_glsl o helpers comunes.	ComputeCompileResult con program=GL id si ok=true; si ok=false, err_line apunta al user_body (no al header) y err_msg trae el log completo de glGetShaderInfoLog/glGetProgramInfoLog.

gpu_compute_program

Mismo patron que gl_shader::compile_fragment, especializado para compute shaders 4.3+.

Estructura del shader resultante

#version 430 core
layout(local_size_x = <local_size_x>) in;   // o local_size_x,y para 2D
<preamble>                                  // opcional: rng, helpers
<user_body>                                 // declaraciones + main()

El err_line se ajusta restando las lineas del header para que apunte al texto que el caller escribio.

Ejemplo basico

const char* body = R"glsl(
layout(std430, binding = 0) buffer Out { float vals[]; };
uniform uint u_count;
void main() {
    uint i = gl_GlobalInvocationID.x;
    if (i >= u_count) return;
    vals[i] = float(i) * 0.5;
}
)glsl";

auto r = fn::gfx::compile_compute(body, 64);
if (!r.ok) {
    std::fprintf(stderr, "line %d: %s\n", r.err_line, r.err_msg.c_str());
    return;
}
glUseProgram(r.program);

Con preamble (RNG inyectado)

auto rng = fn::gfx::glsl_rng_preamble(/*seed_binding=*/9);
auto r = fn::gfx::compile_compute(body, 64, rng);

El user_body ya puede llamar rng_uniform(i), rng_normal(i) etc. — definidas por el preamble.

Notas

• El context GL debe ser current y gl_loader_init() ya invocado.
• Tras un delete_compute_program el id queda invalido para todos los glUseProgram posteriores.
• Liberar siempre con delete_compute_program para evitar leaks (el destructor de C++ no lo hace porque program es un unsigned int).