dolphin - Dolphinは、Windows、Linux、macOS、および最近のAndroidデバイスでGameCubeおよびWiiゲームを実行するためのエミュレーターです。

(Dolphin is a GameCube / Wii emulator, allowing you to play games for these two platforms on PC with improvements.)

Created at: 2013-07-22 17:07:57
Language: C++
License: NOASSERTION

イルカ-ゲームキューブとWiiエミュレーター

ホームページ| プロジェクトサイト| Buildbot | フォーラム| Wiki | 課題追跡システム| コーディングスタイル| Transifexページ

Dolphinは、Windows、Linux、macOS、および最近のAndroidデバイスでGameCubeおよびWiiゲームを実行するためのエミュレーターです。これは、GNU General Public Licenseバージョン2以降(GPLv2 +)の条件に基づいてライセンスされています。

Dolphinを使用する前にFAQをお読みください。

システム要求

デスクトップ

  • OS
    • Windows(7 SP1以降)。
    • Linux。
    • macOS(10.13 High Sierra以降)。
    • Linux以外のUnixライクなシステムは公式にはサポートされていませんが、動作する可能性があります。
  • プロセッサー
    • SSE2をサポートするCPU。
    • 最新のCPU(3 GHzおよびデュアルコア、2008年以前)を強くお勧めします。
  • グラフィックス
    • 適度に最新のグラフィックカード(Direct3D 11.1 / OpenGL 3.3)。
    • Direct3D 11.1 /OpenGL4.4をサポートするグラフィックカードをお勧めします。

アンドロイド

  • OS
    • Android(5.0 Lollipop以降)。
  • プロセッサー
    • 64ビットアプリケーション(ARMv8またはx86-64)をサポートするプロセッサ。
  • グラフィックス
    • OpenGLES3.0以降をサポートするグラフィックプロセッサ。パフォーマンスはドライバーの品質によって大きく異なります。
    • 最高のパフォーマンスを得るには、標準のデスクトップOpenGL機能をサポートするグラフィックプロセッサをお勧めします。

Dolphinは、上記の要件を満たすデバイスにのみインストールできます。サポートされていないデバイスにインストールしようとすると失敗し、エラーメッセージが表示されます。

Windows用の構築

ソリューションファイル

Source/dolphin-emu.sln
を使用して、WindowsでDolphinをビルドします。Visual Studio202217.0以降は厳しい要件です。他のコンパイラはWindowsでDolphinをビルドできる可能性がありますが、テストされていないため、使用することはお勧めしません。ビルド時にGitとWindows11SDKをインストールする必要があります。

ビルドする前に、必ずサブモジュールをプルしてください。

git submodule update --init

「リリース」ソリューションの構成には、最高のユーザーエクスペリエンスを実現するためのパフォーマンスの最適化が含まれていますが、Dolphinのデバッグは複雑になります。「デバッグ」ソリューションの構成は、大幅に遅く、冗長で、許容度が低くなりますが、Dolphinのデバッグが容易になります。

Installer.nsi
インストーラーは、インストーラーディレクトリのスクリプトを使用して作成できます。これには、Nullsoft Scriptable Install System(NSIS)をインストールする必要があります。Binaryディレクトリには動作するDolphinディストリビューションが含まれているため、Dolphinを実行するためにインストーラーを作成する必要はありません。

LinuxおよびmacOS向けのビルド

Dolphinは、Windows以外のシステムにCMakeを必要とします。多くのライブラリはDolphinにバンドルされており、システムにインストールされていない場合に使用されます。バンドルされたライブラリが使用されているかどうか、または不足しているパッケージを自分でインストールする必要があるかどうかは、CMakeから通知されます。

ビルドする前に、必ずサブモジュールをプルしてください。

git submodule update --init

macOSビルド手順:

単一のアーキテクチャをサポートするバイナリは、次の手順を使用して構築できます。

  1. mkdir build
  2. cd build
  3. cmake ..
  4. make

アプリケーションバンドルはで作成され

./Binaries
ます。

次の手順を使用して、同じアプリケーションバンドルでx64とARMの両方をサポートするユニバーサルバイナリを構築するためのスクリプトも提供されています。

  1. mkdir build
  2. cd build
  3. python ../BuildMacOSUniversalBinary.py
  4. ユニバーサルバイナリは
    universal
    フォルダで利用可能になります

これを行うには、x64とARM(または同等のユニバーサルライブラリ)の両方のライブラリ依存関係をインストールする必要があり、関連するライブラリの場所を指すために追加の引数を指定する必要があるため、より複雑です。詳細については、BuildMacOSUniversalBinary.py--helpを実行してください。

Linuxグローバルビルドステップ:

システムにインストールします。

  1. mkdir build
  2. cd build
  3. cmake ..
  4. make
  5. sudo make install

Linuxローカルビルド手順:

ルートアクセスが不要なため、開発に役立ちます。

  1. mkdir Build
  2. cd Build
  3. cmake .. -DLINUX_LOCAL_DEV=true
  4. make
  5. ln -s ../../Data/Sys Binaries/

Linuxポータブルビルド手順:

外部ストレージに保存して、さまざまなLinuxシステムで使用できます。または、テスト/開発/TAS用に複数の異なるイルカのセットアップを行う場合に便利です。

  1. mkdir Build
  2. cd Build
  3. cmake .. -DLINUX_LOCAL_DEV=true
  4. make
  5. cp -r ../Data/Sys/ Binaries/
  6. touch Binaries/portable.txt

Android向けの構築

これらの手順は、Android開発に精通していることを前提としています。Android開発環境がセットアップされていない場合は、AndroidSetup.mdを参照してください。

ビルドする前に、必ずサブモジュールをプルしてください。

git submodule update --init

Android Studioを使用している場合は、にあるGradleプロジェクトをインポートし

./Source/Android
ます。

Androidアプリは、Gradleと呼ばれるビルドシステムを使用してコンパイルされます。ただし、DolphinのネイティブコンポーネントはCMakeを使用してコンパイルされます。Gradleスクリプトは、Javaコードのビルド中にCMakeビルドを自動的に実行しようとします。

アンインストール

DolphinがNSISインストーラーとともにインストールされている場合、他のWindowsアプリケーションと同じようにDolphinをアンインストールできます。

Linuxユーザーは

cat install_manifest.txt | xargs -d '\n' rm
、ビルドディレクトリからrootとして実行して、システムからDolphinをアンインストールできます。

macOSユーザーは、Dolphin.appを削除するだけでアンインストールできます。

さらに、Dolphinを再インストールする予定がない場合は、グローバルユーザーディレクトリ(保存場所については以下を参照)を削除することをお勧めします。

コマンドラインの使用法

Usage: Dolphin [-h] [-d] [-l] [-e <str>] [-b] [-v <str>] [-a <str>]

  • -h、-helpこのヘルプメッセージを表示する
  • -d、-debuggerデバッガペインと追加の[表示]メニューオプションを表示します
  • -l、-loggerロガーを開きます
  • -e、--exec =指定されたファイル(DOL、ELF、WAD、GCM、ISO)をロードします
  • -b、-batchエミュレータでDolphinを終了します
  • -v、-video_backend=ビデオバックエンドを指定します
  • -a、-audio_emulation =低レベル(LLE)または高レベル(HLE)オーディオ

使用可能なDSPエミュレーションエンジンは、HLE(高レベルエミュレーション)とLLE(低レベルエミュレーション)です。HLEは高速ですが精度が低くなりますが、LLEは低速ですが、ほぼ完全になります。LLEには2つのサブモード(インタープリターとリコンパイラー)がありますが、コマンドラインから選択できないことに注意してください。

使用可能なビデオバックエンドは、「D3D」と「D3D12」(Windowsでのみ使用可能)、「OGL」、および「Vulkan」です。また、何もレンダリングしない「Null」と、CPUをレンダリングに使用し、デバッグのみを目的とした「SoftwareRenderer」もあります。

Sysファイル

  • wiitdb.txt
    : GameTDBのWiiタイトルデータベース
  • totaldb.dsy
    :シンボルのデータベース(開発者のみ)
  • GC/font_western.bin
    :フォントダンプ
  • GC/font_japanese.bin
    :フォントダンプ
  • GC/dsp_coef.bin
    :DSPダンプ
  • GC/dsp_rom.bin
    :DSPダンプ
  • Wii/clientca.pem
    :Wiiネットワーク証明書
  • Wii/clientcakey.pem
    :Wiiネットワーク証明書キー
  • Wii/rootca.pem
    :Wiiネットワーク証明書発行者/ CA

Dolphinに含まれているDSPダンプはゼロから作成されており、著作権で保護された素材は含まれていません。ほとんどの目的で機能するはずですが、一部のゲームでは、ダンプをチェックサムすることでコピー防止機能を実装しています。これらの問題を修正する場合は、コンソールからDSPファイルをダンプし、デフォルトのダンプを置き換える必要があります。

Wiiネットワーク証明書はWiiIOSから抽出する必要があります。そのためのガイドはここにあります。

フォルダ構造

これらのフォルダは読み取り専用でインストールされているため、変更しないでください。

  • GameSettings
    :ゲームごとのデフォルト設定データベース
  • GC
    :DSPおよびフォントダンプ
  • Shaders
    :後処理シェーダー
  • Themes
    :GUIのアイコンテーマ
  • Resources
    :テーマにとらわれないアイコン
  • Wii
    :デフォルトのWiiNANDコンテンツ

パッケージングとudev

Dataフォルダーには、公式のGameCubeコントローラーアダプターとMayflashDolphinBarのudevルールファイルが含まれています。パッケージメンテナは、Dolphinのパッケージでそのファイルを使用できます。LinuxでDolphinをコンパイルするユーザーは、ファイルをudevルールフォルダーにコピーすることもできます。

ユーザーフォルダの構造

キャッシュの目的で、またはユーザーがコンテンツを編集できるようにするために、ユーザーが書き込み可能なディレクトリがいくつか作成されます。macOSとLinuxでは、これらのフォルダはそれぞれとに保存されますが

~/Library/Application Support/Dolphin/
~/.dolphin-emu
環境変数を設定することで上書きできます
DOLPHIN_EMU_USERPATH
。Windowsでは、ユーザーディレクトリは
My Documents
デフォルトでフォルダに保存されますが、この動作を上書きするにはさまざまな方法があります。

  • Dolphin実行可能ファイルの横にあるというファイルを作成すると
    portable.txt
    、Dolphin実行可能ファイルの横にある「User」というローカルディレクトリにユーザーディレクトリが保存されます。
  • レジストリ文字列値
    LocalUserConfig
    がに存在し
    HKEY_CURRENT_USER/Software/Dolphin Emulator
    、値が1の場合、Dolphinは常にポータブルモードで起動します。
  • レジストリ文字列の値
    UserConfigPath
    がに存在する 場合
    HKEY_CURRENT_USER/Software/Dolphin Emulator
    、ユーザーフォルダはその文字列で指定されたディレクトリに保存されます。他の2つの方法は、この設定よりも優先されます。

ユーザーフォルダのリスト:

  • Cache
    :ISOリストをキャッシュするために使用されます
  • Config
    :構成ファイル
  • Dump
    :イルカから捨てられたもの
  • GameConfig
    :ゲームごとに適用される追加設定
  • GC
    :メモリカードとシステムBIOS
  • Load
    :カスタムテクスチャ
  • Logs
    :有効になっている場合はログ
  • ScreenShots
    :イルカ経由で撮影したスクリーンショット
  • StateSaves
    :状態を保存
  • Wii
    :WiiNANDコンテンツ

カスタムテクスチャ

カスタムテクスチャは、のユーザーディレクトリに配置する必要があります

Load/Textures/[GameID]/
。ISOリストでゲームを右クリックして[ISOプロパティ]を選択すると、ゲームIDを見つけることができます。