Skip to main content

quick_noise/api/grid/
warp.rs

1use std::iter::zip;
2use std::marker::PhantomData;
3
4use crate::api::batch::interface::DimIter;
5use crate::api::batch::multizip;
6use crate::simd::{Arch, Simd};
7use crate::{BatchGenerator, BatchNoiseBuilder, Combiner, Grid};
8
9/// Creates a builder struct for warping noise.
10///
11/// # Type Parameters
12/// - `C`: The combiner algorithm to use across octaves.
13/// - `G`: The generator algorithm to sample from.
14///
15/// # Parameters
16/// - `warp_strength`: How strongly the warp is applied.
17/// - `x_iter`: An iterator of warp values to distort each sample's x input.
18/// - `y_iter`: An iterator of warp values to distort each sample's y input.
19impl<A: Arch> Grid<2, A> {
20    pub fn warp_builder<C: Combiner, G: BatchGenerator<2>>(
21        &self,
22        warp_strength: f32,
23        x_iter: impl Iterator<Item = Simd<f32, A>>,
24        y_iter: impl Iterator<Item = Simd<f32, A>>,
25    ) -> BatchNoiseBuilder<2, C, G, A, impl DimIter<A, 2>> {
26        let strength = Simd::splat(warp_strength);
27        let x_iter = zip(x_iter, self.x_iter()).map(move |(x, grid)| x.mul_add(strength, grid));
28        let y_iter = zip(y_iter, self.y_iter()).map(move |(y, grid)| y.mul_add(strength, grid));
29
30        BatchNoiseBuilder {
31            iters: multizip((x_iter, y_iter)),
32            noise_config: Default::default(),
33            combiner_config: Default::default(),
34            _noise_type: PhantomData::<G>,
35            _arch: PhantomData::<A>,
36        }
37    }
38}
39
40/// Creates a builder struct for warping noise.
41///
42/// # Type Parameters
43/// - `C`: The combiner algorithm to use across octaves.
44/// - `G`: The generator algorithm to sample from.
45///
46/// # Parameters
47/// - `warp_strength`: How strongly the warp is applied.
48/// - `x_iter`: An iterator of warp values to distort each sample's x input.
49/// - `y_iter`: An iterator of warp values to distort each sample's y input.
50/// - `z_iter`: An iterator of warp values to distort each sample's z input.
51impl<A: Arch> Grid<3, A> {
52    pub fn warp_builder<C: Combiner, G: BatchGenerator<3>>(
53        &self,
54        warp_strength: f32,
55        x_iter: impl Iterator<Item = Simd<f32, A>>,
56        y_iter: impl Iterator<Item = Simd<f32, A>>,
57        z_iter: impl Iterator<Item = Simd<f32, A>>,
58    ) -> BatchNoiseBuilder<3, C, G, A, impl DimIter<A, 3>> {
59        let strength = Simd::splat(warp_strength);
60        let x_iter = zip(x_iter, self.x_iter()).map(move |(x, grid)| x.mul_add(strength, grid));
61        let y_iter = zip(y_iter, self.y_iter()).map(move |(y, grid)| y.mul_add(strength, grid));
62        let z_iter = zip(z_iter, self.z_iter()).map(move |(z, grid)| z.mul_add(strength, grid));
63
64        BatchNoiseBuilder {
65            iters: multizip((x_iter, y_iter, z_iter)),
66            noise_config: Default::default(),
67            combiner_config: Default::default(),
68            _noise_type: PhantomData::<G>,
69            _arch: PhantomData::<A>,
70        }
71    }
72}