artlib.noise.opensimplex — com.dedovic/artlib-core 0.0.14

Clojure bindings for OpenSimplex2 noise functions. All functions take an optional seed value and return noise in the range [-1, 1]. When seed is not provided, uses value from global seed atom.

get-seed clj

(get-seed)

Get the current global seed value.

noise2 clj

(noise2 x y)

(noise2 seed x y)

2D Simplex noise with standard lattice orientation. Returns values in the range [-1, 1]. Optional seed parameter - uses global seed atom if not provided.

noise2-improve-x clj

(noise2-improve-x x y)

(noise2-improve-x seed x y)

2D Simplex noise with Y pointing down the main diagonal. Better suited for 2D sandbox games where Y is vertical. Consider using standard noise2 for heightmaps or continent maps unless your map is centered around an equator. Returns values in the range [-1, 1]. Optional seed parameter - uses global seed atom if not provided.

noise2-improve-x-norm clj

(noise2-improve-x-norm x y)

(noise2-improve-x-norm seed x y)

2D Simplex noise with Y pointing down the main diagonal. Better suited for 2D sandbox games where Y is vertical. Consider using standard noise2 for heightmaps or continent maps unless your map is centered around an equator. Returns values in the range [0, 1]. Optional seed parameter - uses global seed atom if not provided.

noise2-norm clj

(noise2-norm x y)

(noise2-norm seed x y)

2D Simplex noise with standard lattice orientation. Returns values in the range [0, 1]. Optional seed parameter - uses global seed atom if not provided.

noise3 clj

(noise3 x y z)

(noise3 seed x y z)

3D OpenSimplex2 noise using fallback rotation option. Consider using noise3-improve-xy or noise3-improve-xz instead where appropriate, as they have less diagonal bias. Best used as a fallback option. Returns values in the range [-1, 1]. Optional seed parameter - uses global seed atom if not provided.

noise3-improve-xy clj

(noise3-improve-xy x y z)

(noise3-improve-xy seed x y z)

3D OpenSimplex2 noise with better visual isotropy in (X, Y). Recommended for 3D terrain and time-varied animations where Z is vertical or represents time.

Usage patterns:

• If Y is vertical: (noise3-improve-xz x z y)
• If Z is vertical: (noise3-improve-xy x y z)
• For time animation: (noise3-improve-xy x y t)

Returns values in the range [-1, 1]. Optional seed parameter - uses global seed atom if not provided.

noise3-improve-xy-norm clj

(noise3-improve-xy-norm x y z)

(noise3-improve-xy-norm seed x y z)

3D OpenSimplex2 noise with better visual isotropy in (X, Y). Recommended for 3D terrain and time-varied animations where Z is vertical or represents time.

Usage patterns:

• If Y is vertical: (noise3-improve-xz x z y)
• If Z is vertical: (noise3-improve-xy x y z)
• For time animation: (noise3-improve-xy x y t)

Returns values in the range [0, 1]. Optional seed parameter - uses global seed atom if not provided.

noise3-improve-xz clj

(noise3-improve-xz x y z)

(noise3-improve-xz seed x y z)

3D OpenSimplex2 noise with better visual isotropy in (X, Z). Recommended for 3D terrain and time-varied animations where Y is vertical or represents time.

Usage patterns:

• If Y is vertical: (noise3-improve-xz x y z)
• If Z is vertical: Use noise3-improve-xy instead
• For time animation: (noise3-improve-xz x t z) or use noise3-improve-xy

Returns values in the range [-1, 1]. Optional seed parameter - uses global seed atom if not provided.

noise3-improve-xz-norm clj

(noise3-improve-xz-norm x y z)

(noise3-improve-xz-norm seed x y z)

3D OpenSimplex2 noise with better visual isotropy in (X, Z). Recommended for 3D terrain and time-varied animations where Y is vertical or represents time.

Usage patterns:

• If Y is vertical: (noise3-improve-xz x y z)
• If Z is vertical: Use noise3-improve-xy instead
• For time animation: (noise3-improve-xz x t z) or use noise3-improve-xy

Returns values in the range [0, 1]. Optional seed parameter - uses global seed atom if not provided.

noise3-norm clj

(noise3-norm x y z)

(noise3-norm seed x y z)

3D OpenSimplex2 noise using fallback rotation option. Consider using noise3-improve-xy or noise3-improve-xz instead where appropriate, as they have less diagonal bias. Best used as a fallback option. Returns values in the range [0, 1]. Optional seed parameter - uses global seed atom if not provided.

noise4 clj

(noise4 x y z w)

(noise4 seed x y z w)

4D OpenSimplex2 noise using fallback lattice orientation. Consider using one of the other 4D noise functions if their specific characteristics match your use case. Returns values in the range [-1, 1]. Optional seed parameter - uses global seed atom if not provided.

noise4-improve-xy-improve-zw clj

(noise4-improve-xy-improve-zw x y z w)

(noise4-improve-xy-improve-zw seed x y z w)

4D OpenSimplex2 noise with XY and ZW forming orthogonal triangular-based planes. Recommended for:

• 3D terrain where X and Y (or Z and W) are horizontal
• noise(x, y, sin(time), cos(time)) animations Returns values in the range [-1, 1]. Optional seed parameter - uses global seed atom if not provided.

noise4-improve-xy-improve-zw-norm clj

(noise4-improve-xy-improve-zw-norm x y z w)

(noise4-improve-xy-improve-zw-norm seed x y z w)

4D OpenSimplex2 noise with XY and ZW forming orthogonal triangular-based planes. Recommended for:

• 3D terrain where X and Y (or Z and W) are horizontal
• noise(x, y, sin(time), cos(time)) animations Returns values in the range [0, 1]. Optional seed parameter - uses global seed atom if not provided.

noise4-improve-xyz clj

(noise4-improve-xyz x y z w)

(noise4-improve-xyz seed x y z w)

4D OpenSimplex2 noise with XYZ oriented like noise3 and W providing an extra degree of freedom (repeats eventually). Recommended for time-varied animations texturing 3D objects (W=time) where there isn't a clear distinction between horizontal and vertical. Returns values in the range [-1, 1]. Optional seed parameter - uses global seed atom if not provided.

noise4-improve-xyz-improve-xy clj

(noise4-improve-xyz-improve-xy x y z w)

(noise4-improve-xyz-improve-xy seed x y z w)

4D OpenSimplex2 noise with XYZ oriented like noise3-improve-xy and W providing an extra degree of freedom (repeats eventually). Recommended for time-varied animations texturing 3D objects (W=time) in spaces where Z is vertical. Returns values in the range [-1, 1]. Optional seed parameter - uses global seed atom if not provided.

noise4-improve-xyz-improve-xy-norm clj

(noise4-improve-xyz-improve-xy-norm x y z w)

(noise4-improve-xyz-improve-xy-norm seed x y z w)

4D OpenSimplex2 noise with XYZ oriented like noise3-improve-xy and W providing an extra degree of freedom (repeats eventually). Recommended for time-varied animations texturing 3D objects (W=time) in spaces where Z is vertical. Returns values in the range [0, 1]. Optional seed parameter - uses global seed atom if not provided.

noise4-improve-xyz-improve-xz clj

(noise4-improve-xyz-improve-xz x y z w)

(noise4-improve-xyz-improve-xz seed x y z w)

4D OpenSimplex2 noise with XYZ oriented like noise3-improve-xz and W providing an extra degree of freedom (repeats eventually). Recommended for time-varied animations texturing 3D objects (W=time) in spaces where Y is vertical. Returns values in the range [-1, 1]. Optional seed parameter - uses global seed atom if not provided.

noise4-improve-xyz-improve-xz-norm clj

(noise4-improve-xyz-improve-xz-norm x y z w)

(noise4-improve-xyz-improve-xz-norm seed x y z w)

4D OpenSimplex2 noise with XYZ oriented like noise3-improve-xz and W providing an extra degree of freedom (repeats eventually). Recommended for time-varied animations texturing 3D objects (W=time) in spaces where Y is vertical. Returns values in the range [0, 1]. Optional seed parameter - uses global seed atom if not provided.

noise4-improve-xyz-norm clj

(noise4-improve-xyz-norm x y z w)

(noise4-improve-xyz-norm seed x y z w)

4D OpenSimplex2 noise with XYZ oriented like noise3 and W providing an extra degree of freedom (repeats eventually). Recommended for time-varied animations texturing 3D objects (W=time) where there isn't a clear distinction between horizontal and vertical. Returns values in the range [0, 1]. Optional seed parameter - uses global seed atom if not provided.

noise4-norm clj

(noise4-norm x y z w)

(noise4-norm seed x y z w)

4D OpenSimplex2 noise using fallback lattice orientation. Consider using one of the other 4D noise functions if their specific characteristics match your use case. Returns values in the range [0, 1]. Optional seed parameter - uses global seed atom if not provided.

set-seed! clj

(set-seed! new-seed)

Set the global seed used by all noise functions when no explicit seed is provided.