clisk.functions — net.mikera/clisk 0.11.0

Functions for clisk image synthesis. Images should be generated by composing these functions.

affine-transform clj

(affine-transform matrix-rows)

(affine-transform matrix-rows src)

Performs an affine transformation (implicitly appends a 1 as final row of the input vector)

alpha clj

(alpha v)

Extracts the alpha component of a colour vector. Assumes 1.0 if not present.

apply-to-components clj

(apply-to-components f v)

Applies a function f to all components of a vector

average clj

(average & vs)

c clj

A special node that evaluates to the c vector. Used as initial fractal position

C-SYMBOLS clj

A vector of position symbols.

check-dims clj

(check-dims & vectors)

clamp clj

(clamp v low high)

colour-map clj

(colour-map mapping)

(colour-map mapping x)

Creates a colour map function using a set of value-colour mappings

component clj

components clj

compose clj

(compose f g)

(compose f g & more)

Composes two or more vector functions

cross3 clj

(cross3 a b)

Returns the cross product of 2 3D vectors

diffuse-light clj

(diffuse-light light-colour light-direction normal-direction)

Calculate the diffuse light on a surface normal vector. This function performs its own normalisation, so neither the light vector nor the normal vector need to be normalised.

dimensions clj

dot clj

(dot a b)

Returns the dot product of two vectors

ensure-scalar clj

(ensure-scalar x)

evaluate clj

frac clj

(frac x)

Retuns the fractional part of a number. Equivalent to Math/floor.

fractal clj

(fractal &
         {:keys [init while update result bailout-result max-iterations]
          :or {init pos}})

gradient clj

(gradient f)

Computes the gradient of a scalar function f with respect to [x y z t]

height clj

(height f)

Calculates the height value (z) of a source function

height-normal clj

(height-normal heightmap)

(height-normal scale heightmap)

Calculates a vector normal to the surface defined by the z-value of a source vector or a scalar height value. The result is not normalised.

image-filter clj

(image-filter filter source & {:keys [size width height]})

Applies a BufferedImageOp filter to a source image or function.

If size, width of height is specified, renders function at the specified resolution.

length clj

(length a)

Calculates the length of a vector

lerp clj

Performs clamped linear interpolation between two vectors, according to the proportion given in the 3rd parameter.

let-vector clj macro

(let-vector bindings form)

let a vector value into each component of a function

light-value clj

(light-value light-direction normal-direction)

Calculates diffuse light intensity given a light direction and a surface normal vector. This function performs its own normalisation, so neither the light vector nor the normal vector need to be normalised.

limited-loop clj macro

(limited-loop limit [& bindings] form)

limited-recur clj macro

(limited-recur bailout-result & values)

matrix clj

(matrix rows)

Creates a matrix multiplication function

matrix-transform clj

(matrix-transform matrix-rows)

(matrix-transform matrix-rows src)

Performs a matrix transformation on the given source

max-component clj

(max-component v)

Returns the max component of a vector

min-component clj

(min-component v)

Returns the min component of a vector

normalize clj

(normalize a)

Normalizes a vector

offset clj

(offset offset f)

Offsets a function by a specified amount

phash clj

(phash x)

(phash x y)

(phash x y z)

(phash x y z t)

Returns a hashed double value in the range [0..1)

PI clj

polar clj

(polar v)

Returns the polar co-ordinates of a vector

pos clj

A special node that evaluates to the current position in space as a 4D vector.

POSITION-SYMBOLS clj

A vector of position symbols.

radius clj

(radius v)

Returns the raidus of a vector in polar co-ordinates

render-lit clj

(render-lit height)

(render-lit colour height)

Renders example lighting on a couloured surface with a given heightmap function

rgb clj

(rgb java-colour)

(rgb r g b)

(rgb r g b a)

Creates an RGB colour vector

rgba clj

(rgba java-colour)

(rgba r g b)

(rgba r g b a)

Creates an RGBA colour vector

rotate clj

(rotate angle function)

Rotates a function in the (x,y plane)

scalar-hash-function clj

Hash function producing a scalar value in the range [0..1) for every unique point in space

scalar-lerp clj

(scalar-lerp proportion a b)

Performs clamped linear interpolation between two values, according to the proportion given in the 3rd parameter.

scale clj

(scale factor f)

Scales a function by a given factor.

seamless clj

(seamless v4)

(seamless scale v4)

Creates a seamless 2D tileable version of a 4D texture in the [0 0] to [1 1] region. The scale argument detrmines the amount of the source texture to be used per repeat.

sigmoid clj

Sigmoid function on a scalar or vector in range [0..1]

square clj

square-function clj

(square-function x)

Retuns the square of a number.

step clj

A step function that works on both vectors and scalars

t clj

(t v)

Extracts the t component of a position vector

take-components clj

TAU clj

texture-map clj

theta clj

(theta v)

Returns the angle of a vector in polar co-ordinates

triangle-wave clj

Triangular wave function in range [0..1]

v* clj

Multiplies two or more vectors

v+ clj

Adds two or more vectors

v- clj

Subtracts two or more vectors

vabs clj

vconcat clj

(vconcat & vectors)

Concatenate a set of vectors into a longer vector. Treats scalars as 1D vectors.

vcos clj

vdivide clj

Divides two or more vectors

vector-hash clj

Hash function producing a vector value in the range [0..1)^4 for every unique point in space

vector-offsets clj

(vector-offsets func)

vectorize clj

vectorize-op clj

(vectorize-op f & {:keys [zero identity unary-identity]})

Make an arbitrary function work on clisk vectors in a component-wise manner

vfloor clj

vfor clj

(vfor init
      while
      update
      &
      {:keys [max-iterations result bailout-result] :or {max-iterations 10}})

vfrac clj

viewport clj

(viewport a b function)

Rescales the texture as if viwed from [ax, ay] to [bx ,by]

vif clj

(vif condition a b)

vlet clj macro

(vlet bindings form)

let one or more values within a vector function

vloop clj

(vloop init rest & {:keys [max-iterations] :or {max-iterations 10}})

vmax clj

Computes the maximum of two vectors

vmin clj

Computes the maximum of two vectors

vmod clj

Returns the modulus of a vector by component.

vpow clj

Raises a vector to an exponent

vround clj

vsin clj

vsqrt clj

Takes the square root of a value

warp clj

x clj

(x v)

Extracts the x component of a position vector

y clj

(y v)

Extracts the y component of a position vector

z clj

(z v)

Extracts the z component of a position vector