view release on metacpan or  search on metacpan

lib/Algorithm/Gutter.pm  view on Meta::CPAN

simulate rain (up to the caller) and to redistribute the fluid between
adjacent cells (with a slow and simple algorithm).

Productive uses (dubious--discuss) include procedural generation, in
particular music composition where one may want rhythmic effects similar
to water accumulating and then dripping out of a rain gutter.

The cells are held in an array reference (the B<gutter>); the caller may
need to fiddle around with the cells directly simulate various effects.

Various methods may throw errors, for example if a cell lacks an update
callback function. Such callbacks are not mandatory to give the caller
flexibility in wiring up the gutter in fancy ways.

=head1 FIELDS

=over 4

=item B<gutter>

An optional array reference of objects that conform to the