Max
/
SameBoy
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Updated documents to refer to the new website

This commit is contained in:
Lior Halphon 2017-02-05 21:50:46 +02:00
parent cfe0e55df8
commit 7ee96766b6
3 changed files with 6 additions and 275 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

225
CHANGES.md
View File

@ -1,224 +1 @@
# Change Log
## Version 0.8
### New/Improved Features
* The debugger now includes a ticks command, to allow tick counting
* The debugger now includes a palettes command, to allow dumping the palettes in CGB mode
* General optimizations
* Complete GameBoy Camera support in the Cocoa port, basic support in the SDL port
* Debugger syntax improved, commands now allow modifiers
* print/eval can now have a format modifier (e.g. print/d)
* examine can now have a byte count modifier (e.g. x/4)
* The debugger now includes a disassemble command
* Added a VRAM viewer to the Cocoa port
* GameBoy Printer emulation in the Cocoa port
* New icon for GBC files, following Nintendo's color-coding convention, fixed icon alignment for both GB and GBC icons
* Quick Look support in Cocoa: GB and GBC files now display in-game screenshots on their cartridge icon
### Accuracy Improvements/Fixes
* The APU emulation was refactored, and is now faster and now longer dependent on the sampling rate
* LCDC's bit 0 is now properly emulated (Fixes: Krusty's Fun House)
* The HALT bug is now emulated
* The user is now prevented from pressing opposite keys at the same time (Fixes Pocket Bomberman)
* Fixed MBC2 RAM emulation
* Corrected emulation of the palette registers in CGB mode
* HUC1 is now partially emulated, sans the IR sensor
* Basic HUC3 support, only the MBC is emulated
* Implemented the STAT-write interrupt bug (Fixed: Road Rash and Zero no Densetsu; these games do not work on CGBs)
* Limited the LY=144 interrupt to DMG mode, as hinted by MooneyeGB's test ROMs
The following games now pass the automatic testing:
> All-Star Baseball '99, Cave Noire, Daisenryaku, F-1 Race, Gameboy Camera, Hatris, Ironman, Konami Golf, Kwirk, Meitantei Conan, Nintendo World Cup, Pocket Bomberman (J), Puzzle Boy, SS Spinner, The Smurfs, Speedball 2, Tecmo Bowl, Teenage Mutant Ninja Turtles 2, Tsuri Sensei, Ultima, Ultra Golf, WordZap, Z - The Miracle of the Zone, Zerd no Densetsu
### Bug Fixes
* Fixed a deadlock in the Hex Editor/Viewer when viewing APU data
* Fixed a crash when accessing MBC RAM on some ROMs that do not have MBC RAM
* Multiple watchpoints did not function correctly
* Improved the behavior and performance of the open dialog in Cocoa
* Fixed dereferencing a non-banked address in the debugger
* VRAM was not initialized
* Fixed an edge case where the Hex Editor/Viewer crashed
* Breakpoint and watchpoint conditions no longer trigger other watchpoints; fixed potential crashes
* Better handling of input in the Cocoa port when the system has a non-ASCII keyboard layout
* Minor fixes for the help debugger command
### Misc Internal Changes
* Added rumble API, but it is not actually used by any of the GUIs
* Added serial API, but it is currently only used internally for the GameBoy Printer
## Version 0.7
### New/Improved Features
* The debugger now includes a backtrace command to show the stacktrace
* Cocoa port now includes a Hex Editor/Viewer
* The debugger help command was improved
* General improvements to debugger usability
* The SDL port now compiles on Windows (Binaries included)
* Mouse hiding in Cocoa is now only enabled during full screen
* The Cocoa port now remembers the mute setting
* SameBoy now issues a warning when loading a game that uses an unsupported cartridge
* Cocoa port now remembers previous breakpoints/watchpoints after reset
* Cocoa port now automatically shows the open if needed
### Accuracy Improvements/Fixes
As of this version, SameBoy is regularly tested against 1405 DMG ROMs to make sure no accuracy regressions are made. [The latest results are available here](http://htmlpreview.github.io/?https://github.com/LIJI32/SameBoy/blob/automation_results/results.html).
* OBP0/1 are now initialized to the correct value (Fixes Mooneye's DMG hardware registers test).
* A disconnected serial cable is now emulated. Fixes:
* Baseball
* Faceball 2000
* Fighting Simulator
* Godzilla
* Hiryuu Gaiden
* In Your Face
* Lunar Lander
* Pinball Party
* Sneaky Snakes
* Super R.C. Pro-Am
* WWF Stars
* Yoshi's Egg
* Correctly emulating unused OAM RAM in DMG mode
* DMG boot ROM now finishes with the original register values (Fixes Mooneye's DMG boot registers test)
* RTC clock latching is now emulated.
* Fixed APU issues where simultaneously running games could affect eachother
* Fixed APU issue that could break some games. Fixes:
* Chiki Chiki Tengoku
* Moguranya/Mole Mania
* Fixed MBC RAM not being properly reset. Old save data must be deleted for this fix to apply. Fixes:
* Purikura Pocket 3
* Probably affects many other games
### Bug Fixes
* Boot ROMs were not trimmed correctly
* Fixes several bugs that caused the Cocoa port to freeze when using the reset command during debugging
### Misc Internal Changes
* SameBoy can now be compiled with precompiled (non-SameBoy) boot ROMs
* SameBoy includes an automated game ROM tester
## Version 0.6
### New/Improved Features
* Conditional r/w/rw debugger watchpoints
* Added the "!=" operator to the debugger
* Redefined the debugger input and output syntax, being more consistent with RGBDS
* Debugger now reads .sym files (Tested with 3 popular formats). It shows symbols when possible, and allows using them in expressions
* Debugger data types can now be either 16-bit values, or 25-bit full addresses that include a bank identifier
* Debugger commands and expressions support full addresses as parameters. This allows, for example, breaking on an address on a specific ROM bank, or reading a value from a specific MBC RAM bank.
* Some debugger commands may now run without breaking the debugger. (Similar to LLDB or GDB's async mode)
* SDL port now supports save states
* Improved performance by about 6% by enabling link-time optimizations
* Reduced file size by stripping executables
* Several Cocoa-only UX improvements:
* Prevented being paused "twice" (Both by the pause option and the debugger)
* Optional proportional resizing
* Proper fullscreen support
* Mouse cursor is now hidden while running
### Accuracy Improvements/Fixes
This version includes major accuracy improvements, which allow it to pass 54 tests out of [mooneye-gb](https://github.com/Gekkio/mooneye-gb)'s 58 acceptance tests (2 of which fail due to not including the original boot ROM); more than any other emulator.
* Rewritten MBC support, with MBC1M support (Fixing some N-in-1 cartridges)
* Major accuracy improvements to OAM DMA.
* Corrected a lot of instruction memory-access timings
* Corrected some IO register masks
* Major accuracy improvements to timers (TIMA/DIV)
### Bug Fixes
* Corrected operator priorities in the debugger
* Fixed a bug where a breakpoint might have been ignored
* Reduced CPU usage when running games with a real time clock
* Handling ^C and ^D more sanely in SDL port
* Fixed memory leak in Cocoa
### Misc Internal Changes
* Added infrared API, but it is not actually used by any of the GUIs
* Fixed build system bugs that caused needless dep file generation, and made the Cocoa build fail sometimes if SDL is not installed
## Version 0.5
This version is not compatible with save states of older versions.
### New/Improved Features
* Updated save state format, should now be much more future compatible
* Save state compatibility between 32 and 64 bit versions of SameBoy
* Cocoa version is now using OpenGL 3
* HQ2x filter added (Cocoa only)
* A new, redesigned OmniScale filter; old filter is renamed to OmniScale Legacy (Cocoa only)
* Cocoa port now "remembers" the last window size
* Added boolean operators to the debugger
* Added conditional breakpoints
### Accuracy Improvements/Fixes
* Better emulation of certain behaviors of the SCX register
* Fixed emulation of the STOP instruction
* Minor fix to the accuracy of the JOYPAD register
* Minor improvements to HDMA accuracy
### Bug Fixes
* Improved concurrency in the Cocoa port
* Fixed a bug where an emulator window in the Cocoa port will freeze until resized
* Fixed incorrect disassembler outputs
* Fixed a potential crash when deleting a breakpoint
### Misc Internal Changes
* Large code refactoring, getting ready to stabilize API
## Version 0.4
This version is not compatible with save states of older versions.
### New/Improved Features
* Cocoa port now includes several scaling algorithms, including a beta of the exclusive OmniScale algorithm
* SDL port now includes sound support
* SDL port now includes battery save support
### Accuracy Improvements/Fixes
* APU emulation now includes stereo support
* Improved PCM registers emulation
* More accurate STAT interrupt emulation. This fixes Altered Space.
### Bug Fixes
* The Cocoa port ignored some key presses if the user keyboard layout included non-ASCII characters
* Fixed a bug that could cause a crash when adding or removing a breakpoint
## Version 0.3
### New/Improved Features
* New debugger command: cartridge (alias: mbc) shows information about the cartridge and the current status of the MBC
* Experimental debugger command: sld (Short for Stack Leak Detection) behaves similarly to finish, but stops if a stack leak or stack overflow is detected
* The Cocoa port now allows configuring controls
### Accuracy Improvements/Fixes
* ROM banks now wrap (Fixes game: Pocket Monster Adventures (Bootleg))
* Fixed incorrect DMA behavior, DMA might fail for specific source addresses (Fixes game: The Smurfs 3)
* Timer registers were counting too slow in CGB double speed mode
* Corrected read behavior of the HDMA5 register (Fixes game: A Bug's Life in CGB mode)
* Fixed a bug with the CGB boot ROM that prevented initialization of the wave RAM
* The CGB boot ROM now loads the DMG tilemap for specific games, just like the original ROM (Fixes game: X (intro animation))
* Fixed a bug where audio channel 3 was playing silently while it should have been muted.
### Bug Fixes
* Debugger's finish command now behaves correctly when interrupts are involved
* Corrected the description for the breakpoint command
* SameBoy will not create save files for ROMs without cartridge RAM or RTC, even if they report having a battery, preventing 0-bytes save files
## Version 0.2
### New/Improved Features
* Support for multiple breakpoints
* Better debugger command style and error reporting; includes help command
* In the SDL port, ^C in the terminal will break the debugger instead of quitting SameBoy
* Cocoa port now saves preferences (Model and frame blending)
* It is not possible to toggle console output and debugging in the Cocoa port
### Accuracy Improvements/Fixes
* Read/write masks corrected for several registers
* Corrected 144th OAM interrupt behavior
* LCD operation moved to advance_cycles, fixing some obscure timing issues (Fixes game: X / Ekkusu)
* More accurate emulation of the registers controlling DMG emulation on CGB
* Emulation of PCM_12 and PCM_34 in the SDL port
### Bug Fixes
* Debugger's next command can now exit a function
## Version 0.1
* Initial public release
See https://sameboy.github.io/changelog/

8
README.md
View File

@ -1,6 +1,6 @@
# SameBoy
SameBoy is an open source Gameboy (DMG) and Gameboy Color (CGB) emulator, written in portable C. It has a native Cocoa frontend for OS X, and an incomplete experimental SDL frontend for other operating systems. It also includes a text-based debugger with an expression evaluator.
SameBoy is an open source Gameboy (DMG) and Gameboy Color (CGB) emulator, written in portable C. It has a native Cocoa frontend for OS X, and an incomplete experimental SDL frontend for other operating systems. It also includes a text-based debugger with an expression evaluator. Visit [the website](https://sameboy.github.io/).
## Features
Features common to both Cocoa and SDL versions:
@ -25,11 +25,13 @@ Features currently supported only with the Cocoa version:
* Native Cocoa interface, with support for all system-wide features, such as drag-and-drop and smart titlebars
* Retina display support, allowing a wider range of scaling factors without artifacts
* Optional frame blending
* Several [scaling algorithms](SCALING.md) (Including exclusive algorithms like OmniScale and Anti-aliased Scale2x)
* Several [scaling algorithms](https://sameboy.github.io/scaling/) (Including exclusive algorithms like OmniScale and Anti-aliased Scale2x)
* GameBoy Camera support
[Read more](https://sameboy.github.io/features/).
## Compatibility
SameBoy passes many of [blargg's test ROMs](http://gbdev.gg8.se/wiki/articles/Test_ROMs#Blargg.27s_tests), as well as most of [mooneye-gb's](https://github.com/Gekkio/mooneye-gb) acceptance tests. SameBoy should work with most games and demos, please [report](https://github.com/LIJI32/SameBoy/issues/new) any broken ROM. The latest results for SameBoy's automatic tester are available [here](http://htmlpreview.github.io/?https://github.com/LIJI32/SameBoy/blob/automation_results/results.html).
SameBoy passes many of [blargg's test ROMs](http://gbdev.gg8.se/wiki/articles/Test_ROMs#Blargg.27s_tests), as well as most of [mooneye-gb's](https://github.com/Gekkio/mooneye-gb) acceptance tests. SameBoy should work with most games and demos, please [report](https://github.com/LIJI32/SameBoy/issues/new) any broken ROM. The latest results for SameBoy's automatic tester are available [here](https://sameboy.github.io/automation/).
## Compilation
SameBoy requires the following tools and libraries to build:

48
SCALING.md
View File

@ -1,48 +0,0 @@
# Scaling
Starting with version 0.4, the Cocoa version of SameBoy supports several GPU-accelerated scaling algorithms, some of which made their premiere at SameBoy. This document describes the algorithms supported by SameBoy.
## General-purpose Scaling Algorithms
Common algorithms that were not made specifically for pixel art
### Nearest Neighbor
A simple pixelated scaling algorithm we all know and love. This is the default filter.
### Bilinear
An algorithm that fills "missing" pixels using a bilinear interpolation, causing a blurry image
### Smooth Bilinear
A variant of bilinear filtering that applies a smooth curve to the bilinear interpolation. The results look similar to the algorithm Apple uses when scaling non-Retina graphics for Retina Displays.
## The ScaleNx Family
The ScaleNx family is a group of algorithm that scales pixel art by the specified factor using simple pattern-based rules. The Scale3x algorithm is not yet supported in SameBoy.
### Scale2x
The most simple algorithm of the family. It scales the image by a 2x factor without introducing new colors.
### Scale4x
This algorithm applies the Scale2x algorithm twice to scale the image by a 4x factor.
### Anti-aliased Scale2x
A variant of Scale2x exclusive to SameBoy that blends the Scale2x output with the Nearest Neighbor output. The specific traits of Scale2x makes this blend produce nicely looking anti-aliased output.
### Anti-aliased Scale4x
Another exclusive algorithm that works by applying the Anti-aliased Scale2x algorithm twice
## The HQnx Family
A relatively modern family of scaling algorithms that makes an extensive use of lookup tables to create scaled anti-aliased output. The HQnx family includes several scaling factors and variants.
### HQ2x
Currently HQ2x is the only HQnx algorithm in SameBoy. As the name implies, it scales the image by a factor of 2.
### The OmniScale algorithm
OmniScale is an exclusive algorithm developed for SameBoy. It is inspired by HQnx's lookup tables, but improves on them by handling more cases. OmniScale can scale an image by any factor, including non-integer factors, and produces high quality anti-aliased output.
## The OmniScale Legacy Family (beta)
An old prototype of the OmniScale algorithm. It combines pattern-based rules with a unique locally paletted bilinear filtering technique to scale an image by any factor, including non-integer factors. Its pattern-based rule do not currently detect 30- and 60-degree diagonals, making them look jaggy. The output OmniScale Legacy produces is quite unique, as it tends to produce non-trivial patterns.
### OmniScale Legacy
The base version of the algorithm, which generates aliased output with very few new colors introduced.
### Anti-aliased OmniScale Legacy
A variant of OmniScale that produces anti-aliased output using 2x super-sampling.