기타 작업 (microDisplay X)#
사용자 환경 설정 지정#
- microDisplay X의 GUI 디스플레이(applet 표시 및 파라미터 값의 dec/hex/bin 표시)
- 획득 Property(버퍼 수, 획득 타임아웃, 최대 DMA 버퍼 크기)
- 카메라 감지 및 카메라 제어 동작
microDisplay X 작업 환경 설정을 구성하려면 다음을 수행합니다.
- microDisplay X의 Tools 메뉴에서 Settings를 선택합니다.
-
열리는 대화 상자에서 변경하려는 설정을 조정합니다.
- Applet 표시: 클릭 GUI, 및 다음 아래: Applet 레이아웃 / 보기 모드, 프로그램 창의 Applet 레이아웃 창에 Applet이 표시되는 방식을 결정합니다. Applet의 리소스(포트)를 프로세스별(Process Mode)로 나열할지, 리소스 유형별(Resource Mode)로 나열할지 선택합니다.
- process mode에서는 하나의 프로세스(하나의 취득 채널)에 속하는 리소스(포트)가 Applet 레이아웃 창에 Acquisition Process 항목으로 나열됩니다.
- resource mode의 DMAs 아래에는 활성화된 모든 DMA 포트(microDisplay X에 로드된 Applet의 포트)가 나열됩니다. Camera Ports 아래에는 관련된 프레임 그래버에 연결된 모든 카메라가 나열됩니다.
- 기본 정수 표시 모드: 프로그램 창에서 파라미터 및 픽셀 값을 표시하기 위해 십진수, 십육진수, 이진수 옵션을 사용할 수 있습니다.
-
Acquisition 파라미터: Acquisition 파라미터를 설정하려면 Acquisition을 클릭하고 환경 설정을 지정합니다.
-
검색 설정: 검색 파라미터를 설정하려면 Discovery를 클릭하고 환경 설정을 지정합니다.
- Applet 표시: 클릭 GUI, 및 다음 아래: Applet 레이아웃 / 보기 모드, 프로그램 창의 Applet 레이아웃 창에 Applet이 표시되는 방식을 결정합니다. Applet의 리소스(포트)를 프로세스별(Process Mode)로 나열할지, 리소스 유형별(Resource Mode)로 나열할지 선택합니다.
Applet 구성 저장#
applet을 구성한 후(microDisplay X 또는 Framegrabber API를 통해) 구성을 저장할 수 있습니다.
Applet 구성을 저장하면 다음에 모든 Property가 이미 설정된 상태로 (프레임 그래버, microDisplay X 및/또는 소프트웨어에서) Applet을 로드할 수 있습니다.
정보
applet 구성을 저장하고 사용할 때 동일한 Framegrabber SDK 버전을 사용하고 있는지 확인하십시오. 예를 들어 Framegrabber SDK 버전 5.9.0을 사용하여 applet을 구성하고 이 구성을 저장한 경우, 버전 5.9.0 환경에서만 구성을 로드해야 합니다.
다음 섹션에서는 MCF 파일 작업에 필요한 모든 정보를 제공합니다.
MCF 및 MFS 파일#
MCF 파일#
applet 구성을 저장하면 구성 데이터가 파일에 저장됩니다. 구성 파일의 확장자는 *.mcf입니다. (MCF = microEnable Configuration File)
MCF 파일은 텍스트 형식으로 저장되므로, microDisplay X나 API를 통해서뿐만 아니라 이 파일에서 직접 개별 파라미터 설정을 변경할 수 있습니다.
MCF 파일에는 다음이 포함됩니다.
- 해당 Applet의 이름입니다.
- 수행한 모든 파라미터 설정(유일한 예외: 필드 값).
- 필요한 경우 MFS 파일(Applet 구성 중에 정의한 필드 값이 포함됨)에 대한 링크입니다.
별도의 XML 파일에서의 카메라 구성
MCF 파일에는 카메라 구성이 포함되어 있지 않습니다. 카메라 구성은 별도의 *.xml 파일에 저장할 수 있습니다. MCF 파일에는 applet 구성만 포함됩니다.
MFS 파일#
applet 구성에는 예를 들어 LUT와 같은 필드 파라미터가 포함될 수 있습니다. 이러한 필드 파라미터는 MCF 파일에 직접 저장되지 않고 확장자가 *.mfs인 별도의 파일에 저장됩니다. (MFS = microEnable Field Storage)
MFS 파일을 직접 처리할 일은 없습니다.
- Applet 구성에 필드 Property가 포함된 경우, Applet 구성을 저장할 때 MCF 파일과 함께 MFS 파일이 자동으로 생성됩니다.
- applet 구성을 로드할 때 MCF 파일을 로드하면 충분합니다. MFS 파일의 내용(필드 파라미터)이 MCF 파일과 함께 자동으로 로드되기 때문입니다.
정보
모든 프레임 그래버 모델용 applet 세트는 무료로 제공됩니다. 이러한 applet을 acquisition applets라고 합니다. 모든 acquisition applets의 파일 확장자는 *.dll입니다. Acquisition applets는 applet 세트(프레임 그래버 모델당 1개 세트)로 제공됩니다. Applet 세트는 Framegrabber SDK와 함께 설치하거나 개별 applet 세트 설치 프로그램을 통해 설치할 수 있습니다(Basler 웹사이트의 다운로드 섹션에서 확인 가능). 설치 후 acquisition applets는 Framegrabber SDK 설치 디렉터리의 하위 디렉터리 Dll에 위치합니다. (예: C:\Program Files\Basler\FramegrabberSDK5.x.x\Dll.) Acquisition applets는 프로그래밍 가능 및 비프로그래밍 프레임 그래버(즉, A Series 및 V Series Frame Grabbers)에서 실행됩니다.
모든 Acquisition Applet에는 필드 파라미터가 포함되어 있습니다. 따라서 Acquisition Applet의 구성을 저장할 때마다 *.mcf 파일과 *.mfs 파일의 두 가지 파일이 생성됩니다. 그러나 *.mfs 파일을 저장/로드할 때 항상 자동으로 생성/로드되므로 *.mfs 파일을 별도로 처리할 필요는 없습니다.
모든 Acquisition Applets 또는 일부 Acquisition Applets에는 다음과 같은 배열(필드 Property)이 포함됩니다.
- LUT
- KneeLUTs
- PoCXPStatePort_x (marathon CXP 보드 전용)
- PoCXPCurrentPort_x (marathon CXP 보드 전용)
- PoCXPVoltagePort_x (marathon CXP 보드 전용)
정보
모든 필드 데이터를 별도의 파일에 저장하면 Applet 구성 파일 MCF를 깔끔하게 유지할 수 있으며 하위 호환성이 지원됩니다.
mDisplay X에서의 저장 및 로드#
microDisplay X에서 파일로 Applet 구성 저장#
microDisplay X에서는 현재 로드된 applet의 구성을 파일로 저장할 수 있습니다.
-
File 메뉴에서 Save Configuration을 선택합니다.
-
applet 구성 파일(*.mcf)을 저장할 디렉토리를 선택합니다.
- *.mcf 파일의 이름을 지정합니다.
- Save를 클릭합니다.
*.mcf 파일이 생성되어 2단계에서 지정한 디렉터리에 저장됩니다. 앱릿 구성에 필드 값이 포함된 경우, 앱릿 구성의 모든 필드 파라미터 값이 포함된 추가적인 *.mfs 파일이 생성됩니다. 앱릿에 필드 파라미터가 포함되어 있으면 MFS 파일이 자동으로 생성됩니다.
microDisplay X에서 파일로부터 Applet 구성 로드#
-
microDisplay X에서 구성된 applet을 사용할 프레임 그래버를 선택합니다.
-
File 메뉴에서 Open Configuration을 선택합니다.
-
열리는 대화 상자에서 applet 구성이 포함된 디렉토리로 이동합니다.
- 사용하려는 *.mcf 파일을 선택하고 Open을 클릭합니다.
구성된 applet이 microDisplay X에 로드되고 프레임 그래버에서 활성화됩니다. applet 구성에 필드 파라미터가 포함된 경우, 해당 *.mfs 파일에서 필드 값이 자동으로 로드됩니다. *.mfs 파일을 별도로 로드할 필요는 없습니다.
Framegrabber API를 통한 저장 및 로드#
Framegrabber API를 통한 파일로의 Applet 구성 저장#
앱릿 구성 파일을 저장하기 위해 Framegrabber API(라이브러리 fglib5.lib, 헤더 파일 basler_fg.h):
int Fg_saveConfig (Fg_Struct *Fg, const char *Filename)
Parameters:
Fg: 시스템의 프레임 그래버(보드 인덱스)입니다. 활성 구성(활성 앱릿 및 해당 파라미터화)을 저장할 프레임 그래버를 여기에서 지정합니다.Filename: 여기에 구성 파일의 이름과 경로를 지정합니다. 파일 확장자는 항상 *.mcf입니다.
applet 구성에 필드 값이 포함된 경우, applet 구성의 모든 필드 parameter 값이 포함된 추가 *.mfs 파일이 생성됩니다. applet에 필드 parameter가 포함된 경우 MFS 파일이 자동으로 생성됩니다.
Framegrabber API를 통한 파일로부터의 Applet 구성 로드#
파일에서 앱릿 구성을 로드하기 위해 다양한 함수를 사용할 수 있습니다(라이브러리 fglib5.lib, 헤더 파일 basler_fg.h):
Frame Grabber Initialization#
*.mcf 파일을 통해 board를 직접 초기화할 수 있습니다. MCF 파일에는 applet 이름이 포함되어 있으므로, frame grabber는 MCF 파일에 지정된 applet으로 초기화되며 *.mcf 파일에 저장된 applet 구성(parametrization)이 frame grabber에 이미 설정됩니다.
앱릿 구성에 필드 파라미터가 포함되어 있고 *.mcf 파일과 동일한 디렉터리에 해당 *.mfs 파일이 저장되어 있는 경우, 이 함수를 호출하면 필드 파라미터가 자동으로 로드됩니다.
Fg_Struct* Fg_InitConfig (const char * Config_Name, unsigned int BoardIndex)
Parameters:
Config_Name: 여기에 구성 파일의 이름과 경로를 지정합니다. 파일 확장자는 항상 *.mcf입니다.BoardIndex: *.mcf 파일로 초기화하려는 frame grabber를 (board index를 통해) 여기에 지정합니다. 호출한 후Fg_InitConfig, 프레임 그래버는 *.mcf 파일에 명명된 앱릿과 동일한 파일에 지정된 앱릿 구성으로 초기화됩니다.
Loading Applet Configuration#
앱릿으로 프레임 그래버를 이미 초기화한 후에도 앱릿의 구성을 로드할 수 있습니다.
Prerequisites for using this function:
- 프레임 그래버가 이미 다음 함수를 통해 초기화되었습니다.
FG_Init또는 다음을 사용하는 master로서FG_InitEx. - *.mcf 파일에 저장된 앱릿 구성은 프레임 그래버가 초기화된 앱릿에 적용됩니다. (확실하지 않은 경우 *.mcf 파일을 확인하십시오. 앱릿 이름은 *.mcf 파일의 첫 줄에 언급되어 있습니다.)
applet 구성에 필드 parameter가 포함되어 있고 해당 *.mfs 파일이 *.mcf 파일과 동일한 디렉토리에 저장되어 있는 경우, 이 함수를 호출하면 필드 parameter가 자동으로 로드됩니다.
프레임 그래버 초기화 후 앱릿 구성을 로드하기 위한 함수:
int Fg_loadConfig (Fg_Struct *Fg, const char *Filename)
Parameters:
Fg: *.mcf 파일에 포함된 applet 구성으로 parameter를 설정할 frame grabber를 (board index를 통해) 여기에 지정합니다.Filename: 여기에 구성 파일의 이름과 경로를 지정합니다. 파일 확장자는 항상 *.mcf입니다.
정보
다음 함수를 통해 프레임 그래버를 사용한 후 프레임 그래버 리소스를 해제하는 것을 잊지 마십시오.
int Fg_FreeGrabber (Fg_Struct *Fg)
이 기능은 또한 이전에 다음을 통해 이 frame grabber에 대해 할당된 frame buffer를 해제합니다. Fg_AllocMem().