✦ Stellation Controls
Cells walkthrough History Open the app →

Controls & views

Three views of one selection, and each view works at its own scale: the solid adds and removes one cell, the diagram toggles the cell on either side of its plane, and the Cells table — only the Cells table — moves whole supporting sets.

The gestures, per view

Viewshift + clickctrl + click
solid Add the one cell sitting on the clicked face. Remove the one cell behind it.
diagram Toggle the cell beneath the plane — the one this region caps. Toggle the cell resting on it, above the plane.
Cells table Either modifier: toggle the box together with its whole supporting set — on if it was off, down to the core; off if it was on. A bare click toggles just the box.

Why the difference: in the two graphical views you are pointing at a place, and the natural unit there is the single cell on one side of it. The group operation — a cell with everything supporting it — needs the table, where the support structure is actually visible. The colors say which is which: green adds and red removes in the solid; the diagram's toggles are gold for beneath and blue for above, because there a click is a toggle, not an add or a remove.

The three views

All three show one selection of cells. Editing in any of them changes the other two immediately, because there is only ever one selection.

1 · The solid

What the thing looks like.

  • drag — turn it
  • scroll — zoom
  • right-drag — pan, sliding the picture without turning it. On a touchscreen, drag with two fingers and spread them to zoom; on a trackpad, a sideways two-finger swipe does it with no button at all
  • fit — undoes both the pan and the zoom
  • home — back to the orientation chosen in the menu beside it, however far you have turned the solid since. The menu names the direction you are seeing it from and goes blank the moment you turn off one: the coordinate axes ±x, ±y, ±z, and then the symmetry axes, named for the solid and the order of the axis — i for the icosahedron, o for the cube and octahedron: ±i2 (0, 0, 1), ±i3 (0, 1/τ, τ) a face center, ±i5 (1, 0, τ) a vertex; ±o2 (0, 1, 1) an edge, ±o3 the body diagonal, ±o4 (0, 0, 1). Those are where a solid looks like what it is: seen down its five-fold axis an icosahedral stellation is exactly five-fold on the screen. Each name also names the axis the matching subgroups turn about, so choosing D5 and pressing +i5 looks straight down that group's own axis. i2 and o4 are the z axis under two other names — z is a two-fold of the icosahedron and a four-fold of the cube — which saves working that out when you want it by what it is. Each is the shortest turn from the +z frame to that direction, with no roll on top, so +o2 is a 45° tip about x and nothing else, leaving x across the screen where it started. The two o3 views are the exception, rolled so that y stands upright — the true isometric, the three axes leaving the origin 120° apart and equally foreshortened. Orientation only, so your zoom stays put
  • shift-click a face — add the cell just outside it
  • ctrl-click a face — remove the cell just inside it

You are always pointing at a face, which has a cell on each side. Shift takes the one further out, ctrl the one further in — one cell at a time, so you grow and carve exactly at the surface you can see. Hold a modifier and the outline tells you whether the click will land: on the outermost facets there is nothing further out to add, so holding shift over them draws no outline at all.

2 · The diagram

One face plane, cut by all the others.

  • drag — pan
  • scroll — zoom about the pointer
  • fit — center the diagram and reset the zoom
  • shift-click a region — toggle the cell beneath it
  • ctrl-click — toggle the cell on top of it
  • paint (the brush button) — hand-assign coset colors, region by region

This is the classic stellation diagram, and it draws the surface of the solid, not its volume. A region filled solid is a face looking outward; a region filled very pale is a face looking inward, lining a cavity. Pale therefore means there is a hole behind it.

Painting cosets. With face colors reading by subgroup coset, per facet, the brush button opens a palette of the current coset colors across the top of the diagram — the same colors the Colors panel edits. While the brush is down, a plain click paints in either view: a region of the diagram, or the facet itself on the solid — dragging still turns the solid, only a true click is a stroke. A click never paints one region: it paints the region’s every symmetric copy across the whole figure, each copy taking the coset the chosen one BECOMES under that symmetry — which is what color symmetry demands, and what lets you paint one face solid green and watch every other face come out solid in its own coset: the four-color model, made by hand. shift-click adds the chosen coset to what the region wears, or takes it back out; a region carrying several cosets — by your gesture, or forced, where a copy’s own symmetry straddles cosets — shows their blend and a small dot, and falls to gray when mix cosets colors is off. gray paints "no coset" everywhere at once; auto erases a region and all its copies; clear takes everything back. While the brush is down, merge neighbors is set aside — its regions vote by majority and would quietly outvote a fresh paint — and re-melts, painted labels included, when you leave. Painted labels are part of the document — saved, restored, exported, named by the readouts — and are cleared when the coloring subgroup changes or a different arrangement is built.

3 · The Cells table

Every cell there is, whether or not you can see it.

  • click — toggle one cell
  • click a row number — the whole layer
  • drag, wheel or the scrollbars — move about a wide table
  • ctrl-click a box — toggle it with its whole supporting set (this view only)

Rows are shells with the core at the bottom, each built on the one below. A box is a set of cells the symmetry carries onto one another; a shaded group splits into sub-cells, which is where handedness lives. The full walkthrough →

The panel

core · + layer · all · clear
Walk outward a shell at a time. core alone is the original polyhedron; core + one layer is its first stellation.
fit
Rescale so the current selection fills the frame. The scale is otherwise left alone while you work, so adding a shell does not shrink everything you have already built.
polyhedron / stellation symmetry
The first is the symmetry the cells are grouped under; the second, which must be a subgroup of it, is the editing symmetry: every add or remove toggles the whole orbit of the clicked cell under it. Lowering it splits each group into sub-cells — that is what lets you take one hand of a chiral pair, and at E a click takes a single cell. Changing the stellation symmetry never touches what is already selected, so you can rough out a form under the full symmetry, refine it asymmetrically under a subgroup, and switch back; a box in the Cells table then holding only some of its pieces shows a faint fill, and a click fills it. Only genuine subgroups of the solid's own point group are offered — a name in brackets, like D3d(I) or S6(O), is that group set about the parent's own axes rather than the textbook ones, which is how a triangular antiprism's symmetry can be offered inside an icosahedron at all.
face colors
Two menus. The first names the reading — what the colors mean; the second, applied, appears only for the two readings that offer a choice and says what wears one color: per plane paints a whole face plane at once, which is the classical reading and the one that makes a compound come out as solid pieces; per facet paints each piece of surface separately, so it can tell apart parts of a plane the reading treats differently; a coset labeling adds per split facet, which also divides a facet where a mirror cuts it, and an orbit labeling adds per cell, which paints whole cells rather than surfaces.

Five readings. By shell, one hue per layer outward from the core, so you can read how deep a piece sits. By face class, one hue per kind of face of the original polyhedron — a property of the solid you started from, so an icosahedron has one kind however you stellate it, with its undersides the same hue darkened. By stellation face class, the same but grouped under the stellation symmetry: the two agree at full symmetry and part company below it, because a subgroup can no longer carry every face onto every other. The icosahedron's twenty faces are one class under I, two under Th, and twenty under E — so this is the coloring that shows what the symmetry you are building under actually treats as the same. Then by subgroup coset, which copy of the chosen subgroup a piece belongs to — the classical five-color compounds — and by subgroup orbit, what that subgroup preserves, which is defined for every subgroup and never gray. Both take their subgroup from the coloring menu in the symmetry subsection above.

mix cosets colors, offered for the coset reading, says what to do with an element that belongs to several cosets at once and so has no color of its own. On, its cosets are mixed. Off, it falls to gray — which nothing else in a coset reading wears, so the pieces the coloring cannot name become visible at a glance instead of reading as an oddly muddy color somebody chose. It applies wherever the palette does: the solid, the diagram, both exports. An orbit reading puts every element in exactly one orbit, so nothing is ever shared and the switch is not offered.

merge neighbors, offered for the two per-facet readings, melts adjacent pieces into solid regions: kinds of piece that touch inside one face are merged, smallest first, each absorbed into the neighbor it shares the most boundary with, until only the chosen number of colors remains. 1 asks for the fewest possible — every connected patch of surface solid; raising the count lets the larger patterns back in while the smallest slivers stay merged. Both numbers count kinds, up to the figure’s full symmetry — the merging itself runs on that symmetry’s quotient, one step melting every copy of a face at once, so every position of the dial is a symmetric picture — and the readout says what was actually kept of how many kinds there were. The count is clamped between the number of connected patch-kinds (pieces that never touch are never merged) and the number of piece-kinds, which is the reading untouched. Each region wears the color most of its own facets already wore, majorities taken face by face; an exact tie is worn as the blend of the tied labels, or gray with mixing off. The palette keeps its meaning, edited colors keep applying, and the pointer’s readout still names a coset or an orbit. In the per split facet reading the switch stays visible but disabled — merging would melt the very pieces that reading exists to keep apart — and its tooltip says where to find it working. Both views and both exports follow, like everything else the palette decides; the dial is saved with the document.

image places a picture on the plane the diagram shows — one image per class of plane, so a truncated cube can wear one on its octagons and another on its triangles — and the stellation symmetry does the rest: the face wears as many copies as it has symmetries (a cube face four under O, eight under Oh, the mirror images among them), and every plane of the class wears the same picture, carried there by the group. Where the image lands is yours: size in face widths, position and angle in the diagram’s own frame, mirror to flip it, or place by hand, which puts handles on the copies in the diagram — drag inside a box to move the image, a corner to turn and scale it about the pivot, the pivot to move that center (double-click resets it), the tip of the orange arrow to set the tilt; any copy can be grabbed, the arrow keys nudge, and the solid follows every step. Where copies overlap, stack and tilt decide: a higher stack lies on top, and a tilt — a direction within the image and an amount — lets the copies of one image weave over and under one another, each passing over one neighbor and under the next, instead of blending; flat copies at the same stack blend evenly, as coset colors do. tile the image repeats it endlessly over the plane, for patterns. A change of stellation symmetry keeps every copy on the solid: under a smaller group they become separate images (the which menu picks the one to edit), under a larger one they fold back together.

blend says how the images meet the face colors. tint, the default, multiplies them — white shows the coset color pure, dark ink shades it, which is why the bundled patterns are light. stamp lays the image over the face in its own colors, a white glyph staying white. replace makes the image the face itself: where it is transparent there is no face at all, and the glyphs float in the air. Transparency is honored throughout — a transparent background leaves the face color untouched, semi-transparent pixels blend by their alpha — so the bundled arrow reads as outline ink under tint, pops as itself under stamp, and hangs alone under replace. opacity is the layer’s own dial, independent of the faces’. The images can also be colorized per group: the Colors panel gains an editing switch while an image is armed, and its texture ink palette is a second color and opacity per coset, defaulting to white — so a red face can carry green arrows and a green face red ones, independent of the face colors entirely. The diagram shows the layer on its plane exactly as the solid wears it. The images live in img/textures/; drop a file there and rerun node docs/tools/make-textures.mjs to list it in the menu. Everything — every plane’s images and placements, blend, opacity and the ink palette — is saved with the document.

To read a mix back, rest the pointer on the facet. Each view answers along its own bottom edge, once the pointer has been still for a moment — so that sweeping across a figure never fires it. The diagram puts it on the same line that names the two cells the region lies between — beneath the plane and above it — and the solid on the line that names the cell you are looking at and the one a shift-click would add to it: cell 2.0.0 · adds 3.0.0. A dash for either means there is no such cell, and with the modifier held the line says why. Either way it names the group under the pointer — coset 3, or cosets 1 + 8 for a mix, with the mixed color and the colors that went into it swatched beside the numbers, or no coset fits where nothing does. It is the only form the answer can take: a mix of three colors in Oklab is not three colors any more, and the combinations are far too many for a legend — a six-way mix like cosets 0 + 21 + 22 + 31 + 36 + 59 is ordinary on a low-symmetry subgroup. An orbit reading names its orbit the same way; the readings that have no group vocabulary show nothing.

Edit colors…
Opens the Colors panel: one row for every group the reading above can name — each shell, each face class, each coset or orbit — with the group's color and its own opacity. A group at full opacity is drawn as always; below it the group turns to glass and what sits behind it shows through; at zero its fill is gone altogether and only its edges remain, which is how to look past one component of a compound at the rest without losing the shape of the thing you are looking past. Gray gets a row too, so "no coset fits" can be faded like any other group.

A coset reading can offer more rows than the figure has faces, and each row says which it is. The subgroup’s cosets all get a row, because a row’s colour is an ingredient: a facet wearing a mix of two cosets takes its colour from both, so changing either changes the picture. N facets means the group is worn on its own, with 5, 10 that it only ever appears blended and names who with, in N mixes when there are too many partners to fit on the row (the tooltip lists them), and unused here that this figure never mentions it at all — that row can be changed freely and nothing will move. The cube under C4 is the sharp case: twelve cosets, not one worn alone, eight blended across its four non-axis faces and four unused — but switch applied to per split facet and all twelve come into use, four facets each, with nothing left to annotate.

The colors are the figure's, not the app's: they follow it into the diagram, the diagram export and every mesh format that carries color, and a saved document reopens wearing them. The panel's copy box holds them as plain hex — the same array the document saves — so a palette can be lifted from one figure and pasted onto another; each position is a group number, so the colors land on the groups they came from even when the two figures have different numbers of them. Reset all gives the palette back. The facet opacity slider still works as it did, over the top of whatever the groups say.

coloring (the subgroup)
In Construction › symmetry, beside the stellation symmetry: a subgroup of the polyhedron symmetry, deliberately independent of the stellation one — the stellation symmetry is how you edit, and changing it never repaints the figure. It is the H that the coset and orbit readings in Coloring are taken with respect to, which is why it sits with the groups rather than with the colors.

Which pieces then share a color is the applied menu's business — per plane or per facet. Nothing about the cosets differs between them; only which pieces share a color.

Per plane paints every facet by which coset its plane belongs to: the subgroup's own set of planes, and one translate of that set per coset. This is the classical picture and the reason the coloring exists — set the polyhedron symmetry to I and the subgroup to T, and the icosahedron's twenty face planes fall into five sets of four, each set the faces of one inscribed tetrahedron, so the compound of five tetrahedra wears five colors, one per tetrahedron. The chiral group matters: inside the full Ih every face plane is held by mirrors that T does not contain, no coset can name it, and the figure grays — honestly, rather than being given colors it has no right to.

Per facet is the same labeling applied to the smaller pieces, and it can say things whole planes cannot. Color the icosahedron under Ih by cosets of I, index two: the two hands of its chiral facets come out as the two colors, where the plane coloring can only gray, both hands lying in the same planes. Where the per-plane labeling exists the facets simply inherit it, so the two agree and the smaller pieces never contradict the larger.

Gray always means the same thing: no coset can name this piece. Either the subgroup holds it still — the core cell, fixed by everything — or its stabiliser contains symmetries the subgroup lacks, as C5 cannot name a face held by a three-fold axis.

Where no single coset can name a piece but a small set can, the piece wears the mix of that set instead of gray. The mixing is exact, not decorative: every piece of an orbit blends the same number of cosets — the translates of the reference sub-figure that contain it — and the count is forced by how the piece's own symmetry overlaps the subgroup. The icosahedron under Ih by cosets of T, formerly all gray, is the picture this exists for: each face mixes exactly one right-handed and one left-handed tetrahedron of the ten, twenty distinct pastels, both chiral compounds of five readable at once. A mix that would need every color says nothing, so those pieces stay gray.

Mirror-split — the per-facet coloring's finishing move — removes even that gray. A piece grays when its own symmetry straddles cosets; cutting it along that symmetry's own mirror lines (or fanning it about its center, when the symmetry is purely rotational) leaves pieces whose only symmetry is none at all, and those sit inside every subgroup, so every piece takes a crisp coset color at the full palette. The icosahedron under Ih by cosets of I shows the classical result: every mirror-straddling face splits into two hands' colors along its mirror line. The cut is purely a coloring device — the cells, the selection and the geometry of the figure are untouched.

By subgroup orbits — per plane, per facet or per cell — is the other half of the question. Two pieces share a color exactly when some motion of the subgroup carries one onto the other, so where the cosets ask "which copy of the sub-figure is this?", the orbits ask "what does the subgroup itself preserve?" — its invariant sub-figures appear as the small classes, T on the icosahedron's twenty planes giving 4+4+12 with the two invariant tetrahedra picked out. Orbits exist for every subgroup, need no reference choice, and never gray; the price is that the class sizes vary, because orbits are not cosets. Per cell colors whole solid pieces — the unit a physical model is painted in.

One caveat worth knowing. A coset labeling is canonical only within one orbit: swap an orbit's representative for one outside the subgroup and every label in it shifts together. The planes are a single orbit, which is what makes them a shared frame for everything else. Where no per-plane labeling exists, each facet orbit is labeled on its own, so it still separates the hands but the particular colors need not correspond from one orbit to the next.

Both colorings follow the figure into the diagram, the diagram export and every mesh format that carries color, and a saved document remembers them. The gallery's compound of five tetrahedra opens already colored this way — and the coloring tutorial walks all of these modes through twelve classical pictures, each one click from the app.

shells count
How far out to carry the arrangement. Chosen per solid; raise it if shift-click reports nothing further out.
diagram face
Which face's plane the diagram is drawn on. Only faces the chosen symmetry cannot carry onto one another are listed — the rest would give the same picture.
symmetry elements
Rotation axes, mirror planes and rotoreflection axes, drawn as solid geometry through the origin so the stellation hides what is behind them. Inequivalent elements get different colors; the legend names each class, and mark on the diagram shows where the same elements meet the diagram's plane.

group chooses whose elements these are: any subgroup of the polyhedron symmetry, independent of the symmetry you are building with. A subgroup's axes show what a lower symmetry would preserve, which is what you are choosing between when you decide to stellate under one — the tetrahedral axes drawn on an icosahedral figure say where its five tetrahedra sit. The choice is yours rather than the document's: it is remembered between sessions, never saved into a file, and falls back to the stellation symmetry when a new solid leaves it meaningless.

With nothing selected the elements and the coordinate arrows stay on screen, sized to the core — layer 0, the polyhedron you started from. That is the one length in the arrangement that does not depend on the selection, so an empty figure has a stable scale to be read against, and it does not matter what was on screen before.

background
The color behind the figure, with its own opacity, in Solid › fill. It follows the theme until you pick one, and is yours from then on — a background somebody chose should not be repainted because the light outside changed.

The opacity is not decoration: what you see is what an exported image carries. At 100 the picture comes out on a solid ground; in between it carries a genuinely semi-transparent background, so a PNG can sit over whatever it is dropped onto while still tinting it; at 0 there is no background at all, which is the transparent PNG that used to be the only thing on offer. JPEG has no alpha to carry, so it is laid on white first and then given whatever the background says.

perspective
Where the centre of projection sits, given as the figure's own radius divided by its distance: 0 is the parallel camera at infinity, 0.1 an eye ten radii out, 0.25 four radii. A number and a slider, on the same value, running from −0.8 to 0.8.

Negative values put the centre behind the figure and reverse the effect: what leans away from you is drawn larger, what leans toward you smaller. That is the reverse perspective of icon painting, and on a stellation it opens out the far side of the figure rather than the near one. Nothing in the projection asked the sign to be positive — the middle plane is still fixed, the clip plane simply moves to the far side with the centre — so the slider passes through the parallel camera at 0 without a seam.

The unit is the radius of whatever is currently selected, so the eye stands off in proportion to it and a bare core and a stellation eight times its size look alike at the same setting. The cost is that adding or removing cells moves the eye with the figure, so the interior shifts on screen as it grows — perspective is for looking, and the parallel camera at 0 is the one that holds the interior still.

It is a deformation of the parallel camera rather than a second camera, and the property that makes it usable on a stellation is that the plane through the centre keeps its size for every setting. Turning it up therefore does not resize or re-frame the figure — it leans the parts in front of that plane toward you and the parts behind it away, about a plane that stays put — and at 0 it is exactly the parallel projection again, with no jump on the way.

Navigation stays in the picture: panning slides the finished image, zooming scales it, and fit changes only that zoom, so none of them move the eye and the perspective you chose survives being looked around. Nothing needs capping: the eye sits at one radius over p, which is outside the figure for every setting on the slider. The setting travels with the saved view, so a document reopens from the camera it was composed at.

auto zoom
Keeps the figure framed as you build, and is on by default. When adding or removing cells pushes the figure out of the view — or leaves it small in the middle of one — the zoom eases to fit again. Between those it does nothing: while the figure still sits comfortably inside the frame, toggling a cell moves nothing, because a rescale on every edit reads as the model changing rather than the selection.

It never re-centres. Adding a cell is not a request to undo a pan you made on purpose, so only the zoom moves — unlike the fit button, which undoes both because “show me all of it” means both. Turn it off and the zoom is yours alone, however far the figure outgrows the view.

Both it and the fit button frame the figure’s radius as it appears in the plane through the centre — the one plane perspective leaves alone. So the framing does not shift when you move the perspective slider, or when you turn the figure. The trade is that at high perspective the parts leaning toward you can reach past the frame, which is the same bargain the middle plane makes everywhere else in this camera.

coordinate axes
The x, y and z axes through the origin, drawn as colored arrows spanning the solid — red, green and blue, each an arrow whose head is a 60° cone. This is the frame the symmetry groups' matrices are written in, so the arrows say which way a group's axes are meant to run: in the z view x points right, y up, and z toward you. They are sized to the selection you have, not to everything the planes could build, so they grow with it. Thickness is adjustable.
Edit planes…
Stellate an arbitrary set of planes instead of a catalog solid — the original program's plane editor. Each row is one plane, written as four numbers (normal, then distance from the origin, full double precision) so it copies and pastes as plain text; then a factor that scales the distance, sliding the plane along its own normal without retyping it; then its own symmetry group — the plane is added together with its whole orbit, whose size is shown beside it. Rows with different groups combine freely: the planes of an icosahedron alongside the planes of a cube, or one solid's planes twice at two depths. A 3D preview draws each plane as a spoke from the origin with a disc lying in it, colored by row. Planes can be imported from a solid, a preset or a file — the same three sources the New dialog offers — each reduced to one row per symmetry class. The sheet saves into the JSON document as before.

A JavaScript port of the Stellation applet written by Vladimir Bulatov between 1998 and 2001. See the Cells walkthrough for what the table means, the history for where these solids come from, and what changed for the current round of work.