BGB versione 0.85

homepage: bgbemu.cjb.net, www.tomaatnet.nl/~steendijk
email: steendijk@tomaatnet.nl

questo  un emulatore di gameboy/color per piattaforme win32 che probabilmente non verr mai completato

garanzie:
=========
nessuna garanzia di alcun tipo, usatelo a vostro rischio. Questo programma  garantito che non fa nulla di strano al vosto computer, tranne che occupare spazio su hard disk. Non incolpatemi se il vostro computer verr danneggiato o il vostro hard disk verr formattato o altro ancora.
Usare rom protette da copyright con questo emulatore  ILLEGALE, specialmente se non possedete la cartuccia originale.
Se decidete di farlo  solo a vostra responsabilit.

principali caratteristiche:
===========================
* emulazione di GameBoy, GameBoy Color e Super GameBoy
* multiplayer SGB con 2 controller
* esegue quasi tutte le rom perfettamente
* accurata emulazione sonora, suoni identici a un GB/GBC originale. I suoni possono essere scritti in un file .wav
* accurata emulazione video. La grafica  esattamente come quella di un GB/GBC originale
* l'emulazione  molto veloce
* supporto per Joystick/Gamepad, completamente configurabili
* emulazione MBC3 Real Time Clock
* Auto delay/frameskip, il gameboy gira alla velocit reale al 100%
* GameGenie e GameShark cheat
* salvataggio/caricamento con tasti veloci (modello zsnes)
* tasti e colori dello schermo configurabili
* supporto per rom compresse con zip o gzip
* non richiede librerie runtime o DirectX
* supporto per bordi opzionali e una pseudo modalit fullscreen

specifiche tecniche:
====================
* emulazione della cpu "z80" con tutti gli opcode, a 4.194304 MHz o modalit velocit doppia
* emulation di HALT+ints
* Emulation dello schermo LCD, 59.7275 fps, emulatione di "ISTAT".
* tutti gli interrupt sono emulati
* Supporto per MBC1,MBC2,MBC3+rtc, MBC5, e parzialmente mappatura HuC1/HuC3, dimensione delle rom fino a 64Mbit, memoria ram fino a 1 mbit
* La RAM non inizializzata contiene numeri generati a caso (come nella realt)
* suono stereo, volume globale o per canale, envelope, sweep, suono bianco, aggiornamento CH3 come nella realt, registrazione rapida dei cambiamenti. I suoni sono generati con una qualit fino a 48KHz/16bits.
* emulazione della modalit GB o GBC, in modalit GB non  supportata nessuna funzione GBC


requisiti di sistema:
=====================
win32 (95/NT o successivi)

Lo schermo deve essere impostato in modalit 16 bit o pi, raccomandata 16 bit perch pi veloce che in 24 o 32 bit.

Scheda sonora o joystick opzionali.

Pentium 133 MHz: giochi GB e vecchi giochi GBC girano fluidamente
Pentium 233-266 MHz: raccomandato per giochi GBC esigenti


cosa potrebbe esserci nelle prossime versioni
=============================================
* supporto per altre rom

tasti:
====== 
numpad +        avanzamento veloce
numpad *        reset del gameboy
numpad -        abilita/disabilita i cheat
Z               bottone B
X               bottone A
Shift           bottone Select
Enter           bottone Start

F2 salva un'immagine
F3 seleziona un'immagine salvata
F4 carica un'immagine salvata

I tasti del joypad possono essere configurati. Alcune tastiere non supportano la pressione contemporanea dei tasti Z e X. Impostando i bottoni A e B su altri tasti potrebe risolvere il problema.

Cliccare il tasto destro del mouse sulla finestra dell'emulatore per entrare nel men da cui accedere a tutte le funzioni.

schermata delle opzioni:
========================
Menu popup menu --> opzioni
Da cui si possono cambiare i tasti del joypad, i colori dello schermo e le impostazioni sonore.

Per cambiare un tasto, premere il tasto desiderato in corrispondenza del bottone scelto. Non fate caso ai numeri.

Correzione della gamma: su molti monitor i colori appaiono troppo scuri. Regolate la luminosit attravesto l'apposita barra.

effetti 8 bit contro effetti 16 bit:
====================================
BGB ha due diverse emulazioni per le routine GB e GBC che gestiscono la grafica, una usa bitmap a 8 bit, l'altra bitmap a 16 bit.

"No": utilizza sempre la grafica a 16 bit.
"Auto": usa la grafica a 8 bit se possibile, ma imposta la grafica a 16 bit dove richiesto.

"Yes": non raccomandato. Usa sempre l'engine a 8 bit.

- con alcune schede video BGB pu girare pi velocemente se le impostazioni per la grafica di windows sono a 16 bit (hicolor) piuttosto che a 32 bit (true color)

- su cpu lente l'impostazionbe gfx a 8 bit (auto setting) pu risultare pi veloce che quella a 16 bit perch sfrutta meno la CPU.

quale delle due impostazioni tra 8 bit e 16 bit risulta la pi veloce dipende dall'hardware del vostro PC (CPU e scheda grafica), provatele entrambe con diverse impostazioni (schermo intero, in finestra, ecc.)

salvataggio di file wav:
========================
Impostate il nome del file da salvare nelle opzioni.
Ogni qualvolta abilitate i suoni o resettate l'emulatore il file wav viene reimpostato perci se volete salvare il file dovete copiarlo da un'altra parte. Il file wav verr chiuso quando diabiliterete il sonoro nel menu popup.

Cheat per GameGenie/GameShark:
==============================
La finestra dei cheat  simile a un blocco note. Copiate e incollate i codici, uno per linea e saranno operativi da subito. Linee con codici non corretti verranno ignorate. Per disabilitare un singolo codice, fatelo precedere da un carattere non alfanumerico, tipo ";". Se un codice non funziona provate a resettare l'emulatore oppure avete una versione differente della rom.

Codici Gameshark: ogni codice deve avere 7 cifre nell'area ram A,B,C,D (ram area). Non ho altre informazioni al riguardo.

problemi:
=========
- nessun problema che meriti di essere menzionato.

Se trovate un problema con una rom mandatemi una email, possibilmente con informazioni per poterlo correggere.

Come aumentare la velocit di BGB se avete un computer lento
============================================================
* Impostare la risoluzione dello schermo in 640x480 con l'impostazione finestra piccola (1x1 scale)
* Impostare windows a 16 bpp. 
* Impostare "8 bits gfx quick & dirty" nelle opzioni di BGB.
* Impostare la frequenza dei suoni a 22KHz o disabilitarli del tutto.

modalit schermo intero:
========================
select window size -> full screen, per impostare la modalit a schermo intero. Lo schermo del GB sar centrato e avr la stessa dimensione di prima che cambiaste l'impostazione.

bitmap per il bordo:
====================
potete usare un'immagine bitmap come bordo per BGB (verr visualizzata se abilitata e non ci sono bordi SGB). Usate un'immagine di 160x144 pixel e un rettangolo colorato per definire la posizione dello schermo del GB. Non  compatibile con immagini bitmap encodate con la modalit RLE.

cronologia delle versioni:
==========================
0.85 - emulazione di 2 joypad per la modalit multiplayer SGB. Corretto un problema di memoria quando il caricamento di una rom non viene portato a termine. Aggiunto il supporto per rom compresse con Gzip. Corretti alcuni bug nel codice degli header zip, BGB non dovrebbe pi incasinarsi con file zip corrotti. Nuovo codice per la sincronizzazione del tempo. Bugfix sonori e miglioramenti. Aggiunta l'opzione per usare colori GB in modalit SGB.

0.84 - corretto pokemon crystal (problema con l'HDMA). Opzione per generare onde sonore di alta qualit (CH1 e CH2).

0.83 - corretti alcuni bug sonori introdotti con la versione 0.82. Anti aliasing sul CH4, specialmente con suoni ad alto picco sul CH4. Corretto un problema di ridimensionamento in wine.

0.82 - corretto "magical drop" e "miahamm soccer shootout". corretto "little mermaid ii pinball frenzy", probabilmente un problema di HDMA. Riscritto il codice per la gesione del sonoro e migliorato. CH4 (rumori) ora assomiglia di pi a quello del GB reale. Aggiunto il controllo per gli anti emulatori.

0.81 - riscritto il codice per STAT/timing/interrupt, ora pi accurato (?), corretti *molti* roblemi conosciuti con le rom. Implementato il DI+HALT hardware bug, non ancora perfettamente funzio. smurfs/thunderbirds di nuovo (grazie all'history text di no$gmb). "little mermaid ii pinball frenzy" rimarr non corretta fino a quando non avr i timing esatti dell'HDMA. Agginta la modalit "finestra non visibile" (doppio click sulla finestra di BGB per attivarla. Lo schermo del GB adesso pu essere anche non centrato rispetto alla bitmap del bordo. I bordi SGB possono adesso sovrapporsi allo schermo principale nella modalit a 16 bit (alfred chicken). Altre correzioni minori.

0.8 - aggiunto il supporto SGB. Rinominato "snapshot" in "state" per non screare confusione con gli "screenshot". Cambiati i rgistri di I/O, adesso dovrebbero essere maggiormente simili al GB reale se non ho fatto casini. Corretti bug, aggiunte opzioni.

0.71b - ho tolto la funzione nascondi la taskbar in modalit fullscreen in quanto inutile. Aggiunto il supporto per "the smurfs" e "pocket puyo sun"

0.71 - agginto il supporto per HuC1 e HuC3. Migliorata l'interfaccia di controllo grafica. I 4 canali sonori possono essere emulati o disabilitati indipendentemente. I colori delle sfondo, delle finestre e degli sprite possono essere cambiati. Migliorato il supporto fullscreen. Bugfix. Cambiate le impostazioni del DMA, adesso "little mermaid II pinball frenzy" e "le mans 24h" dovrebbero essere visualizzati correttamente. Corretta la schermata con il logo nintendo (ishido).

0.7 - migliorata la compatibilit, corretti alcuni problemi; testati: "legend of zerd", "magical chase", "elmo in grouchland", "faceball 2000" (framerate), "dragon slayer" (musica). la velocit di emulazione pu essere impostata. Aggiunta l'impostazione "delay" per fare in modo che BGB non usi la cpu al 100%. Emulazione dell'assenza di ram esterna (legge $ff). Altre correzioni.

0.66b - Salvataggio di file .sav con lunghezza zero corretto. I file salvati venivano troncati al primo punto, corretto. Problema con la pressione simultanea dei tasti U+D o L+R corretto. Corretto il problema con "Mr. do!" che si bloccava alla schermata degli "highscores".

0.66 - Si possono trascinare rom direttamente nella finestra di BGB. BGB pu partire senza rom caricate, non appare pi la finestra per il caricamento della rom all'avvio.

0.65b - riportati i cambiamenti dalla versione 0.65 alla versione 0.64... riscritto l'engine gfx, non mi piaceva che fosse 5 fps pi lento sul mio pc.

0.65 - supporto per il bilinear filter. rimosso il visualizzatore della vram; Non lo usavo e non era stabile. Corretto il problema con "Mr. Do!". Correzione nell'engine gfx: problemi con "fortress of fear". Corretti alcuni problemi sonori (provenienti dalla versione 0.64)

0.64 - correzioni minori e bugfix sulla diagnostica delle rom. Corretto la velocit dell'envelope sweep, adesso  1/64 di sec per unit, come nella realt. La riproduzione dei suoni ora  molto simile a quella di un GB reale. OAM  riempita di zeri al reset, gli sprite non erano corretti.

0.63 - aggiornamenti minori. Corretto il suono stereo scambiato (reversed). Aggiunta l'opzione "colori LCD" per il GBC, simile all'impostazione "colori reali" in no$gmb. Possono essere usati fino a 16 tasti del Joystick. Corretto il problema con puzzle road.

0.62 - Aggiunto il supporto per joystick/gamepad. Aggiunto il supporto per rumble cart. Ripulito il codice per LCD/STAT/interrupt; risolto qualche problema con le rom, adesso gira pinball deluxe/fantasies. Corretto il problema con il volume del sonoro, suoni migliorati. Corretto il problema con il sonoro di Cannon Fodder introdotto con la versione 0.61.

0.61 - Aggiunto il supporto per file zippati. Aggiunto l'engine a 16 bit per i vecchi giochi GB (pi veloci con la finestra ingrandita/massimizzata).

0.6 - Aggiunto il supporto GameShark. Corretti molti bug. Molti miglioramenti per il sonoro (corretto anche un bug che causava problemi con il sonoro in modalit GBC). Priorit degli sprite come nel GB reale.

0.52 - Agginta un'impostazione che cambia automaticamente dalla modalit grafica a 8 bit (veloce) a quella a 16 bit quando richiesto. Corretti i problemi con la finestra principale (alfred's adventure). Il salvataggio dei file WAV non funziona se la scheda sonora  diabilitata... correzioni minori. Corretto un problema con Hook.

0.51 - Corretti alcuni problemi, altre rom supportate, date un'occhiata alla pagina degli screenshot. Aggiunto il visualizzatore dei titoli. Corretto un problema con i nomi dei file del salvataggio WAV.

0.5 - Aggiunto l'engine grafico GBC in hicolor. Aggiunto il supporto per la priorit del background. Aggiunta l'emulazione del timer MBC3. Alcuni problemi risolti, altre rom funzionano correttamente. Detect di Wait-loop, alcuni giochi girano pi velocemente. Impostazione per il massimo dei frameskip. Visualizzatore in background della mappa vram. Cambiamenti minori.

0.4 - Aggiunto il supporto GBC. Corretti alcuni bug nel codice di auto-frameskip, adesso gira pi fluido. Cambiamenti minori nell'engine grafico, "the addams family" e "starfight" adesso girano.

0.32 - Aggiunta l'icona. Corretti i trasferimenti seriali; Mortal Kombat e Alleyway adesso girano. CPU ottimizzata con l'assembler. Corretti problemi di emulazione della finestra (la scheramata di briefing di startrek. Cambiamenti minori.

0.31 - Aggiunto il supporto per MBC5 (giochi come warioland 2). Aggiunto il tasto per l'abilitazione/disabilitazione dei cheat gamegenie. Cambiamenti nella finestra di selezione delle snapshot.

0.3 - Prima versione rilasciata

ringraziamenti:
===============
- Koiote in irc-hispano
- Martin nocash Korth
- Liu ricky
- lord_nightmare
- [dox]
- tutti gli altri che ho dimenticato di menzionare

feedback:
=========
Se avete commenti, suggerimenti, aiuti o problemi/bug non descritti in questo file, mandatemi una mail a: steendijk@tomaatnet.nl
