99 lines
3.6 KiB
Plaintext
99 lines
3.6 KiB
Plaintext
_ _
|
|
/ \_/ \ ___ _ ____
|
|
\ /___ ___ / || | __ / \ ____
|
|
\ // || \ / || | \ \\ \_// \
|
|
/ // || // _ || |__\ \\ \ __/
|
|
\_// _ || \\_/ \_||______/ \ \\ \__
|
|
\_/ \_||___/ \____/ \____\
|
|
Yet Another Buggy And Uncomplete Saturn Emulator
|
|
|
|
____________________________________
|
|
Copyright (c) 2002-2012 Yabause team
|
|
|
|
|
|
1) Introduction.............................................20
|
|
2) Compiling instructions...................................26
|
|
3) How to use Yabause.......................................46
|
|
4) Known Issues.............................................92
|
|
|
|
|
|
1 Introduction________________________________________________
|
|
|
|
This file documents the mac version only, for general
|
|
information check the README file.
|
|
|
|
|
|
2 Compiling instructions______________________________________
|
|
|
|
Yabause is written in C and Objective C using the Cocoa,
|
|
IOKit, OpenGL, and CoreAudio frameworks. All of these
|
|
frameworks should be installed by default on your Mac OS X
|
|
system. You must have the Mac OS X 10.6 SDK installed by the
|
|
Xcode installer in order to build Yabause. In addition, you
|
|
will need at least Xcode 3.2.
|
|
|
|
Once you have Xcode installed, you should be ready to build
|
|
Yabause.
|
|
|
|
Uncompress the Yabause source archive, and open the
|
|
Yabause.xcodeproj in the src/cocoa directory. From there it
|
|
should be as easy as hitting the Build or Build and Run
|
|
button in Xcode. This should generate a Yabause.app file
|
|
that can be run just like any other application bundle on
|
|
Mac OS X.
|
|
|
|
|
|
3 How to use Yabause__________________________________________
|
|
|
|
Before using Yabause, you need to configure a few things in
|
|
the Preferences dialog (Yabause > Preferences).
|
|
|
|
|
|
3.1 Configuration_____________________________________________
|
|
|
|
First, set the BIOS path.
|
|
Yabause can run some games without a BIOS, but many of them
|
|
need it. If you want to use the emulated BIOS, select the
|
|
checkbox for that.
|
|
|
|
Next, set up the video and sound cores. For the video core,
|
|
you have 4 options:
|
|
1. OpenGL Hardware Video Core - Potentially the fastest video
|
|
core choice, at least with a discrete video card. However,
|
|
it is also the least accurate.
|
|
2. Software Video Core - The most accurate video core you can
|
|
use, but also the slowest.
|
|
3. Grand Central Dispatch Software Core - A multithreaded
|
|
version of the Software Video Core. On a multi-core system
|
|
this should be significantly faster than the Software core
|
|
with a similar accuracy level.
|
|
4. Disable Video - Does exactly what it sounds like.
|
|
|
|
For the sound core, you only have two options:
|
|
1. Core Audio Sound Core - The default sound core. Select
|
|
this one if you want sound.
|
|
2. Disable Sound - Does exactly what it sounds like.
|
|
|
|
Next, set up keys for input. Go to the Input tab, and
|
|
configure each button (at least on Controller 1). For the
|
|
moment, this is limited to keyboard input only.
|
|
|
|
There are other options you can configure as well in here,
|
|
including BRAM (for saving), a MPEG ROM (for games that use
|
|
the VideoCD/MPEG card), and a cartridge for the cartridge
|
|
port on the Saturn.
|
|
|
|
Once eveything is set, you can start emulation with the
|
|
"File > Run BIOS", "File > Run CDROM" or "File > Run Image"
|
|
menu options. Don't use the Run BIOS entry if you're using
|
|
BIOS emulation.
|
|
|
|
|
|
4 Known Issues________________________________________________
|
|
|
|
When running in GDB, you should not use fullscreen mode. If
|
|
Yabause crashes while running under GDB in fullscreen mode,
|
|
you will probably get stuck with no way to exit. This should
|
|
only affect developers and shouldn't ever be an issue for
|
|
normal users.
|