Difference between revisions of "VisualBoyAdvance-M"

From ArchWiki
Jump to: navigation, search
(Installation: There's now an official VisualBoyAdvance package)
(Added VBA-M (SDL) dev version)
 
(25 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
[[Category:Gaming]]
 
[[Category:Gaming]]
 
[[Category:Emulators]]
 
[[Category:Emulators]]
'''VisualBoyAdvance''' (commonly abbreviated as '''VBA''') is a cross-platform emulator for the Game Boy, Super Game Boy, Game Boy Color, and Game Boy Advance game consoles. It is an inactive project superseded by '''VisualBoyAdvance-M''' (known as '''VBA-M'''), an improved fork that initially integrated features from earlier forks.
+
[[ja:VisualBoyAdvance-M]]
 +
'''VisualBoyAdvance-M''' (commonly abbreviated as '''VBA-M''') is a cross-platform emulator for the (Super-) Game Boy/Colour/Advance portable game consoles.
  
==Installation==
+
It is a fork of VisualBoyAdvance, a now closed project. VBA-M combines features from several other VBA forks. It is licensed under the GPLv2, and is available in the Community repository.
Install {{Pkg|vbam-gtk}} from the official repositories or {{aur|vba-m-gtk-svn}} from the [[AUR]].
+
  
==Usage==
+
== Installation ==
Run VBA-M with the following.
+
  
vbam ~/path/to/rom.gba
+
* {{App|VBA-M (GTK)|Nintendo GameBoy Advance emulator - GTK version|http://vba-m.com/|{{Pkg|vbam-gtk}}}}
 +
* {{App|VBA-M (wx)|Nintendo GameBoy Advance emulator - wx version|http://vba-m.com/|{{Pkg|vbam-wx}}}}
 +
* {{App|VBA-M (SDL)|Nintendo GameBoy Advance emulator - SDL version|http://vba-m.com/|{{Pkg|vbam-sdl}}}}
 +
* {{App|VBA-M (GTK) (development version)|Gameboy Advance Emulator combining features of all VBA forks - GTK GUI - SVN version|http://vba-m.com/|{{AUR|vbam-gtk-svn}}}}
 +
* {{App|VBA-M (wx) (development version) |Improved (Super) Game Boy Color/Advance emulator - wxWidgets GUI, SVN version|http://vba-m.com/|{{AUR|vbam-wx-svn}}}}
 +
* {{App|VBA-M (SDL) (development version) |Improved (Super) Game Boy Color/Advance emulator - SDL, SVN version|http://vba-m.com/|{{AUR|vbam-sdl-svn}}}}
  
{{Tip|Extensions may vary depending on what console the ROM is for. VBA-M can also open compressed {{ic|.zip}} archives containing a ROM.}}
+
== Usage ==
  
To open a ROM in full screen, with debug messages and emulation speed display disabled, run:
+
For VBA-M, execute {{ic|gvbam ~/path/to/foo.*}} or {{ic|gvbam}} to load the ROM from the interface.
  
vbam -F -N --no-show-speed ~/path/to/rom.zip
+
{{Tip|File extensions differ between emulated platforms. VBA-M also supports compressed ROMs.}}
  
VBA-M also comes with a GTK GUI, which can be used by running {{ic|gvbam}}.
+
{| class="wikitable"
 +
|+ Default controls
 +
!Emulated !! Real
 +
|-
 +
| Left || Left Arrow  (0114)
 +
|-
 +
| Right || Right Arrow (0113)
 +
|-
 +
| Up || Up Arrow    (0111)
 +
|-
 +
| Down || Down Arrow  (0112)
 +
|-
 +
| A || Z (007a)
 +
|-
 +
| B || X (0078)
 +
|-
 +
| L || A (0061)
 +
|-
 +
| R || S (0073)
 +
|-
 +
| Start || Enter (000d)
 +
|-
 +
| Select || Backspace (0008)
 +
|-
 +
| Speed up || Space (0020)
 +
|-
 +
| Capture || F12 (0125)
 +
|}
  
Default controls are:
+
== Troubleshooting ==
  Left          Left Arrow  (0114)
+
  Right        Right Arrow (0113)
+
  Up            Up Arrow    (0111)
+
  Down          Down Arrow  (0112)
+
  A            Z          (007a)
+
  B            X          (0078)
+
  L            A          (0061)
+
  R            S          (0073)
+
  Start        ENTER      (000d)
+
  Select        BACKSPACE  (0008)
+
  Speed up      SPACE      (0020)
+
  Capture      F12        (0125)
+
  
==Issues==
+
{{Out of date|Old advice needs to be verified as still useful, if it is to be kept.|Talk:VisualBoyAdvance-M#Please try to reproduce the problems described in Troubleshooting}}
{{Poor writing|Grammar, spelling, and organisation issues}}
+
There are a couple known issues during installation
+
When trying to run VBA after an install you may get this after typing in gvba.
+
  
~$ Failed to open audio: Fragment size must be a power of two
+
===OpenGL crashes===
Segmentation fault
+
In case of OpenGL errors, it is possible that the video output is set to an invalid display. Editing the {{ic|Display}} section in {{ic|~/.config/gvbam/config}}, and changing {{ic|<nowiki>output=1</nowiki>}} to {{ic|<nowiki>output=2</nowiki>}} or {{ic|<nowiki>output=0</nowiki>}}
  
VBA has been updated to fix this but if you still get this error it may be fixed by editing /src/vbam/src/common/SoundSDL.cpp and editing the function
+
===Directories randomly reverted===
 +
VBA may randomly revert the ROM directories to the defaults. Changing permissions for {{ic|~/.config/gvbam/config}} to read-only will prevent VBA from doing so.
 +
{{Warning|This also prevents any other configuration from being saved.}}
  
    bool SoundSDL::init(long sampleRate)
+
To manually set the directories, edit the {{ic|[Directories]}} section of {{ic|~/.config/gvbam/config}}.
+
Editing the audio sample has helped me before. If you feel this is too technical, you should contact the developers at the vba forums because this issue should now be resolved.
+
 
+
If you are getting errors about OpenGL and video output the problem is most likely that the video output choice is wrong. To fix this edit the configuration file. In the directory /home/<USER>/.config/gvbam
+
 
+
In the '''Display''' Section of the config file changing the line from
+
output=1
+
to
+
output=2
+
or
+
output=0'''
+
 
+
Has been known to fix the problem.
+
 
+
Also the Directories for which VBA will search for the game saves and ROMs can sometimes revert back to the default setting. If prefer to keep you saves and ROMs in a specific directory you may want to edit the config file in /home/$USER/.config/gvbam You may then set the permissions to read-only to prevent VBA from changing them.Take note that any time you change a setting and save while the cofig file is on read-only it will not save. Putting it to read-only effectively "locks" the file from any annoying changes.
+
 
+
In the '''Directories''' section simply enter in your preferred directory like this.
+
  
 
  [Directories]
 
  [Directories]
  gb_roms=/home/generic/Documents/VBA/ROMs
+
  gb_roms=
  gba_roms=/home/generic/Documents/VBA/ROMs
+
  gba_roms=
  batteries=/home/generic/.config/gvbam
+
  batteries=
  saves=/home/generic/Documents/VBA/SAVES
+
cheats=
  captures=/home/generic/Documents/VBA
+
  saves=
 
+
  captures=
Also make sure your new config file is saved as "config" and not "config~".
+

Latest revision as of 19:05, 20 February 2016

VisualBoyAdvance-M (commonly abbreviated as VBA-M) is a cross-platform emulator for the (Super-) Game Boy/Colour/Advance portable game consoles.

It is a fork of VisualBoyAdvance, a now closed project. VBA-M combines features from several other VBA forks. It is licensed under the GPLv2, and is available in the Community repository.

Installation

  • VBA-M (GTK) — Nintendo GameBoy Advance emulator - GTK version
http://vba-m.com/ || vbam-gtk
  • VBA-M (wx) — Nintendo GameBoy Advance emulator - wx version
http://vba-m.com/ || vbam-wx
  • VBA-M (SDL) — Nintendo GameBoy Advance emulator - SDL version
http://vba-m.com/ || vbam-sdl
  • VBA-M (GTK) (development version) — Gameboy Advance Emulator combining features of all VBA forks - GTK GUI - SVN version
http://vba-m.com/ || vbam-gtk-svnAUR
  • VBA-M (wx) (development version) — Improved (Super) Game Boy Color/Advance emulator - wxWidgets GUI, SVN version
http://vba-m.com/ || vbam-wx-svnAUR
  • VBA-M (SDL) (development version) — Improved (Super) Game Boy Color/Advance emulator - SDL, SVN version
http://vba-m.com/ || vbam-sdl-svnAUR

Usage

For VBA-M, execute gvbam ~/path/to/foo.* or gvbam to load the ROM from the interface.

Tip: File extensions differ between emulated platforms. VBA-M also supports compressed ROMs.
Default controls
Emulated Real
Left Left Arrow (0114)
Right Right Arrow (0113)
Up Up Arrow (0111)
Down Down Arrow (0112)
A Z (007a)
B X (0078)
L A (0061)
R S (0073)
Start Enter (000d)
Select Backspace (0008)
Speed up Space (0020)
Capture F12 (0125)

Troubleshooting

Tango-view-refresh-red.pngThis article or section is out of date.Tango-view-refresh-red.png

Reason: Old advice needs to be verified as still useful, if it is to be kept. (Discuss in Talk:VisualBoyAdvance-M#Please try to reproduce the problems described in Troubleshooting)

OpenGL crashes

In case of OpenGL errors, it is possible that the video output is set to an invalid display. Editing the Display section in ~/.config/gvbam/config, and changing output=1 to output=2 or output=0

Directories randomly reverted

VBA may randomly revert the ROM directories to the defaults. Changing permissions for ~/.config/gvbam/config to read-only will prevent VBA from doing so.

Warning: This also prevents any other configuration from being saved.

To manually set the directories, edit the [Directories] section of ~/.config/gvbam/config.

[Directories]
gb_roms=
gba_roms=
batteries=
cheats=
saves=
captures=