Dated source reference. Current release status: handoff state. Full original relative paths are in the developer archive.

Flat lineup graphics

pregame.lineups_flat offers a complete two-team card at the guarded native lineup draw. It uses the fresh public snapshot's five on-court players for each team. match_lineups.v1 exposes away.team_name, home.team_name and {away,home}.players.{0..4}.{key,name}. Order follows the copied native roster slots. A slot is not a playing-position label. Missing names, incomplete teams or duplicate slots withhold the whole card rather than guessing a player.

The scene data may also be used by an explicitly requested ordinary client graphic. A native draw scene uses selection none; it does not select one player or one team. Source run, match, epoch and source revision must match the catalog. Player keys are canonical public API keys, not identities inferred from the native animation's text.

The optional native capability is bit 32768 in the existing plane transport. Declare a version5 replace owner with dependencies score, phase, period. The adapter permits this alternative only at its actual lineup draw during the verified pregame phase. All normal run, lifetime, pause/replay, generation, 100 ms freshness, frame expiry, resource and successful-pixel-draw guards apply. Missing or refused pixels preserve the original native draw. Native updates, 3D staging, resource work and completion callbacks continue behind the card.

Choose exactly one of pregame.lineups_flat and pregame.lineups_3d per package. They are alternatives for one physical draw, not independently suppressible graphics. Both package loading and native frame validation reject simultaneous claims. Older hosts do not advertise the flat capability: required ownership refuses, while optional ownership remains hidden and native graphics continue.

The neutral example generator accepts flat_lineups=True separately from lineups=True. The latter retains copied native visual slots and statistics; the flat option displays both complete copied on-court lists. Neither option claims native sequence start, completion, cancellation, interruption, or a selected-player cue. The new flat option requires its own exact-build native acceptance before it may be listed as accepted in the coverage ledger.