KSLCore/ksl.app.config/TracingConfig

TracingConfig

@Serializable

data class TracingConfig(val animationTraceFile: String? = null, val captureLevel: CaptureLevel = CaptureLevel.MINIMAL, val flushEveryNEvents: Int = 1000)(source)

Animation trace capture settings embedded in a RunConfiguration.

When animationTraceFile is null (the default), tracing is disabled and the AnimationTraceAttachment (Phase 7) is never created — zero overhead.

The CaptureLevel taxonomy is a placeholder until Phase 7, where the full set of observable events in ksl.modeling will be inventoried and classified.

Constructors

TracingConfig

constructor(animationTraceFile: String? = null, captureLevel: CaptureLevel = CaptureLevel.MINIMAL, flushEveryNEvents: Int = 1000)

Properties

animationTraceFile

val animationTraceFile: String?

file-system path for the trace output file; null disables tracing

captureLevel

val captureLevel: CaptureLevel

how much detail to capture; see CaptureLevel

flushEveryNEvents

val flushEveryNEvents: Int

how often (in events) the trace writer should flush its buffer to disk