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
- Odaberi verziju emulatora gumbom iznad biblioteke na naslovnici.
- 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.
- 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.
- 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.