Island Maps
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.
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”.
A color per brick
Section titled “A color per brick”The quickest way to see what the node does: give every brick of a wall its own color.
- Add a Pattern set to Brick: light bricks in dark mortar. Wire it into Island Maps’ Image.
- 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.
- 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.
What counts as an island
Section titled “What counts as an island”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.
Every output is opaque
Section titled “Every output is opaque”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 outputs
Section titled “The outputs”| Output | What it holds |
|---|---|
| Random | One gray per island, drawn between black and white. |
| Random Color | A random offset per island: three separate draws, in red, green and blue. It is data to steer another node with, not a tint. |
| Gradient | A ramp from black to white across each island, along Angle. |
| Size | One gray per island: the largest island is white, and an island half its size across is half as bright. |
| Position | Where 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 UV | The 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. |
| Sampled | The 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”.
Recipes
Section titled “Recipes”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)”Random Color moves each island’s picture by its own amount, so every patch, plank or tile shows a different part of one picture.
- A Pattern set to Brick with Scale 6, Aspect 1 and Offset 0, so each brick is a square patch, into Island Maps.
- The picture to cut up, such as a fabric print or a wood scan, into Displace.
- 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.
Shingles that lap (Gradient)
Section titled “Shingles that lap (Gradient)”- A Pattern set to Brick with Scale 8, Aspect 0.67 and Offset 0.5, one island per shingle, into Island Maps.
- 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.
- 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.
- 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)”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.
- The height whose pieces you want to tilt (light pieces on dark joints) into Island Maps.
- Set Angle Variation to 180, so every piece points its own way.
- 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.
- 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.
Color by size (Size)
Section titled “Color by size (Size)”- A mask of chips of very different sizes, such as a Noise set to Voronoi, into Island Maps.
- 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.
- 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 Pattern set to Hex Grid into Island Maps. Set Edge Mode to Open if the wall does not tile.
- 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.
- 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.
- 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 mask with one island per block, some lying across and some standing up, into Island Maps.
- Local UV into Channel Split. Red runs from 0 at one end of every block to 1 at the other; Green runs across it.
- 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 mosaic from a photo (Sampled)
Section titled “A mosaic from a photo (Sampled)”- 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.
- The photo into Sample.
- Sampled is now the photo with every chip one flat color.
- 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.
A picture per plank
Section titled “A picture per plank”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.
One value per region of an ID map
Section titled “One value per region of an ID 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.
Dark islands on a light ground
Section titled “Dark islands on a light ground”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 separate pieces
Section titled “A photo of separate pieces”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.
Gradient: Angle and Angle Variation
Section titled “Gradient: Angle and Angle Variation”- 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, Anti-aliasing and Seed
Section titled “Edge Mode, Anti-aliasing and Seed”- 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.
Limits
Section titled “Limits”- 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.
Parameters
Section titled “Parameters”Pins
Islands
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.
Picks the threshold from the picture, between its dark and light areas. Turn off to set Threshold yourself
The brightness that parts islands from gaps under Bright Areas and Dark Areas. 0.5 is half brightness
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.
Picks how much to split touching pieces, from the picture. Turn off to set Separate yourself when pieces stay joined or get cut apart
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
Fills the space between islands from the nearest island on every output. Off leaves it black
Gradient
The direction each island's Gradient ramps along, in degrees. 0 = right, 90 = down. Also picks which end Local UV starts from
How far each island's direction turns from Angle, in degrees. 0 aligns every ramp; 180 lets each island point anywhere
General
- Open: the canvas edge cuts islands.
- Repeat: islands join across the edges, for tiling textures.
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.
Picks every island's random values. -1 gives each node its own
Usage Tips
Section titled “Usage Tips”- 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.