Menu

Tree [d0deb9] default tip /
 History

Read Only access


File Date Author Commit
 etc 2011-08-08 clach04 clach04 [8d400f] New 8px PressStart font added, created and cont...
 ubytegui 2011-08-12 clach04 clach04 [bdd2c9] Fixes issue 15.
 .hgignore 2010-11-20 clach04 clach04 [ab52b6] .hgignore: Ignore generated binaries and save s...
 BUILDING 2010-11-19 clach04 clach04 [c5a3d0] OhBoy isa gnuboy port originally by ubyte.cwb. ...
 COPYING 2010-11-19 clach04 clach04 [c5a3d0] OhBoy isa gnuboy port originally by ubyte.cwb. ...
 Makefile.caanoo 2011-08-12 clach04 clach04 [d0dbcb] Patch from Hi-Ban to enable builds for Caanoo.
 Makefile.devkit2x 2010-11-19 tc@box tc@box [448faf] Removed gnuboy 1.0.3 code. gnuboy code should n...
 Makefile.dingoo 2012-10-12 clach04 clach04 [113a7e] Fix issue 29, dingux controls.
 Makefile.linux_sdl 2013-06-30 clach04 clach04 [2c740c] use OhBoy SDL audio code for Linux x86
 Makefile.mingw 2011-08-20 clach04 clach04 [57657b] Slightly improved version dependency rules, Abo...
 Makefile.opendingux 2012-10-12 clach04 clach04 [4ca6d2] Enabled sound for linux x86 sdl and opendingux.
 README 2010-11-19 clach04 clach04 [d5a36f] Import of (non executable) OhBoy required binar...
 default_gnuboy.rc 2010-11-19 clach04 clach04 [9b1ed2] Added function prototypes, fixed many compiler ...
 font14px.h 2010-12-10 clach04 clach04 [1c6e16] Improved non-TTF font (SFont) menu display. Alm...
 font_pressstart8x.h 2011-08-08 clach04 clach04 [8d400f] New 8px PressStart font added, created and cont...
 gen_ohboyver.bat 2011-08-20 clach04 clach04 [c1e5ff] Updated makefiles for Windows, Linux, Dingoo (n...
 gen_ohboyver.sh 2011-08-20 clach04 clach04 [c1e5ff] Updated makefiles for Windows, Linux, Dingoo (n...
 gui_sdl.c 2011-08-20 clach04 clach04 [6b4363] Fix for issue 19 From Hi-Ban - Menu option for ...
 gui_sdl.h 2010-11-23 clach04 clach04 [ccdc57] Added simple/quick hack for taking screen shots...
 keymap.c 2010-11-19 clach04 clach04 [c5a3d0] OhBoy isa gnuboy port originally by ubyte.cwb. ...
 main.c 2013-07-20 clach04 clach04 [d0deb9] Merge
 menu.c 2012-10-12 clach04 clach04 [113a7e] Fix issue 29, dingux controls.
 menu.h 2010-12-21 clach04 clach04 [9dae75] Added simple command line arg for rom name.
 ohboy.h 2010-11-19 tc@box tc@box [64214c] Changes and makefile so that OhBoy builds under...
 ohboy.png 2010-11-19 clach04 clach04 [d5a36f] Import of (non executable) OhBoy required binar...
 ohboy.rc 2013-07-20 clach04 clach04 [cc231a] Fix issue #34.
 sdl_gp2xpatch.c 2010-11-19 clach04 clach04 [c5a3d0] OhBoy isa gnuboy port originally by ubyte.cwb. ...

Read Me

OhBoy 1.x.x 2009 Copyright (C) UBYTE
ubyte.cwb@googlemail.com 
www.clockworkbytes.com (coming soon)


ABOUT

OhBoy is a Game-Boy/Game-Boy Color Emulator. Currently binaries are 
available for the GP2X Wiz. GP2X(F-xxx) and Pandora Support is planned. 

It is based on gnu-boy 1.0.3. The core sources have not been modified in
anyway but rather OhBoy provides a graphical front-end and GP2x-centric
back-end tailored for portable gaming.

OhBoy is currently beta software and has been somewhat rushed (along
with these docs) in time for Christmas but I hope you enjoy.


INSTALLATION

-GP2X WIZ
Extract all files and folders included in the archive onto your device.
No extra support files are required. The 'ohboy.gpe' script launches
the software and returns to the menu upon quitting. 'ohboy' is the
main executable.


USAGE

GP2X UP/DOWN/LEFT/RIGHT: Gameboy D-Pad + Menu Navigation
GP2X START/MENU/HOME:    Gameboy 'Start' Button
GP2X SELECT:             Gameboy 'Select' Button
GP2X B:                  Gameboy 'A' button + Menu 'Select/OK' button
GP2X X:                  Gameboy 'B' button + Menu 'Back/Cancel' button
GP2X Y:                  Menu button (brings up the menu while playing a ROM)


LAUNCHER

-Load ROM
	Load and run a *.gb, *.gbc or *.zip ROM file.
-Options
	Brings up the global options editor. See OPTIONS for usage.
-Quit
	Exits the software.

MENU

-Back to Game
	Simply returns back to the game. Alternatively press the Back/Cancel button.
-Load ROM
	Load and run a *.gb, *.gbc or *.zip ROM file. To exit the ROM navigator 
	without loading a ROM press the Back/Cancel button. Press Select/OK to load
	the selected ROM.
-Load/Save State
	Load or save the current game state int a slot (up to 8 for any one game.)
	A save-state allows you to save the state of a game as-is for recall later.
	Save-states differ from a games usual save methods in that you can save or
	load at any time.
-Options
	See 'OPTIONS' for more info.
-Quit
	Quit the software. Recommended before switching off the device directly
	as any carts internal memory is saved at this point.

OPTIONS
	OhBoy's options are currently relatively basic. More reconfigurability is planned
	for future releases. Currently options are saved globally but I hope to
	include per-game support in the next major release.
-Mono Palette
	For non-color games, a selection of palettes.
-Color Filter
	Emulates the washed-out look of the Gameboy-color screens. Set to:
	-Off (no filtering)
	-On (Gameboy & Gameboy Color games are filtered)
	-GBC Only (Only Gameboy Color games are filtered)
-Upscaler
	Quality over quantity for this release :).
	-Sample1.5x:             Scales the display to 150% using grid-based
	                         pixel average up-sampling. (Quite fast.)
							 
	-Scale3x + Sample.75%:   Scales the display internally using the
	                         Scale3x algorithm which is a pixel-expansion
							 algorithm which enhances the look of the
							 original graphics. The result is down-sampled
							 using pixel averaging. (Not quite-so fast I
							 recommend upping the clock speed and/or 
							 frame-skip).
-Frameskip
	Some games will struggle to run at full-speed on the default/lower 
	clock speeds. Using frame skip will render every-other frame to allow
	the logic and sound emulation to run real-time at the cost of lower 
	FPS.
	- Auto: Will automatically skip frames if the game starts struggling.
	- Off:  Turns frame-skip off.
	- 1-4:  Fixed frame skip. Skips frames at regular intervals.
-Clock Speed
	The clock speed can be increased to increase performance of games that
	require greater-than typical processing power. This is at the cost
	of battery life. Frame-skip can be used as an alternative.
-ROM Path
	Sets the default path to search when loading ROMs.
-Apply
	Applies the above settings without saving (will be lost when quitting the
	emulator.)
-Save
	Applies the settings and saves them. When you next run OhBoy these settings
	will be automatically loaded. OhBoy does not currently support per-game
	saves.


CREDITS

Laguna and Gilgamesh
	gnuboy 1.0.3

narrowhouse
	FreeUniversal.ttf font. Licenced under the Open Font Licence.


THANKS

To all the talented devs at GP32X.com
	for all your insightful posts that eased me into deving for the GP2x Wiz.

chickendung at the GP32X.com forums.
	for believing. :)

	
CHANGES

1.0.0-beta 1 (21st December 2009)
	Initial public release.

	
LICENCE

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

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 for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.


DISCLAIMER

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
POSSIBILITY OF SUCH DAMAGE. 

Gameboy and Gameboy Color are registered trademarks of Nintendo

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.