Module touch_intention

Structs§

ControlFollowTracker: Watches the window after a touch to decide, by outcome, whether the touch was a control touch: did the toucher stay with the ball (close and speed-matched) or earn the follow-up touch? Resolutions are applied retroactively to the already-emitted touch event, mirroring how ball-movement credit is finalized.
PossessionResolution: Outcome of a closed control-follow window. touch_index addresses the touch event whose possession tag should be set; possession is the tag to apply, or None when the window resolved without confirming possession.
ShotProjectionResolution: Outcome of a closed shot-projection window. touch_index addresses the touch event to upgrade to a shot when is_shot is true.
ShotProjectionTracker: Watches the ball’s free flight after a touch and decides, from the settled trajectory before the next touch, whether the touch sent the ball goalward — recovering shots whose touch-frame velocity had not yet finished updating. Resolutions are applied retroactively to the already-emitted touch event, mirroring ControlFollowTracker.
TouchActionResolution: The resolved touch intention with supporting context.
TouchIntentionClassifier: Stateful helper that classifies the intention of each touch.
TouchIntentionFrameContext: Per-frame context a touch intention classification draws on.

Possession: What happened to possession after a touch, assigned retroactively by ControlFollowTracker once the outcome is known. Orthogonal to TouchAction: it answers “did the toucher keep the ball?”, independent of what the touch was trying to do.
TouchAction: What a touch was trying to do with the ball, read at contact time.