「RetroArch」の版間の差分

2018年1月4日 (木) 23:38時点における版

ノート: RetroArch は Arch Linux とは関係ありません。

RetroArch はモジュール式のコマンドラインを使用する、マルチシステムエミュレータです。高速かつ軽量で、移植性が高くなるように設計されています。RetroArch には他のエミュレータには見られないような機能もあり、リアルタイムの巻き戻しや libretro API によるゲーム別のシェーディングなどが出来ます。

インストール

1. retroarch パッケージをインストールしてください。あるいは開発版を使いたい場合は retroarch-git^AUR をインストールしてください。

2. XMB メニューアセットを正しく表示させるために retroarch-assets-xmb パッケージをインストールしてください。

使用方法

RetroArch はエミュレータコアやエミュレータ実装と呼ばれる形でライブラリを分離しており Community リポジトリや Libretro GitHub リポジトリから入手できます。

libretro コアパッケージはライブラリを /usr/lib/libretro/ にインストールします。ライブラリを選択して retroarch を実行する場合:

$ retroarch --libretro /usr/lib/libretro/libretro-core.so path/to/rom

デフォルトのエミュレーションコアは retroarch.cfg で定義でき、毎回コアを指定する必要がなくなります。例:

~/.config/retroarch/retroarch.cfg

libretro_path = "/usr/lib/libretro/libretro-core.so"

設定

RetroArch の設定ファイルは /etc/retroarch.cfg にあり、コメントが大量に付記されています。

デフォルトの設定ファイルをホームディレクトリにコピー:

$ cp /etc/retroarch.cfg ~/.config/retroarch/retroarch.cfg

メインの設定ファイル retroarch.cfg で #include "foo.cfg" ディレクティブを使うことで設定ファイルを分割することができます。--appendconfig /path/to/config パラメータを使うことで設定を上書きすることができ、キーバインドやビデオ設定、音声設定などを実装に合わせて変更する必要がある場合に便利です。

ヒント: RetroArch は bsnes xml filters と cg shaders をロードすることができ、それぞれ retroarch.cfg で video_bsnes_shader と video_cg_shader として定義します。

ノート: retroarch-git^AUR で cg shaders を使うには nvidia-cg-toolkit が必要です。

警告: ALSA を使用する場合、audio_out_rate をシステムのデフォルト出力レート (通常は 48000) に合わせる必要があります。

オンラインアップデータ

最近のバージョンの RetroArch には、RetroArch Buildbot からコアファイルや様々なアセットデータなどを更新できるメニューがあります。メインメニューの "Online Updater" からアクセスできます:

Online Updater

Core Updater
Update Core Info Files
Update Assets
Update Autoconfig Profiles
Update Cheats
Update Databases
Update Overlays
Update GLSL Shaders

上記のコア・アセットファイルは最新状態が保たれ、常時アップデータから取得することができます。

トラブルシューティング

No cores found

デフォルトでは RetroArch は /usr/lib/libretro/ からコアを検索します。付属のオンラインアップデータでダウンロードされたコアは root で retroarch を実行しないと保存されません (推奨されません、pacman によってインストールされたコアを上書きしてしまう恐れがあります)。ユーザーではディレクトリを編集する権限がないためです。オンラインアップデータのコアを使うには、以下の行を編集してください:

~/.config/retroarch/retroarch.cfg

libretro_directory = "~/.config/retroarch/cores"
libretro_info_path = "~/.config/retroarch/cores/info"

メニューにコアをアップデート・ダウンロードするオプションが存在しない

~/.config/retroarch/retroarch.cfg または /etc/retroarch.cfg を開いて menu_show_core_updater が true に設定されていることを確認してください。設定すると Online Updater メニューからコアをアップデートして Load Core メニューからコアをダウンロードできるようになります。

入力デバイスが使えない

RetroArch を CLI で実行したり Xorg 以外のディスプレイサーバーで実行すると問題が発生します。/dev/input ノードは root だけがアクセスできるように制限されているためです。この問題は手動で KERNEL=="event*", NAME="input/%k", MODE="666" という中身のルールを /etc/udev/rules.d/99-evdev.rules に追加することで解決します。次を実行して udev ルールをリロードしてください:

# udevadm control --reload-rules

システムを再起動したりデバイスの再接続ができない場合、次のコマンドでパーミッションを強制的に設定することもできます:

# chmod 666 /dev/input/event*

もしくは、ユーザーを "input" グループに追加してください。例:

# usermod -a -G input user

ビデオパフォーマンスが悪い

ビデオパフォーマンスが低いのを補うために、~/.config/retroarch/retroarch.cfg に video_threaded = true と設定することで RetroArch を別のスレッドで実行することができます。

ただし、垂直同期が完全に使えなくなり、遅延が多少増えるため、RetroArch のビデオ解像度やリフレッシュレートを調整することで問題が解決する場合はこの手段は使わないほうが良いでしょう。

参照

@@ 1行目: / 1行目: @@
 [[Category:ゲーム]]
-[[Category:エミュレータ]]
+[[Category:エミュレーション]]
 [[en:RetroArch]]
+[[es:RetroArch]]
 {{Note|RetroArch は [[Arch Linux]] とは関係ありません。}}
@@ 17行目: / 18行目: @@
  $ retroarch --libretro /usr/lib/libretro/libretro-''core''.so ''path/to/rom''
-デフォルトのエミュレーションコアは {{ic|retroarch.cfg}} で定義でき、毎回コアを指定する必要がなくなります。
+デフォルトのエミュレーションコアは {{ic|retroarch.cfg}} で定義でき、毎回コアを指定する必要がなくなります。例:
+{{hc|~/.config/retroarch/retroarch.cfg|2=
-例:
-{{hc|/etc/retroarch.cfg または ~/.retroarch.cfg|2=
 libretro_path = "/usr/lib/libretro/libretro-''core''.so"}}
@@ 33行目: / 33行目: @@
 {{Tip|RetroArch は ''[https://gitorious.org/bsnes/xml-shaders bsnes xml filters]'' と ''[https://github.com/libretro/common-shaders cg shaders]'' をロードすることができ、それぞれ {{ic|retroarch.cfg}} で {{ic|video_bsnes_shader}} と {{ic|video_cg_shader}} として定義します。}}
 {{Note|{{AUR|retroarch-git}} で ''cg shaders'' を使うには {{pkg|nvidia-cg-toolkit}} が必要です。}}
-{{Warning|''[[ALSA]]'' を使用する場合、{{ic|audio_out_rate}} をシステムのデフォルト出力レート (通常は 48000) に合わせる必要があります。}}
+{{Warning|[[ALSA]] を使用する場合、{{ic|audio_out_rate}} をシステムのデフォルト出力レート (通常は {{ic|48000}}) に合わせる必要があります。}}
-=== パス ===
-Arch のパッケージを正しく使うには設定に変更が必要です:
- assets_directory = "/usr/share/libretro/assets"
- libretro_info_path = "/usr/share/libretro/info"
- libretro_directory = "/usr/lib/libretro"
- joypad_autoconfig_dir = "/usr/share/libretro/autoconfig"
 == オンラインアップデータ ==
@@ 62行目: / 54行目: @@
 == トラブルシューティング ==
 === No cores found ===
-デフォルトでは RetroArch は {{ic|~/.config/retroarch/cores}} からコアを検索します。公式リポジトリのパッケージではコアを {{ic|/usr/lib/libretro/}} にインストールし、コアの情報を {{ic|/usr/share/libretro/info}} にインストールします。上記の[[#パス|パス]]セクションに書かれているようにディレクトリの設定を変更してください。
+デフォルトでは RetroArch は {{ic|/usr/lib/libretro/}} からコアを検索します。付属のオンラインアップデータでダウンロードされたコアは root で retroarch を実行しないと保存されません (推奨されません、[[pacman]] によってインストールされたコアを上書きしてしまう恐れがあります)。ユーザーではディレクトリを編集する権限がないためです。オンラインアップデータのコアを使うには、以下の行を編集してください:
+{{hc|~/.config/retroarch/retroarch.cfg|2=
+libretro_directory = "~/.config/retroarch/cores"
+libretro_info_path = "~/.config/retroarch/cores/info"
+}}
+=== メニューにコアをアップデート・ダウンロードするオプションが存在しない ===
+{{ic|~/.config/retroarch/retroarch.cfg}} または {{ic|/etc/retroarch.cfg}} を開いて {{ic|menu_show_core_updater}} が {{ic|true}} に設定されていることを確認してください。設定すると ''Online Updater'' メニューからコアをアップデートして ''Load Core'' メニューからコアをダウンロードできるようになります。
 === 入力デバイスが使えない ===
-RetroArch を CLI で実行したり [[Xorg]] 以外のディスプレイサーバーで実行すると問題が発生します。{{ic|/dev/input}} ノードは root だけがアクセスできるように制限されているためです。この問題は手動で {{ic|<nowiki>KERNEL=="event*", NAME="input/%k", MODE="666"</nowiki>}} という中身のルールを {{ic|/etc/udev/rules.d/99-evdev.rules}} に追加することで解決します。次を実行して udev ルールをリロードしてください:
+RetroArch を CLI で実行したり [[Xorg]] 以外のディスプレイサーバーで実行すると問題が発生します。{{ic|/dev/input}} ノードは root だけがアクセスできるように制限されているためです。この問題は手動で {{ic|1=KERNEL=="event*", NAME="input/%k", MODE="666"}} という中身のルールを {{ic|/etc/udev/rules.d/99-evdev.rules}} に追加することで解決します。次を実行して udev ルールをリロードしてください:
  # udevadm control --reload-rules