StrokeStyleT/StrokeStyleT.cs

   1 using System;
   2 using System.Collections.Generic;
   3 using System.Diagnostics;
   4 using System.IO;
   5 using System.Linq;
   6 using System.Windows.Forms;
   7 using Microsoft.VisualBasic.ApplicationServices;
   8 using FDK;      // for string 拡張
   9
  10 namespace SST
  11 {
  12         class StrokeStyleT : FDK.ApplicationBase
  13         {
  14                 // グローバルリソース (static)
  15                 public static SST.フォルダ フォルダ => ( StrokeStyleT.bs_フォルダ );
  16                 public static FDK.入力.Keyboard キーボード入力 => ( StrokeStyleT.bs_キーボード入力 );
  17                 public static FDK.入力.MidiIn MIDI入力 => ( StrokeStyleT.bs_MIDI入力 );
  18                 public static FDK.メディア.サウンド.WASAPI排他.ExclusiveDevice Wasapiデバイス => ( StrokeStyleT.bs_Wasapiデバイス );
  19                 public static Random 乱数 => ( StrokeStyleT.bs_乱数 );
  20                 public static SST.ユーザ.ユーザ管理 ユーザ管理 => ( StrokeStyleT.bs_ユーザ管理 );
  21                 public static SST.曲.曲ツリー管理 曲ツリー管理 => ( StrokeStyleT.bs_曲ツリー管理 );
  22                 public static SSTFormat.スコア 演奏スコア { get; set; } = null;
  23                 public static SST.設定.Config Config => ( StrokeStyleT.bs_Config );
  24
  25                 /// <summary>
  26                 /// ビュアーモード用のプロパティ。(static)
  27                 /// 各プロパティの値は、起動時のコマンドライン引数を解析して得られる。
  28                 /// </summary>
  29                 public class ViewerMode
  30                 {
  31                         public bool ビュアーモードである => ( this.曲ファイルパス.Nullでも空でもない() );
  32                         public string 曲ファイルパス { get; set; } = null;
  33                         public int 演奏開始小節番号 { get; set; } = 0;
  34                         public bool 演奏停止 { get; set; } = false;
  35                         public bool ドラム音を使う { get; set; } = false;
  36                 }
  37                 public static ViewerMode ビュアーモード => ( StrokeStyleT.bs_ビュアーモード );
  38
  39                 public static void すべての入力デバイスをポーリングする()
  40                 {
  41                         // hack: 追加の入力デバイスができたら、ここにポーリングコードを追加すること。
  42                         StrokeStyleT.キーボード入力?.ポーリングする();
  43                         StrokeStyleT.MIDI入力?.ポーリングする();
  44                 }
  45
  46                 // get only static property の初期化。
  47                 static StrokeStyleT()
  48                 {
  49                         // フォルダ変数を真っ先に登録する。（ほかのメンバのコンストラクタでフォルダ変数を利用できるようにするため。）
  50                         StrokeStyleT.bs_フォルダ = new SST.フォルダ();
  51                         SST.フォルダ.フォルダ変数を追加する( "Static", StrokeStyleT.フォルダ.StaticFolder );
  52                         SST.フォルダ.フォルダ変数を追加する( "AppData", StrokeStyleT.フォルダ.AppDataFolder );
  53                         SST.フォルダ.フォルダ変数を追加する( "User", null );
  54
  55                         // その他の static の生成。
  56                         StrokeStyleT.bs_ユーザ管理 = new ユーザ.ユーザ管理();
  57                         StrokeStyleT.bs_曲ツリー管理 = new 曲.曲ツリー管理();
  58                 }
  59
  60                 protected override void 初期化する()
  61                 {
  62                         FDK.Log.BeginInfo( $"{FDK.Utilities.現在のメソッド名}" );
  63
  64                         lock( this.スレッド間同期 )
  65                         {
  66                                 Debug.Assert( null == this.デバイスリソース, "デバイスリソースの作成前であること。" );
  67
  68                                 StrokeStyleT.bs_ビュアーモード = this.コマンドライン引数を解析する(
  69                                         Environment.GetCommandLineArgs().Skip( 1 ) );   // 最初の要素は exe ファイル名なのでスキップする。
  70
  71                                 this.MainForm.Text = $"StrokeStyle<T> {System.Reflection.Assembly.GetExecutingAssembly().GetName().Version.ToString()}";
  72                                 this.設計画面サイズdpx = new SharpDX.Size2F( 1920, 1080 );     // 設計画面サイズdpx（固定）
  73
  74                                 #region " コンフィグ を初期化する。"
  75                                 //----------------
  76                                 FDK.Log.Info( "コンフィグを初期化します。" );
  77                                 StrokeStyleT.bs_Config = new 設定.Config();
  78                                 StrokeStyleT.bs_Config.ConfigXmlを読み込む();
  79                                 //----------------
  80                                 #endregion
  81                                 #region " コンフィグで指定されたウィンドウサイズに変更する。"
  82                                 //----------------
  83                                 this.MainForm.ClientSize = new System.Drawing.Size( StrokeStyleT.Config.物理画面サイズpx.Width, StrokeStyleT.Config.物理画面サイズpx.Height );
  84                                 //----------------
  85                                 #endregion
  86
  87                                 #region " System.Stopwatch が高解像度タイマを使わないならエラー。"
  88                                 //-----------------
  89                                 if( false == System.Diagnostics.Stopwatch.IsHighResolution )
  90                                         throw new SSTException( "このシステムは、高解像度タイマをサポートしていません。" );
  91                                 //-----------------
  92                                 #endregion
  93                                 #region " MediaFoundation を起動する。"
  94                                 //-----------------
  95                                 SharpDX.MediaFoundation.MediaManager.Startup();
  96                                 //-----------------
  97                                 #endregion
  98                                 #region " Sleep 精度を上げる。"
  99                                 //-----------------
 100                                 StrokeStyleT.timeBeginPeriod( 1 );
 101                                 //-----------------
 102                                 #endregion
 103
 104                                 #region " ステージのActionを接続する。"
 105                                 //----------------
 106                                 this.結果ステージ.演奏ステージインスタンスを取得する = () => ( this.演奏ステージ );
 107                                 this.結果ステージ.BGMを終了する = () => { this.演奏ステージ.BGMを解放する(); };
 108                                 //----------------
 109                                 #endregion
 110                                 #region " ユーザを初期化する。"
 111                                 //-----------------
 112                                 FDK.Log.Info( "ユーザ情報を初期化します。" );
 113                                 StrokeStyleT.ユーザ管理.UsersXmlを読み込む();
 114
 115                                 // ユーザ別の初期化。
 116                                 foreach( var ユーザ in StrokeStyleT.ユーザ管理.ユーザリスト )
 117                                         ユーザ.SourcesXmlを読み込む();
 118                                 //-----------------
 119                                 #endregion
 120                                 #region " WASAPI デバイスを初期化する。"
 121                                 //----------------
 122                                 StrokeStyleT.bs_Wasapiデバイス = new FDK.メディア.サウンド.WASAPI排他.ExclusiveDevice();
 123                                 StrokeStyleT.bs_Wasapiデバイス.初期化する( 15.0f );
 124                                 //----------------
 125                                 #endregion
 126                                 #region " キーボード入力 を初期化する。"
 127                                 //-----------------
 128                                 FDK.Log.Info( "キーボード入力デバイスを初期化します。" );
 129                                 StrokeStyleT.bs_キーボード入力 = new FDK.入力.Keyboard( this.MainForm.Handle );
 130                                 //-----------------
 131                                 #endregion
 132                                 #region " MIDI入力 を初期化する。"
 133                                 //-----------------
 134                                 FDK.Log.Info( "MIDI入力デバイスを初期化します。" );
 135                                 StrokeStyleT.bs_MIDI入力 = new FDK.入力.MidiIn();
 136                                 //-----------------
 137                                 #endregion
 138
 139                                 this.現在のステージ = this.最初のダミーステージ;
 140
 141                                 //#warning 全画面モード切替えを KeyDown で仮実装。
 142                                 this.MainForm.KeyDown += ( target, arg ) => {
 143                                         // Alt+Enter → 画面モードの切り替え
 144                                         //                              if( ( arg.KeyCode == System.Windows.Forms.Keys.Return ) && ( arg.Modifiers == Keys.Alt ) )
 145                                         //                                      this.全画面モードとウィンドウモードを切り替える();
 146                                 };
 147                         }
 148
 149                         FDK.Log.EndInfo( $"{FDK.Utilities.現在のメソッド名}" );
 150                 }
 151                 protected override void 終了する()
 152                 {
 153                         FDK.Log.BeginInfo( $"{FDK.Utilities.現在のメソッド名}" );
 154
 155                         lock( this.スレッド間同期 )
 156                         {
 157                                 Debug.Assert( null != this.デバイスリソース, "デバイスリソースが解放される前であること。" );
 158
 159                                 #region " ステージを終了し、解放する。"
 160                                 //----------------
 161                                 if( ( null != this.現在のステージ ) && ( this.現在のステージ.活性化している ) )            // 念のため
 162                                         this.現在のステージ.非活性化する( this.デバイスリソース );
 163
 164                                 this.最初のダミーステージ = null;
 165                                 this.起動ステージ = null;
 166                                 this.タイトルステージ = null;
 167                                 this.ログインステージ = null;
 168                                 this.選曲ステージ = null;
 169                                 this.曲読込ステージ = null;
 170                                 this.演奏ステージ = null;
 171                                 this.結果ステージ = null;
 172                                 this.ビュアーステージ = null;
 173                                 //----------------
 174                                 #endregion
 175                                 #region " MIDI入力 を解放する。"
 176                                 //-----------------
 177                                 FDK.Log.Info( "MIDI入力デバイスを解放します。" );
 178                                 FDK.Utilities.解放する( ref StrokeStyleT.bs_MIDI入力 );
 179                                 //-----------------
 180                                 #endregion
 181                                 #region " キーボード入力 を解放する。"
 182                                 //-----------------
 183                                 FDK.Log.Info( "キーボード入力デバイスを解放します。" );
 184                                 FDK.Utilities.解放する( ref StrokeStyleT.bs_キーボード入力 );
 185                                 //-----------------
 186                                 #endregion
 187                                 #region " WASAPIデバイスを解放する。"
 188                                 //----------------
 189                                 FDK.Log.Info( "WASAPIデバイスを解放します。" );
 190                                 FDK.Utilities.解放する( ref StrokeStyleT.bs_Wasapiデバイス );
 191                                 //----------------
 192                                 #endregion
 193                                 #region " コンフィグを解放する。"
 194                                 //----------------
 195                                 FDK.Log.Info( "コンフィグを解放します。" );
 196                                 StrokeStyleT.bs_Config = null;
 197                                 //----------------
 198                                 #endregion
 199                                 #region " MediaFoundation を終了する。"
 200                                 //-----------------
 201                                 SharpDX.MediaFoundation.MediaManager.Shutdown();
 202                                 //-----------------
 203                                 #endregion
 204                         }
 205
 206                         FDK.Log.EndInfo( $"{FDK.Utilities.現在のメソッド名}" );
 207                 }
 208                 protected override void シーンを描画する()
 209                 {
 210                         // このメソッドは、GUIスレッドではなく進行描画スレッドから呼び出されるので注意。（FDK.ApplicationBase.進行描画スレッド処理() を参照。）
 211
 212                         // 現在のステージを進行描画する。
 213                         lock( this.スレッド間同期 )
 214                         {
 215                                 #region " 描画の準備を行う。"
 216                                 //----------------
 217                                 var d3dDevice = (SharpDX.Direct3D11.Device) null;
 218                                 using( var d3dLock = new FDK.同期.AutoD3DDeviceLock( this.デバイスリソース.DXGIDeviceManager, out d3dDevice ) )
 219                                 using( d3dDevice )
 220                                 using( var d3dContext = d3dDevice.ImmediateContext )
 221                                 {
 222                                         // 既定のD3Dレンダーターゲットビューを黒でクリアする。
 223                                         d3dContext.ClearRenderTargetView( this.デバイスリソース.D3DRenderTargetView, SharpDX.Color4.Black );
 224
 225                                         // 深度バッファを 1.0f でクリアする。
 226                                         d3dContext.ClearDepthStencilView(
 227                                                 this.デバイスリソース.D3DDepthStencilView,
 228                                                 SharpDX.Direct3D11.DepthStencilClearFlags.Depth,
 229                                                 depth: 1.0f,
 230                                                 stencil: 0 );
 231                                 }
 232                                 //----------------
 233                                 #endregion
 234
 235                                 this.現在のステージ?.進行描画する( this.デバイスリソース );
 236                         }
 237
 238                         // スワップチェーンを表示する。垂直帰線待ちなどで時間がかかるので、この部分はスレッド排他領域の外に配置すること。
 239                         this.デバイスリソース.SwapChain.Present(
 240                                 ( StrokeStyleT.Config.垂直帰線待ちを行う ) ? 1 : 0,
 241                                 SharpDX.DXGI.PresentFlags.None );
 242
 243                         // ステージの状態をチェックし、必要あれば遷移またはアプリを終了する。
 244                         bool アプリを終了せよ = false;
 245                         lock( this.スレッド間同期)
 246                         {
 247                                 if( null != this.現在のステージ )
 248                                 {
 249                                         switch( this.現在のステージ.GetType().Name )
 250                                         {
 251                                                 case nameof( ステージ.ステージ ):
 252                                                         #region " ビュアーモード → ビュアーステージへ。"
 253                                                         //----------------
 254                                                         if( StrokeStyleT.ビュアーモード.ビュアーモードである )
 255                                                         {
 256                                                                 this.ビュアーステージ.活性化する( this.デバイスリソース );
 257                                                                 this.現在のステージ = this.ビュアーステージ;
 258                                                         }
 259                                                         //----------------
 260                                                         #endregion
 261                                                         #region " 通常モード → 起動ステージへ。"
 262                                                         //----------------
 263                                                         else
 264                                                         {
 265                                                                 this.起動ステージ.活性化する( this.デバイスリソース );
 266                                                                 this.現在のステージ = this.起動ステージ;
 267                                                         }
 268                                                         //----------------
 269                                                         #endregion
 270                                                         break;
 271
 272                                                 case nameof( ステージ.起動.起動ステージ ):
 273                                                         #region " 終了 → タイトルステージへ。"
 274                                                         //---------------
 275                                                         if( this.起動ステージ.現在のフェーズ == ステージ.起動.起動ステージ.フェーズ.終了 )
 276                                                         {
 277                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 278                                                                 this.現在のステージ = this.タイトルステージ;
 279                                                                 this.現在のステージ.活性化する( this.デバイスリソース );
 280                                                         }
 281                                                         //---------------
 282                                                         #endregion
 283                                                         break;
 284
 285                                                 case nameof( ステージ.タイトル.タイトルステージ ):
 286                                                         #region " 確定 → ログインステージへ。"
 287                                                         //---------------
 288                                                         if( this.タイトルステージ.現在のフェーズ == ステージ.タイトル.タイトルステージ.フェーズ.確定 )
 289                                                         {
 290                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 291                                                                 this.現在のステージ = this.ログインステージ;
 292                                                                 this.現在のステージ.活性化する( this.デバイスリソース );
 293                                                         }
 294                                                         //---------------
 295                                                         #endregion
 296                                                         #region " キャンセル → アプリを終了する。"
 297                                                         //---------------
 298                                                         else if( this.タイトルステージ.現在のフェーズ == ステージ.タイトル.タイトルステージ.フェーズ.キャンセル )
 299                                                         {
 300                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 301                                                                 this.現在のステージ = null;
 302                                                                 アプリを終了せよ = true;
 303                                                         }
 304                                                         //---------------
 305                                                         #endregion
 306                                                         break;
 307
 308                                                 case nameof( ステージ.ログイン.ログインステージ ):
 309                                                         #region " 確定 → ログイン処理を行って、選曲ステージへ。"
 310                                                         //---------------
 311                                                         if( this.ログインステージ.現在のフェーズ == ステージ.ログイン.ログインステージ.フェーズ.確定 )
 312                                                         {
 313                                                                 StrokeStyleT.ユーザ管理.ユーザを選択する( this.ログインステージ.ユーザインデックス );
 314                                                                 FDK.Log.Info( $"ユーザが選択されました。[{StrokeStyleT.ユーザ管理.現在選択されているユーザ.名前}]" );
 315                                                                 StrokeStyleT.ユーザ管理.現在選択されているユーザ.曲を検索して曲ツリーを構築する();
 316                                                                 StrokeStyleT.曲ツリー管理.現在の管理対象ツリー = StrokeStyleT.ユーザ管理.現在選択されているユーザ.曲ツリーのルートノード;
 317
 318                                                                 // 選曲ステージへ。
 319                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 320                                                                 this.現在のステージ = this.選曲ステージ;
 321                                                                 this.現在のステージ.活性化する( this.デバイスリソース );
 322                                                         }
 323                                                         //---------------
 324                                                         #endregion
 325                                                         #region " キャンセル → タイトルステージへ。"
 326                                                         //---------------
 327                                                         else if( this.ログインステージ.現在のフェーズ == ステージ.ログイン.ログインステージ.フェーズ.キャンセル )
 328                                                         {
 329                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 330                                                                 this.現在のステージ = this.タイトルステージ;
 331                                                                 this.現在のステージ.活性化する( this.デバイスリソース );
 332                                                         }
 333                                                         //---------------
 334                                                         #endregion
 335                                                         break;
 336
 337                                                 case nameof( ステージ.選曲.選曲ステージ ):
 338                                                         #region " 曲確定 → 曲読込ステージへ。"
 339                                                         //---------------
 340                                                         if( this.選曲ステージ.現在のフェーズ == ステージ.選曲.選曲ステージ.フェーズ.曲確定 )
 341                                                         {
 342                                                                 // 曲ノードが選択されていることを確認。
 343                                                                 Trace.Assert( null != StrokeStyleT.曲ツリー管理.現在選択されているノード, "[バグあり] 選択曲が null です。" );
 344                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 345                                                                 this.現在のステージ = this.曲読込ステージ;
 346                                                                 this.現在のステージ.活性化する( this.デバイスリソース );
 347                                                         }
 348                                                         //---------------
 349                                                         #endregion
 350                                                         #region " キャンセル → アプリを終了する。"
 351                                                         //---------------
 352                                                         else if( this.選曲ステージ.現在のフェーズ == ステージ.選曲.選曲ステージ.フェーズ.キャンセル )
 353                                                         {
 354                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 355                                                                 this.現在のステージ = null;
 356                                                                 アプリを終了せよ = true;
 357                                                         }
 358                                                         //---------------
 359                                                         #endregion
 360                                                         break;
 361
 362                                                 case nameof( ステージ.曲読込.曲読込ステージ ):
 363                                                         #region " 終了 → 演奏ステージへ。"
 364                                                         //--------------------
 365                                                         if( this.曲読込ステージ.現在のフェーズ == ステージ.曲読込.曲読込ステージ.フェーズ.終了 )
 366                                                         {
 367                                                                 // 演奏スコアインスタンスが作成されていることを確認。
 368                                                                 Debug.Assert( null != StrokeStyleT.演奏スコア );
 369
 370                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 371                                                                 this.現在のステージ = this.演奏ステージ;
 372                                                                 this.現在のステージ.活性化する( this.デバイスリソース );
 373                                                         }
 374                                                         //--------------------
 375                                                         #endregion
 376                                                         break;
 377
 378                                                 case nameof( ステージ.演奏.演奏ステージ ):
 379                                                         #region " 演奏終了 → 結果ステージへ。"
 380                                                         //--------------------
 381                                                         if( this.演奏ステージ.現在のフェーズ == ステージ.演奏.演奏ステージ.フェーズ.クリアor失敗 )
 382                                                         {
 383                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 384                                                                 this.現在のステージ = this.結果ステージ;
 385                                                                 this.現在のステージ.活性化する( this.デバイスリソース );
 386                                                         }
 387                                                         //--------------------
 388                                                         #endregion
 389                                                         #region " キャンセル → 選曲ステージへ。"
 390                                                         //--------------------
 391                                                         if( this.演奏ステージ.現在のフェーズ == ステージ.演奏.演奏ステージ.フェーズ.キャンセル )
 392                                                         {
 393 #warning 結果ステージのデバッグのため、演奏キャンセル時も結果ステージへ遷移する。
 394                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 395                                                                 this.現在のステージ = this.結果ステージ;
 396                                                                 this.現在のステージ.活性化する( this.デバイスリソース );
 397                                                                 //this.現在のステージ.非活性化する( this.スレッド排他領域.デバイスリソース );
 398                                                                 //this.現在のステージ = this.選曲ステージ;
 399                                                                 //this.現在のステージ.活性化する( this.スレッド排他領域.デバイスリソース );
 400                                                         }
 401                                                         //--------------------
 402                                                         #endregion
 403                                                         break;
 404
 405                                                 case nameof( ステージ.結果.結果ステージ ):
 406                                                         #region " 終了 → 選曲ステージへ。"
 407                                                         //--------------------
 408                                                         if( this.結果ステージ.現在のフェーズ == ステージ.結果.結果ステージ.フェーズ.終了 )
 409                                                         {
 410                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 411                                                                 this.現在のステージ = this.選曲ステージ;
 412                                                                 this.現在のステージ.活性化する( this.デバイスリソース );
 413                                                         }
 414                                                         //--------------------
 415                                                         #endregion
 416                                                         break;
 417
 418                                                 case nameof( ステージ.演奏.ビュアーステージ ):
 419                                                         #region " 終了 → アプリを終了する。"
 420                                                         //---------------
 421                                                         if( this.ビュアーステージ.現在のフェーズ == ステージ.演奏.ビュアーステージ.フェーズ.終了 )
 422                                                         {
 423                                                                 this.現在のステージ.非活性化する( this.デバイスリソース );
 424                                                                 this.現在のステージ = null;
 425                                                                 アプリを終了せよ = true;
 426                                                         }
 427                                                         //---------------
 428                                                         #endregion
 429                                                         break;
 430                                         }
 431                                 }
 432                         }
 433
 434                         if( アプリを終了せよ )
 435                         {
 436                                 // GUIスレッド上で、ウィンドウを閉じる。
 437                                 this.MainForm.BeginInvoke( new Action( () => { this.MainForm.Close(); } ) );
 438                         }
 439                 }
 440                 protected override void デバイス依存リソースを解放する()
 441                 {
 442                         FDK.Log.BeginInfo( $"{FDK.Utilities.現在のメソッド名}" );
 443
 444                         lock( this.スレッド間同期 )
 445                         {
 446                                 Debug.Assert( null != this.デバイスリソース );  // 解放前であること。
 447                                 this.現在のステージ?.デバイス依存リソースを解放する( this.デバイスリソース );
 448                         }
 449
 450                         FDK.Log.EndInfo( $"{FDK.Utilities.現在のメソッド名}" );
 451                 }
 452                 protected override void デバイス依存リソースを再構築する()
 453                 {
 454                         FDK.Log.BeginInfo( $"{FDK.Utilities.現在のメソッド名}" );
 455
 456                         lock( this.スレッド間同期 )
 457                         {
 458                                 Debug.Assert( null != this.デバイスリソース );  // 再生成済みであること。
 459                                 this.現在のステージ?.デバイス依存リソースを作成する( this.デバイスリソース );
 460                         }
 461
 462                         FDK.Log.EndInfo( $"{FDK.Utilities.現在のメソッド名}" );
 463                 }
 464                 /// <summary>
 465                 /// アプリが二重起動されたときに発生するイベント。
 466                 /// </summary>
 467                 /// <remarks>
 468                 /// 後続のインスタンスは起動せず、既存のインスタンスに対してこのイベントが発生する。
 469                 /// eventArg.CommandLine で、後続のインスタンスのコマンドライン引数を確認することができる。
 470                 /// </remarks>
 471                 protected override void OnStartupNextInstance( StartupNextInstanceEventArgs eventArgs )
 472                 {
 473                         FDK.Log.BeginInfo( $"{FDK.Utilities.現在のメソッド名}" );
 474
 475                         lock( this.スレッド間同期 )
 476                         {
 477                                 if( StrokeStyleT.ビュアーモード.ビュアーモードである )
 478                                 {
 479                                         this.新しいビュアーモード = this.コマンドライン引数を解析する( eventArgs.CommandLine );
 480                                         this.ビュアーモードアクションを実行せよ.状態 = FDK.同期.TriStateEvent.状態種別.ON;
 481                                 }
 482                                 else
 483                                 {
 484                                         FDK.Log.ERROR( "現在、ビュアーモードではありません。" );
 485                                 }
 486                         }
 487
 488                         FDK.Log.EndInfo( $"{FDK.Utilities.現在のメソッド名}" );
 489                 }
 490
 491                 // 各ステージの、唯一のインスタンス。最終的に null を代入するので、readonlyにはしない。
 492                 protected SST.ステージ.ステージ 最初のダミーステージ = new ステージ.ステージ();
 493                 protected SST.ステージ.起動.起動ステージ 起動ステージ = new ステージ.起動.起動ステージ();
 494                 protected SST.ステージ.タイトル.タイトルステージ タイトルステージ = new ステージ.タイトル.タイトルステージ();
 495                 protected SST.ステージ.ログイン.ログインステージ ログインステージ = new ステージ.ログイン.ログインステージ();
 496                 protected SST.ステージ.選曲.選曲ステージ 選曲ステージ = new ステージ.選曲.選曲ステージ();
 497                 protected SST.ステージ.曲読込.曲読込ステージ 曲読込ステージ = new ステージ.曲読込.曲読込ステージ();
 498                 protected SST.ステージ.演奏.演奏ステージ 演奏ステージ = new ステージ.演奏.演奏ステージ();
 499                 protected SST.ステージ.結果.結果ステージ 結果ステージ = new ステージ.結果.結果ステージ();
 500                 protected SST.ステージ.演奏.ビュアーステージ ビュアーステージ = new ステージ.演奏.ビュアーステージ();
 501
 502                 private SST.ステージ.ステージ 現在のステージ = null;
 503
 504                 // ビュアーモード連携。
 505                 private ViewerMode 新しいビュアーモード = null;
 506                 private FDK.同期.TriStateEvent ビュアーモードアクションを実行せよ = new FDK.同期.TriStateEvent( FDK.同期.TriStateEvent.状態種別.OFF );
 507
 508                 #region " バックストア。"
 509                 //----------------
 510                 private static SST.フォルダ bs_フォルダ = null;
 511                 private static FDK.入力.Keyboard bs_キーボード入力 = null;
 512                 private static FDK.入力.MidiIn bs_MIDI入力 = null;
 513                 private static FDK.メディア.サウンド.WASAPI排他.ExclusiveDevice bs_Wasapiデバイス = null;
 514                 private static readonly Random bs_乱数 = new Random( DateTime.Now.Millisecond );
 515                 private static SST.ユーザ.ユーザ管理 bs_ユーザ管理 = null;
 516                 private static SST.曲.曲ツリー管理 bs_曲ツリー管理 = null;
 517                 private static SST.設定.Config bs_Config = null;
 518                 private static SST.StrokeStyleT.ViewerMode bs_ビュアーモード = new ViewerMode();
 519                 //----------------
 520                 #endregion
 521
 522                 /// <summary>
 523                 /// コマンドライン引数を解析して、ビュアーモードの設定があればそれを返す。
 524                 /// </summary>
 525                 /// <param name="args">コマンドライン引数の列挙。exeファイル名は含まない。</param>
 526                 /// <return>引数を反映したビュアーモード変数。</return>
 527                 private ViewerMode コマンドライン引数を解析する( IEnumerable<string> args )
 528                 {
 529                         FDK.Log.BeginInfo( $"{FDK.Utilities.現在のメソッド名}" );
 530
 531                         var vmode = new ViewerMode() {
 532                                 曲ファイルパス = null,
 533                                 演奏停止 = false,
 534                                 演奏開始小節番号 = 0,
 535                                 ドラム音を使う = false,
 536                         };
 537
 538                         try
 539                         {
 540                                 if( 0 == args.Count() )
 541                                 {
 542                                         FDK.Log.Info( "引数は指定されていません。" );      // ビュアーモードではない。
 543                                         return vmode;
 544                                 }
 545
 546                                 try
 547                                 {
 548                                         // オプションを定義する。
 549                                         var optionSet = new Mono.Options.OptionSet() {
 550                                                 "Usage: StrokeStyleT [File] [OPTIONS]+",
 551                                                 "  File\t\t\t\tビュアーモードで表示する曲ファイル名です。",
 552                                                 { "p=|part=", "ビュアーモードで起動し、指定された小節番号から演奏を開始します。小節番号を省略すると、先頭から再生します。", (int v) => { vmode.演奏開始小節番号 = v; }  },
 553                                                 { "s|stop", "ビュアーモードで演奏中であれば、演奏を停止します。", v => { vmode.演奏停止 = ( v != null ); } },
 554                                                 { "d|drums", "ビュアーモードで、チップヒット時に内蔵のドラム音を再生します。", v => { vmode.ドラム音を使う = ( v != null ); } },
 555                                         };
 556
 557                                         // オプションを解析する。
 558                                         List<string> ファイルパスs = optionSet.Parse( args );
 559
 560                                         // 解析結果。
 561                                         if( vmode.演奏停止 )
 562                                         {
 563                                                 // (A) 演奏停止（曲ファイルパスは省略可。）
 564                                                 FDK.Log.Info( "演奏停止" );
 565                                         }
 566                                         else
 567                                         {
 568                                                 // (B) 演奏開始（曲ファイルパスは必須。）
 569                                                 if( 0 < ファイルパスs.Count )
 570                                                 {
 571                                                         if( File.Exists( ファイルパスs[ 0 ] ) )
 572                                                         {
 573                                                                 vmode.曲ファイルパス = ファイルパスs[ 0 ];
 574                                                         }
 575                                                         else
 576                                                         {
 577                                                                 vmode.曲ファイルパス = null;    // ファイルが存在しなかったら null 。
 578                                                                 throw new Mono.Options.OptionException( $"ファイルが存在しません。[{FDK.フォルダ.絶対パスをフォルダ変数付き絶対パスに変換して返す( ファイルパスs[ 0 ] )}]", "File" );
 579                                                         }
 580                                                 }
 581                                                 else
 582                                                 {
 583                                                         throw new Mono.Options.OptionException( "ファイルの指定がありません。", "File" );
 584                                                 }
 585
 586                                                 FDK.Log.Info( $"曲ファイルパス: {vmode.曲ファイルパス}" );
 587                                                 FDK.Log.Info( $"開始小節番号: {vmode.演奏開始小節番号}" );
 588                                                 FDK.Log.Info( $"ドラム音: {vmode.ドラム音を使う}" );
 589                                         }
 590                                 }
 591                                 catch( Mono.Options.OptionException e )
 592                                 {
 593                                         FDK.Log.ERROR( $"{e.Message}" );
 594                                 }
 595
 596                                 return vmode;
 597                         }
 598                         finally
 599                         {
 600                                 FDK.Log.EndInfo( $"{FDK.Utilities.現在のメソッド名}" );
 601                         }
 602                 }
 603
 604                 #region " Win32 API "
 605                 //-----------------
 606                 [ System.Runtime.InteropServices.DllImport( "winmm.dll", EntryPoint = "timeBeginPeriod" )]
 607                 private static extern uint timeBeginPeriod( uint uMilliseconds );
 608
 609                 [System.Runtime.InteropServices.DllImport( "winmm.dll", EntryPoint = "timeEndPeriod" )]
 610                 private static extern uint timeEndPeriod( uint uMilliseconds );
 611                 //-----------------
 612                 #endregion
 613         }
 614 }