ORAO / UPUTE BIBLIOTEKE

Novi pristup.Potpuno sačuvan emulator.

Što je sačuvano?

Skripte, stilovi, ROM i svi arhivirani emulatorovi izvori ostaju identični. Biblioteka je dio naslovnice na /orao/ i otvara izvorni emulator iz njegove postojeće arhive. Naslovnica je dopunjena bibliotekom; njezin prijašnji sadržaj sačuvan je u usporednim i povijesnim zapisima projekta. Izvorne datoteke nisu kopirane u prepravljenu verziju niti su mijenjane pri učitavanju.

Nova skripta biblioteke ne zamjenjuje emulatorove funkcije, prototipove ili ROM. Poziva već postojeće radnje i standardna sučelja browsera. Samostalni izvorni emulator možeš i dalje otvoriti bez biblioteke. Izvorni arhivski manifest i SHA-256 omogućuje provjeru svakog arhiviranog izvora.

Karusel i odabir datoteke

Kasete su grupirane u vodoravni karusel koji zadržava jedan red i kada biblioteka raste. Strelice ili povlačenje prstom pomiču popis. Riftfarer ima izbor pet verzija, a PEL demonstracija izbor dva dijela; ostale kasete prikazuju svoj pojedinačni zapis. Malom strelicom uz naziv odaberi datoteku koju želiš povući. Odabir vrijedi i za detalje, preuzimanje, Učitaj i Novi Orao. Naziv otvara detalje mišem, dodirom ili tipkovnicom. Izbor datoteka i detalji ostaju izvan emulatorova canvasa.

Prva datoteka u grupi odabrana je početno: Riftfarer v0.5.0 i PEL Demo1. Svaki raniji zapis ostaje dostupan u izborniku, sa svojim izvornim sadržajem i provjerom. Odabir ne pokreće učitavanje; povuci kasetu ili koristi Učitaj / Novi Orao iz detalja.

Tipkovnica: Tab bira kontrole, lijevo/desno ili Home/End pomiču fokus među kasetama. Enter na nazivu otvara detalje. U izboru datoteke koristi gore/dolje, Home/End i Enter; Escape zatvara izbor i vraća fokus. Karusel se ne pomiče automatski.

Kako učitati igru

  1. Odaberi verziju emulatora gumbom iznad biblioteke na naslovnici.
  2. Povuci kasetu na prozor virtualnog Orla. Pogađa se prozor na mjestu ispuštanja; bilježnica, programi i prazna radna površina ne prihvaćaju kasetu.
  3. Biblioteka provjeri datoteku, umetne je kroz izvorni ulaz za datoteke i aktivira postojeći gumb LMEM. Stvarni monitor u ROM-u učitava kasetu u emulirani RAM.
  4. Za Riftfarer, biblioteka provjeri SHA-256 učitanog programa pa pošalje postojeću naredbu LNK4096. Izvorne PEL demonstracije nakon LMEM učitavanja pokreće njihov vlastiti učitavač; biblioteka provjerava početak BASIC programa i ne šalje dodatni RUN ili LNK. Igra se pokreće na uobičajenoj brzini 1×.

Učitaj je alternativa povlačenju za tipkovnicu i zaslone osjetljive na dodir. Koristi trenutačni Orao ili posljednji postojeći Orao ako je aktivan pomoćni prozor. Novi Orao učitava igru u novo virtualno računalo; ostali nastavljaju raditi. Učitavanje u postojeći Orao zamjenjuje njegov program. Tijekom učitavanja jedna kaseta koristi 16× brzinu. Cijeli postupak traje nekoliko sekundi i ima pokazivač napretka.

Možeš povući i preuzetu TAP datoteku na Orlov prozor. Automatsko učitavanje dostupno je za datoteke koje se SHA-256 sadržajem podudaraju s bibliotekom. Za ostale kasete koristi izvorni gumb IN i autorove upute: različite kasete mogu tražiti LOAD/RUN, LMEM/LNK ili drugu početnu adresu.

Prva konverzija i poboljšano izdanje

Kasete Riftfarer / Orao 0.1.0, 0.2.0, 0.3.0, 0.4.0 i 0.5.0 sadrže oba nivoa u jednom programu pisanom za 6502. Prva kaseta čuva početnu konverziju, a druga dodaje glađi let i nasumični raspored platformi. Treća kaseta ispunjava teren, popravlja sudare bombi i ubrzava pećinu na oko 47 FPS pri 1 MHz. Četvrta kaseta odvaja logiku i crtanje pećine: oko 33 logička koraka i 67 prolaza crtanja u sekundi pri 1 MHz, uz mirniji tempo i interpolirane pokrete. To su mjerenja nativnog koda; broj vidljivih slika ovisi i o osvježavanju browsera. Peta kaseta uklanja preostale skokove neprijatelja: kreću se u koracima od jednog piksela, a nova rutina zadržava likove vidljivima tijekom računanja i precrtava samo promijenjene. Tempo ostaje približno isti, oko 31 logički korak i 61 prolaz crtanja u sekundi pri 1 MHz. Paketi izvornog koda uz kartice sadrže upute, dokumentirani razvoj, sastavljač, izvore, provjere i licencu GPL-3.0-or-later. Sve datoteke kaseta i izvornog koda kopije su pripadajućih sačuvanih izdanja.

Manic Miner — Nenad Mihailović

Izvorna kaseta iz ManicMiner.zip sačuvana je bajt po bajt. Autor je Nenad Mihailović, kako je navedeno pri dostavi i u izvornom naslovnom prikazu. Oznaka „Izvorna” označava dostavljeni zapis; broj verzije, datum i licenca nisu navedeni u arhivi. Igra ima 13 pećina.

Povuci kasetu na Orlov prozor. Izvorni LMEM učitavač sam pokreće program; biblioteka ne šalje dodatni RUN ili LNK. Igra zadržava vlastito uvodno čekanje: nakon učitavanja zaslon može nakratko biti prazan. Kada se pojavi naslovni ekran, pritisni Enter za početak. Kontrole prikazuje izvorna igra. Objavljeni TAP i emulator ostaju neizmijenjeni; vanjska biblioteka koristi isti privremeni završni omot kao za PEL demonstracije. Podrijetlo i SHA-256.

PEL Varaždin: Mikroračunalo Orao

Demo1 i Demo2 dva su izvorna zapisa iz dostavljene arhive Demo.zip. TAP datoteke sačuvane su bajt po bajt; oznake Demo1 i Demo2 nazivi su zapisa. Licenca i datum nastanka nisu navedeni u arhivi. Svaka kaseta sadrži vlastiti učitavač, grafiku i BASIC demonstraciju.

Za učitavanje u ovom emulatoru koristi biblioteku na naslovnici. Vanjska biblioteka privremenoj datoteci za izvorni ulaz IN dodaje 360 završnih bajtova koje stari parser odbacuje. Time se pročita cijeli zapis. Preuzeta kaseta i kod emulatora ostaju neizmijenjeni. Izvorni učitavač sam pokreće demonstraciju; brzina prikaza vraća se na 1×. Podrijetlo, veličine i SHA-256 kaseta.

Dodavanje budućih kaseta

Popis je u catalogue.json. Datoteke iste kasete poveži jednakim group_id; bez te oznake grupiraju se isti naslovi. Svaka datoteka zadržava vlastiti jedinstveni ID i način učitavanja. Prvi zapis grupe početno je odabran. Za novu kasetu dodaj novu datoteku i novi zapis s jedinstvenim identifikatorom, naslovom, verzijom, veličinom, SHA-256, licencom i kompatibilnim verzijama emulatora. Način učitavanja je LMEM za strojni kod ili LOAD za BASIC. Strojni kod navodi početnu adresu kao decimalni broj, a BASIC se pokreće naredbom RUN. Provjera učitanog dijela RAM-a je opcionalna; uključena je za sve postojeće kasete. Buduće verzije emulatora trebaju zasebno biti provjerene i označene kao kompatibilne.

Lokalni pregled i objava

Automatsko učitavanje treba HTTP ili HTTPS i emulator na istoj domeni kao biblioteka. Browser može izolirati iframeove i onemogućiti dohvat datoteka kada je stranica otvorena putem file://. U radnoj mapi projekta pokreni node orao-tests/tape-library-server.cjs, zatim otvori http://127.0.0.1:8788/orao/. Za pregled nije potreban pristup internetu.

Stranica je pripremljena za postojeće statičko web sjedište. Objavljuju se promijenjene datoteke naslovnice i biblioteke te njihovi Markdown pratitelji. Arhiva emulatora ostaje neizmijenjena na istoj adresi. Prijašnja adresa /orao/tapes/ preusmjerava na naslovnicu i biblioteku. Provjera očuvanog emulatora i novog sučelja. Tracker i događaj aktivacije verzije emulatora koriste postojeću, neizmijenjenu skriptu za analitiku; pojedini virtualni Orlovi nisu zasebne aktivacije verzije.