Skip to content

Island Maps

Island Maps
Texture

Island Maps finds the separate pieces of a picture, its islands, and gives each one values of its own on seven outputs: a random gray, a random offset, a gradient, its size, its position, its own coordinates and a sampled color. An island is one brick of a brick pattern, one stone of a pavement mask, one cell of a Voronoi noise or one flat color of an ID map. It is the node for bricks that each have their own color, tiles that each tilt their own way, boards with worn ends and a mosaic made from a photo.

A wall of reclaimed brick in running bond where every brick is its own color, deep red through orange and dusty rose to pale buff, a few darker overfired bricks and a few with spalled faces, set in dark sandy mortar and lit low from the side

Wire the picture that holds the islands into Image. Two more inputs are optional: Sample, the picture the Sampled output averages, and Angle, a map that sets each island’s gradient direction. Search the node palette for “island maps”, “per island”, “per cell” or “id map”.

The quickest way to see what the node does: give every brick of a wall its own color.

Pattern 1 backgroundmasksize ref image Brick Island Maps 1 imagesampleangle randomrandom colorgradientsizepositionlocal uvsampled Gradient Map 1 imagemask image five brick colors
Random gives every brick one gray, and Gradient Map turns each gray into one of the palette's colors.
  1. Add a Pattern set to Brick: light bricks in dark mortar. Wire it into Island Maps’ Image.
  2. Wire Random into a Gradient Map with a few brick colors, such as a deep red, an orange, a dusty rose and a pale buff. Every brick draws one gray, so every brick lands on one color.
  3. Put the mortar back. Island Maps fills the joints with the values of the bricks beside them (see Every output is opaque), so finish with a Composite (Normal): the mortar color as Base, the colored bricks as Overlay, and the brick Pattern on its Mask input.

Change Seed for another arrangement of colors.

Pick out a few bricks. Random also makes a selection. Wire it into a Levels with Master In Black 0.9 and Master In White 0.92: only the bricks that drew above 0.9 stay white, about one in ten. Use that as the Mask of a Composite set to Multiply that lays a dark brown over the wall, and those bricks read as burnt. A second Levels at the other end of the range (0.1 and 0.12, with Master Out Black 1 and Master Out White 0) picks a different one in ten, and picks from opposite ends of the range never overlap. For selections like this, turn Anti-aliasing off so no thin slivers are left along the joints.

The Islands group of Island Maps' parameters at their defaults: Islands From Auto, Auto Threshold on with the Threshold grayed, Ignore Smaller Than 10%, Auto Separate on, Fill Gaps on, and below them the line counting the islands found, highlighted

Islands From picks what makes an island:

  • Auto (the default) looks at the picture. If it has any transparency, the opaque parts are the islands. Otherwise, if it is an ID map of flat colors, every flat color is an island. Otherwise (a gray picture or a color photo) its bright areas are the islands.
  • Alpha: pixels at least half opaque.
  • Bright Areas: pixels at the threshold or brighter, such as light bricks in dark mortar.
  • Dark Areas: pixels darker than the threshold, such as dark tiles on a light ground.
  • Color Regions: one island per flat color, for an ID map.

Pixels that touch side by side or one above the other belong to one island. Two tiles that meet only at a corner stay two islands.

The other rows of the Islands group:

  • Auto Threshold (on for a new node) takes the threshold for Bright Areas and Dark Areas from the picture, at the split between its dark and its light. A photo is read through a light blur first, so its grain does not speckle the islands; a mostly black and white mask such as a Pattern keeps half brightness. Turn it off to set Threshold yourself (0 to 1, default 0.5). While Auto Threshold is on, the grayed slider shows the threshold it chose.
  • Ignore Smaller Than (10% on a new node) drops specks. An island smaller than this percent of the largest island becomes part of the gap, so with Fill Gaps on it takes the value of the island nearest it. 0 keeps every island. It does not apply to an ID map read by Color Regions, where every region is kept however small, and the row grays out.
  • Auto Separate (on for a new node) parts pieces that touch through a thin neck, such as stones in a photo whose joints touch. It finds the distance at which the necks have parted and no piece has been lost, and the grayed Separate slider shows the distance it chose. A strand thinner than that everywhere, such as a bright joint or a wisp of moss, becomes part of the gap.
  • Separate (with Auto Separate off) sets that distance yourself, as a percent of the canvas. 0 is off. Keep it under half the thickness of the thinnest piece, or whole pieces disappear. Separate never moves an outline: every pixel still goes to the piece it belongs to.
  • Fill Gaps (on by default) fills the space between islands, on every output, with the value of the nearest island. Off leaves the gaps black.

A line under Fill Gaps counts what was found, such as “128 islands”, or “36 regions” when the islands are flat colors. When nothing was found it says why.

With Fill Gaps on, every output has a value at every pixel and no transparency, so any output wires straight into the Preview, a Composite, a Gradient Map or 3D Render with nothing in between. The price is that the joints are filled too: the mortar between two bricks takes the values of the bricks beside it. Put the mortar back as the last step, by laying the mortar color over the result through the pattern’s own mask, as in A color per brick.

The seven outputs of one Island Maps on a mosaic of hand-broken chips: Random, one gray per chip; Random Color, one flat color per chip; Gradient, a ramp across each chip in its own direction; Size, bigger chips brighter; Position, each chip colored by where its center sits; Local UV, red and green coordinates inside each chip; and Sampled, each chip one flat color of a sunflower photo
OutputWhat it holds
RandomOne gray per island, drawn between black and white.
Random ColorA random offset per island: three separate draws, in red, green and blue. It is data to steer another node with, not a tint.
GradientA ramp from black to white across each island, along Angle.
SizeOne gray per island: the largest island is white, and an island half its size across is half as bright.
PositionWhere the island’s center sits on the canvas: x in red, y in green, each 0 at the left and top and 1 at the right and bottom. Flat across the island.
Local UVThe island’s own coordinates: red runs from 0 to 1 along the island’s long side and green across it at the same scale, whichever way the island is turned.
SampledThe average color of the Sample picture over the island.

To look at an output without wiring it, select Island Maps and pick it in the row of view buttons above the Preview.

Random, Gradient and Size are grayscale maps. The six outputs other than Sampled are data, kept at full float precision in every document, so Random through a Gradient Map lands on the same colors in an 8-bit document and a 32-bit one. Sampled is a color picture at the document’s bit depth. A Gradient Map places its stops at the output’s own value: a stop at 0.3 changes color where Random, Size or Gradient is 0.3.

Only the outputs in use are made. Random is always made. Each other output is made only while it is wired to another node or picked in the Preview’s view buttons, so an output nothing uses costs no time and no memory. Wire one later and only that output is made; until then, its pin tooltip and Node Info (hold I over the node) read “Not cooked”.

Each recipe uses one output. They combine freely: most finished materials use Random for tone, Random Color for a piece of a photo per island, and Gradient for a tilt.

A different piece of a photo on every patch (Random Color)

Section titled “A different piece of a photo on every patch (Random Color)”
A patchwork quilt of printed cotton squares, every patch cut from a different one of nine fabrics so no two neighbors match, padded, puckered at the seams and stitched, lit low from the side

Random Color moves each island’s picture by its own amount, so every patch, plank or tile shows a different part of one picture.

  1. A Pattern set to Brick with Scale 6, Aspect 1 and Offset 0, so each brick is a square patch, into Island Maps.
  2. The picture to cut up, such as a fabric print or a wood scan, into Displace.
  3. Random Color into Displace’s map input, with Channel Red-Green, Map Midpoint 0.5 and Edge Mode Wrap.

Red moves each patch’s picture sideways and green moves it up or down. The move is flat across a patch, so the picture inside it is not bent, only cut from another part. To use whole pictures from a sheet of several, such as nine fabrics packed three by three with Sprite Sheet, round Random Color to steps first with two Levels and a Composite, so each move is exactly one picture of the sheet.

A roof of cedar shingles in staggered courses, each shingle a wedge thick at its lower edge so every course throws a shadow on the one below, each shingle its own piece of wood grain
  1. A Pattern set to Brick with Scale 8, Aspect 0.67 and Offset 0.5, one island per shingle, into Island Maps.
  2. Set Angle to 90 and Angle Variation to 0. Gradient is then 0 at the top of each shingle and 1 at its lower edge.
  3. Lay Gradient over a flat gray with a Composite (Normal) that has the shingles on its Mask input, and wire the result into a Texture’s Height.
  4. In 3D Render, raise Height Scale a little (about 0.02) with a high Tessellation: each shingle becomes a wedge, so every course laps the one below.

Tilt each piece of a height you already have (Gradient)

Section titled “Tilt each piece of a height you already have (Gradient)”
A floor of blue glazed square tiles under the same low light twice: on the left every tile is flat and evenly lit; on the right each tile is tipped its own way, so every tile is a different shade, lighter on the side that faces the light

Gradient can tip pieces that already have a height, such as tiles, stones or bricks, so each one catches the light its own way. Work in a 32-bit document: in 8-bit a height built from Gradient has only 256 steps, which Normal Map turns into visible bands.

  1. The height whose pieces you want to tilt (light pieces on dark joints) into Island Maps.
  2. Set Angle Variation to 180, so every piece points its own way.
  3. A Composite set to Subtract at an Opacity of 25% to 70% (higher tips each piece further), with the height as Base, Gradient as Overlay and the height again on its Mask input, so the joints stay put.
  4. That into Normal Map with Strength about 12 to 30, then into a Texture’s Normal and 3D Render.

Subtract the ramp rather than adding it: adding stops at white, so a ramp added onto a height near white flattens it.

A polished terrazzo floor of angular stone chips in speckled cement: the biggest chips white marble, the middling ones green, the small ones terracotta and the crumbs black
  1. A mask of chips of very different sizes, such as a Noise set to Voronoi, into Island Maps.
  2. Size into a Gradient Map with Interpolation set to Constant and a few stops: the biggest chips get one color, the middling ones another, the crumbs a third.
  3. Put the cement back with a Composite through the chip mask.

Moss only on the big stones of a wall is the same recipe with a single cut.

A fade that goes tile by whole tile (Position)

Section titled “A fade that goes tile by whole tile (Position)”
A wall of glazed hexagon tiles fading from white at the top through pale aqua and teal to navy at the bottom, every tile one flat glaze, so the fade steps tile by whole tile with lighter and darker tiles mixed where the colors meet
  1. A Pattern set to Hex Grid into Island Maps. Set Edge Mode to Open if the wall does not tile.
  2. Position into Channel Split. Green is 0 for a tile at the top and 1 for one at the bottom, one flat value across the whole tile.
  3. Lay Random over Green with a Composite (Normal, Opacity about 30%), so each tile’s value is mostly its height and a little its own draw.
  4. That into a Gradient Map running from white through aqua and teal to navy.

Each tile is one flat glaze, a little lighter or darker than its neighbors at the same height, so the fade reads as a scatter of whole tiles. A plain Gradient through the same Gradient Map would shade smoothly across every tile instead. Red does the same from left to right.

Wear that follows each block, whichever way it lies (Local UV)

Section titled “Wear that follows each block, whichever way it lies (Local UV)”
A basket-weave parquet floor of oak blocks laid in squares that turn about, every block darker at its own two ends, the blocks lying across and the blocks standing up alike, each a little cupped across its width
  1. A mask with one island per block, some lying across and some standing up, into Island Maps.
  2. Local UV into Channel Split. Red runs from 0 at one end of every block to 1 at the other; Green runs across it.
  3. Red through Curves, with the Master curve at 1 at both ends and 0 in the middle (from 0.25 to 0.75): white at both ends of every block. Use it as the Mask of a Composite (Multiply) that lays a dirty brown over the wood.

The ends darken on every block, lying or standing, with no rule about which is which. Green through Levels and Curves the same way, added faintly to the height, cups each block across its own width.

Local UV is laid out like a UV map: red is u along the island’s long side, green is v across it measured from the island’s lower edge, and blue holds the island’s scale (the distance one pixel covers in those units). Red and green share one scale, so the island keeps its aspect: on a plank eight times as long as it is wide, red reaches 1 and green stops at 0.125. Of an island’s two ends, u starts at the one that makes it run closest to Angle.

A photo of a sunflower beside a mosaic made from it: every hand-broken chip one flat color taken from the photo under it, set in pale grout and lit so each chip shines a little differently
Noise 1 backgroundmasksize ref image Voronoi Image In 1 sunflower.jpg image Island Maps 1 imagesampleangle randomrandom colorgradientsizepositionlocal uvsampled
The chips go into Image and the photo into Sample. Sampled is the photo with every chip one flat color.
  1. A mask of small chips into Island Maps’ Image, such as a Noise set to Voronoi with a little warp, through Levels. Set Edge Mode to Open if the chips do not tile.
  2. The photo into Sample.
  3. Sampled is now the photo with every chip one flat color.
  4. Put the grout back with a Composite: a grout color as Base, Sampled as Overlay and the chip mask on its Mask input.

With nothing on Sample, Sampled is black and the panel says so. Sample may be any size; it is stretched to the size of the Image.

To lay a wood photo along every plank of a floor, each plank turned along its own length, use Scatter in Islands mode. It finds the planks the way Island Maps does and lays one copy of the photo on each. Random Color into Displace (above) is the shortcut, but Displace moves the photo without turning it, so the grain runs along the planks only when the photo’s grain already runs their way. For a tone per plank, lay Island Maps’ Random through a Gradient Map over the scattered wood.

An ID map of irregular regions, each a flat arbitrary color, beside the same regions after Island Maps reads them by their colors: each region one of five colors picked by Random through a Gradient Map

An ID map is a picture of flat colors, one per material or part. Wire it into a new Island Maps: Auto sees an opaque color picture and reads it by Color Regions, so every flat color is one island and the count line counts regions. Random into a Gradient Map then gives every region its own color.

Two regions of different colors that touch stay two islands. The soft one or two pixel blend along an antialiased edge joins the larger region beside it, so a resized or imported ID map still gives one value per flat color. A transparent part of the map is a gap.

With Anti-aliasing on, the outputs follow the map’s own edges: where an antialiased map blends two regions along a seam, the outputs blend the two regions’ values by the same amounts. A hard-edged map holds no in-between information, so its seams stay on whole pixels. For exact edges on any ID map, such as a pixel-art sprite, turn Anti-aliasing off; for soft edges on a hard map, put a 1 px Blur before Island Maps.

Auto never picks the dark side of a gray picture. For dark tiles on light grout, or a Pattern that draws dark bricks in light mortar, set Islands From to Dark Areas. Under Auto the light mortar is read as the islands and the bricks as the gaps.

A photo of cobblestones beside the same photo read by a new Island Maps, every cobble tinted one color from a five-color palette and the joints between them left as they are

Wire a photo of separate pieces, such as pavers, cobbles or tiles, straight into a new Island Maps, then Random into a Gradient Map: every piece gets one color. To keep the stones’ own texture, turn Fill Gaps off and lay that color over the photo with a Composite set to Multiply: the joints keep the photo’s own color, so neighbors that happen to draw the same color still read as separate stones. A color photo works, and so does the ambient occlusion map of a scanned surface, as long as the pieces read lighter than what lies between them. Auto Threshold finds the split between pieces and joints, Auto Separate parts the pieces that touch, and Ignore Smaller Than drops specks.

What it cannot do yet:

  • A dense pile of touching pebbles of many sizes reads about half as many islands as there are pebbles: no single separation parts the large pebbles without erasing the small ones. Turn Auto Separate off and move Separate while you watch the count line, or draw the pieces as a mask.
  • A height map with a slope, whose ground rises and falls across the picture, has no one threshold between pieces and ground, so most pieces join. Flatten it first (for example, subtract a large Blur of it) or use its occlusion or color map.
  • A few pieces split or joined. Where moss between two stones is as bright as the stones, they join; where a stain crosses a stone, it can split. Separate never moves an outline, so the edges stay where the photo has them.
The Preview showing Island Maps' Gradient view on a brick pattern, every brick a ramp from black to white in the same direction, with the Angle arrow drawn from the center of the picture at 30 degrees and the Gradient view button highlighted
  • Angle (0 to 360, default 0) is the direction every island’s ramp runs. 0 points right and 90 points down.
  • Angle Variation (0 to 180, default 30) is how far each island’s direction turns from Angle. 0 lines every ramp up; 180 lets each island point anywhere. Each island keeps its own share of the turn, so moving the slider turns every island smoothly.

The Angle handle. While Island Maps is selected and Gradient is the output in the Preview, an arrow from the center of the Preview points along Angle. Drag its tip around the center to set Angle; hold Shift to snap to 15 degree steps, and double-click the tip to set it back to 0. The arrow shows only on Gradient.

The Angle input. Wire a grayscale map into Angle and each island reads its direction from the map at its own center: black is 0 degrees and white is 360. The Angle row grays out and the arrow hides, and Angle Variation still turns each island from the map’s direction. Local UV keeps following the Angle row’s value, since the map sets only the direction of Gradient.

  • Edge Mode: Repeat (the default) joins an island across the edges of the picture, so a brick cut by the left edge and its other half on the right are one island with one value, and every output tiles. Open treats the edge as a cut; use it for a picture that does not tile, such as a photo.
  • Anti-aliasing (on by default) smooths the edges where islands meet: a pixel on the line between two islands blends their values by how much of it each covers. Off, every pixel holds exactly one island’s value. Turn it off for pixel art, exact selections through a tight Levels, and data lookups that want one key per pixel. Position and Local UV keep hard edges either way.
  • Seed picks every island’s random values. -1 gives each node its own; the dice button picks a new one.
  • An island that moves is a new island. Each island’s random values come from where it sits. Adding, removing or moving one island changes no other island, but a moved island draws new values. Widening the mortar or resizing the picture moves no island, so every island keeps its values.
  • Under Open, an island cut by the edge can change. As the mortar changes it gains or loses pixels, its center moves, and it can draw new values. Under Repeat no island is cut.
  • An island that runs the full width or height under Repeat joins itself across the edge and has no ends. Its Gradient and Local UV still ramp once across it.
  • Local UV turns end for end when Angle crosses the direction straight across a plank. Leave Angle alone once a material depends on which end is which.
  • Memory at very large sizes. Each output in use holds a picture the size of the image. At 4096 px a cook takes a fraction of a second. At 16384 px all seven outputs together hold about 19 GB, and Random alone about 1 GB.
  • Texture sets are refused at the Image input: Island Maps reads a picture, not a material. Build the mask or ID map as a picture, run it through Island Maps, and wire the results into a Texture’s maps.

The result is the same on every run and on every computer.

Pins

ImageImage
InputRequired
SampleImage
InputOptional
AngleMask
InputOptional
RandomMask
Output
Random ColorImage
Output
GradientMask
Output
SizeMask
Output
PositionImage
Output
Local UVImage
Output
SampledImage
Output

Islands

Islands FromChoice
Default: Auto Range: Auto / Alpha / Bright Areas / Dark Areas / Color Regions

What makes an island.

  • Auto: alpha when the image has transparency, else its flat colors when it is an ID map, else its bright areas (a photo too).
  • Alpha: pixels at half opacity or more.
  • Bright Areas / Dark Areas: pixels above or below the threshold.
  • Color Regions: one island per flat color.
Auto ThresholdToggle
Default: true

Picks the threshold from the picture, between its dark and light areas. Turn off to set Threshold yourself

ThresholdNumber
Default: 0.50 Range: 0.00–1.00

The brightness that parts islands from gaps under Bright Areas and Dark Areas. 0.5 is half brightness

Ignore Smaller ThanNumber
Default: 10.0 Range: 0.0–50.0

Islands smaller than this percent of the largest island's size become gaps, so specks drop out. 0 keeps every island.

Does not apply to an ID map read by its Color Regions: every region is kept.

Auto SeparateToggle
Default: true

Picks how much to split touching pieces, from the picture. Turn off to set Separate yourself when pieces stay joined or get cut apart

SeparateNumber
Default: 2.5 Range: 0.0–8.0

Splits pieces that touch through a narrow join, such as stones in a photo. Higher splits wider joins. Outlines stay as they are. 0 is off

Fill GapsToggle
Default: true

Fills the space between islands from the nearest island on every output. Off leaves it black

Gradient

AngleNumber
Default: 0 Range: 0–360

The direction each island's Gradient ramps along, in degrees. 0 = right, 90 = down. Also picks which end Local UV starts from

Angle VariationNumber
Default: 30 Range: 0–180

How far each island's direction turns from Angle, in degrees. 0 aligns every ramp; 180 lets each island point anywhere

General

Edge ModeChoice
Default: Repeat Range: Open / Repeat
  • Open: the canvas edge cuts islands.
  • Repeat: islands join across the edges, for tiling textures.
Anti-aliasingToggle
Default: true

Smooth island edges.

Turn it off for every pixel to hold exactly one island's value, best for pixel art and exact selections. Position and Local UV keep hard edges either way.

SeedInteger
Default: -1 Range: -1–2147483647

Picks every island's random values. -1 gives each node its own

  • Start with Random into a Gradient Map to check what the node found, then read the count line under Fill Gaps.
  • Put the joints back as the last step, with a Composite through the pattern’s own mask. Every output fills the joints.
  • Turn Anti-aliasing off whenever a Levels picks some islands out, or the selection keeps slivers along the seams.
  • For dark pieces on a light ground, set Islands From to Dark Areas; Auto always takes the bright side of a gray picture.
  • Build heights from Gradient in a 32-bit document.