ROM List Screen - cressie176/Load64 GitHub Wiki

Primary Purpose

View and manage the ROM files for a game.

Main Screen Design

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  <Game Title> > ROMs                                          [Add]  [Back]  │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  LIST                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │   #   Label          Filename                                          │  │
│  ├────────────────────────────────────────────────────────────────────────┤  │
│  │ > 1   Disk 1         last-ninja-the-disk1.d64                          │  │
│  │   2   Disk 2         last-ninja-the-disk2.d64                          │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

If no ROMs have been added:

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  <Game Title> > ROMs                                          [Add]  [Back]  │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  Select Add to add a ROM file.                                               │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

TOP BAR

Focusable: [Add] and [Back] CTAs only
Interactive: [Add] and [Back] CTAs only
Purpose: Display the game name and provide access to add ROM files

[Add] CTA

Navigates to the ROM Add screen.

[Back] CTA

Returns to the previous screen.

LIST

Type: Single-selection vertical list
Focusable: Yes (primary focus region)
Interactive: Yes
Order: User-defined; determines disk swap order during gameplay
Purpose: View and select ROM files for editing

Each row shows:

Position number
Label (e.g. Disk 1, Side A)
Filename

Selecting a row navigates to the Game ROM Edit screen pre-populated with its values.

Context Menu

Action	Behaviour
Reorder	Enters reorder mode for the focused ROM. See Reorder Mode.
Remove	Opens a confirmation overlay before removing the focused ROM.

Reorder Mode

While in reorder mode, Escape cancels the reorder without making any changes and returns focus to the list.

Controller	Keyboard	Behaviour
Back	Escape	Cancel reorder; discard changes

Remove confirmation overlay:

┌──────────────────────────────────────────────────────────────────────────────┐
│                    ┌──────────────────────────────┐                          │
│                    │ Remove <Label>?              │                          │
│                    │                              │                          │
│                    │   > Yes                      │                          │
│                    │     No                       │                          │
│                    └──────────────────────────────┘                          │
└──────────────────────────────────────────────────────────────────────────────┘

Option	Behaviour
Yes	Remove the ROM from the list and delete the file from the game directory
No	Close the overlay and return focus to the list

BOTTOM BAR

Focusable: No
Interactive: No
Purpose: Display confirmation messages after any ROM action

After adding a ROM:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Filename> added                                                            │
└──────────────────────────────────────────────────────────────────────────────┘

After renaming a label:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Old Label> renamed to <New Label>                                          │
└──────────────────────────────────────────────────────────────────────────────┘

After changing a ROM file:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Old Filename> replaced with <New Filename>                                 │
└──────────────────────────────────────────────────────────────────────────────┘

After removing a ROM:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Label> removed                                                             │
└──────────────────────────────────────────────────────────────────────────────┘