「RetroArch」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(→‎使用方法: 英語版に差し替え)
16行目: 16行目:
   
 
== 使用方法 ==
 
== 使用方法 ==
RetroArch は''エミュレータコア''や''エミュレータ実装''と呼ばれる形でライブラリを分離しており [https://www.archlinux.org/packages/?q=libretro Community] リポジトリや [https://github.com/libretro Libretro GitHub リポジトリ] から入手できます。
 
   
  +
RetroArch relies on separate libraries, called "cores", for most of its functionality. These can be downloaded per-user within RetroArch itself (via the [https://buildbot.libretro.com/ libretro Buildbot]) or you can [[install]] them system-wide via [https://www.archlinux.org/groups/x86_64/libretro/ Community] or [https://aur.archlinux.org/packages/?O=0&K=libretro AUR].
libretro コアパッケージはライブラリを {{ic|/usr/lib/libretro/}} にインストールします。ライブラリを選択して ''retroarch'' を実行する場合:
 
$ retroarch --libretro /usr/lib/libretro/libretro-''core''.so ''path/to/rom''
 
   
  +
By default RetroArch is configured to load the per-user cores that it downloads. Change your [[#Configuration]] if you install them elsewhere.
デフォルトのエミュレーションコアは {{ic|retroarch.cfg}} で定義でき、毎回コアを指定する必要がなくなります。例:
 
   
  +
The command to run a particular core is
{{hc|~/.config/retroarch/retroarch.cfg|2=
 
  +
libretro_path = "/usr/lib/libretro/libretro-''core''.so"}}
 
  +
$ retroarch --libretro ''/path/to/some_core_libretro.so'' ''/path/to/rom''
   
 
== 設定 ==
 
== 設定 ==

2020年9月3日 (木) 22:57時点における版

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

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

インストール

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

ヒント:

使用方法

RetroArch relies on separate libraries, called "cores", for most of its functionality. These can be downloaded per-user within RetroArch itself (via the libretro Buildbot) or you can install them system-wide via Community or AUR.

By default RetroArch is configured to load the per-user cores that it downloads. Change your #Configuration if you install them elsewhere.

The command to run a particular core is

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

設定

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

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

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

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

ヒント: RetroArch は bsnes xml filterscg shaders をロードすることができ、それぞれ retroarch.cfgvideo_bsnes_shadervideo_cg_shader として定義します。
ノート: retroarch-gitAURcg shaders を使うには nvidia-cg-toolkit が必要です。
警告: ALSA を使用する場合、audio_out_rate をシステムのデフォルト出力レート (通常は 48000) に合わせる必要があります。

ヒントとテクニック

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

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

~/.config/retroarch/retroarch.cfg
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 ~/.config/retroarch/retroarch.cfg and set autosave_interval to n.

~/.config/retroarch/retroarch.cfg
autosave_interval = "600"

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

警告: Setting this value too low will cause all sorts of issue, most notably hardware degradation. See [1]

Filters and shaders

RetroArch can load BSNES XML filters and CG shaders. These are set in retroarch.cfg with video_bsnes_shader and video_cg_shader respectively. The shaders can also be obtained and updated directly inside RetroArch using the Online Updater.

ノート: retroarch-gitAUR requires 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 Start. To remove a button from a keybind, highlight the keybind and press Y.

トラブルシューティング

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_updatertrue に設定されていることを確認してください。設定すると 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.cfgvideo_threaded = true と設定することで RetroArch を別のスレッドで実行することができます。

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

Audio issues with ALSA

When using ALSA the audio_out_rate must match the system's default output rate, usually 48000.

Save data is lost whenever RetroArch crashes

See #Enabling SaveRAM Autosave Interval.

参照