AbstractAbstractdesignThe tracked record the builder reads, derived rather than transcribed.
Every call must return a record byte-identical to the previous call for the same constructor inputs, because the compiled design is what the frames are derived from. The base class neither checks this nor caches or freezes the result.
AbstractmembersThe subjects this group holds, in a stable order.
Called on every render, so this order is the merge order and therefore
fixes the bytes of the shot program; returning another order on a later
call changes the output.
Merge every member's authored contribution in stable member order.
Each call renders every member again with the same context and merges the results. Nothing is cached, so a nested group re-renders its whole subtree on every call.
A subject that is a collection of subjects.
A cluster holds figures, a group holds clusters, a village holds buildings, a map holds everything standing on it. The shape is the same at every level, which is what makes a line battle authorable: a group advancing is one call rather than two thousand.
rendercomposes its members by default, so a group states what it holds and how it is arranged, not how to draw it. A group that needs to add something of its own (a banner, a dust cue, a shared route) overridesrenderand merges its own contribution withsuper.render, rather than replacing what its members said.Membership is not checked for cycles: a group that lists itself, directly or through a member, recurses in
renderuntil the call stack overflows.