- 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.