Skip to main content

Development capture and storage

Normal user mode leaves the development subsystems dormant. An API consumer cannot override the user's INI ceiling.

Permission layers

  1. INI mode: User, Observe, Harvest or Capture.
  2. Cache policy: Off, ReadOnly or ReadWrite.
  3. Allowed scope mask derived from those settings.
  4. AllowApiActivation, which decides whether API demand may wake dormant work.
  5. A consumer lease requesting an allowed subset for 1–1200 frames.

INI auto-start is separate. If API activation is disabled, both explicit capture leases and older high-cost capability demand remain unable to wake the work.

Scope meaning

ScopeWork
PassiveObservationPassive reload/animation observation.
ExactAnimationHarvestExact off-screen weapon clip sampling.
WeaponMotionCompilationCompile value-only motion paths.
CompiledCacheReadRead validated compiled records.
CompiledCacheWritePersist compiled records.
LiveMotionLearningLearn strokes from native observations.

The 128 MiB sample budget bounds raw in-process animation evidence. Persistent storage contains compiled value-only motion paths, not native graphs or the raw sample catalog. ReadOnly never creates directories/files, touches timestamps, prunes, or writes.

An authoring UI should show allowed, requested, active and denied scopes; lease remaining; preharvest progress; sample bytes; clip/part/stage counts; persistent records; and pending writes. PermissionDenied is a valid user policy result.

Ship capture disabled, renew a short lease while the authoring session is open, and clear it immediately on close/reset/shutdown.