Media Get From URL Screen - cressie176/Load64 GitHub Wiki

Primary Purpose

Add an image from a remote URL to the candidate grid on the Cover Art screen or Screenshots screen.

Main Screen Design

Cover Art

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  <Game Title> > Media > Cover Art > From URL                                 │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  FORM                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │                                                                        │  │
│  │  URL *                                                                 │  │
│  │  ┌──────────────────────────────────────────────────────────────────┐  │  │
│  │  │ _                                                                │  │  │
│  │  └──────────────────────────────────────────────────────────────────┘  │  │
│  │                                                                        │  │
│  │  [Download]                                                            │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

Screenshots

┌──────────────────────────────────────────────────────────────────────────────┐
│ TOP BAR                                                                      │
│  <Game Title> > Media > Screenshots > From URL                               │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  FORM                                                                        │
│  ┌────────────────────────────────────────────────────────────────────────┐  │
│  │                                                                        │  │
│  │  URL *                                                                 │  │
│  │  ┌──────────────────────────────────────────────────────────────────┐  │  │
│  │  │ _                                                                │  │  │
│  │  └──────────────────────────────────────────────────────────────────┘  │  │
│  │                                                                        │  │
│  │  [Download]                                                            │  │
│  └────────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
├──────────────────────────────────────────────────────────────────────────────┤
│ BOTTOM BAR                                                                   │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

Import mode

In import mode the breadcrumb is prefixed with Import Games >:

Import Games > <Title> > Media > Cover Art > From URL
Import Games > <Title> > Media > Screenshots > From URL

TOP BAR

Focusable: No
Interactive: No
Purpose: Identify the screen and the calling context

Context	Mode	Title
Cover Art	Standard	`<Game Title> > Media > Cover Art > From URL`
Cover Art	Import	`Import Games > <Title> > Media > Cover Art > From URL`
Screenshots	Standard	`<Game Title> > Media > Screenshots > From URL`
Screenshots	Import	`Import Games > <Title> > Media > Screenshots > From URL`

See Import Candidate screen for the <Title> derivation rule.

FORM

Type: Form
Focusable: Yes (primary focus region)
Interactive: Yes
Purpose: Provide a remote image URL to download and add to the candidates grid

URL field

A text input for the remote image URL. LoadC64 downloads the image and stores it in the appropriate media subfolder (media/cover/ for Cover Art, media/screenshots/ for Screenshots) when [Download] is pressed. The filename is derived from the image content — see Media filename conventions. Downloading the same image again, from any URL, is idempotent: the existing file is overwritten and no duplicate appears in the candidates grid.

[Download]

Downloads the image from the URL and returns to the calling screen, where the image is appended to the candidates grid and focused. If the download fails, the error is shown in the bottom bar and the screen remains open.

BOTTOM BAR

Focusable: No
Interactive: No
Purpose: Display errors when the image cannot be downloaded

After an error:

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

Validation Rules

Name	Type	Required	Notes
URL	String	Yes	Must not be empty.