profiling

type Focus ¶

type Focus int

Focus values are used to indicate when (very broadly) a function, a line of code, etc. has executed

const (
	FocusAll      Focus = 0x00
	FocusScreen   Focus = 0x01
	FocusVBLANK   Focus = 0x02
	FocusOverscan Focus = 0x04
)

func (k Focus) String() string

type Load ¶

type Load struct {
	// cycle count
	FrameCount   float32
	AverageCount float32
	MaxCount     float32

	// cycle count expressed as a percentage
	Frame   float32
	Average float32
	Max     float32

	// whether the corresponding values are valid
	FrameValid   bool
	AverageValid bool
	MaxValid     bool
}

Load records the frame (or current) load as well as the average and maximum load.

type Stats ¶

type Stats struct {
	OverProgram  Load
	OverFunction Load

	// cycle count this frame
	Count float32
	// contains filtered or unexported fields
}

Stats records the cycle count over time and can be used to the frame (or current) load as well as average and maximum load.

The actual percentage values are accessed through the OverProgram and OverFunction fields. These fields provide the necessary scale by which the load is measured.

The validity of the OverProgram and OverFunction fields depends on context. For instance, for the SourceFunction type, the corresponding OverFunction field is invalid. For the Source type meanwhile, neither field is valid.

For the SourceLine type however, both OverProgram and OverFunction can be used to provide a different scaling to the load values.

func (stats *Stats) HasExecuted() bool

func (stats *Stats) NewFrame(prog *Stats, function *Stats)

func (stats *Stats) Reset()

type StatsGroup ¶

type StatsGroup struct {
	// cycle statistics for the entire program
	Overall Stats

	// kernel specific cycle statistics for the program. accumulated only once TV is stable
	VBLANK   Stats
	Screen   Stats
	Overscan Stats
}

StatsGroup collates the Stats instance for all kernel views of the program.