libretro/gambatte-libretro
1
0
Fork 0
mirror of https://github.com/libretro/gambatte-libretro.git synced 2024-11-22 15:29:46 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
Hard fork of Gambatte to the libretro API.
1,058 Commits 5 Branches 0 Tags 10 MiB
C 50.6%
C++ 45.4%
Python 3.9%
master
Go to file
github-actions[bot] 32cf604fa6 Fetch translations & Recreate libretro_core_options_intl.h
2024-11-22 10:53:19 +00:00
.github/workflows Fix build problems due to removal of the Hebrew localisation (#247) 2023-01-06 23:59:45 +01:00
common C++ source code is not executable. 2015-06-14 12:31:23 +02:00
intl Fix Crowdin config & workflow (#245) 2023-01-02 22:50:23 +01:00
libgambatte Fetch translations & Recreate libretro_core_options_intl.h 2024-11-22 10:53:19 +00:00
.gitignore Add emscripten output to gitignore. 2015-07-13 23:55:25 -05:00
.gitlab-ci.yml Update .gitlab-ci.yml 2023-02-20 19:07:10 +01:00
.travis.yml add 3ds to travis build 2017-10-23 21:24:09 -04:00
appveyor.yml Appveyor CI 2017-12-21 21:40:35 +09:00
changelog Update changelog for 0.4.1 2009-01-10 22:41:54 +00:00
COPYING Move COPYING file to root directory. We only need one. 2007-08-26 10:05:47 +00:00
crowdin.yml Set up fully automatic translations sync with Crowdin 2021-09-02 19:10:59 +02:00
Makefile Move the makefiles in the root folder 2016-08-30 20:18:39 +02:00
Makefile.common Replace direct file access with VFS routines + clean-ups 2021-10-04 15:42:51 +01:00
Makefile.libretro tvos: properly set min supported version (#272) 2024-10-21 14:40:27 -07:00
README.md README.md: Convert from iso8859-1 to utf-8 encoding (#267) 2024-05-07 08:06:38 -07:00

README.md

Build Status Build status

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 an accuracy-focused, open-source, cross-platform 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 contained in a separate library back-end (libgambatte) written in 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.

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.

gambatte_sdl keyboard commands: TAB - fast-forward Ctrl-f - toggle full screen Ctrl-r - reset F5 - save state F6 - previous state slot F7 - next state slot F8 - load state 0 to 9 - select state slot 0 to 9

Default key mapping: Up: Up Down: Down Left: Left Right: Right A: D B: C Start: Return Select: Shift

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.
  • optionally zlib

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 Make should work).
  • Platform-specific requirements:
    • MS Windows:
      • Win32 API headers and libraries.
      • DirectSound and DirectDraw7 headers and libraries.
      • Direct3D9 headers
    • Linux/BSD/UNIX-like OSes:
      • POSIX/UNIX headers (unistd.h, fcntl.h, sys/ioctl.h, sys/time.h, sys/shm.h).
      • Open Sound System header (sys/soundcard.h).
      • X11 Xlib, XVideo, XRandR and XShm headers and libraries.
      • Alsa headers and library (Linux only).
    • Max OS X:
      • Recent Mac OS X SDK (Panther Xcode/SDK should work) (- 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) Gilles Vollant Jeff Frohwein Jonathan Gevaryahu (Lord Nightmare) kOOPa Marat Fayzullin Martin Korth (nocash) Maxim Stepin (MaxSt) Nach Pan of Anthrox Pascal Felber Paul Robson SDL Shay Green (blargg) 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.