Binary Edit Screen - cressie176/Load64 GitHub Wiki

Primary Purpose

Set or clear the VICE binary path for a specific system platform.

Main Screen Design

When a path is already configured:

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  Binaries > <Binary Name>                                                    │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  FORM                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │                   ┌───────────────────────────────────────┐            │  │
│  │  Path             │ /Applications/VICE/bin/x64sc_         │  [Browse]  │  │
│  │                   └───────────────────────────────────────┘            │  │
│  │                                                                        │  │
│  │  [Save]    [Cancel]                                                    │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

When no path is configured:

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  Binaries > <Binary Name>                                                    │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  FORM                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │                   ┌───────────────────────────────────────┐            │  │
│  │  Path             │ _                                     │  [Browse]  │  │
│  │                   └───────────────────────────────────────┘            │  │
│  │                                                                        │  │
│  │   [Save]   [Cancel]                                                    │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

TOP BAR

Focusable: No
Interactive: No
Purpose: Identify the system platform being configured

FORM

Type: Form
Focusable: Yes (primary focus region)
Interactive: Yes
Purpose: Enter or edit the path to the VICE binary for this platform

Pre-populated with the current path if configured, or empty if not. Can be typed directly or selected via the OS file picker opened by [Browse].

Leaving the field empty and saving clears the configured path, setting the system to Not configured.

[Save] / [Cancel]

[Save] validates the path. If valid, saves and returns to the Binary List screen. If invalid, displays an error in the bottom bar and keeps the form open.
[Cancel] discards changes and returns to the Binary List screen.

BOTTOM BAR

Focusable: No
Interactive: No
Purpose: Display validation errors

After a validation error:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Reason>. Games on this platform will be unlaunchable.                      │
└──────────────────────────────────────────────────────────────────────────────┘

Where <Reason> is one of:

Binary not found
Binary is not executable

Validation Rules

Name	Type	Required	Notes
Path	String	No	If provided, must be an existing executable file. Empty clears the path.