コンテンツにスキップ
SMI Developer Center

コマンドライン引数

本ドキュメントでは、FX Viewer がサポートする隠しコマンド引数について説明します。基本的にこれらの機能は、プログラムの一般的な目的に適合しないか、テストまたはデバッグ用途などに使用されます。ほとんどの場合、プログラム引数なしで実行することを推奨します。

引数の適用方法

プログラムに特定の引数を適用する方法には、以下のような方法があります:

  • プログラムのショートカットのプロパティを利用

  • CMD/PowerShell を利用

  • 実行ウィンドウを利用

このほか、複数の引数を一度に適用することが可能です。引数を複数入力する場合、引数同士の値は半角スペースで区切ります。

プログラムのショートカットのプロパティを利用

  • デスクトップなどにある FX Viewer のショートカットアイコンを右クリックして ‘プロパティ’ ウィンドウを開きます。

  • ショートカットの項目で ‘リンク先’ と表示されている入力フィールドの右端に、使用する引数を入力します。

ショートカットのプロパティウィンドウの 'リンク先' 入力フィールドの右端に引数を入力する画面

PowerShell を利用

Win+X、I キーまたはその他の方法で PowerShell ウィンドウを起動した後、以下のコマンドを参照して、目的の引数に変更してから実行します。 Powershell の場合、各引数は引用符(”)で囲んで区別する必要があります。

Terminal window
Start-Process "$env:APPDATA\FX Viewer\FX Viewer.exe" -ArgumentList "--enable-prpd-calc", "--enable-windowed"

コマンドプロンプト(CMD)を利用

コマンドプロンプトのウィンドウを開いた後、以下のコマンドを参照して、目的の引数に変更してから実行します。

Terminal window
start "" "%APPDATA%\FX Viewer\FX Viewer.exe" --enable-prpd-calc --enable-windowed

実行ウィンドウを利用

Win+R キーを押して実行ウィンドウを開いた後、以下のコマンドを参照して、目的の引数に変更してから実行します。

Terminal window
cmd /c start "" "%appdata%\FX Viewer\FX Viewer.exe" --enable-prpd-calc

実行ウィンドウ(Win+R)にコマンドを入力した例の画面

引数一覧

  • --enable-prpd-calc

  • --enable-ai-console

  • --enable-windowed

  • --enable-prpd-more-executor

引数の詳細

enable-prpd-calc

PRPD 分類器の演算結果を詳細に表示し、計算時間と分類器のバージョンを選択できるボタンを表示します。

Old Classificator の場合、結果は Probability、New Classificator の場合、結果は Logits です。

enable-prpd-calc 引数によって表示される PRPD 分類器の詳細な演算結果画面

enable-ai-console

カメラ別詳細設定 → AI 学習の実行時に、AI 学習の進行状況を表示するコンソールを表示するように選択します。 学習の実行以外にも、リアルタイムでモデルを適用しているときにもコンソールを表示するように選択します。

enable-ai-console 引数によって表示される AI 学習の進行コンソール画面

enable-windowed

FX Viewer のウィンドウモードでの実行を許可します。

enable-windowed 引数で実行した FX Viewer のウィンドウモード画面

enable-prpd-more-executor

PRPD 分類器が CPU 以外の演算を使用することを許可します。

ROCm、MIGraphX、OpenVINO の場合、それぞれに対応するドライバーおよびランタイム、SDK のインストールが必要です。プログラムのインストール時には提供されず、対応するドライバーおよび使用条件の検査を通過した場合に、以下の表に記載された Executor が有効になります。

Executor使用例備考
CUDANVIDIA GPU ( RTX 20xx 以上 )
ROCmAMD GPU ( RX 5700 XT 以降 )
MIGraphXAMD ROCm 対応環境実験的
OpenVINOIntel CPU 第6世代以上の環境実験的
CPUすべての x64 ベースの CPUデフォルトで有効に設定されます

  • CUDA の場合、プログラム実行時により多くのメモリを必要とし、PRPD のリアルタイム分類時に演算の遅延、メモリの過負荷、リークなどの問題が発生する可能性があります。

  • ROCm、MIGraphX の場合、対応するグラフィックカードがないためテストされていません。

  • OpenVINO の場合、AVX 演算などにより CPU が過度に高温になる可能性があります。

💡 参考: CUDA 機能は CUDA 12.9 ToolKit、CUDNN 9.10 バージョンでテストされました。 背景ノイズ除去機能が要求する CUDA は 11.8、CUDNN は 8.7 バージョンです。