video

type CPU interface {
	AddEvent(cpu uint8, delay33MHz int64, taskID uint16)
	RegisterTask(name string, cb func(late int64, _ uint64), prio uint8) (taskID uint16)
	IRQ(cpu uint8, irqID int, late33MHz int64)
	CheckDMAs(cpu uint8, mode uint8)
}

type Extpal struct {
	Bg  [(32 * KB) / 2]uint16 // 32KB
	Obj [(8 * KB) / 2]uint16  // 8KB
}

type ExtpalMapping struct {
	Bg  [4]mapFlag // 4 * 8KB ; e.g [[E, F], [E, F], [E, G], [E, G]] -> スロット0 には バンク E, F がマッピングされている, スロット2 には バンク E, G がマッピングされている
	Obj mapFlag    // 8KB; とりうる値は [], [F], [G], [F, G] の4つのどれか
}

type Fastmem struct {
	BGa  [32]([]uint8)
	BGb  [8]([]uint8)
	OBJa [16]([]uint8)
	OBJb [8]([]uint8)
}

type Mapping struct {
	// マッピングのブロックサイズは全部同じサイズにしたいので、最低サイズに合わせる(例: BGa は 16KB の バンクF, G がマッピングされる可能性があるので 16KB にする)
	BGa  [32]mapFlag // 32 * 16KB = 512KB; e.g. BGa[7] が ((1 << VRAM_BANK_A) | (1 << VRAM_BANK_C) | (1 << VRAM_BANK_D)) -> 0x0601_C000..0601_FFFF に書き込んだとき、バンク A, C, D に書き込む
	BGb  [8]mapFlag  // 8 * 16KB = 128KB
	OBJa [16]mapFlag // 16 * 16KB = 256KB
	OBJb [8]mapFlag  // 8 * 16KB = 128KB
	LCDC mapFlag

	WRAM7   [2]mapFlag       // 2 * 128KB = 256KB (バンクC,Dしかマッピングされないので最低サイズが128KB); e.g. WRAM7[0] が ((1 << VRAM_BANK_C) | (1 << VRAM_BANK_D)) -> wram7領域のオフセット0(NDS7アドレス: 0x0600_0000..0601_FFFF) に書き込んだとき、バンク C, D に書き込む
	Extpal  [2]ExtpalMapping // [EngineA, EngineB], 本来、最低サイズは BG:32KB, OBJ:16KB だがスロットサイズは8KBなので、それに合わせる
	Texture [4]mapFlag       // 4 * 128KB = 512KB (バンクA,B,C,Dしかマッピングされないので最低サイズが128KB)
	Texpal  [6]mapFlag       // 6 * 16KB = 96KB (バンクE,F,Gがマッピングされるので最低サイズが16KB)
}

type PPU struct {
	Power bool // falseだとレジスタが読み取り専用になる

	// Registers
	LCDC                       uint32    // DISPCNT
	BGCNT                      [4]uint16 // BGnCNT
	BGOFS                      [4]scroll // BGnOFS
	BG2X, BG2Y, BG3X, BG3Y     uint32
	BG2Xi, BG2Yi, BG3Xi, BG3Yi uint32    // BG2XYとBG3XYの内部(ラッチ)レジスタ(実際にハードウェアに存在)
	BG2P, BG3P                 [4]uint16 // BG2PA, BG2PB, BG2PC, BG2PD, BG3PA, BG3PB, BG3PC, BG3PD
	WININ                      [3]uint8  // WININ0, WININ1, WININ2
	WINOUT                     uint8     // WINOUT
	MOSAIC                     uint16    // 0x0400004C(BG), 0x0400004D(OBJ)
	BLDCNT, BLDALPHA           uint16

	Extpal Extpal // Extended Palettes
	CAPCNT uint32 // DISPCAPCNT (エンジンAのみ)
	// contains filtered or unexported fields
}

type VRAM struct {
	STAT    uint8    // NDS7.0x04000240
	Cnt     [9]uint8 // bit0-2: MST, bit3-5: Offset, bit7: Enable(NDS9アドレス空間にマッピングされているか)
	Data    [656 * KB]uint8
	Bank    [9][]uint8 // A:128KB, B:128KB, C:128KB, D:128KB, E:64KB, F:16KB, G:16KB, H:32KB, I:16KB
	Mapping Mapping
	Tracker vramTracking // 3Dエンジン や その他コンポーネント とのVRAMのコピーのためにVRAMの変更を追跡する
	Ptr     Fastmem
}

type Video struct {
	CPU         CPU
	Frame       uint64
	FrontBuffer uint8 // 0 or 1 (現在画面に表示されているフレームバッファのインデックス)
	FrameBuffer [2][256 * (192 * 2)]color.NRGBA
	Ly          int16
	PPU         [2]*PPU // 2Dエンジン, [EngineA(下画面), EngineB(上画面)] (ただしPOWCNT1のDisplay Swapで上下入れ替え可能)
	GPU         *gpu.GPU

	// Memory
	Palette [512 + 512]uint16 // GBAと同じパレットx2(エンジンAとエンジンB), 合計2KB
	VRAM    *VRAM
	OAM     [(1 * KB) * 2]uint8 // GBAと同じOAMx2(エンジンAとエンジンB), 合計2KB

	// Registers
	/*
		  DISPSTAT (0x0400_0004)
		  2DエンジンA,Bに1つずつではなく,ARM9とARM7で1つずつ(VBlankのときにARM7にだけ割り込みをかけたい場合などに使う)
			bit0,1,2 は共有しているらしい (https://discord.com/channels/465585922579103744/667132407262216272/1181684466477973635)
	*/
	STAT    [2]uint16
	Powcnt9 uint16 // POWCNT1

	// Task
	Task struct {
		HBlank uint16 // HBlank タスクID
		HDraw  uint16 // LYをインクリメントするタスクID
	}

	// デバッグ用
	Debug struct {
		SwapBuffer bool // このフレームで SWAP_BUFFERS　が実行されたかどうか
	}
	// contains filtered or unexported fields
}