CommandLine Arguments

이 문서에서는 FX Viewer가 지원하는 숨겨진 명령어 인자들에 대해 설명합니다. 기본적으로 이 기능들은 프로그램의 일반적인 목적에 맞지 않거나, 테스트 또는 디버깅 용도 등으로 사용됩니다. 대부분의 경우에는 프로그램 인자 없이 실행하는 것이 추천됩니다.

인자 적용 방법

프로그램에 특정 인자를 적용시키는 방법으로는 아래와 같은 방법이 있습니다:

이 외에 여러 인자를 한번에 적용하는게 가능합니다. 인자를 여러 개 입력하고자 하는 경우, 인자 끼리의 값은 띄어쓰기로 구분합니다.

바로가기 속성 창의 '대상' 입력 필드 맨 오른쪽 끝에 인자를 입력하는 화면

Win+X, I 키 혹은 기타의 방법으로 PowerShell 창을 실행한 뒤 아래의 명령어를 참조하여 원하는 인자로 변경 후 실행합니다. Powershell의 경우, 각 인자는 따옴표(”)로 감싸 구별하여야 합니다.

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

명령 프롬프트 창을 연 뒤, 아래의 명령어를 참조하여 원하는 인자로 변경 후 실행합니다.

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

Win+R 키를 눌러 실행창을 연 뒤, 아래의 명령어를 참조하여 원하는 인자로 변경 후 실행합니다.

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

실행 창(Win+R)에 명령어를 입력한 예시 화면

PRPD 분류기의 연산 결과를 상세히 표시하고, 계산 시간과 분류기의 버전을 선택할 수 있는 버튼을 노출합니다.

Old Classificator의 경우 결과는 Probability, New Classificator의 경우 결과는 Logits 입니다.

enable-prpd-calc 인자로 표시되는 PRPD 분류기 상세 연산 결과 화면

카메라 별 상세 설정 → AI 학습 진행 시 AI 학습 진행상황을 표시하는 콘솔을 표시하도록 선택합니다. 학습 진행 이외에도 실시간으로 모델을 적용하고 있을 때도 콘솔을 표시하도록 선택합니다.

enable-ai-console 인자로 표시되는 AI 학습 진행 콘솔 화면

FX Viewer의 창모드 실행을 허용합니다.

enable-windowed 인자로 실행한 FX Viewer 창모드 화면

PRPD 분류기가 CPU 이외의 연산을 사용하도록 허용합니다.

ROCm, MIGraphX, OpenVINO의 경우 각각에 맞는 드라이버 및 런타임, SDK 설치가 필요합니다. 프로그램 설치 시에 제공되지 않으며, 맞는 드라이버 및 사용 조건 검사를 통과하는 경우 아래의 표에 명시된 Executor가 활성화됩니다.

CUDA의 경우, 프로그램 실행 시 메모리를 더 많이 요구하게 되며, PRPD 실시간 분류 시 연산 밀림, 메모리 과부하, 누수 등의 문제가 발생할 수 있습니다.
ROCm, MIGraphX의 경우 지원 대상 그래픽카드가 없으므로 테스트되지 않았습니다.
OpenVINO의 경우, AVX 연산등으로 인하여 CPU가 과도하게 뜨거워질 수 있습니다.

💡 참고: CUDA 기능은 CUDA 12.9 ToolKit, CUDNN 9.10 버전에서 테스트 되었습니다. 배경소음제거 기능에서 요구하는 CUDA는 11.8, CUDNN은 8.7 버전입니다.