reflection

type Broker ¶ added in v0.2.1

type Broker interface {
	GetReflectionRenderer() Renderer
}

Broker implementations can identify a reflection.Renderer.

type Hmove ¶ added in v0.2.1

type Hmove struct {
	DelayCt  int
	Delay    bool
	Latch    bool
	RippleCt uint8
}

Hmove groups the HMOVE reflection information. It's too complex a property to distil into a single variable.

Ordering of the structure is important.

type ID ¶ added in v0.10.1

type ID int

ID identifies the reflection information that can be ascertained from the contents of a VideoStep. Other information can probably be gleaned but these are the ones that have been identified. For convenience only.

const (
	WSYNC ID = iota
	Collision
	CXCLR
	HMOVEdelay
	HMOVEripple
	HMOVElatched
	RSYNCalign
	RSYNCreset
	CoprocessorActive
)

type Reflector ¶ added in v0.10.1

type Reflector struct {
	// contains filtered or unexported fields
}

Reflector should be run (with the Check() function) every video cycle. The (reflection) Renderer's Reflect() function is consequently also called every video cycle with a populated instance of LastResult.

func NewReflector(vcs *hardware.VCS) *Reflector

func (ref *Reflector) AddRenderer(renderer Renderer)

func (ref *Reflector) NewFrame(_ bool) error

func (ref *Reflector) Pause(pause bool) error

func (ref *Reflector) Step(bank mapper.BankInfo) error

type Renderer ¶

type Renderer interface {
	// Mark the start and end of an update event from the television.
	// Reflect() should only be called between calls of UpdatingPixels(true)
	// and UpdatingPixels(false)
	UpdatingPixels(updating bool)

	// Reflect sends a VideoStep instance to the Renderer.
	Reflect(VideoStep) error
}

Renderer implementations display or otherwise process VideoStep values.

type VideoStep ¶ added in v0.8.0

type VideoStep struct {
	CPU               execution.Result
	Collision         video.Collisions
	Bank              mapper.BankInfo
	TV                signal.SignalAttributes
	Hmove             Hmove
	VideoElement      video.Element
	WSYNC             bool
	IsRAM             bool
	CoprocessorActive bool
	IsHblank          bool
	RSYNCalign        bool
	RSYNCreset        bool
}

VideoStep packages together the details of the the last video step that would otherwise be difficult for a debugger to access.

It includes the CPU execution result, the bank from which the instruction originates, the video element that produced the last video pixel on screen; among other information.

Note that ordering of the structure is important. There's a saving of about 2MB per frame compared to the unoptimal ordering.