mirror of
https://github.com/libretro/gambatte-libretro.git
synced 2024-11-27 01:40:23 +00:00
a64766a62e
git-svn-id: https://gambatte.svn.sourceforge.net/svnroot/gambatte@20 9dfb2916-2d38-0410-aef4-c5fe6c9ffc24
109 lines
4.5 KiB
Plaintext
109 lines
4.5 KiB
Plaintext
--------------------------------------------------------------------------------
|
|
--------------------------------------------------------------------------------
|
|
Copyright (C) 2007 by Sindre Aamås
|
|
aamas@stud.ntnu.no
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License version 2 as
|
|
published by the Free Software Foundation.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License version 2 for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
version 2 along with this program; if not, write to the
|
|
Free Software Foundation, Inc.,
|
|
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
|
|
--------------------------------------------------------------------------------
|
|
--------------------------------------------------------------------------------
|
|
|
|
About
|
|
--------------------------------------------------------------------------------
|
|
Gambatte is a highly accurate, open-source, cross-platform
|
|
Game Boy / Game Boy Color emulator written in C++. It is based on hundreds of
|
|
corner case hardware tests, as well as previous documentation and reverse
|
|
engineering efforts.
|
|
|
|
The core emulation code is seperated to a library back-end (libgambatte) written
|
|
in pure platform-independent C++. There is currently a GUI front-end
|
|
(gambatte_qt) using Trolltech's Qt4 toolkit, and a simple command-line SDL
|
|
front-end (gambatte_sdl).
|
|
|
|
The GUI front-end contains platform-specific extensions for video, sound and
|
|
timers. It should work on MS Windows, Linux/BSD/UNIX-like OSes, and Mac OS X
|
|
(although no testing or specific extensions have been done for Mac OS X yet).
|
|
|
|
The SDL front-end should be usable on all platforms with a working SDL port. It
|
|
should also be quite trivial to create new (simple) front-ends (note that the
|
|
library API should in no way be considered stable).
|
|
|
|
Usage
|
|
--------------------------------------------------------------------------------
|
|
You will have to supply Gambatte with a ROM image file of the GB/GBC
|
|
program/game you'd like to run/play, either as a command-line argument to
|
|
gambatte_sdl, or through the File->Open... menu in gambatte_qt.
|
|
|
|
The TAB key can be used for fast-forward during execution.
|
|
|
|
Compiling
|
|
--------------------------------------------------------------------------------
|
|
Building Gambatte from source code can be done by executing the
|
|
build_<qt/sdl>.sh scripts for the qt/sdl front-ends respectively, or by issueing
|
|
the correct build command (either 'scons' or 'qmake && make') in the top-level
|
|
subdirectories (libgambatte will have to be built first). The clean.sh script
|
|
can be executed to remove all generated files after a compile (including
|
|
binaries).
|
|
|
|
Requirements for building libgambatte:
|
|
- A decent C++ compiler (like g++ in the GNU Compiler Collection).
|
|
- SCons.
|
|
|
|
Requirements for building gambatte_sdl:
|
|
- A decent C++ compiler (like g++ in the GNU Compiler Collection).
|
|
- SDL headers and library.
|
|
- SCons.
|
|
(- libgambatte.)
|
|
|
|
Requirements for building gambatte_qt:
|
|
- A decent C++ compiler (like g++ in the GNU Compiler Collection).
|
|
- Qt4 (Core, GUI, OpenGL) headers and library.
|
|
- Qmake and make (GNU Automake should work).
|
|
- Platform-specific requirements:
|
|
* MS Windows:
|
|
- Win32 API headers and libraries.
|
|
- DirectSound and DirectDraw7 headers and libraries.
|
|
* Linux/BSD/UNIX-like OSes:
|
|
- POSIX/UNIX headers (unistd.h, fcntl.h, sys/ioctl.h, sys/time.h).
|
|
- Open Sound System header (sys/soundcard.h).
|
|
- X11 Xlib, XVideo and XRandR headers and libraries.
|
|
- Alsa headers and library (Linux only).
|
|
* Max OS X:
|
|
- POSIX/UNIX headers (sys/time.h).
|
|
- libao headers and library.
|
|
(- libgambatte.)
|
|
|
|
Installing after a compile simply amounts to copying the generated binary
|
|
(either gambatte_qt/bin/gambatte_qt<.exe> or gambatte_sdl/gambatte_sdl<.exe>)
|
|
to wherever you'd like to keep it.
|
|
|
|
Thanks
|
|
--------------------------------------------------------------------------------
|
|
Derek Liauw Kie Fa (Kreed)
|
|
Jeff Frohwein
|
|
Jonathan Gevaryahu (Lord Nightmare)
|
|
kOOPa
|
|
Marat Fayzullin
|
|
Martin Korth (nocash)
|
|
Maxim Stepin (MaxSt)
|
|
Pan of Anthrox
|
|
Pascal Felber
|
|
Paul Robson
|
|
The OpenGL Extension Wrangler Library
|
|
|
|
--------------------------------------------------------------------------------
|
|
Game Boy and Game Boy Color are registered trademarks of
|
|
Nintendo of America Inc.
|
|
Gambatte is not affiliated with or endorsed by any of the companies mentioned.
|