「RetroArch」の版間の差分
(同期) |
(同期) |
||
4行目: | 4行目: | ||
{{Note|RetroArch は [[Arch Linux]] とは関係ありません。}} |
{{Note|RetroArch は [[Arch Linux]] とは関係ありません。}} |
||
− | [http://www. |
+ | [http://www.retroarch.com/ RetroArch] はモジュール式のコマンドラインを使用する、マルチシステムエミュレータです。高速かつ軽量で、移植性が高くなるように設計されています。RetroArch には他のエミュレータには見られないような機能もあり、リアルタイムの巻き戻しや libretro API によるゲーム別のシェーディングなどが出来ます。 |
== インストール == |
== インストール == |
||
− | {{Pkg|retroarch}} パッケージをインストールしてください。あるいは開発版を使いたい場合は {{AUR|retroarch-git}} をインストールしてください。 |
+ | 1. {{Pkg|retroarch}} パッケージをインストールしてください。あるいは開発版を使いたい場合は {{AUR|retroarch-git}} をインストールしてください。 |
+ | |||
+ | 2. '''XMB メニューアセット'''を正しく表示させるために {{Pkg|retroarch-assets-xmb}} パッケージをインストールしてください。 |
||
== 使用方法 == |
== 使用方法 == |
||
13行目: | 15行目: | ||
libretro コアパッケージはライブラリを {{ic|/usr/lib/libretro/}} にインストールします。ライブラリを選択して ''retroarch'' を実行する場合: |
libretro コアパッケージはライブラリを {{ic|/usr/lib/libretro/}} にインストールします。ライブラリを選択して ''retroarch'' を実行する場合: |
||
− | $ retroarch - |
+ | $ retroarch --libretro /usr/lib/libretro/libretro-''core''.so ''path/to/rom'' |
デフォルトのエミュレーションコアは {{ic|retroarch.cfg}} で定義でき、毎回コアを指定する必要がなくなります。 |
デフォルトのエミュレーションコアは {{ic|retroarch.cfg}} で定義でき、毎回コアを指定する必要がなくなります。 |
||
例: |
例: |
||
− | {{hc|/etc/retroarch.cfg |
+ | {{hc|/etc/retroarch.cfg または ~/.retroarch.cfg|2= |
− | libretro_path = "/usr/lib/libretro/libretro- |
+ | libretro_path = "/usr/lib/libretro/libretro-''core''.so"}} |
== 設定 == |
== 設定 == |
||
RetroArch の設定ファイルは {{ic|/etc/retroarch.cfg}} にあり、コメントが大量に付記されています。 |
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}} パラメータを使うことで設定を上書きすることができ、キーバインドやビデオ設定、音声設定などを実装に合わせて変更する必要がある場合に便利です。 |
メインの設定ファイル {{ic|retroarch.cfg}} で {{ic|#include "foo.cfg"}} ディレクティブを使うことで設定ファイルを分割することができます。{{ic|--appendconfig /path/to/config}} パラメータを使うことで設定を上書きすることができ、キーバインドやビデオ設定、音声設定などを実装に合わせて変更する必要がある場合に便利です。 |
||
29行目: | 34行目: | ||
{{Note|{{AUR|retroarch-git}} で ''cg shaders'' を使うには {{pkg|nvidia-cg-toolkit}} が必要です。}} |
{{Note|{{AUR|retroarch-git}} で ''cg shaders'' を使うには {{pkg|nvidia-cg-toolkit}} が必要です。}} |
||
{{Warning|''[[ALSA]]'' を使用する場合、{{ic|audio_out_rate}} をシステムのデフォルト出力レート (通常は 48000) に合わせる必要があります。}} |
{{Warning|''[[ALSA]]'' を使用する場合、{{ic|audio_out_rate}} をシステムのデフォルト出力レート (通常は 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" |
||
== オンラインアップデータ == |
== オンラインアップデータ == |
||
48行目: | 61行目: | ||
== トラブルシューティング == |
== トラブルシューティング == |
||
+ | === No cores found === |
||
+ | デフォルトでは RetroArch は {{ic|~/.config/retroarch/cores}} からコアを検索します。公式リポジトリのパッケージではコアを {{ic|/usr/lib/libretro/}} にインストールし、コアの情報を {{ic|/usr/share/libretro/info}} にインストールします。上記の[[#パス|パス]]セクションに書かれているようにディレクトリの設定を変更してください。 |
||
+ | |||
=== 入力デバイスが使えない === |
=== 入力デバイスが使えない === |
||
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|<nowiki>KERNEL=="event*", NAME="input/%k", MODE="666"</nowiki>}} という中身のルールを {{ic|/etc/udev/rules.d/99-evdev.rules}} に追加することで解決します。次を実行して udev ルールをリロードしてください: |
||
65行目: | 81行目: | ||
== 参照 == |
== 参照 == |
||
+ | * [http://www.retroarch.com/ 公式ウェブサイト] |
||
* [https://github.com/libretro/RetroArch/wiki RetroArch wiki on Github] |
* [https://github.com/libretro/RetroArch/wiki RetroArch wiki on Github] |
||
− | * [ |
+ | * [https://github.com/libretro/libretro.github.com/wiki/Documentation-devs 開発者向けドキュメント] |
2017年7月14日 (金) 23:24時点における版
RetroArch はモジュール式のコマンドラインを使用する、マルチシステムエミュレータです。高速かつ軽量で、移植性が高くなるように設計されています。RetroArch には他のエミュレータには見られないような機能もあり、リアルタイムの巻き戻しや libretro API によるゲーム別のシェーディングなどが出来ます。
目次
インストール
1. retroarch パッケージをインストールしてください。あるいは開発版を使いたい場合は retroarch-gitAUR をインストールしてください。
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
で定義でき、毎回コアを指定する必要がなくなります。
例:
/etc/retroarch.cfg または ~/.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
パラメータを使うことで設定を上書きすることができ、キーバインドやビデオ設定、音声設定などを実装に合わせて変更する必要がある場合に便利です。
パス
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"
オンラインアップデータ
最近のバージョンの 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 は ~/.config/retroarch/cores
からコアを検索します。公式リポジトリのパッケージではコアを /usr/lib/libretro/
にインストールし、コアの情報を /usr/share/libretro/info
にインストールします。上記のパスセクションに書かれているようにディレクトリの設定を変更してください。
入力デバイスが使えない
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 のビデオ解像度やリフレッシュレートを調整することで問題が解決する場合はこの手段は使わないほうが良いでしょう。