Expand description
Pure orchestration between a pacing director, adaptive hunt AI, and presentation.
perturbator_orchestra maps perturbator_director::PacingContext into the
small perturbator_hunt_ai::HuntPacing contract and combines pacing with
sanitized hunt telemetry to produce continuous emotional intent plus sparse
dramatic cues. It never queries a world, plays audio, moves a boss, or controls
a camera; hosts translate its normalized output into their own presentation stack.
The same contract serves 3D and isometric games first, and 2D games as well,
because it contains no coordinate, transform, camera, or navigation types.
use perturbator_director::PacingContext;
use perturbator_orchestra::{
ConductorInput, EmotionalConductor, HuntPacingMapper, HuntStage, HuntTelemetry,
PlayerAgency,
};
let mut pacing = PacingContext::default();
pacing.tension = 0.7;
let hunt_pacing = HuntPacingMapper::default().map(pacing)?;
let hunt = HuntTelemetry::new(HuntStage::Search, 0.6, 0.5, 0.0, false)?;
let output = EmotionalConductor::default().update(
1.0 / 60.0,
ConductorInput {
pacing,
hunt_pacing,
hunt,
agency: PlayerAgency::InControl,
reduced_sensory: false,
},
)?;
assert!(output.intent().dread() > 0.0);Structs§
- Axis
Smoothing - One attack/release pair for exponential smoothing.
- Conductor
Config - Timing and safety limits for
EmotionalConductor. - Conductor
Input - Immutable input for one conductor update.
- Conductor
Output - Output of one conductor update.
- Emotional
Conductor - Stateful emotional orchestrator with attack/release smoothing and cue debouncing.
- Emotional
Intent - Normalized emotional axes consumable by music, ambience, lighting, or camera adapters.
- Hunt
Pacing MapConfig - Designer-authored mapping from macro pacing into the hunt AI’s two-axis input.
- Hunt
Pacing Mapper - Validated, deterministic bridge from
PacingContexttoHuntPacing. - Hunt
Telemetry - Sanitized hunt facts safe for presentation systems.
- Pacing
Modifiers - Optional host adjustments applied after the director context is sampled.
Enums§
- Emotional
Cue - Edge-triggered dramatic punctuation emitted by the conductor.
- Hunt
Stage - Player-visible phase of an adaptive hunt.
- Orchestra
Error - Fail-closed error returned for invalid configuration or runtime input.
- Player
Agency - Whether presentation may safely escalate while the player can respond.
Type Aliases§
- Orchestra
Result - Result alias used by orchestra operations.