Inspection snapshots and the scriptable game harness.

Classes

CutsceneDirector FlightCamera GalaxyInspectorRead-only diagnostics derive from the current world, including after a save load.GameHarness Maneuvers Observatory OnFoot Series

Interfaces

AstronomyNote BaselineEntry BaselineOptions CapabilityContext CapabilityResult CutsceneOutcomeWhich scene left, and how.CutsceneScriptA scripted scene.CutsceneStatus DescentOptionsWhere a descent goes, and how it is flown.DescentReport DescentStatusA drop in flight: how far down it is, and how long it has left.DescentStep DossierEverything the object panel draws, for one star or one body.DropAim EntityInspection FactOne reading: what it is, what it says, and a second scale for the same thing.FactGroupA titled run of facts.FlightCameraStatus FrameStatsFrame timing from a render loop.GalaxyJourneyStatusEverything a panel needs to draw the observatory's state.GalaxyPlate GalaxyPlateOptions GalaxyRenderReport GenerationCostTiming for the CPU half of a patch, measured rather than budgeted.GuideHostPort GuideStatusConversation diagnostics exclude transcript and provider credentials.GuideTraceEntryOptional, in-memory data-channel traffic; never authentication traffic.GuideUsageWhat the session has cost so far, as the provider reports it.HarnessStatus HostWhat the harness is built over: the simulation, and the render side.LateFrame LoadOutcomeWhat a successful load gives back.ManeuverResult ObserverMotionRecipe ObserverMotionStatus ObserverPoseA camera pose in universe coordinates: where the eye is, and where it looks.ObserverStatus ObserverTargetWhat the camera is looking at, once an address has been resolved.OnFootStatus OrbitInspectionThe orbit a ship is on, as the numbers a pilot reads: how high it goes and how low, above the datum rather than from the center, and how long a lap is.OrbitPathOne body's path, in universe coordinates, starting at where it is now.OrbitPathOptions OrbitScopeContextWhat the host knows about the subject when it decides which traces to keep.PassReportThe frame's GPU time by pass, independent of the renderer that timed it — apps/game/src/render/passTimeline.ts produces it, ir.passes() reports it.Picture PictureReportThe reconstruction's live buffers and history, independent of its host API.PlayOptionsHow play is asked to run a scene.PreparedCutscene ProfileOptions ProfileReport RenderHost RenderInspection ResolvedSubjectA subject as the tools use it: identity and framings, and the record.SatelliteA body going round this one, as a row that can be clicked.ScenarioResult SearchEntryOne string a place can be found by, and the address it belongs to.SeriesStats SessionA running session: the host the harness is built over, and what came with it.SessionOptions ShotPlacement SiteProbeWhat a descent onto one survey site does, without generating anything.SpanSummary StageThe harness's stage, as the walker sees it.StepOutSite SurfaceStatusWhere the camera is standing, when it is standing rather than orbiting.TerrainBaseline TerrainCacheReport TerrainReportWhat a live terrain streamer has, as data.TimingEntryOne entry, read back off a timeline.TimingPortWhat a host has to be able to do for ir.timing and ir.profile to work.TimingVerbir.timing — a callable that also carries the rest of the verbs.TravelTargetA place the player can be sent, as a row of a listing.TravelTargetOptions ViewDescription ViewOptions ViewSubjectWhere a body sits in the frame, in the words a guide would use.WorldInspection ZooEntryWhat the zoo says about one of its members.ZooOptions

Types

BootPhaseRenderHost.boot: renderer absent, drawing under the cover, or up.CutsceneEndingHow a scene left the director.GalaxyPlateView GuideStateWhat the guide is doing, as one code a script can compare against.PictureFramingWhat a picture asks the camera to do.PictureProcessingA portable camera choice excludes display headroom and adaptation history.ShotDefinitionThe list, as the ship placer sees it.SubjectLookup TravelDestination

Functions

astronomySource baselineAddresses canHoldOrbit captureCameraProcessing createTourContext currentBodyAddress currentSystemOf decodePictures descentRegions descentTarget describeView dossier encodePictures findPicture findShot gravity headingOf inspectEntity inspectRender inspectWorld isPicture isZooCandidate kindNoun landingTarget lookAlong makeTimingVerb measureHeightfieldSource measurePatchGeneration mergePictures missingArchetypes normalizeSubjectName openSession orbitalPhase orbitPaths orbitScopeKey pictureIds placeShot placeWord plateName readAstronomyNote renderHost resolveDestination resolveSubject runCapabilityChecks sameTargets sampleIsFinite screenPositionOf searchEntries searchIndexVersion searchTargets shotNames simulateDescent snapshot standoffShot subjectAt subjectBrief summarizeBaseline summarizeCapabilities summarizeDescent summarizeProfile sunDirection synodicDay targetsFor terrainBaseline terrainBaselineWithSource terrainZoo tidallyLocked tngScreenDirection tourCandidate tourSubjectId travelTargets unresolvedCompositions viewingAltitudeKm visibleOrbits withAstronomyNotes withNotes zooRelief

Constants

ASTRONOMY_NOTESThe collection covers historical findings, not current mission schedules.CUTSCENESThe director and document host publish the same scene library.DEBUG_LANDING_SITEWhere land puts a ship when nobody says otherwise: the surface scenario's site and the dock's Land button's.DEFAULT_CACHE DEFAULT_DROPPED_FRAME_MSWhere a frame stops being jitter, for a caller that supplies no budget.DEFAULT_FILLThe opening framing for a newly picked target: a disk with space around it.DEFAULT_PICTURE_PROCESSINGVersion 1 preserves its camera geometry, not its historical image appearance.DEFAULT_SAMPLESEnough for a smooth ellipse at any framing; 48 shows facets on a wide shot.DEFAULT_SEARCH_LIGHT_YEARSHow far a world search sweeps when it is not told.DEFAULT_SEARCH_LIMITHow many of the nearest matches a search keeps.DESCENT_RAILThe credit descent as a rail — the pass design/plans/tng-intro.md §2 says jags, and the jag is what a straight line refuses.ENTERPRISE_PORTRAITSThree held photographs; the director owns both poses and the entire lens.FLIGHT_FAST FLIGHT_FLOOR_SPEED FLIGHT_SPEED_PER_HEIGHT MARS_LANDING MARS_PAD_SITEThe instant the scene is composed for, in J2000 seconds: the Sun 3° above the horizon and west of MARSPAD, so the descent is shot into a sunset.MAX_FILE_PICTURES MAX_PICTURE_BYTES MAX_PICTURES NO_GUIDE_USAGE PICTURES PLATE_HEIGHT PLATE_WIDTHThe plate for a picture: its file name, and the size it is captured at.RISE_HEIGHT_RADIIHow high a rise stands, as a fraction of the body's own radius.SEARCH_BATCHHow many systems one search job walks.SHOTS TNG_CUTSThe shot boundaries, so a test can assert where the cuts are.TNG_HULL_LENGTHHull length the ranges assume, and the lens they are solved for.TNG_INTRO TNG_LENS TNG_RAILSThe rails and the frames they own, for tests and for a throttle audit.TNG_SHIP_BEATSThe authored screen beats, in their measured form.TNG_TITLE_WINDOWSThe measured windows the script must reproduce.TNG_WIPE_OCCLUSIONSThe measured wipe occlusions, and the offsets that place them.TNG_WIPE_OFFSETS TRAVEL_TAUHow long a fly-to takes to close 63% of the gap, seconds.UNAVAILABLE_GUIDE WIPE_RAILThe wipe as a rail, and the check that it is the right one.ZOO_MIN_RADIUSBelow this a body is a rock rather than a world, meters.