Vice Argument Edit Screen - cressie176/Load64 GitHub Wiki

Primary Purpose

Add or edit a VICE command-line argument for a profile or launch configuration.

Main Screen Design

When adding a new argument:

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  <Owner> > VICE Arguments > Add                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  FORM                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │                   ┌─────────────────────────────────────────────────┐  │  │
│  │  Name             │ _                                               │  │  │
│  │                   └─────────────────────────────────────────────────┘  │  │
│  │                                                                        │  │
│  │                   ┌─────────────────────────────────────────────────┐  │  │
│  │  Value            │ _                                               │  │  │
│  │                   └─────────────────────────────────────────────────┘  │  │
│  │                                                                        │  │
│  │  [Save]   [Cancel]                                                     │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

When editing an existing argument:

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  <Owner> > VICE Arguments > <Argument Name>                                  │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  FORM                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │                   ┌─────────────────────────────────────────────────┐  │  │
│  │  Name             │ -sidmodel_                                      │  │  │
│  │                   └─────────────────────────────────────────────────┘  │  │
│  │                                                                        │  │
│  │                   ┌─────────────────────────────────────────────────┐  │  │
│  │  Value            │ 8580_                                           │  │  │
│  │                   └─────────────────────────────────────────────────┘  │  │
│  │                                                                        │  │
│  │  [Save]   [Cancel]                                                     │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
└──────────────────────────────────────────────────────────────────────────────┘

TOP BAR

Focusable: No
Interactive: No
Purpose: Identify the owner and the argument being edited

<Owner> is the full breadcrumb path to the owner. i.e.

Owner	Owner Template	Add Example	Edit Example
Controller Families	Controller Families >	Controller Families > Logitech > VICE Arguments > Add	Controller Families > Logitech > VICE Arguments > -sidmodel
Controllers	Controllers >	Controllers > Logitech Dual Action > VICE Arguments > Add	Controllers > Logitech Dual Action > VICE Arguments > -sidmodel
Launch Configuration		The Last Ninja > VICE Arguments > Add	The Last Ninja > VICE Arguments > -sidmodel

FORM

Type: Form
Focusable: Yes (primary focus region)
Interactive: Yes
Purpose: Enter or edit the argument name and value

Fields are pre-populated when editing an existing argument, or empty when adding a new one.

Name

The full argument name including its prefix (e.g. -sidmodel, -autostart-warp, +confirmonexit). VICE arguments begin with - or + and contain no spaces.

Value

Optional. The argument value (e.g. 8580). Leave empty for flag-style arguments that take no value (e.g. -autostart-warp).

[Save] / [Cancel]

[Save] saves the argument and returns to the Vice Argument List screen.
[Cancel] discards changes and returns to the Vice Argument List screen.

BOTTOM BAR

Focusable: No
Interactive: No
Purpose: Display validation errors

After a validation error:

├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│  <Error message>                                                             │
└──────────────────────────────────────────────────────────────────────────────┘

Behaviour

When adding: fields are empty on entry.
When editing: fields are pre-populated with the current values.
If validation fails, the error is shown in the bottom bar and the form remains open.

Validation Rules

Name	Type	Required	Notes
Name	String	Yes	Must not be empty. Must begin with `-` or `+`. No spaces.
Value	String	No	May be empty.