카메라 vTool#
다음 파일을 다운로드하세요 pylon Software Suite 다운로드하여 카메라 vTool을 사용하세요.

카메라 할당#
카메라 vTool은 사용자가 특정 카메라 속성을 정의하지 않은 경우, 사용 가능한 카메라를 무작위로 할당합니다. 단일 카메라 설계의 경우, 이를 통해 신속하게 작업을 시작할 수 있습니다.
다중 카메라 설계에서 특정 카메라를 Camera vTool에 할당하려면 다음 섹션을 참조하십시오.
카메라 vTool 대화 상자 사용#
Basler는 Camera vTool 대화 상자를 사용하여 카메라를 Camera vTool에 할당할 것을 권장합니다.
방법:
- 다음 파라미터 블록에서 Recipe Management [ ] 내의 vTool 설정 영역에서 클릭하세요 설정 열기 또는 vTool을 두 번 클릭하세요.

- 할당할 카메라를 선택한 다음 클릭하세요 할당.
카메라 이름 옆에 녹색 체크 표시가 나타납니다. 이는 해당 카메라가 이제 vTool에 할당되었음을 나타냅니다:
또한, 이 대화 상자에는 장치를 식별하는 데 사용된 속성이 표시됩니다. 드문 경우지만, 이러한 속성을 수정해야 할 수도 있습니다. 속성을 수정하려면 ‘기능’ 창을 사용하십시오.
기능 창 사용하기#
또한 ‘기능’ 창을 사용하여 카메라를 Camera vTool에 할당할 수도 있습니다.
이는 매우 드문 경우에만 필요한데, 예를 들어 컴퓨터에 실제 카메라가 연결되어 있지 않은 상태에서 카메라 할당 정보를 확인하거나 변경하고자 할 때 등이 해당됩니다.
‘기능’ 창을 사용하여 특정 카메라를 지정하려면:
- Workbench 에서 ‘Camera’ vTool을 선택합니다.
- '기능 - 전체 ' 창을 엽니다.
- vTool > 장치 열거 제어 > 장치 목록 업데이트> 실행을 클릭하여 사용 가능한 카메라 목록을 확인하십시오.
- ‘Device Selector’ 매개변수를 사용하여 사용 가능한 카메라를 찾아보세요.
이를 통해 개별 카메라에 대한 특정 정보를 확인하여 원하는 카메라를 선택할 수 있습니다. - 원하는 카메라를 확인했다면, ‘Device Choose ’ > ‘Execute’를 클릭하여 해당 카메라를 Camera vTool에 할당하십시오.
-
할당하려는 카메라가 충족해야 하는 추가 장치 속성을 지정하려면, vTool > 장치 열거 제어 그룹에 있는 ‘장치 속성 *’ 매개변수를 사용하십시오.
정보
장치 정보 속성에 대한 자세한 내용은 CDeviceInfo 클래스 및 pylon C++ API의 Pylon/Key 네임스페이스 문서에서 확인할 수 있습니다. 이를 통해 카메라 선택을 세밀하게 제어할 수 있으며, 올바른 카메라가 장착된 여러 대의 컴퓨터에서 동일한 레시피를 실행할 수 있도록 보장합니다.
시스템에 여러 대의 카메라가 연결된 경우, Basler는 DeviceClass 및 UserDefinedName 속성을 사용할 것을 권장합니다. UserDefinedName 속성을 사용하여 카메라를 선택하려면 먼저 카메라의 DeviceUserID 매개변수를 설정해야 합니다.
USB 카메라의 경우, 새로 설정된 DeviceUserID를 사용하려면 재설정하거나 전원을 껐다가 다시 켜야 한다는 점에 유의하십시오.
카메라 설정#
카메라를 Camera vTool에 할당한 후, ‘ Workbench ’ 도구 모음에서 ‘Lock Resources’ 버튼을 클릭하여 할당된 카메라 장치와 배타적 연결을 설정합니다.

이제 ‘기능 - 전체 ’ 패널에서 카메라를 설정할 수 있습니다.
레시피에 카메라 설정 저장하기#
레시피를 저장할 때 카메라 설정이 자동으로 저장되지 않는 이유는, 레시피를 저장하는 시점에 ‘카메라 vTool’에 할당된 카메라 장치가 연결되어 있지 않을 수도 있고, 그 사이에 다른 프로그램에 의해 카메라 장치의 설정이 변경되었을 수도 있기 때문입니다.
대신, 매개변수를 구성한 후 vTool > 구성 세트 지속성 ( Configuration Set Persistence) 아래의 ‘기능 - 전체(Features - All )’ 창에 있는 매개변수를 사용하여 카메라 장치의 설정 및 관련 설정을 저장하십시오.
정보
카메라 장치를 처음 설정할 때는 Basler에서 제공하는 기존 ‘ pylon Viewer ’ 기능을 사용할 것을 권장합니다.
카메라 설정을 레시피에 저장하려면:
- 다음 항목을 클릭합니다. 리소스 잠금 Workbench 도구 모음의 [버튼]을 클릭하여 할당된 카메라 장치와 전용 연결을 설정합니다.

- “기능 - 전체” 창에서 “구성 세트 지속성” 범주를 열고, “구성 세트 선택기” 매개변수를 “카메라”로 설정하여 카메라 장치의 매개변수 세트를 선택합니다.
- ‘구성 세트 가져오기’를 클릭하여 카메라 장치에서 설정을 가져온 다음, 이를 ‘구성 세트 준비됨’ 매개변수에 저장합니다.
-
Optional: You can inspect or manually modify the parameter settings by copying the text to a text editor and back into Configuration Set Staged.
In the text editor, you will see that each line of text contains the name and the value of a parameter separated by a tab or = character. Lines starting with # are treated as comments. A configuration set must start with the following line:
# {05D8C294-F295-4dfb-9D01-096BD04049F4}정보
또는 사용자 세트를 사용하여 카메라 설정을 영구적으로 저장할 수도 있습니다.
-
‘구성 세트 적용( Configuration Set Commit )’을 클릭하여 매개변수를 적용하고 레시피 설정에 저장하십시오. 이렇게 하면 ‘리소스 잠금’ 작업이 실행될 때마다 매개변수가 자동으로 설정됩니다.
정보
카메라가 이미 할당된 경우, 매개변수 설정이 즉시 카메라로 전송됩니다. 전송에 실패하면 매개변수 설정은 ‘활성 구성 세트(Configuration Set Active)’에 저장되지 않습니다. 할당된 카메라가 없는 경우, 카메라가 할당되면 설정이 해당 카메라로 전송됩니다. 이 전송에 실패하면 레시피를 시작할 수 없습니다.
일부 카메라 매개변수(예: ‘카메라 인스턴스’ 구성 세트에 포함된 매개변수)는 카메라가 닫혀 있을 때만 변경할 수 있습니다. 이 경우, ‘활성 구성 세트’에 저장된 매개변수는 카메라를 열기 전에 카메라가 할당될 때 카메라로 전송됩니다.
-
레시피에서 매개변수 설정을 지우려면 ‘데이터 지우기’를 클릭하십시오.
이벤트 알림 및 청크 데이터 사용#
또한 Camera vTool을 사용하면 카메라의 이벤트 및 청크 데이터에 접근할 수 있습니다. 이벤트 및 청크 데이터를 위한 출력 핀을 추가로 설정하여 이를 통해 애플리케이션을 제어할 수 있습니다. 예를 들어, 노출 종료와 같은 카메라 이벤트는 외부 장치를 제어하는 데 사용할 수 있습니다. 타임스탬프나 노출 시간과 같은 청크 데이터는 애플리케이션 내의 작업을 제어하고 동기화하는 데 사용할 수 있습니다.
정보
- 레시피가 실행 중이 아닐 때만 핀을 추가할 수 있습니다.
- 핀 이름은 고유해야 합니다.
- 허용되는 데이터 유형: 부울, 실수, 정수, 문자열
카메라 이벤트에 접근하기#
- 카메라에서 원하는 이벤트를 활성화하십시오.
- Workbench 에서 ‘Camera’ vTool을 선택합니다.
- '기능 - 전체 ' 창을 엽니다.
- vTool > 이벤트 출력 제어 그룹으로 이동합니다.
- '이벤트 핀 추가 ' 명령을 실행합니다.
- 다음 파라미터 블록에서 이벤트 핀 구성 필드에 추가할 이벤트 핀의 구성을 입력하십시오. 다음 구문을 사용하십시오:
<MyPinName>.Type=<MyPinType>.EventName=<CameraEvent>.ValueName=<CameraEventValue>
여기서:<MyPinName>: 새로운 출력 핀의 이름<MyPinType>: 액세스하려는 이벤트의 데이터 유형 (허용되는 값: Boolean, Float, Integer, String)<CameraEvent>: 카메라에서와 같이 액세스하려는 이벤트의 이름<CameraEventValue>: 카메라에 표시되는 이벤트 값의 이름(예: EventExposureEnd) - Enter 키를 누르세요.
새로운 핀이 vTool에 표시됩니다.
구성 예시#
ExposureEnd라는 이름과 Integer 데이터형을 가진 출력 핀을 생성하여, 노출 종료 카메라 이벤트의 정보를 출력하고자 한다고 가정해 봅시다. 이를 위해 다음 문자열을 입력하십시오:
ExposureEnd.Type=Integer.EventName=ExposureEnd.ValueName=EventExposureEnd
청크 데이터에 접근하기#
- 카메라에서 청크 모드와 원하는 데이터 청크를 활성화하십시오.
- Workbench 에서 ‘Camera’ vTool을 선택합니다.
- '기능 - 전체 ' 창을 엽니다.
- vTool > 청크 데이터 출력 제어 그룹으로 이동합니다.
- “청크 핀 추가 ” 명령을 실행합니다.
- 다음 파라미터 블록에서 청크 핀 구성 필드에 추가하려는 데이터 청크 핀의 구성을 입력하십시오. 다음 구문을 사용하십시오:
<MyPinName>.Type=<MyPinType>.ValueName=<ChunkName>
여기서:<MyPinName>: 새로운 출력 핀의 이름<MyPinType>: 카메라에서와 마찬가지로, 액세스하려는 청크 데이터의 값 유형<ChunkName>: 카메라에서와 같이 액세스하려는 청크의 이름. 예: ChunkExposureTime - Enter 키를 누르세요.
새로운 핀이 vTool에 표시됩니다.
구성 예시#
ExposureTimeChunk라는 이름과 Integer 데이터형을 가진 출력 핀을 생성하여 카메라의 노출 시간 청크에 포함된 정보를 출력하고자 한다고 가정해 봅시다. 이를 위해 다음 문자열을 입력하십시오:
ExposureTimeChunk.Type=Float.ValueName=ChunkExposureTime
문제 해결#
일치하는 카메라 여러 대 발견됨
문제: 카메라 vTool 대화 상자를 열면 카메라 이름 옆에 경고 표시가 나타납니다.

이유: vTool에 저장된 장치 속성과 일치하는 카메라가 여러 대 있기 때문입니다.
위의 예시에서 저장된 장치 속성은 다음과 같습니다. DeviceClass = BaslerUsb 및 ModelName = acA1920-40uCMT. 이 세 대의 카메라는 모두 USB 카메라이며, 이름이 “acA1920-40uCMT”이므로 이러한 속성에 부합합니다.
해결 방법: 이 문제를 방지하려면 대화 상자를 사용하여 카메라를 다시 할당하거나, ‘기능’ 창을 통해 속성을 변경하십시오.
일치하는 카메라를 찾을 수 없습니다
문제: 카메라 vTool 대화 상자를 열면 “일치하는 카메라를 찾을 수 없음”이라는 메시지가 표시됩니다.

이유: vTool에 저장된 장치 속성과 일치하는 카메라가 없기 때문입니다.
위의 예시에서 저장된 장치 속성은 다음과 같습니다. DeviceClass = BaslerUsb 및 ModelName = acA645-100uc. 하지만 “acA645-100uc”라는 이름의 카메라는 연결되어 있지 않습니다.
해결 방법: 이러한 문제를 방지하려면, 해당 카메라를 연결하거나, 대화 상자를 통해 카메라를 다시 할당하거나, ‘기능’ 창을 사용하여 속성을 변경하십시오.
Outputs#
Image#
카메라로 캡처한 이미지를 반환합니다. 이 출력 이미지는 이미지를 입력으로 받는 모든 vTool에서 사용할 수 있습니다.
- Data type: Image
- 이미지 형식: 카메라에서 설정된 대로