Struct GpuBoids 

pub struct GpuBoids;

Boids flocking as a GpuAgentModel, seeded through BoidsModel::init.

Trait Implementations

impl Debug for GpuBoids

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl GpuAgentModel for GpuBoids

const BUFFERS: &'static [BufferSpec] = BUFFER_SPECS

Position, velocity and colour, each double buffered, since a boid reads its neighbours’ current values while writing its own next values.

const REPLAYS_EXACTLY: bool = false

The neighbour index leaves the order of boids within a cell to the GPU.

const REDUCE: ReduceSpec

Reduction of three lanes: speed, x velocity and y velocity.

const NAME: &'static str = "Boids Flocking (GPU)"

Name shown in the UI.

const ID: &'static str = "gpu_boids"

Stable id that identifies the model in a model set, on the command line and in a spec file.

const DESCRIPTION: &'static str = "A simulation of flocking behavior in a group of boids, stepped entirely on the GPU"

One-line description shown in the UI.

const STATS: &'static [StatDescriptor] = BoidsModel::STATS

Stat series for the history chart. Declared once, so Self::stats returns bare values.

const POS_BUFFER: usize = POS

Index into Self::BUFFERS of the vec2<f32> positions that the view draws.

const COLOR_BUFFER: usize = COLOR

Index into Self::BUFFERS of the packed RGBA that the view draws.

const INDEX: bool = true

Whether the engine rebuilds a neighbour index from the positions before every step.

const STEP_PASSES: &'static [PassSpec]

Passes of one step, run in declaration order.

const ACTIONS: &'static [GpuAgentAction]

One-off passes the user can trigger. Each gets a button in the Parameters panel.

fn param_descriptors() -> Vec<ParamDescriptor>

Returns the full descriptor list.

fn dims(params: &[ParamValue]) -> (u32, Extent)

Returns the population and the world extent for these params. The engine clamps the population and each axis of the extent to at least 1.

fn buffer_lens(geom: &Geometry) -> Vec<usize>

Returns the length in u32-sized elements of each buffer, one per Self::BUFFERS entry.

fn seed_buffers( geom: &Geometry, params: &[ParamValue], seed: Option<u64>, ) -> Vec<Vec<u8>>

Returns the initial contents of each buffer as raw bytes, one vector per Self::BUFFERS entry.

fn index_cell_size(params: &[ParamValue]) -> f32

Returns the neighbour index’s cell size for these params.

fn pass_params_bytes( pass: PassId, ctx: PassCtx<'_>, params: &[ParamValue], ) -> Vec<u8>

Returns the uniform block of pass as raw bytes.

fn stats(sums: &[f32], _counters: &[u32], geom: &Geometry) -> Vec<StatValue>

Turns the reduction and the counters into values, in Self::STATS order.

const COUNTERS: usize = 0

Number of persistent u32 counters that a kernel accumulates into.

const DISPLAY: Option<DisplaySpec> = None

Display pass, for a model that draws a grid layer under its agents.