RetroArchのソースを表示

[[Category:ゲーム]]
[[Category:エミュレーション]]
[[en:RetroArch]]
[[es:RetroArch]]
{{Note|RetroArch は [[Arch Linux]] とは関係ありません。}}

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

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

{{Tip|
* Install {{Pkg|retroarch-assets-xmb}} to get the fonts and icons for the RetroArch GUI. You may also want to install {{Pkg|retroarch-assets-ozone}} for a more desktop-friendly GUI.
* Install {{AUR|retroarch-standalone-service}} to get system user, system service and RetroArch configuration for standalone game-box. Then start and/or enable {{ic|retroarch-standalone.service}}.
}}

== 使用方法 ==

RetroArch は、その機能のほとんどを「コア」と呼ばれる個別のライブラリに依存しています。これらは、RetroArch 内で ([https://buildbot.libretro.com/ libretro Buildbot] を介して) ユーザーごとにダウンロードするか、または、システム全体に[https://www.archlinux.org/groups/x86_64/libretro/ Community] または [https://aur.archlinux.org/packages/?O=0&K=libretro AUR] から[[インストール]]することもできます。 

デフォルトでは、RetroArchはダウンロードするユーザーごとのコアをロードするように構成されています。他の場所にインストールする場合は、[[#設定]] を変更します。

特定のコアを実行するコマンドは次の通りです

 $ retroarch --libretro ''/path/to/some_core_libretro.so'' ''/path/to/rom''

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

デフォルトの設定ファイルをホームディレクトリにコピー:
 $ cp /etc/retroarch.cfg ~/.config/retroarch/retroarch.cfg

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

{{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}} をシステムのデフォルト出力レート (通常は {{ic|48000}}) に合わせる必要があります。}}

== ヒントとテクニック ==

=== ''オンラインアップデーター'' を有効にする ===

pacman の代わりに組み込みのアップデータを使用して、すべての RetroArch コンポーネントをインストールする場合は、設定ファイルを使用して有効にすることができます:

{{hc|~/.config/retroarch/retroarch.cfg|2=menu_show_core_updater = "true"}}

=== Enabling ''SaveRAM Autosave Interval'' ===

By default, RetroArch only writes SRAM onto disk when it exits without error, which means that there is a risk of losing save data when using crash-prone cores. To change this behavior, open {{ic|~/.config/retroarch/retroarch.cfg}} and set {{ic|autosave_interval}} to ''n''.

{{hc|~/.config/retroarch/retroarch.cfg|2=
autosave_interval = "600"
}}

With the example above, RetroArch will write SRAM changes onto disk every 600 seconds.

{{Warning|Setting this value too low will cause all sorts of issue, most notably hardware degradation. See [https://github.com/libretro/RetroArch/issues/4901#issuecomment-300888019]}}

=== Filters and shaders ===

RetroArch can load [https://gitorious.org/bsnes/xml-shaders BSNES XML filters] and [https://github.com/libretro/common-shaders CG shaders]. These are set in {{ic|retroarch.cfg}} with {{ic|video_bsnes_shader}} and {{ic|video_cg_shader}} respectively. The shaders can also be obtained and updated directly inside RetroArch using the Online Updater.

{{Note|{{AUR|retroarch-git}} requires {{pkg|nvidia-cg-toolkit}} in order to use the ''cg shaders''.}}

=== Reset settings to their default value ===

To reset a setting or keybind to its default value through the GUI, highlight it and press {{ic|Start}}. To remove a button from a keybind, highlight the keybind and press {{ic|Y}}.

== トラブルシューティング ==
=== No cores found ===
デフォルトでは 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|1=KERNEL=="event*", NAME="input/%k", MODE="666"}} という中身のルールを {{ic|/etc/udev/rules.d/99-evdev.rules}} に追加することで解決します。次を実行して udev ルールをリロードしてください:
 # udevadm control --reload-rules

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

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

 # usermod -a -G input user

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

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

=== Audio issues with ALSA ===

When using [[ALSA]] the {{ic|audio_out_rate}} must match the system's default output rate, usually {{ic|48000}}.

=== Save data is lost whenever RetroArch crashes ===

See [[#Enabling SaveRAM Autosave Interval]].

== 参照 ==
* [http://www.retroarch.com/ 公式ウェブサイト]
* [https://github.com/libretro/RetroArch/wiki RetroArch wiki on Github]
* [https://github.com/libretro/libretro.github.com/wiki/Documentation-devs 開発者向けドキュメント]