콘텐츠로 바로 가기

Framegrabber API 필수 조건#

Framegrabber API를 사용하여 프로그램을 작성하려면 C/C++로 작성된 프로그램을 컴파일하고 링크하기 위한 도구 세트가 필요합니다. Microsoft Windows의 경우, Framegrabber API는 Microsoft C/C++ 컴파일러 툴체인에 대한 지원을 제공하며 대부분의 프로젝트에서 Microsoft Visual Studio 통합 개발 환경(IDE)이 사용됩니다.

Linux 운영 체제를 사용할 때는 GNU C/C++ 및 Clang 컴파일러 툴체인이 지원됩니다. 이들은 일반적으로 Linux 배포판과 함께 제공되는 패키지 관리자를 사용하여 설치할 수 있습니다. Linux 배포판 설명서 및 특정 온라인 포럼과 커뮤니티를 참조하십시오.

이 문서의 코드 예제는 일반적으로 C++11 표준 이상을 지원하는 최신 C++ 컴파일러가 사용된다고 가정합니다. 엄격한 C 컴파일이 필요한 경우 자세한 내용은 순수 C 사용 시 고려 사항 장을 참조하십시오.

환경#

Framegrabber SDK를 설치할 때 일반적으로 환경 변수 BASLER_FG_SDK_DIR 가 시스템에 등록되며, 이는 이후 Framegrabber SDK 설치 위치를 나타내는 데 사용됩니다.

Linux 운영 체제를 사용하는 경우 스크립트 setup_siso_env.sh 가 환경 변수를 설정하며 시스템 관리자에 의해 시작 스크립트에 추가될 수 있습니다. 배포판마다 사용되는 시작 방식의 차이로 인해 이 작업은 자동으로 수행되지 않습니다. 시스템이 시작되거나 사용자가 로그인할 때 스크립트가 자동으로 호출되지 않는 경우, Framegrabber API를 사용하는 응용 프로그램을 컴파일하고 실행하려면 source 스크립트를 수동으로 실행해야 합니다.

운영 체제 드라이버#

Framegrabber API는 컴퓨터에 설치된 프레임 그래버에 접근하기 위해 운영 체제 드라이버가 필요합니다. Microsoft Windows에서는 Framegrabber SDK 설치 프로그램을 사용하여 드라이버를 설치할 수 있습니다. Linux 운영 체제를 사용할 때는 드라이버를 별도로 다운로드, 컴파일 및 설치해야 합니다. 드라이버 컴파일 및 설치 방법에 대한 자세한 내용은 Linux 드라이버 패키지의 INSTALL 문서를 따르십시오.

Microsoft Visual Studio 사용#

Microsoft Visual Studio를 사용할 때 새 프로젝트를 시작하고 "Visual C++" 범주에서 "Empty Project" 템플릿을 선택할 수 있습니다. 생성될 프로젝트에서 라이브러리를 사용하려면 먼저 디렉터리 %BASLER_FG_SDK_DIR%\include 를 컴파일러에서 사용하는 포함 경로에 추가해야 합니다.

정보

대상 플랫폼이 사용 중인 Framegrabber SDK 플랫폼과 일치하는지 항상 확인하십시오. Framegrabber SDK의 경우 항상 64비트입니다.

컴파일러 설정

다음으로, 디렉터리 %BASLER_FG_SDK_DIR%\lib\visualc 를 링커에서 사용하는 라이브러리 경로에 추가해야 합니다.

링커 설정

Microsoft Visual Studio 프로젝트에서 라이브러리에 링크하려면 링커 설정의 종속성에 라이브러리를 추가해야 합니다. 다음 예에서는 라이브러리 fglib5.lib 가 추가됩니다.

링커 설정

종속성을 추가하려면 다음을 클릭할 수 있습니다. 드롭다운 메뉴 버튼을 누르고 선택하세요. <Edit...>.

Linux 사용#

Linux 운영 체제 및 gcc 또는 clang 컴파일러를 사용하는 경우, -I $BASLER_FG_SDK_DIR/include 스위치는 컴파일러 설정에 Framegrabber API include 디렉터리를 추가하고, -L $BASLER_FG_SDK_DIR/lib 스위치는 링커 설정에 Framegrabber API library 디렉터리를 추가합니다.

gcc 또는 clang 컴파일러를 사용할 때 라이브러리에 링크하려면 -l 스위치가 사용됩니다. 예를 들어, -l fglib5 은(는) 링커 종속성에 라이브러리 libfglib5.so 을(를) 추가합니다. 소스 코드 파일 main.cpp이(가) 주어졌을 때, 파일을 컴파일하고 실행 파일 SimpleExample(으)로 링크하려면 명령 줄에 다음 명령을 입력할 수 있습니다.

g++ -o SimpleExample -I $BASLER_FG_SDK_DIR/include -L $BASLER_FG_SDK_DIR/lib -l fglib5 main.cpp

CMake 사용#

CMake는 Microsoft Visual Studio와 같은 다양한 통합 개발 환경(IDE)을 위한 프로젝트 요구 사항의 간단한 텍스트 설명으로부터 프로젝트 파일을 생성하는 도구이며, make.

Framegrabber API에는 CMake FIND_PACKAGE 명령을 지원하는 파일이 포함되어 있습니다. 소스 코드 파일 main.cpp이(가) 주어졌을 때, 파일을 컴파일하고 실행 파일 CMakeLists.txt (으)로 링크하는 프로젝트를 위한 간단한 SimpleExample 파일은 다음과 같을 수 있습니다.

PROJECT(SimpleExample)

FILE(TO_CMAKE_PATH "$ENV{BASLER_FG_SDK_DIR}" BASLER_FG_SDK_DIR)
LIST(APPEND CMAKE_MODULE_PATH "${BASLER_FG_SDK_DIR}/cmake/modules")

FIND_PACKAGE(FgLib5 REQUIRED)

INCLUDE_DIRECTORIES(
    ${FgLib5_INCLUDE_DIR}
)

SET (PRJ_SOURCES
    SimpleExample.cpp
)

ADD_EXECUTABLE(${PROJECT_NAME} ${PRJ_SOURCES})

TARGET_LINK_LIBRARIES(${PROJECT_NAME}
    ${FgLib5_LIBRARIES}
)

Microsoft Visual Studio와 함께 CMake 사용#

파일 CMakeLists.txt 을(를) 처리하여 Microsoft Visual Studio용 프로젝트를 생성하려면 GUI 도구를 사용하거나 명령 줄에 다음과 같이 입력하여 프로젝트를 생성할 수 있습니다.

cmake -G "Visual Studio 15 2017 Win64" .

make와 함께 CMake 사용#

빌드 워크플로를 위한 Makefile 을(를) make을(를) 사용하여 생성하려면 명령 줄에 다음을 입력할 수 있습니다.

cmake -G "Unix Makefiles" .