翻訳(Translate)

起動オプション一覧

ssp.exeには以下のオプション(スイッチ)をつけて起動することができます。

起動オプションとは?

windowsのソフトウェアの起動時に、設定を切り替えて実行するための仕組みです。
詳しい事は実行時オプション、コマンドラインオプション、起動オプションなどの言葉を調べてみてください。

利用方法

方法はいろいろあります。
例えば「コマンドプロンプト」や「ファイル名を指定して実行」からも使用できます。
ここでは、オプション専用のショートカットを作る方法を書いておきます。

  1. ssp.exeのショートカットを作成します。
    例:ssp.exeを右クリック→ショートカットの作成
  2. 作成したショートカットのプロパティを開きます。
    例:ショートカットを右クリック→プロパティ
  3. プロパティの「リンク先」欄にssp.exeのパスがあるのを確認したら、その全体を「""」で囲います。
  4. 囲ったパスに続けて半角スペースを一つ置き、その後ろに下記の起動オプションを記入します。
    例:"C:/User/Document/略/SSP/ssp.exe" --random
  5. そのままOKボタンを押してプロパティを閉じ、ついでにショートカットに解りやすい名前をつけましょう。
    例:SSP-ランダム起動
  6. そのショートカットを実行すれば、普通にssp.exeを起動した場合とは異なり、オプション設定が反映された状態で起動できます。

オプション一覧

--option オプションはカンマ区切りで複数指定できます。

各オプションは --オプション名 形式を推奨します。後方互換のため /x / -x 形式のショートオプションも引き続き使用できます。

スイッチ 機能
--option nobootcheck
(旧: /o nobootcheck)
異常終了チェックを無効にする
--option layered
(旧: /o layered)
半透明ウインドウ有効
--option region
(旧: /o region)
半透明ウインドウ無効(リージョンモード)
--option bootunlock
(旧: /o bootunlock)
二重起動チェックをスキップ
--option standalone
(旧: /o standalone)
SSP.exeがすでに立ち上がっていた時に、起動中のSSP.exeに対してインストールやゴースト起動などの処理を委譲する仕組みを無効化し、必ず自身でゴーストを起動したりインストールを行ったりする。
--option bootunlock,standalone のように二重起動チェックスキップと合わせて指定することで、完全に警告なしでSSP.exeを複数起動できる。
--option kiosk
(旧: /o kiosk)
KIOSKモードを有効にする。以下の通りの挙動となる。 [2.6.54~]
--option bootunlock,standaloneが有効になる
必ずalignmenttodesktopがfreeになる
マウス・キーボード入力を受けつけない
二重起動チェックに一切干渉しない
通知領域アイコン・タスクバーアイコンを表示しない
ゴーストシェルのSSP側で管理している設定を保存しない
起動中を示すウインドウを表示しない
エラー通知しない
--option dontloadmodule
(旧: /o dontloadmodule)
SHIORI/MAKOTO/PLUGIN/HEADLINE/CALENDAR系を読まない
--option dpiaware
(旧: /o dpiaware)
DPI Awareness ModeをPer-Monitor V2にして起動する
--option callghost
(旧: /o callghost)
--install と同時に使うと、インストール完了後にゴーストが自動で呼び出される。
--option deletesource
(旧: /o deletesource)
--install と同時に使うと、NARのインストールに成功した時にNARを削除する。
--fmo-name FMO名
(旧: /f FMO名)
書き込むFMO名を強制的に指定したものに変更する。
--random
(旧: /r)
設定にかかわらずゴーストをランダム起動
--ghost フォルダ名/ゴースト
(旧: /g フォルダ名/ゴースト名)
指定したゴーストを起動する。空白区切りで複数起動する。SSP起動時に指定された場合は、指定されたゴーストのうち最初のものを1組目のゴーストとして起動する。
--help
(旧: /?)
起動オプションのヘルプページをブラウザで開く
--help ファイル名
(旧: /? ファイル名)
指定ファイル名のヘルプページをブラウザで開く
--ukagaka-link x-ukagaka-link:URL
(旧: /m x-ukagaka-link:URL)
x-ukagaka-link:URLを開いた時と同じ動きをする。SSP起動時に指定された場合は、1組目のゴースト起動まで待機してから実行される。
--install NARファイル名
(旧: /i NARファイル名)
NARをインストールする。起動中のSSPがある場合はインストール処理を起動中のほうに任せ、ない場合は自身でインストール処理を行った後起動を続行する。
空白区切りで複数指定すると、複数個のNARを順番にインストールする。
任せる先のSSPがゴーストがインストールされていない旨の警告ダイアログ(「何とかして下さい」ダイアログ)が出ている状態でも対応できる。
また、その場合に --option callghost も指定した場合は、警告ダイアログの起動続行ボタンを自動的に押された状態にして起動を続行する。
--ssf SSFファイル名
(旧: /s SSFファイル名)
SSFファイルを実行する。SSP起動時に指定された場合は、1組目のゴースト起動まで待機してから実行される。
オフラインサーフェスダンプ
--offline-dump フォルダパス オフラインダンプモードで起動する。ゴーストを実際に起動することなく、指定したゴーストフォルダのsurfaces.txtを読み込んでサーフェス画像をダンプし、即終了する。SHIORI/MAKOTO/PIROはロードされない。ウィンドウ・メッセージループも作成されない。
引数にはゴーストのフォルダパスを指定する(末尾の\は任意)。

例:ssp.exe --offline-dump "C:\SSP\ghost\myGhost" --dump-surface-list "0,1" --dump-output-dir "C:\dump"
--dump-shell フォルダ名か名前 [省略可] --offline-dump と組み合わせて使用する。ダンプ対象のシェルをフォルダ名(=shell以下の相対パス)か名前で指定する。省略時はdescript.txtで指定されているデフォルトシェル(通常はmaster)が使われる。
--dump-scope (スコープID) [省略可] --offline-dump と組み合わせて使用する。ダンプ画像のスコープIDを指定する。省略時は0。
--dump-surface-list リスト [省略可] --offline-dump と組み合わせて使用する。ダンプするサーフェスをカンマ区切りで指定する。surface番号のプレフィックス(surface)は省略可能。surfaces.txtのサーフェスID指定の拡張形式も使用できる。
例:--dump-surface-list "0,1,10"
このオプションを省略した場合はサーフェスダンプは行われない(--dump-error-log と組み合わせてパースエラーのみ出力することができる)。
--dump-output-dir ディレクトリ [省略可] --offline-dump と組み合わせて使用する。ダンプ画像の出力先ディレクトリを指定する。省略時はカレントディレクトリが使われる。
--dump-output-prefix プレフィックス [省略可] --offline-dump と組み合わせて使用する。出力ファイル名の先頭に付けるプレフィックスを指定する。省略時はプレフィックスなし。
--dump-error-log ファイルパス [省略可] --offline-dump と組み合わせて使用する。surfaces.txtのパースエラーをUTF-8テキストファイルとして指定パスに書き出す。エラーがない場合は空のファイルが作成される。
--dump-surface-list を省略してこのオプションのみ指定することで、ダンプを行わずエラーチェックのみを実行できる。
その他
initial_install.nar 起動オプションではないが、ssp.exeと同じフォルダにinitial_install.narという名前のNARファイルを配置しておくと、SSP起動時にサイレント(確認ダイアログなし)で上書きインストールされる。インストール完了後、initial_install.narは自動的に削除される。SSPにゴースト等を同梱して配布する場合などに利用できる。 [2.7.52~]