patterning.layouts — com.alchemyislands/patterning 0.7.4

alt-cols clj/s

(alt-cols n groups1 groups2)

Fills a group-stream with cols from alternative group-streams

alt-cols-grid-layout clj/s

(alt-cols-grid-layout n groups1 groups2)

Every other column from two streams

alt-rows clj/s

(alt-rows n groups1 groups2)

Fills a group-stream with rows from alternative group-streams

alt-rows-grid-layout clj/s

(alt-rows-grid-layout n groups1 groups2)

Every other row from two streams

aspect-ratio-frame clj/s

(aspect-ratio-frame cols rows corner-pattern edge-pattern)

aspect-ratio-framed clj/s

(aspect-ratio-framed cols rows corner-pattern edge-pattern inner-pattern)

(aspect-ratio-framed cols rows corner-pattern edge-pattern inner-pattern fit-fn)

calc-dims clj/s

(calc-dims cols rows)

cart clj/s

(cart colls)

Cartesian Product of two collections

check-seq clj/s

(check-seq n groups1 groups2)

returns the appropriate lazy seq of groups for constructing a checkered-grid

checkered-grid clj/s

(checkered-grid number groups1 groups2)

does checks using grid layout (column-wise)

clock-rotate clj/s

(clock-rotate n group)

(clock-rotate n offset group)

Circular layout. Returns n copies in a rotation. Optional offset pushes items out from center before rotating.

corners clj/s

(corners cols rows corner-pattern)

diamond-grid clj/s

(diamond-grid n groups)

Like half-drop

diamond-layout-positions clj/s

(diamond-layout-positions number)

Diamond grid, actually created like a half-drop

drop-every clj/s

(drop-every n xs)

edges clj/s

(edges cols rows edge-pattern)

ensure-sequence clj/s

(ensure-sequence xs)

If xs is a single group/pattern (sequence of SShapes), repeat it. If xs is already a sequence of groups/patterns, return as-is.

flower-of-life-positions clj/s

(flower-of-life-positions r depth [cx cy])

four-mirror clj/s

(four-mirror group)

Four-way mirroring. Returns the group repeated four times reflected vertically and horizontall

four-round clj/s

(four-round group)

Four squares rotated

frame clj/s

(frame grid-size corners edges)

Frames consist of corners and edges.

framed clj/s

(framed grid-size corners edges inner)

Puts a frame around the other group

grid clj/s

(grid n groups)

Takes an n and a group-stream and returns items from the group-stream in an n X n grid (column-wise: top to bottom, then next column)

grid-layout-positions clj/s

(grid-layout-positions number)

calculates the positions for a grid layout (column-wise: top to bottom, then next column)

h-checkered-grid clj/s

(h-checkered-grid number groups1 groups2)

does checks using h-grid layout (row-wise)

h-grid clj/s

(h-grid n groups)

Takes an n and a group-stream and returns items from the group-stream in an n X n grid (row-wise: left to right, then next row)

h-grid-layout-positions clj/s

(h-grid-layout-positions number)

calculates the positions for a grid layout (row-wise: left to right, then next row)

h-mirror clj/s

(h-mirror group)

Reflect horizontally and stretch

h-row clj/s

(h-row n margin groups)

Takes n (number of groups), margin (spacing between groups), and groups (sequence of patterns). Lays out groups left to right with margin spacing.

half-drop-grid clj/s

(half-drop-grid n groups)

Like grid but with half-drop

half-drop-grid-layout-positions clj/s

(half-drop-grid-layout-positions number)

Like a grid but with a half-drop every other column

hex-grid clj/s

(hex-grid n groups)

Takes an n and a group-stream and returns items in a hexagonal grid layout

hex-grid-layout-positions clj/s

(hex-grid-layout-positions number)

calculates positions for a hexagonal grid layout (pointy-top hexagons)

inner-max clj/s

(inner-max inner-w inner-h inner-content)

Fills inner rectangle and clips excess (crop to fit)

inner-min clj/s

(inner-min inner-w inner-h inner-content)

Shrinks content to fit within inner rectangle (letterbox/pillarbox)

inner-stretch clj/s

(inner-stretch inner-w inner-h inner-content)

Stretches content to exactly fill the inner rectangle

iterate-stack clj/s

(iterate-stack n f pattern)

Applies a transformation function iteratively to a pattern and stacks all results. Returns n+1 patterns: [original, f(original), f(f(original)), ...] for n iterations.

Examples: (iterate-stack 3 #(groups/scale 0.8 %) pattern) ; progressively smaller (iterate-stack 5 #(groups/translate 0.1 0.1 %) pattern) ; progressive translation (iterate-stack 4 #(groups/rotate (/ maths/PI 8) %) pattern) ; progressive rotation

map-stack clj/s

(map-stack f patterns)

Maps a function across a sequence of patterns and stacks the results. Can accept either a single pattern or a sequence of patterns.

Examples: (map-stack #(groups/scale 0.8 %) [pat1 pat2 pat3]) (map-stack #(groups/rotate (/ maths/PI 4) %) pattern)

nested-stack clj/s

(nested-stack reducer n group & [styles])

superimpose smaller copies of a shape

old-ring clj/s

(old-ring n offset groups)

Legacy ring layout (pre-2026 behavior).

one-col-layout clj/s

(one-col-layout n i groups1 groups2)

uses one-x-layout with rows

one-row-layout clj/s

(one-row-layout n i groups1 groups2)

uses one-x-layout with rows

one-x-layout clj/s

(one-x-layout n i f groups1 groups2)

Takes a total number of rows, an index i and two group-streams. Makes an n X n square where row or col i is from group-stream2 and everything else is group-stream1

place-groups-at-positions clj/s

(place-groups-at-positions groups positions)

Takes a list of groups and a list of positions and puts one of the groups at each position

q1-rot-group clj/s

(q1-rot-group group)

q2-rot-group clj/s

(q2-rot-group group)

q3-rot-group clj/s

(q3-rot-group group)

random-grid clj/s

(random-grid n groups & {:keys [random] :or {random default-random}})

Takes a group and returns a grid with random quarter rotations

random-turn-groups clj/s

(random-turn-groups groups & {:keys [random] :or {random default-random}})

rgrid clj/s

(rgrid cols rows groups)

Takes cols, rows, and a group-stream and returns items in a rectangular grid with square tiles, filled row-wise (left to right, top to bottom)

rgrid-layout-positions clj/s

(rgrid-layout-positions cols rows)

calculates the positions for a rectangular grid layout in row-wise order (left to right, top to bottom)

ring clj/s

(ring rotation-number group)

(ring rotation-number radius-offset scale-factor group)

Ring layout where each copy keeps its original orientation.

ring-out clj/s

(ring-out rotation-number group)

(ring-out rotation-number radius-offset scale-factor group)

Ring layout where each copy faces outward from the center.

ring-rotate clj/s

(ring-rotate rotation-number group)

(ring-rotate rotation-number radius-offset scale-factor group)

Ring layout where each copy is rotated by its position (clock-rotate style).

rows clj/s

(rows row-groups)

Lay out a nested vector of rows, left-to-right and top-to-bottom. Short rows are padded with empty patterns to match the longest row.

scale-group-stream clj/s

(scale-group-stream n groups)

sshape-as-layout clj/s

(sshape-as-layout sshape group-stream scalar)

sshape-to-positions clj/s

(sshape-to-positions {:keys [style points] :as sshape})

stack clj/s

(stack & groups)

superimpose a number of groups

superimpose-layout clj/s

(superimpose-layout group1 group2)

simplest layout, two groups located on top of each other

v-mirror clj/s

(v-mirror group)

Reflect vertically and stretch