VisualApplets
Operator Reference

Operator Library: Hardware Platform

이 오퍼레이터는 CXP 듀얼 탭 카메라와 VisualApplets 간의 이미지 데이터 인터페이스를 나타냅니다. 이 오퍼레이터는 싱글 채널, 듀얼 채널 또는 쿼드 채널 CXP 인터페이스에 사용할 수 있습니다. ConnectionCount 파라미터를 사용하여 인터페이스 유형을 선택합니다. 오퍼레이터는 카메라가 전달하는 포맷에 관계없이 각 탭 포트에 대한 로우 이미지 데이터를 출력합니다. 그런 다음 이 이미지 데이터를 카메라에서 전송하는 포맷으로 변환해야 합니다. 이미지 데이터를 변환하려면 로우 바이트 값을 집계하고 픽셀 값으로 캐스팅하는 데 적절한 오퍼레이터를 사용하십시오. 작동 중 특정 상황은 아래 설명된 대로 이벤트 시스템을 통해 전달될 수 있습니다. 또한 이 오퍼레이터에는 카메라와의 연결 상태를 신호로 전달하는 다양한 파라미터가 있습니다.

CXP 표준 멀티 탭 정의

일반적으로 이미지 픽셀은 왼쪽 위에서 오른쪽 아래로 순차적으로 스캔됩니다. 그러나 최신 이미지 센서의 픽셀 수가 꾸준히 증가함에 따라 이 방식으로는 수용 가능한 프레임 속도를 얻을 수 없습니다. 이 문제를 해결하기 위해 센서 제조사들은 여러 픽셀을 동시에 스캔하는 방식을 사용합니다. CXP 표준은 taps 개념을 도입하여 이 기술을 수용합니다. 탭은 이미지 픽셀을 순차적으로 읽는 스캔 디바이스로 볼 수 있습니다. 이미지가 스캔되는 방식은 호스트가 디바이스에서 읽어오는 Tap Geometry로 정의됩니다.

CXP 표준에서는 프레임 그래버 호스트가 1X-1Y, 1X-1Y2 및 1X-2YE의 세 가지 탭 포맷을 지원하는 것이 권장됩니다. 1X-1Y 탭 포맷은 왼쪽 위에서 오른쪽 아래로 픽셀 단위로 이미지를 스캔하는 기본 특성을 나타내며, 다른 포맷은 다음 그림에 묘사된 두 가지 탭 지오메트리를 나타냅니다.

각 탭의 데이터는 별도의 스트림으로 형성되지만 스트림 ID와 탭 간에 고정된 매핑은 없다는 점에 유의해야 합니다. 그러나 이 매핑은 adquisición(취득) 과정 동안 일정하게 유지된다고 가정해도 무방합니다. TapG 코드, 즉 이 매핑을 찾는 데 필요한 정보는 CXP 이미지 헤더에 제공되며, 이는 선택 사항인 MetaDataTap0/1 포트에서 읽을 수 있습니다.

VisualApplets에서의 인스턴스화

오퍼레이터는 출력 탭에 이미지 데이터를 제공합니다. 이 출력은 항상 존재합니다. 싱글 탭의 경우 1이며 듀얼 탭 카메라의 경우 2로 설정해야 합니다. 이 표준 출력 포트 외에도 각 탭 출력 전용으로 CXP 헤더 메타데이터에 대한 선택적 MetaData 출력을 구성할 수 있습니다. 즉, 듀얼 탭 애플리케이션의 경우 최대 2개의 MetaDataTap 포트를 정의할 수 있습니다. 다음 팝업 대화 상자는 오퍼레이터 인스턴스화 중에 나타나며 다음 순열로 구성할 수 있습니다.

선택적 MetaDataTap Port

두 메타데이터 포트의 형식은 동일합니다. VisualApplets에서 32비트 출력으로 제공되며 다음 그림과 같습니다:

각 CXP 프레임은 해당되는 오류 없는 이미지 헤더를 제공합니다. 잘못된 이미지 헤더의 경우, 이미지 스트림 데이터가 VisualApplets 파이프라인으로 소싱되지 않습니다. 압축된 이미지 헤더는 6개 워드로 구성됩니다. 마지막 바이트는 내부 용도로만 사용되는 추가 정보를 위해 사용됩니다. 특히 HeaderError 비트는 이미지 헤더 자체에 오류가 있는지 여부를 알려줍니다.

Device Resource Usage

연산자는 파라미터 ConnectionCount의 선택에 따라 CameraPort 유형의 리소스를 하나 이상 사용합니다. 이벤트 system의 경우 EventPort 유형의 리소스가 사용됩니다. ConnectionCount가 X4(쿼드 채널)로 설정된 경우 다음과 같은 리소스 대화상자가 열립니다.

Error Handling 및 이벤트 시스템

연산자는 수신된 재구성된 프레임이 CXP 이미지 헤더에서 카메라가 홍보한 것보다 크거나 작음을 감지하면 안전 회로가 활성화됩니다. 그런 후 연산자는 초과하는 픽셀과 라인을 잘라내어 후속 처리 파이프라인이 항상 이미지 헤더에 정의된 프레임 크기를 인식하도록 합니다. 수신된 프레임의 크기가 이미지 헤더에 지정된 것보다 작은 경우, 연산자는 이미지 헤더에 정의된 지정된 프레임 크기를 달성하기 위해 수신된 프레임을 정의되지 않은 데이터로 채웁니다. 더 작은 프레임을 채우면 후속 프레임이 손실될 수 있습니다. 그러면 손실은 이벤트별로 런타임 소프트웨어(Framegrabber SDK)에 보고됩니다(다음 단락 참조). 크기 불일치 또한 이벤트를 유발합니다.

For a set of very critical errors, the operator will forward asynchronous events to the host runtime software (Framegrabber SDK). The event name in the Framegrabber API is <hierarchical operator name>\CxpStreamStatus, e.g. Device1\Process0\Camera\CxpStreamStatus. The event payload is provided as four 16-bit data words. The event format is defined as follows:

이벤트에는 손상된 엔티티용 이벤트와 손실된 엔티티용 이벤트의 두 가지 유형이 있습니다. 단어 3의 비트 0은 어떤 종류의 이벤트가 발생했는지 나타냅니다. 이벤트 버퍼가 가득 차면 이벤트가 손실될 수 있습니다. 손상된 엔티티를 나타내는 이벤트가 손실되면 단어 3의 비트 1이 설정됩니다. 손실된 엔티티를 나타내는 이벤트가 손실되면 단어 3의 비트 2가 설정되며 비트 3부터 15까지는 손실된 프레임을 나타내는 손실된 이벤트의 수를 제공합니다. 비트 2가 설정되어 있지만 Counter가 0인 경우, Counter 오버플로가 발생했음을 의미합니다.

모든 이벤트는 소프트웨어 인터럽트를 발생시킵니다. 이벤트 수를 줄이기 위해 동일한 프레임 태그를 가진 여러 이벤트가 병합될 수 있습니다. 이 경우 일부 오류 플래그가 결합됩니다. 이벤트가 손실된 경우, 손실된 이벤트 이전의 이벤트에는 손실된 이벤트에 대한 정보가 포함되며 동일한 프레임 태그를 가진 추가 이벤트와 병합될 수 없습니다.

CRC 오류로 인해 발생한 이벤트는 CRC 오류가 발생한 프레임과 정확히 관련되지 않을 수 있는 프레임 태그를 보고합니다. 프레임 태그는 이전 프레임 또는 다음 프레임의 것일 수 있습니다. 이는 카메라가 2개 이상의 프레임 간의 전환을 포함하는 CXP 패킷을 보낼 때만 발생할 수 있습니다. CRC 계산은 패킷 끝에서 완료되지만 스트림 데이터는 온더플라이 방식으로 재구성됩니다. 즉, operator가 이미 이전 프레임을 보낸 후에야 CRC 오류가 감지되는 상황이 발생할 수 있습니다. 카메라 패킷에 진행 중인 프레임의 끝과 다음 프레임의 시작 데이터가 모두 포함되어 있지 않은 일반적인 상황에서는 CRC 오류 발생 시의 프레임 태그가 항상 정확합니다. 전체 프레임 스트림 데이터가 8k의 최대 패킷 크기보다 작은 다른 모든 경우에서는 1개의 패킷 내에 1개의 프레임 오버랩만 있을 수 있습니다. 이 경우 소프트웨어 응용 프로그램은 프레임 태그 - 1인 이전 프레임과 프레임 태그 + 1인 다음 프레임도 잠재적으로 손상된 것으로 간주해야 합니다.