jacobi_diffusion()

Portal::Graphics::ShaderSpec MayaFlux::Buffers::RelaxationSpecs::jacobi_diffusion ( )

inline

Jacobi-style diffusion rule: each cell blends toward the average of its 8 Moore neighbors.

Built on KernelTemplate::Stencil with KernelOp::WeightedBlend. PC layout is width, height, rate, neighbor_scale. Supply rate and neighbor_scale through GridConfig::Stage::constants in that order. A neighbor_scale of 1/8 produces a true average over the eight Moore neighbors.

Definition at line 21 of file RelaxationSpecs.hpp.

{
    auto spec = ShaderSpec::Assemble {}
                    .tmpl(KernelTemplate::Stencil)
                    .ssbo("state_in", BindingDirection::Input, Kakshya::GpuDataFormat::FLOAT32)
                    .ssbo("state_out", BindingDirection::Output, Kakshya::GpuDataFormat::FLOAT32)
                    .pc("width", Kakshya::GpuDataFormat::UINT32)
                    .pc("height", Kakshya::GpuDataFormat::UINT32)
                    .pc("rate", Kakshya::GpuDataFormat::FLOAT32)
                    .pc("neighbor_scale", Kakshya::GpuDataFormat::FLOAT32)
                    .op(KernelOp::WeightedBlend)
                    .workgroup(16, 16)
                    .build();
    return spec;
}

References MayaFlux::Portal::Graphics::ShaderSpec::Assemble::build(), MayaFlux::Kakshya::FLOAT32, MayaFlux::Portal::Graphics::ShaderSpec::Assemble::op(), MayaFlux::Portal::Graphics::ShaderSpec::Assemble::pc(), MayaFlux::Portal::Graphics::ShaderSpec::Assemble::ssbo(), MayaFlux::Portal::Graphics::ShaderSpec::Assemble::tmpl(), MayaFlux::Kakshya::UINT32, and MayaFlux::Portal::Graphics::ShaderSpec::Assemble::workgroup().

Here is the call graph for this function: