TrgPortLine 연산자

VisualApplets
Operator Reference

TrgPortLine 연산자

Operator Library: Hardware Platform

이 연산자는 카메라의 트리거(Exsync)를 생성합니다. 또한, 획득한 라인을 이미지로 조합하는 역할도 담당합니다.

내부 신호 발생기(GrabberControlled)를 사용하거나, 외부 신호를 통해 신호 발생기를 트리거할 수 있으며, 이는 트리거 확장 보드(TTL Trigger 보드 또는 OPTO Trigger 보드)의 입력 신호를 이용하거나 소프트웨어를 통해 수행할 수 있습니다. 이 신호 발생기는 지연 시간, 펄스 폭 및 극성을 유연하게 설정하여 Exsync 신호를 생성할 수 있습니다. 또한, 트리거 확장 보드에서 사용할 수 있는 플래시 신호도 생성됩니다.

이 오퍼레이터는 CC 신호를 위해 4개의 디지털 출력과 1개의 카메라 포트를 사용합니다. 따라서 CameraControl 유형의 VisualApplets 리소스 1개가 사용됩니다. 리소스 인덱스가 0으로 설정된 경우, 디지털 출력 0~2와 카메라 포트 A가 사용됩니다. 리소스 인덱스가 1로 설정되면 디지털 출력 4~6과 카메라 포트 B가 사용됩니다. 출력 3과 7은 이 오퍼레이터에서 사용되지 않습니다. 다른 오퍼레이터는 이러한 하드웨어 리소스를 사용할 수 없음을 유의하십시오. 리소스 대화 상자에서 리소스 인덱스를 설정하십시오.

하드웨어 플랫폼별 지원 여부
microEnable IV VD1-CL/-PoCL
microEnable IV VD4-CL/-PoCL

I/O Properties

Property	Value
Operator Type	P
입력 링크	I, data input
출력 링크	O, data output

지원되는 Link Format

Link Parameter	Input Link I	Output Link O
Bit Width	[1, 64]	as I
Arithmetic	{unsigned, signed}	as I
Parallelism	any	as I
Kernel Columns	1	as I
Kernel Rows	1	as I
Img Protocol	VALT_LINE1D	VALT_IMAGE2D
Color Format	any	as I
Color Flavor	any	as I
Max. Img Width	any	as I
Max. Img Height	65536	as I

Parameters

YOffset
Type	dynamic/static 읽기/쓰기 파라미터
Default	0
Range	[0, 2²⁴]
이 매개변수는 프레임 시작 부분에서 생략되는 줄 수를 정의합니다.

YLength
Type	dynamic/static 읽기/쓰기 파라미터
Default	1024
Range	[8, 2²⁴]
이 매개변수는 프레임의 줄 수를 정의합니다.

MaxGatedHeight

Type

dynamid 읽기/쓰기 매개변수

Default

제한됨

Range

{제한됨, 제한 없음}

MaxGatedHeight 매개변수를 사용하면 이미지 트리거 모드(ImgTriggerMode)가 ExternSw_Gate로 설정된 경우 이미지의 최대 높이를 제한할 수 있습니다.

이미지 트리거 모드(ImgTriggerMode)가 ExternSw_Gate로 설정되어 있고, 매개변수 MaxGatedHeight가 제한 없음으로 설정된 경우, 이미지 높이는 게이트가 열린 시간, 즉 외부 이미지 트리거 신호의 펄스 폭이나 소프트웨어 트리거가 1인 상태로 유지되는 기간에 의해 결정됩니다. 이때, 게이트가 오랫동안 열려 있으면 이미지 높이가 커집니다. 매개변수 MaxGatedHeight가 제한(restricted)으로 설정된 경우, 게이트가 여전히 열려 있더라도 이미지 높이는 YLength 이미지 라인으로 제한됩니다. 이때 운영자는 그 이후의 라인을 모두 버리고, 다음 게이트가 열릴 때까지 기다린 후 새로운 프레임을 시작합니다.

반면, 이 매개변수가 ‘제한 없음’으로 설정된 경우, 이미지의 높이는 게이트에 의해서만 결정됩니다.

링크 속성 위반 가능성

무제한 모드에서 이 매개변수를 사용하면 ‘ VisualApplets ’ 링크 프로토콜 위반이 발생할 수 있습니다. 이미지 높이가 TrgPortLine 연산자의 출력 링크에 정의된 최대 허용 이미지 높이를 초과할 수 있습니다. 무제한 모드를 사용할 때는 주의하십시오. 링크 속성에 대한 자세한 내용은 ‘링크 속성’을 참조하십시오.

연속된 SplitImage 연산자를 사용하면 큰 이미지를 여러 조각(더 작은 이미지)으로 나눌 수 있습니다.

LineTriggerMode
Type	dynamic/static 읽기/쓰기 파라미터
Default	Grabber 제어
Range	{GrabberControlled, Extern_Trigger, GrabberControlled_Gated_by_Img, Extern_Trigger_Gated_by_Img}
이 매개변수는 내장 Exsync 신호 발생기의 작동 모드를 선택합니다. 외부 트리거 입력의 소스는 LineTrgInSourceA 및 LineTrgInSourceB 매개변수를 통해 선택할 수 있습니다( 아래 참조). GrabberControlled: Exsync는 내부 신호 발생기에 의해 주기적으로 생성됩니다. Extern_Trigger: 외부 트리거 신호는 신호 발생기를 한 번 시작하는 데 사용됩니다. GrabberControlled_Gated_by_Img: 프레임 획득 중 내부 신호 발생기에 의해 주기적으로 Exsync 신호가 생성됩니다. frame Extern_Trigger_Gated_by_Img: 프레임 획득 중에 외부 트리거 신호를 사용하여 신호 발생기를 트리거합니다. frame

ExsyncEnable
Type	동적 읽기/쓰기 매개변수
Default	OFF
Range	{꺼짐, 켜짐}
카메라로 전송되는 Exsync 출력을 활성화하거나 비활성화합니다.

LineTrgInSourceA
Type	dynamic/static 읽기/쓰기 파라미터
Default	InSignal0
Range	{InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}
이 매개변수는 Exsync 신호 발생기를 트리거하는 데 사용되는 신호 소스를 지정합니다. 이는 TriggerMode가 Extern_Trigger로 설정된 경우에만 적용됩니다.

LineTrgInSourceB
Type	dynamic/static 읽기/쓰기 파라미터
Default	InSignal0
Range	{InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}
이 매개변수는 Exsync 신호 발생기를 트리거하는 데 사용되는 신호 소스를 지정합니다. 이는 TriggerMode가 Extern_Trigger로 설정되고 EncoderABMode가 Signal_AB_Filter로 설정된 경우에만 적용됩니다.

EncoderABMode
Type	dynamic/static 읽기/쓰기 파라미터
Default	신호_A_만
Range	{Signal_A_Only, Signal_AB_Filter, Signal_ABx2_Filter, Signal_ABx4_Filter}
이 매개변수는 Exsync 생성에 단일 트리거 입력(A만)을 사용할지, 아니면 신호 A 와 B를 모두 사용할지를 지정합니다. 신호 A/B 지원 기능을 통해 샤프트 인코더의 회전 방향을 파악하고 역방향 이동을 억제 및 보정할 수 있습니다: Signal_A_Only: LineTrgInSourceA에서 선택한 트리거 입력이 Exsync 생성에 사용됩니다. Signal_AB_Filter: 단일 분해능에서 샤프트 엔코더가 정방향으로 회전할 때 Exsync 신호가 생성됩니다. 즉, LineTrgInSourceA의 상승 에지에 대한 트리거 펄스가 발생합니다. Signal_ABx2_Filter: 이중 분해능에서 샤프트 엔코더가 정방향으로 회전할 때 Exsync가 생성됩니다. 즉, LineTrgInSourceA의 상승 에지와 하강 에지에 대한 트리거 펄스가 각각 생성됩니다. LineTrgInSourceA의 양쪽 에지가 모두 사용됩니다. Signal_ABx4_Filter: 쿼드 해상도에서 샤프트 엔코더가 정방향으로 회전할 때 Exsync가 생성됩니다. 즉, LineTrgInSourceA의 상승 에지와 하강 에지, 그리고 LineTrgInSourceB의 상승 에지와 하강 에지에 대한 트리거 펄스가 생성됩니다. AB 지원이 활성화된 경우의 관련 매개변수: EncoderABLead (전진 방향 정의 전환 가능) 파라미터 EncoderABMode를 Signal_A_Only 값으로 설정하면 샤프트 엔코더를 재설정할 수 있습니다.

인코더AB리드
Type	dynamic/static 읽기/쓰기 파라미터
Default	Signal_AB
Range	{Signal_AB, Signal_BA}
매개변수가 Signal_AB로 설정된 경우, 신호 A가 신호 B보다 먼저 상승 에지를 보이면 이를 ‘A가 B보다 앞서 나간다’고 정의하며, 반대의 경우도 마찬가지입니다: Signal_AB: ‘Forward’는 B보다 A가 먼저 오도록 정의됩니다. Signal_BA: ‘Forward’는 ‘A’보다 ‘B’에 의해 먼저 정의된다.

LineTrgInPolarity
Type	동적 읽기/쓰기 매개변수
Default	저활동
Range	{저활동, 고활동}
이 매개변수는 외부 입력 트리거 신호인 LineTrgInSourceA 및 LineTrgInSourceB의 극성을 정의합니다. 이 매개변수가 LowActive로 설정된 경우, Exsync 생성기는 ImgTrgInSource 매개변수로 지정된 신호의 하강 에지에서 시작됩니다. 그렇지 않은 경우, Exsync 생성은 상승 에지에서 시작됩니다. 이는 TriggerMode가 Extern_Trigger로 설정된 경우에만 적용됩니다.

LineTrgDownscaler
Type	dynamic/static 읽기/쓰기 파라미터
Default	1
Range	[1, 256]
이 매개변수는 Exsync를 생성하는 데 필요한 외부 입력 트리거 신호의 수를 지정합니다. 이 설정은 TriggerMode가 외부 트리거 모드로 설정된 경우에만 적용됩니다.

LineTrgPhase
Type	dynamic/static 읽기/쓰기 파라미터
Default	1
Range	[1, 256]
이 매개변수는 프레임의 첫 번째 Exsync를 생성하는 데 필요한 외부 입력 트리거 신호의 수를 지정합니다. 이는 TriggerMode가 Extern_Trigger_Gated_by_Img로 설정된 경우에만 적용됩니다.

ExsyncPeriod
Type	dynamic/static 읽기/쓰기 파라미터
Default	100 μs
Range	[1.024, 4000] μs
이 매개변수는 Exsync 신호의 주기를 지정합니다. 따라서, 이 매개변수는 그래버 제어 모드를 사용하여 연결된 카메라를 트리거할 때의 라인 주파수를 정의합니다.

ExsyncExposure
Type	dynamic/static 읽기/쓰기 파라미터
Default	20 μs
Range	[1.024, 2000] μs, ExsyncPeriod를 초과해서는 안 됩니다.
이 매개변수는 Exsync 신호의 펄스 폭을 지정하며, 많은 카메라에서 이 신호를 사용하여 노출 시간을 설정할 수 있습니다. 따라서 캡처 중에도 소프트웨어를 통해 노출 시간을 조정할 수 있습니다.

Exsync2Delay
Type	dynamic/static 읽기/쓰기 파라미터
Default	0 μs
Range	[0, 2000] μs, ExsyncPeriod를 초과해서는 안 됨
이 매개변수는 외부 트리거 입력에 대한 생성된 Exsync 신호의 지연 시간을 지정합니다. 따라서, Exsync2 신호는 Exsync 신호의 지연된 복제본입니다(극성, 주기 등은 Exsync와 동일합니다).

ExsyncPolarity
Type	dynamic/static 읽기/쓰기 파라미터
Default	저활동
Range	{저활동, 고활동}
이 매개변수는 Exsync 신호 발생기의 극성을 연결된 카메라가 인식하는 극성에 맞게 조정합니다. 카메라가 하강 에지에서 셔터를 열 경우 LowActive를 사용하고, 그렇지 않은 경우 HighActive를 사용하십시오.

ImgTriggerMode
Type	dynamic/static 읽기/쓰기 파라미터
Default	FreeRun
Range	{FreeRun, ExternSw_Trigger, ExternSw_Gate}
이 매개변수는 내장 이미지 게이트의 작동 모드를 선택합니다. 이미지 트리거 입력 신호는 외부(주변) 장치(예: 샤프트 인코더)나 소프트웨어를 통해 생성될 수 있습니다. 외부 이미지 트리거 입력의 출처는 ImgTrgInSource 매개변수를 통해 선택할 수 있습니다(아래 참조). ImgTriggerMode 매개변수의 값에 따라 다음과 같은 동작이 나타납니다: FreeRun: 카메라에서 전송되는 모든 수신 신호는 수신됩니다. 이미지 게이트는 무시됩니다. YLength 매개변수는 프레임 끝(EOF)이 생성되는 시점을 정의합니다. 매개변수 yOffset이 0보다 크면, 연속된 두 이미지 사이의 yOffset 개 줄이 생략됩니다. 예시: yOffset = 0, YLength = 2: 예시: yOffset = 2, YLength = 2: ExternSw_Trigger: 수신된 이미지 트리거 입력 신호의 상승 에지에서, 새로운 프레임이 시작되고, 들어오는 라인은 YLength까지 이미지에 추가됩니다. YLength 매개변수는 프레임 끝(EOF)이 생성되는 시점을 정의합니다. 이미지 트리거의 새로운 상승 에지는 YLength 줄이 추가되고 EOF가 생성된 후에야 인정됩니다. 이미지에 YLength 줄이 추가되고 EOF가 생성되기 전에 이미지 트리거의 새로운 상승 에지가 발생하면 무시됩니다. 예시: YLength가 값 2로 설정된 경우: ExternSw_Gate: 게이트 모드에서는 이미지 트리거 입력 신호가 활성 상태를 유지하는 시간이 중요합니다. 이는 해당 신호가 이미지 게이트 신호로 기능하기 때문입니다. 이 모드의 정확한 동작은 MaxGatedHeight 매개변수를 통해 정의할 수 있습니다. ( MaxGatedHeight를 사용하면 이미지의 최대 높이를 제한할지 여부를 설정할 수 있습니다. 자세한 내용은 MaxGatedHeight 매개변수 설명을 참조하십시오.) *매개변수 MaxGatedHeight가* “Unrestricted” 값으로 설정되었을 때 ExternSW_Gate 모드의 동작** 이미지 게이트 신호가 활성화된 동안, 입력되는 라인은 이미지에 추가됩니다. 이미지 게이트는 어떤 이미지 라인이 유효한지를 제어합니다: 이미지 게이트 신호가 활성 상태인 동안, 입력되는 라인이 수용됩니다. (그림 참조, 예: 라인 n+8 및 n+9.) 이미지 게이트 신호가 비활성화된 상태에서는 입력 라인이 무시됩니다. (그림 참조, 예: n+3번째 라인.) 이미지 게이트 신호가 활성 상태일 때 시작되는 각 라인은 유효합니다. (그림 참조: n+1, n+2, n+4, n+5, n+6, n+8 및 n+9가 유효합니다.) 마지막 라인의 모든 데이터가 수집되기 전에 이미지 게이트의 하강 에지가 발생하더라도, 해당 라인은 여전히 유효하며 완전히 수집됩니다. (그림 참조: n+2 및 n+6) 항상 완성된 라인이 이송되고 있습니다. 이미지 게이트가 닫혀 있는 상태에서 시작되는 각 라인은 유효하지 않습니다. (그림 참조: 라인 n과 n+7은 유효하지 않고, 라인 n+4는 유효합니다.) 줄 끝(EoL)과 프레임 끝(EoF)은 새 줄이 시작되기 바로 직전에 생성되거나, 이미지 게이트의 하강 에지에서 생성됩니다. 새 줄이 시작되기 직전의 EoL: 한 줄의 하강 에지가 열린 이미지 게이트 내에서 발생하고 이미지 게이트가 다음 줄의 시작 부분을 포함하는 경우, EoL은 다음 라인의 상승 에지 바로 직전에 생성됩니다. (그림 참조: n+1, n+4, n+5 및 n+8.) 새로운 라인 시작 직전에 EoL과 EoF가 동시에 발생: 이미지 게이트의 하강 에지가 라인의 하강 에지보다 먼저 발생하면, EoL과 EoF는 다음 라인의 상승 에지 바로 직전에 생성됩니다. (그림 참조: 이미지 m 및 이미지 m+1.) 이미지 게이트의 하강 에지에서 EoL과 EoF가 동시에 발생하는 경우: 한 라인의 하강 에지가 열린 이미지 게이트 내에서 발생하고 이미지 게이트의 하강 에지가 다음 라인의 상승 에지보다 먼저 발생하는 경우, EoL과 EoF는 이미지 게이트의 하강 에지 직후에 생성됩니다. (그림 참조: 이미지 m+2.) MaxGatedHeight 매개변수가 “Restricted” 값으로 설정되었을 때 Mode ExternSW_Gate의 동작 만약 매개변수가 MaxGatedHeight 이 값이 “제한됨”으로 설정된 경우, 동작은 앞서 설명한 것과 동일합니다. MaxGatedHeight 값이 "unrestricted"인 경우, 단, 다음의 예외 사항이 적용됩니다: 이미지 게이트가 열려 있는 동안에는 최대 이미지높이인 YLength까지 줄이 추가됩니다. 그 이후의 모든 줄은 이미지 게이트 신호의 다음 상승 에지가 나타날 때까지 생략됩니다. YLength 줄이 추가되기 전에 Image Gate 신호의 하강 에지가 발생하면: Image Gate 신호의 하강 에지가 이미지의 높이를 결정하며, 이미지가 YLength 높이에 미치지 못하더라도 마찬가지입니다. (이미지 높이에 대한 자세한 내용은 MaxGatedHeight 매개변수를 참조하십시오.) 아래 예시(그림)는 MaxGatedHeight = restricted이고 YLength = 3일 때의 동작을 보여줍니다.

ImgTrgInSource
Type	dynamic/static 읽기/쓰기 파라미터
Default	InSignal0
Range	{InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}
이 매개변수는 이미지 획득을 트리거하는 데 사용되는 신호 소스를 지정합니다. 이는 ImgTriggerMode가 ExternSw_Trigger 또는 ExternSw_Gate로 설정된 경우에만 적용됩니다.

ImgTrgInPolarity
Type	동적 읽기/쓰기 매개변수
Default	저활동
Range	{저활동, 고활동}
이 매개변수는 외부 입력 트리거 신호의 극성을 정의합니다.

ImgTrgDelay
Type	동적 읽기/쓰기 매개변수
Default	0
Range	{0, 4095}
이 매개변수는 이미지 트리거 신호를 지정된 이미지 라인 수만큼 지연시킵니다.

FlashEnable
Type	동적 읽기/쓰기 매개변수
Default	OFF
Range	{꺼짐, 켜짐}
플래시 출력을 켜거나 끕니다. 플래시 신호의 펄스 폭은 1라인 주기와 같습니다.

플래시 극성
Type	dynamic/static 읽기/쓰기 파라미터
Default	저활동
Range	{저활동, 고활동}
이 매개변수는 생성되는 플래시 신호의 극성을 정의합니다.

FlashDelay
Type	dynamic/static 읽기/쓰기 파라미터
Default	0
Range	{0, 4095}
이 매개변수는 외부 트리거 입력에 대해 생성된 플래시 신호를 지연시킬 라인 수를 지정합니다. 따라서 플래시를 외부 트리거 입력과 동기화할 수 있습니다. 플래시 신호의 펄스 폭은 한 라인 주기와 같습니다.

SoftwareTrgPulse
Type	동적/정적 쓰기 파라미터
Default
Range	{1}
이 매개변수를 1로 설정하면 소프트웨어 트리거가 생성됩니다. 이는 TriggerMode가 외부 트리거 모드로 설정되어 있고 ImgTrgInSource가 SoftwareTrigger로 설정된 경우에만 적용됩니다.

SoftwareTrgInput
Type	동적/정적 쓰기 파라미터
Default
Range	{0, 1}
이 매개변수를 사용하면 이미지 트리거 모드 ExternSw_Gate에 대한 소프트웨어 게이트를 생성할 수 있습니다.

ImgTrgIsBusy
Type	동적/정적 읽기 매개변수
Default	0
Range	{0, 1}
The ImgTrgIsBusy parameter enables software readout of the busy state for the image trigger. If busy then this parameter is set to 1 to reflect an ongoing image capture. If set to 0 then the operator is not busy.

CC1 출력
Type	동적/정적 쓰기 파라미터
Default	Exsync
Range	{Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}
이 매개변수는 CameraLink 케이블의 CC1 라인에서 사용할 수 있는 신호를 지정합니다.

CC2 출력
Type	동적/정적 쓰기 파라미터
Default	Exsync
Range	{Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}
이 매개변수는 CameraLink 케이블의 CC2 라인에서 사용할 수 있는 신호를 지정합니다.

CC3 출력
Type	동적/정적 쓰기 파라미터
Default	Exsync
Range	{Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}
이 매개변수는 CameraLink 케이블의 CC3 라인에서 사용할 수 있는 신호를 지정합니다.

CC4 출력
Type	동적/정적 쓰기 파라미터
Default	Exsync
Range	{Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}
이 매개변수는 CameraLink 케이블의 CC4 라인에서 사용할 수 있는 신호를 지정합니다.

ImgTrgDebouncingMaxTime
Type	정적 쓰기 파라미터
Default	65.520 미크로초
Range	[0.016, 1000000] 마이크로초
이 매개변수는 ImgTrgDebouncingTime 매개변수의 최대 시간을 지정합니다. 최대 시간이 짧을수록 디바운싱 타이머를 구현하는 데 필요한 FPGA 리소스가 줄어듭니다.

ImgTrgDebouncingTime
Type	동적/정적 쓰기 파라미터
Default	0.112 마이크로초
Range	[0.016, ImgTrgDebouncingMaxTime] us
이 매개변수는 입력 이미지 트리거 신호가 감지되기 위해 동일한 값을 유지해야 하는 디바운싱 시간을 지정합니다. 디바운싱 시간 내에 발생하는 급격한 신호 변화는 필터링되어 제거됩니다.

LineTrgDebouncingMaxTime
Type	정적 쓰기 파라미터
Default	65.520 미크로초
Range	[0.016, 1000000] 마이크로초
이 매개변수는 LineTrgDebouncingTime 매개변수의 최대 시간을 지정합니다. 최대 시간이 짧을수록 디바운싱 타이머를 구현하는 데 필요한 FPGA 리소스가 줄어듭니다.

LineTrgDebouncingTime
Type	동적/정적 쓰기 파라미터
Default	0.112 마이크로초
Range	[0.016, ImgTrgDebouncingMaxTime] us
이 매개변수는 입력 라인 트리거 신호가 감지되기 위해 동일한 값을 유지해야 하는 디바운싱 시간을 지정합니다. 디바운싱 시간 내에 발생하는 급격한 신호 변화는 필터링되어 제거됩니다.

사용 예

다음 예제에서는 TrgPortLine 연산자의 사용법을 보여줍니다:

'디바이스 리소스 할당'

연산자의 디바이스 리소스 할당을 학습합니다.
'Camera Link 라인 스캔 카메라 '

예시 - 기본 습득
'Filter for Line Scan Cameras'

예제 - 라인 스캔 카메라용 필터를 구현하는 방법을 설명합니다.

이전	상위 레벨	다음
콘텐츠	맨 위로	홈

사이드바	이전 \| 상위로 \| 다음
콘텐츠 \| 홈
PDF \| 인쇄 \| 문의하기

VisualApplets Operator Reference