Maintainer	Jeremy Nuttall <jeremy@jeremy-nuttall.com>
Stability	experimental
Safe Haskell	None
Language	GHC2021

Numeric.Noise.Cellular

Contents

Configuration
2D Noise

Description

Synopsis

data CellularConfig a = CellularConfig {
- cellularDistanceFn :: CellularDistanceFn
- cellularJitter :: a
- cellularResult :: CellularResult
}
defaultCellularConfig :: RealFrac a => CellularConfig a
data CellularDistanceFn
- = DistEuclidean
- | DistEuclideanSq
- | DistManhattan
- | DistHybrid
data CellularResult
- = CellValue
- | Distance
- | Distance2
- | Distance2Add
- | Distance2Sub
- | Distance2Mul
- | Distance2Div
noise2 :: (RealFrac a, Floating a) => CellularConfig a -> Noise2 a

Configuration

data CellularConfig a Source #

Configuration for cellular (Worley) noise generation.

Cellular noise is based on distances to randomly distributed cell points, creating a distinctive cellular or organic pattern.

Constructors

CellularConfig
Fields cellularDistanceFn :: CellularDistanceFn Distance metric to use when computing distance to cell points. cellularJitter :: a Amount of randomness in cell point positions. \( 0 \) creates a regular grid, \( 1 \) creates fully random positions. Values outside \( [0, 1] \) may produce unusual results. cellularResult :: CellularResult What value to return from the noise function.

Instances

Instances details

Generic (CellularConfig a) Source #

Instance details

Defined in Numeric.Noise.Cellular

Associated Types

type Rep (CellularConfig a)

Instance details

Defined in Numeric.Noise.Cellular

type Rep (CellularConfig a) = D1 ('MetaData "CellularConfig" "Numeric.Noise.Cellular" "pure-noise-0.2.1.0-4Gerhi0am1zGiIYaJVZKZH" 'False) (C1 ('MetaCons "CellularConfig" 'PrefixI 'True) (S1 ('MetaSel ('Just "cellularDistanceFn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 CellularDistanceFn) :*: (S1 ('MetaSel ('Just "cellularJitter") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 a) :*: S1 ('MetaSel ('Just "cellularResult") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 CellularResult))))

Methods

from :: CellularConfig a -> Rep (CellularConfig a) x #

to :: Rep (CellularConfig a) x -> CellularConfig a #

Show a => Show (CellularConfig a) Source #

Instance details

Defined in Numeric.Noise.Cellular

Methods

showsPrec :: Int -> CellularConfig a -> ShowS #

show :: CellularConfig a -> String #

showList :: [CellularConfig a] -> ShowS #

type Rep (CellularConfig a) Source #

Instance details

Defined in Numeric.Noise.Cellular

type Rep (CellularConfig a) = D1 ('MetaData "CellularConfig" "Numeric.Noise.Cellular" "pure-noise-0.2.1.0-4Gerhi0am1zGiIYaJVZKZH" 'False) (C1 ('MetaCons "CellularConfig" 'PrefixI 'True) (S1 ('MetaSel ('Just "cellularDistanceFn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 CellularDistanceFn) :*: (S1 ('MetaSel ('Just "cellularJitter") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 a) :*: S1 ('MetaSel ('Just "cellularResult") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 CellularResult))))

defaultCellularConfig :: RealFrac a => CellularConfig a Source #

Default configuration for cellular noise generation.

data CellularDistanceFn Source #

Distance function for cellular noise calculations.

Different distance metrics produce different visual characteristics in the cellular pattern.

Constructors

DistEuclidean	\( \sqrt{dx^2 + dy^2} \) - Creates circular cells with smooth edges.
DistEuclideanSq	\( dx^2 + dy^2 \) - Faster than `DistEuclidean` with similar appearance.
DistManhattan	\( \|dx\| + \|dy\| \) - Creates diamond-shaped cells with sharp edges.
DistHybrid	Hybrid of Euclidean and Manhattan distances.

Instances

Instances details

Bounded CellularDistanceFn Source #

Instance details

Defined in Numeric.Noise.Cellular

Methods

minBound :: CellularDistanceFn #

maxBound :: CellularDistanceFn #

Enum CellularDistanceFn Source #

Instance details

Defined in Numeric.Noise.Cellular

Methods

succ :: CellularDistanceFn -> CellularDistanceFn #

pred :: CellularDistanceFn -> CellularDistanceFn #

toEnum :: Int -> CellularDistanceFn #

fromEnum :: CellularDistanceFn -> Int #

enumFrom :: CellularDistanceFn -> [CellularDistanceFn] #

enumFromThen :: CellularDistanceFn -> CellularDistanceFn -> [CellularDistanceFn] #

enumFromTo :: CellularDistanceFn -> CellularDistanceFn -> [CellularDistanceFn] #

enumFromThenTo :: CellularDistanceFn -> CellularDistanceFn -> CellularDistanceFn -> [CellularDistanceFn] #

Generic CellularDistanceFn Source #

Instance details

Defined in Numeric.Noise.Cellular

Associated Types

type Rep CellularDistanceFn

Instance details

Defined in Numeric.Noise.Cellular

type Rep CellularDistanceFn = D1 ('MetaData "CellularDistanceFn" "Numeric.Noise.Cellular" "pure-noise-0.2.1.0-4Gerhi0am1zGiIYaJVZKZH" 'False) ((C1 ('MetaCons "DistEuclidean" 'PrefixI 'False) (U1 :: Type -> Type) :+: C1 ('MetaCons "DistEuclideanSq" 'PrefixI 'False) (U1 :: Type -> Type)) :+: (C1 ('MetaCons "DistManhattan" 'PrefixI 'False) (U1 :: Type -> Type) :+: C1 ('MetaCons "DistHybrid" 'PrefixI 'False) (U1 :: Type -> Type)))

Methods

from :: CellularDistanceFn -> Rep CellularDistanceFn x #

to :: Rep CellularDistanceFn x -> CellularDistanceFn #

Read CellularDistanceFn Source #

Instance details

Defined in Numeric.Noise.Cellular

Methods

readsPrec :: Int -> ReadS CellularDistanceFn #

readList :: ReadS [CellularDistanceFn] #

readPrec :: ReadPrec CellularDistanceFn #

readListPrec :: ReadPrec [CellularDistanceFn] #

Show CellularDistanceFn Source #

Instance details

Defined in Numeric.Noise.Cellular

Methods

showsPrec :: Int -> CellularDistanceFn -> ShowS #

show :: CellularDistanceFn -> String #

showList :: [CellularDistanceFn] -> ShowS #

Eq CellularDistanceFn Source #

Instance details

Defined in Numeric.Noise.Cellular

Methods

(==) :: CellularDistanceFn -> CellularDistanceFn -> Bool #

(/=) :: CellularDistanceFn -> CellularDistanceFn -> Bool #

Ord CellularDistanceFn Source #

Instance details

Defined in Numeric.Noise.Cellular

Methods

compare :: CellularDistanceFn -> CellularDistanceFn -> Ordering #

(<) :: CellularDistanceFn -> CellularDistanceFn -> Bool #

(<=) :: CellularDistanceFn -> CellularDistanceFn -> Bool #

(>) :: CellularDistanceFn -> CellularDistanceFn -> Bool #

(>=) :: CellularDistanceFn -> CellularDistanceFn -> Bool #

max :: CellularDistanceFn -> CellularDistanceFn -> CellularDistanceFn #

min :: CellularDistanceFn -> CellularDistanceFn -> CellularDistanceFn #

type Rep CellularDistanceFn Source #

Instance details

Defined in Numeric.Noise.Cellular

type Rep CellularDistanceFn = D1 ('MetaData "CellularDistanceFn" "Numeric.Noise.Cellular" "pure-noise-0.2.1.0-4Gerhi0am1zGiIYaJVZKZH" 'False) ((C1 ('MetaCons "DistEuclidean" 'PrefixI 'False) (U1 :: Type -> Type) :+: C1 ('MetaCons "DistEuclideanSq" 'PrefixI 'False) (U1 :: Type -> Type)) :+: (C1 ('MetaCons "DistManhattan" 'PrefixI 'False) (U1 :: Type -> Type) :+: C1 ('MetaCons "DistHybrid" 'PrefixI 'False) (U1 :: Type -> Type)))

data CellularResult Source #

What value to return from cellular noise evaluation.

These options allow for different visual effects by returning different properties of the cell structure.

Constructors

CellValue	Return the hash value of the nearest cell point. Creates discrete regions with constant values.
Distance	Return the distance to the nearest cell point. Creates a classic Worley noise pattern with cell boundaries.
Distance2	Return the distance to the second-nearest cell point. Creates larger, more organic-looking cells.
Distance2Add	Return the sum of distances to the two nearest cell points. Creates smooth, rounded cells.
Distance2Sub	Return the difference between distances to the two nearest cell points. Emphasizes cell boundaries and creates sharp edges.
Distance2Mul	Return the product of distances to the two nearest cell points. Creates cells with varying contrast.
Distance2Div	Return the ratio of nearest to second-nearest distance. Creates normalized cell patterns.