mirror/bsnes
1
0
Fork 0
mirror of https://github.com/bsnes-emu/bsnes.git synced 2025-08-10 08:34:07 +02:00
Code Issues Projects Releases Wiki Activity

More cleanups and revision.

Browse Source
This commit is contained in:
Tim Allen
2017-08-24 18:34:37 +10:00
parent d621136d69
commit 15b3dc8b0b
6 changed files with 252 additions and 212 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
docs/concepts/game-library.md
View File

@@ -61,8 +61,9 @@ because there's two parts to it:
telling icarus where to put imported games, telling icarus where to put imported games,
and telling higan where to find them. and telling higan where to find them.
1. If necessary, 1. Move your existing game library folder
create the folder you want higan to use to the new location,
or otherwise create the folder you want higan to use
as its game library. as its game library.
1. Launch icarus, 1. Launch icarus,
then click the "Settings ..." button in the lower-right, then click the "Settings ..." button in the lower-right,

54
docs/guides/import.md
View File

@@ -11,28 +11,56 @@ unusual hardware.
Regular games Regular games
------------- -------------
icarus supports importing games icarus can import games
in the most commonly-used formats in the most commonly-used formats
for each supported console, for each supported console,
and also those same formats inside `.zip` files. and also those same formats inside `.zip` files
(as long as tthe `.zip` file contains only one game).
More advanced compression formats More advanced compression formats
like RAR or 7-zip are not supported. like RAR or 7-zip are not supported.
For most games To import a game,
that do not use special chips or co-processors, open [the Library menu](../interface/higan.md#the-library-menu),
importing a game is straight-forward.
From [the Library menu](../interface/higan.md#the-library-menu)
choose "Load ROM File ..." choose "Load ROM File ..."
to open [a filesystem browser](../interface/common.md#the-filesystem-browser), to open [a filesystem browser](../interface/common.md#the-filesystem-browser),
choose the game you want to play, choose the ROM file of the game you want to play,
and it will be imported into the library and loaded. and it will be imported into the library and loaded.
To play the game again **Note:**
select the console the game runs on from If you want to import many games,
[the Library menu](../interface/higan.md#the-library-menu) run icarus directly,
to open another or choose "Import ROM Files ..."
[filesystem browser](../interface/common.md#the-filesystem-browser) from the Library menu
that lists all the previously-imported games for that platform. (which just runs icarus anyway).
See [the icarus documentation](../interface/icarus.md) for details.
To play a game for a particular console from your library,
open the Library menu,
pick the console manufacturer submenu
(Nintendo for the Super Famicom,
Bandai for the WonderSwan,
etc.)
then choose the appropriate console menu item.
A filesystem browser will appear
listing all the games in your library
for that particular console.
Select the game you want to play
and click the Open button,
or just double-click the game,
and it will begin playing as though you'd just turned on the console.
**Note:**
Sometimes
the NTSC and PAL variants of a particular console
behave differently,
or the Japanese and American variants.
When choosing a game from the Game Library,
a drop-down list in the bottom-right of the filesystem browser
allows you to choose which regional variation
of the console it should emulate.
For most consoles,
higan can reliably guess which variant to use,
and the list defaults to "Auto".
Games with co-processor firmware Games with co-processor firmware
-------------------------------- --------------------------------

2
docs/index.md
View File

@@ -31,7 +31,7 @@ It also includes some level of support for these consoles:
- Sega Megadrive/Genesis - Sega Megadrive/Genesis
- NEC PC Engine/TurboGrafx 16 (but not the CD-ROM² System/TurboGrafx-CD) - NEC PC Engine/TurboGrafx 16 (but not the CD-ROM² System/TurboGrafx-CD)
- NEC SuperGrafx - NEC SuperGrafx
- Bandai Wonderswan - Bandai WonderSwan
- Bandai Wonderswan Color - Bandai Wonderswan Color
**Note:** Some consoles were released under different names **Note:** Some consoles were released under different names

380
docs/interface/higan.md
View File

@@ -1,65 +1,31 @@
When you launch higan, When you launch higan
the main window appears, the main window appears,
with a menu-bar across the top, with a menu-bar across the top,
a status-bar across the bottom, a status-bar across the bottom,
and a large area in the middle where the game's video output appears. and a large area in the middle that shows
the running game's video output.
The Library menu The Library menu
---------------- ----------------
The Library menu allows you Manufacturer submenus
to import games into higan's game library, allow you to play
and to load games from the library. games you've already imported
higan organises the games in your library into higan's
according to which console they were intended to run on. [game library](../concepts/game-library.md).
See [Importing and playing games](../guides/import.md).
To play a game for a particular console from your library,
click on the Library menu, **Load ROM File ...**
click on the console manufacturer submenu opens a [filesystem browser](common.md#the-filesystem-browser)
(Nintendo for the Super Famicom, allowing you to choose a single ROM file.
Bandai for the WonderSwan, It will be imported and immediately start playing.
etc.) See [Importing and playing games](../guides/import.md).
then click on the console menu item.
A window will appear listing all the games in your library **Import ROM Files ...**
for that particular console. launches the icarus importing tool,
Select the game you want to play allowing you to bulk-import many ROM files at once.
and click the Open button, See [the icarus documentation](icarus.md).
or just double-click the game,
and it will begin playing as though you'd just turned on the console.
**Note:**
Sometimes
the NTSC and PAL variants of a particular console
behave differently,
or the Japanese and American variants.
When opening a game from the Game Library,
a drop-down list in the bottom-right of the window
allows you to choose which regional variation
of the console it should emulate.
For most consoles,
higan can reliably guess which variant to use,
and the list defaults to "Auto".
To add a new game to your library,
choose "Load ROM File ..." from the Library menu.
A [filesystem browser](common.md#the-filesystem-browser) will appear,
allowing you to pick any ROM image for any supported system,
with any of the most common file extensions.
It also allows loading ROM images from `.zip` archives,
if the archive contains a single ROM image.
**Note:** Some games require extra steps to import correctly;
see [Importing and playing games](../guides/import.md) for details.
To add many games at once,
run icarus,
or choose "Import ROM Files ..." from the Library menu
(which just runs icarus anyway).
See [the icarus interface](icarus.md)
for more information about bulk-importing.
For more information about the higan game library,
see [The Game Library](../concepts/game-library.md).
The console menu The console menu
--------------- ---------------
@@ -80,52 +46,60 @@ to the particular console being emulated.
All consoles will have some of the following items, All consoles will have some of the following items,
but few consoles have all of them. but few consoles have all of them.
- **Controller Port 1**
allows you **Controller Port 1**
to connect different emulated controllers allows you
to the first controller port, to connect different emulated controllers
if there is one. to the first controller port,
- See [higan's Input settings](higan-settings.md#input) if there is one.
for information about configuring See [higan's Input settings](higan-settings.md#input)
which host controller inputs are used for information about configuring
for the emulated controllers. which PC controller inputs are used
- This menu appears for the Famicom, for the emulated controllers.
even though the Famicom did not support alternate controllers,
because the Famicom emulation core also emulates the NES, This menu appears for the Famicom,
which did. even though the Famicom did not support alternate controllers,
- **Controller Port 2** because the Famicom emulation core also emulates the NES,
allows you which did.
to connect different emulated controllers
to the second controller port, **Controller Port 2**
if there is one. allows you
- See [higan's Input settings](higan-settings.md#input) to connect different emulated controllers
for information about configuring to the second controller port,
which host controller inputs are used if there is one.
for the emulated controllers. See [higan's Input settings](higan-settings.md#input)
- This menu appears for the Famicom, for information about configuring
even though the Famicom did not support alternate controllers, which PC controller inputs are used
because the Famicom emulation core also emulates the NES, for the emulated controllers.
which did.
- **Expansion Port** This menu appears for the Famicom,
allows you even though the Famicom did not support alternate controllers,
to connect different emulated devices because the Famicom emulation core also emulates the NES,
to the console's expansion port, which did.
if there is one.
- For the Super Famicom, **Expansion Port**
the [21fx][21fx] is a homebrew device allows you
that allows a program running on a PC to connect different emulated devices
to control a physical Super Famicom (or SNES). to the console's expansion port,
This option allows the same program if there is one.
to control the emulated SNES,
for development or testing. For the Super Famicom,
- **Power Cycle** the [21fx][21fx] is a homebrew device
restarts the loaded game that allows a program running on a PC
as though the emulated console were switched off and on again. to control a physical Super Famicom (or SNES).
- **Unload** This option allows the same program
stops the current game, to control the emulated SNES,
as though the emulated console were switched off. for development or testing.
You can load the same or a different game
from [the Library menu](#the-library-menu). **Power Cycle**
restarts the loaded game
as though the emulated console were switched off and on again.
**Unload**
stops the current game,
as though the emulated console were switched off.
You can load a new game
from [the Library menu](#the-library-menu).
[21fx]: https://github.com/defparam/21FX [21fx]: https://github.com/defparam/21FX
@@ -135,75 +109,96 @@ The Settings menu
The Settings menu allows you to configure things The Settings menu allows you to configure things
that aren't specific to any particular console. that aren't specific to any particular console.
- **Video Scale** determines the size and shape
of the emulated console's video output **Video Scale** determines the size
in windowed mode of the emulated console's video output
(as opposed to fullscreen). when higan is running in windowed mode
- **Video Emulation** applies various effects (as opposed to fullscreen).
to the emulated console's video output
to reproduce some behaviours **Video Emulation** applies various effects
that aren't technically part of the console itself. to the emulated console's video output
- "Blurring" simulates the limited horizontal resolution to reproduce some behaviours
of standard-definition TVs that aren't technically part of the console itself:
by blurring together horizontally-adjacent pixels.
Games like Jurassic Park for the Super Famicom - **Blurring**
simulates the limited horizontal resolution
of standard-definition TVs
by blurring together horizontally-adjacent pixels.
For hand-held consoles,
this simulates the slow response time
of the cheap LCD screens these consoles used
by blending each output frame with the previous one.
- Games like
Jurassic Park for the Super Famicom
or Chikyuu Kaihou Gun ZAS for the Game Boy
depend on this to emulate a transparency effect. depend on this to emulate a transparency effect.
For hand-held consoles like the Game Boy Advance, - **Colors**
this simulates the slow response time simulates the way a console's display device
of the cheap LCD screens these consoles used differs from modern computer monitor's colour reproduction.
by blurring each output frame with the previous one. In particular,
- "Colors" simulates the way a console's display device it simulates the slightly-different gamma correction
differs from modern computer monitor's colour reproduction. used by the Super Famicom,
In particular, the dim, washed out colours of the original Game Boy Advance,
it simulates the slightly-different gamma correction and the pea-green display of the original Game Boy.
used by the Super Famicom,
the dim, washed out colours of the original Game Boy Advance, **Video Shader** controls
and the pea-green display of the original Game Boy. how the low-resolution video output of the emulated console
- **Video Shader** controls is scaled up to suit modern high-resolution displays.
how the low-resolution video output of the emulated console The availability of items in this submenu depends on
is scaled up to suit modern high-resolution displays. which video driver higan is using,
The availability of items in this submenu depends on so see [Choosing drivers](../guides/drivers.md) for more information.
which video driver higan is using,
so see [Choosing drivers](../guides/drivers.md) for more information. - **None**
- "None" draws each output pixel according to draws each output pixel according to
the colour of the single nearest input pixel, the colour of the single nearest input pixel,
sometimes called "nearest neighbour" scaling. sometimes called "nearest neighbour" scaling.
This produces unnaturally crisp and blocky images. This produces unnaturally crisp and blocky images.
- "Blur" draws each output pixel by
averaging the colours of the four nearest input pixels, - **Blur**
sometimes called "bilinear" scaling. draws each output pixel by
This produces unnaturally blurry images. averaging the colours of the four nearest input pixels,
- When using the OpenGL driver, sometimes called "bilinear" scaling.
an additional item appears in this menu for This produces unnaturally blurry images.
each installed Quark shader.
See [Using video shaders](../guides/shaders.md) - When using the OpenGL driver,
for details. an additional item appears in this menu for
- **Synchronize Audio** each installed shader.
causes higan to wait for audio playback to complete See [Using video shaders](../guides/shaders.md)
before resuming emulation. for details.
This should reduce popping and glitching noises,
and slows the emulation down to approximately the correct speed. **Synchronize Audio**
If your PC cannot emulate at full-speed, causes higan to wait for audio playback to complete
(60fps for most consoles, 75fps for WonderSwan) before resuming emulation.
this has no noticable effect. This should reduce popping and glitching noises,
- **Mute Audio** and slows the emulation down to approximately the correct speed.
causes higan to not output sound from the emulated console. If your PC cannot emulate at full-speed,
The sound hardware is still emulated. (60fps for most consoles, 75fps for WonderSwan)
- **Show Status Bar** this has no noticable effect.
causes higan to show or hide the status bar
at the bottom of the window. **Mute Audio**
This option has no effect in full-screen mode. causes higan to not output sound from the emulated console.
See [The status bar](#the-status-bar) for more information. The sound hardware is still emulated.
- **Video ...**
opens [higan's Video settings](higan-settings.md#video). **Show Status Bar**
- **Audio ...** causes higan to show or hide the status bar
opens [higan's Audio settings](higan-settings.md#audio). at the bottom of the window.
- **Input ...** This option has no effect in full-screen mode.
opens [higan's Input settings](higan-settings.md#input). See [The status bar](#the-status-bar) for more information.
- **Hotkeys ...**
opens [higan's Hotkeys settings](higan-settings.md#hotkeys). **Video ...**
- **Advanced ...** opens [higan's Video settings](higan-settings.md#video).
opens [higan's Advanced settings](higan-settings.md#advanced).
**Audio ...**
opens [higan's Audio settings](higan-settings.md#audio).
**Input ...**
opens [higan's Input settings](higan-settings.md#input).
**Hotkeys ...**
opens [higan's Hotkeys settings](higan-settings.md#hotkeys).
**Advanced ...**
opens [higan's Advanced settings](higan-settings.md#advanced).
[svsa]: #why-do-synchronize-video-and-synchronize-audio-conflict [svsa]: #why-do-synchronize-video-and-synchronize-audio-conflict
@@ -213,33 +208,38 @@ The Tools menu
The Tools menu The Tools menu
contains features for manipulating the emulated console. contains features for manipulating the emulated console.
- **Save Quick State** **Save Quick State**
stores the current state of the emulated console stores the current state of the emulated console
into one of the quick state slots. into one of the quick state slots.
See [Save States](../concepts/save-states.md) for more information. See [Save States](../concepts/save-states.md) for more information.
- **Load Quick State**
restores the emulated console to **Load Quick State**
a state previously saved to one of the quick state slots. restores the emulated console to
See [Save States](../concepts/save-states.md) for more information. a state previously saved to one of the quick state slots.
- **Cheat Editor** See [Save States](../concepts/save-states.md) for more information.
opens [the Cheat Editor window](higan-tools.md#the-cheat-editor)
- **State Manager** **Cheat Editor**
opens [the State Manager window](higan-tools.md#the-state-manager) opens [the Cheat Editor window](higan-tools.md#the-cheat-editor)
- **Manifest Viewer**
opens [the Manifest Viewer window](higan-tools.md#the-manifest-viewer) **State Manager**
opens [the State Manager window](higan-tools.md#the-state-manager)
**Manifest Viewer**
opens [the Manifest Viewer window](higan-tools.md#the-manifest-viewer)
The Help menu The Help menu
------------- -------------
The Help menu contains information about higan itself. The Help menu contains information about higan itself.
- **Documentation** **Documentation**
loads the official higan documentation loads the official higan documentation
in your web-browser. in your web-browser.
- **About**
opens the About dialog, **About**
which displays basic information about higan, opens the About dialog,
including the version number. which displays basic information about higan,
including the version number.
The status bar The status bar
-------------- --------------

22
docs/interface/icarus.md
View File

@@ -2,7 +2,15 @@ When launching icarus,
directly or by picking "Import ROM Files ..." directly or by picking "Import ROM Files ..."
from higan's [Library menu](higan.md#the-library-menu), from higan's [Library menu](higan.md#the-library-menu),
the main icarus window appears. the main icarus window appears.
This is [a filesystem browser](common.md#the-filesystem-browser), This window allows you to bulk-import ROM files
into [higan's game library][gamelib],
and also to access icarus' settings.
Bulk importing ROM files
------------------------
icarus' main window
is [a filesystem browser](common.md#the-filesystem-browser),
with customisations: with customisations:
- The filesystem browser only lists - The filesystem browser only lists
@@ -15,22 +23,24 @@ with customisations:
- You can un-tick all the check-boxes - You can un-tick all the check-boxes
by pressing "Unselect All" in the bottom-left. by pressing "Unselect All" in the bottom-left.
Pressing "Settings ..." in the bottom-right
opens [the icarus Settings dialog](#the-icarus-settings-dialog).
Pressing "Import ..." in the bottom-right Pressing "Import ..." in the bottom-right
will close the filesystem browser will close the filesystem browser
then try to import all the files then try to import all the files
whose check-boxes are ticked whose check-boxes are ticked
into [the Game Library][gamelib]. into [the Game Library][gamelib].
icarus displays a progress dialog during the import process. icarus displays a progress dialog during the import process,
and a result window if any errors occurred.
**Note:** Some games require extra steps to import correctly; **Note:** Some games require extra steps to import correctly;
see [the Game Library][gamelib] for details. see [Importing and playing games](../guides/import.md) for details.
The icarus Settings dialog The icarus Settings dialog
-------------------------- --------------------------
Pressing "Settings ..."
in the bottom-right corner of the main icarus window
opens the settings dialog.
The icarus Settings dialog contains the following settings: The icarus Settings dialog contains the following settings:
- **Library Location** determines - **Library Location** determines

1
ruby/input/joypad/udev.cpp
View File

@@ -98,6 +98,7 @@ struct InputJoypadUdev {
} }
auto rumble(uint64_t id, bool enable) -> bool { auto rumble(uint64_t id, bool enable) -> bool {
print("Joypad ", id, " rumble: ", enable, "\n");
for(auto& jp : joypads) { for(auto& jp : joypads) {
if(jp.hid->id() != id) continue; if(jp.hid->id() != id) continue;
if(!jp.hid->rumble()) continue; if(!jp.hid->rumble()) continue;