Difference between revisions of "VisualBoyAdvance-M"

From ArchWiki
Jump to: navigation, search
(Add reason for Template:out of date)
(Added VBA-M (SDL) dev version)
 
(30 intermediate revisions by 11 users not shown)
Line 1: Line 1:
 
[[Category:Gaming]]
 
[[Category:Gaming]]
 
[[Category:Emulators]]
 
[[Category:Emulators]]
{{out of date|Removed from the official repositories}}
+
[[ja:VisualBoyAdvance-M]]
Visual Boy Advance is a very popular Game Boy Advance emulator. It supports Game Boy, Super Game Boy, Game Boy Color, and Game Boy Advance games. These games all come in the form of ROMS. They are then loaded and played. It uses 3 rendering engines in the Linux version, They are OpenGL, Cairo, and Xvideo. It includes some useful features including fullscreen, image filters, save, load, screen capture, key mapping, frame throttling, and some extra sound and video filters.
+
'''VisualBoyAdvance-M''' (commonly abbreviated as '''VBA-M''') is a cross-platform emulator for the (Super-) Game Boy/Colour/Advance portable game consoles.
  
[http://vba.ngemu.com/index.shtml Homepage]
+
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.
  
Hint: VBA has been removed from the [[Official Repositories]]. The fork [https://aur.archlinux.org/packages.php?O=0&K=vba-m&do_Search=Go vba-m] is available in the [[AUR]].
+
== Installation ==
  
==Installation==
+
* {{App|VBA-M (GTK)|Nintendo GameBoy Advance emulator - GTK version|http://vba-m.com/|{{Pkg|vbam-gtk}}}}
You can install {{pkg|visualboyadvance}} from [[Official Repositories]].
+
* {{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}}}}
  
==Usage==
+
== Usage ==
  
# VisualBoyAdvance someRom.zip
+
For VBA-M, execute {{ic|gvbam ~/path/to/foo.*}} or {{ic|gvbam}} to load the ROM from the interface.
  
Full screen, no debug messages, doesn't show speed % on screen.
+
{{Tip|File extensions differ between emulated platforms. VBA-M also supports compressed ROMs.}}
# VisualBoyAdvance -F -N --no-show-speed someRom.zip
+
  
Default controls are:
+
{| class="wikitable"
  Left         Left Arrow  (0114)
+
|+ Default controls
  Right         Right Arrow (0113)
+
!Emulated !! Real
  Up           Up Arrow    (0111)
+
|-
  Down         Down Arrow  (0112)
+
| Left || Left Arrow  (0114)
  A             Z           (007a)
+
|-
  B             X           (0078)
+
| Right || Right Arrow (0113)
  L             A           (0061)
+
|-
  R             S           (0073)
+
| Up || Up Arrow    (0111)
  Start         ENTER      (000d)
+
|-
  Select       BACKSPACE  (0008)
+
| Down || Down Arrow  (0112)
  Speed up     SPACE      (0020)
+
|-
  Capture       F12         (0125)
+
| 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==
+
== Troubleshooting ==
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
+
{{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}}
Segmentation fault
+
  
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
+
===OpenGL crashes===
 +
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>}}
  
    bool SoundSDL::init(long sampleRate)
+
===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.
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.
+
{{Warning|This also prevents any other configuration from being saved.}}
  
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
+
To manually set the directories, edit the {{ic|[Directories]}} section of {{ic|~/.config/gvbam/config}}.
 
+
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=