VisualApplets
Operator Reference

Operator Library: Memory

이 연산자를 사용하면 호스트 PC에서 프레임 그래버로 이미지 파일을 업로드할 수 있으며, 이 파일은 지속적으로 출력되어 이미지 소스로 사용됩니다. 여기서는 이미지 파일이 범용 데이터 컨테이너로 사용됩니다. 따라서 업로드된 이미지에는 계수(coefficients)와 같은 모든 데이터가 포함될 수 있습니다. 모든 계수 이미지는 픽셀 너비와 높이가 동일해야 하지만 형식은 완전히 다를 수 있습니다. 예를 들어 링크 0 계수 이미지는 GRAY 8비트 형식일 수 있습니다. 링크 1은 RGB16 형식의 이미지를 제공할 수 있습니다. 그리고 링크 2는 바이너리 이미지일 수 있습니다. 모든 계수 이미지는 Frame Grabber RAM(DRAM)에 저장됩니다. RAM 유형의 VisualApplets 리소스가 하나 필요합니다. 자세한 내용은 'Allocation of Device Resources'를 확인하십시오. 연산자의 지연 시간(latency)에 대한 정보는 Table 46, 'Individual Latencies of the Operators in Library Memory'를 참조하십시오.

CoefficientBuffer는 imaFlex CXP-12 Quad 및 imaFlex CXP-12 Penta 플랫폼에서 사용할 수 없습니다.

CoefficientBuffer는 imaFlex CXP-12 Quad 및 imaFlex CXP-12 Penta 플랫폼에서 지원되지 않습니다. 'Functional Example for Loading Test Images Using ImageInjector' 예제에서는 ImageInjector 연산자를 사용하여 imaFlex CXP-12 Quad 또는 imaFlex CXP-12 Penta에서 CoefficientBuffer 연산자의 기능을 테스트 이미지 소스로 대체하는 방법을 보여줍니다. '2D Shading Correction / Flat Field Correction Using Operator RamLUT' 예제는 2D 셰이딩 보정을 위해 CoefficientBuffer 대신 RamLUT을 사용하는 방법을 보여줍니다.

링크 수는 CoefficientBuffer에 저장된 계수 이미지의 수와 일치합니다. 계수 이미지는 이미지 취득(acquisition)이 실행되지 않는 동안 소프트웨어를 통해서만 FPGA 버퍼에 업로드할 수 있습니다. 이는 LoadCoefficients 파라미터에 값을 써서 수행합니다.

연산자의 출력 포트는 동기식으로 작동합니다. 첫 번째 이미지 픽셀의 전송은 모든 출력 포트에서 정확히 같은 순간에 시작됩니다. 모든 이미지가 수신 연산자로 전송되면 CoefficientBuffer는 이미지를 다시 동기적으로 출력하기 시작합니다.

	시뮬레이션 중 동작
	연산자 링크의 이미지는 동시에 출력됩니다. 하나의 시뮬레이션 단계에서 연산자는 각 링크에 최대 하나의 이미지를 출력합니다. 시뮬레이션 단계 동안 저장된 모든 이미지(링크당 하나)가 수신 연산자로 전달된 경우, 즉 블로킹이 발생하지 않은 경우 다음 시뮬레이션 단계에서 동일한 출력(링크당 하나)이 전달됩니다.

CoefficientBuffer는 관심 영역(RoI) 관리도 지원합니다. RoI는 XOffset, XLength, YOffset 및 YLength의 4가지 파라미터로 정의됩니다. XOffset과 YOffset은 RoI의 좌상단 모서리, 즉 픽셀 단위의 시작 좌표를 정의합니다. RoI의 치수는 파라미터 BufferWidth 및 BufferHeight로 정의된 저장된 계수 이미지의 치수를 초과할 수 없습니다. RoI는 취득 중에 또는 취득이 실행되지 않을 때 4개의 RoI 좌표 파라미터를 모두 새 값으로 설정하고 UpdateROI 파라미터에 씀으로써 동적으로 업데이트할 수 있습니다. XLength는 링크 Parallelism의 단위, 즉 XLength modulo LinkParallelism = 0을 충족해야 합니다.

각 출력 링크에 대해 하나의 계수 이미지 파일이 버퍼에 저장됩니다. 즉, 계수 이미지 0이 링크 0에서 제공됩니다. 계수 이미지는 취득이 시작되기 전에 CoefficientBuffer에 로드되어야 합니다. 계수 이미지는 파라미터 CoefficientFile N에 지정된 파일에 저장되어야 합니다. N은 각각 링크 번호 또는 계수 이미지 번호를 나타냅니다. 계수 파일은 TIF 형식으로 인코딩되어야 합니다.

BufferWidth는 픽셀 단위로 CoefficientBuffer에 저장된 모든 계수 이미지의 너비를 지정합니다.

BufferHeight는 픽셀 단위로 CoefficientBuffer에서 관리하는 모든 계수 이미지의 높이를 지정합니다. BufferWidth와 BufferHeight는 모든 출력 링크의 최대 출력 이미지 크기를 결정합니다.

그레이스케일 링크의 경우 그레이스케일 이미지 파일을 사용해야 합니다. 컬러 링크의 경우 RGB 이미지 파일을 사용해야 합니다.

링크의 Bit Width가 이미지 파일의 Bit Width보다 높은 경우, 연산자는 여러 이미지 파일 픽셀을 사용하여 출력 픽셀을 생성합니다. 예를 들어 22비트 링크에는 8비트 이미지 파일의 픽셀 3개가 필요합니다. 따라서 이미지 파일의 이미지 너비는 파라미터 BufferWidth보다 3배 더 커야 합니다.

링크의 Bit Width가 이미지 파일의 Bit Width보다 작은 경우, 연산자는 입력 이미지 파일의 하위 비트만 사용합니다. 예를 들어 8비트 이미지 파일과 3비트 링크의 경우 파일의 0, 1, 2번 비트가 사용됩니다.

16비트 TIF 파일은 주의해서 사용해야 합니다.

LoadCoefficients 파라미터는 이미지 취득이 시작되기 전에 버퍼로 계수 이미지 로딩을 시작하는 데 사용됩니다. 로딩은 쓰기 주기 또는 이 파라미터에 값 1을 써서 트리거됩니다. 값 0을 쓰는 것은 아무런 효과가 없습니다.

UpdateROI 파라미터는 이미지 취득이 실행되는 동안 또는 이미지를 캡처하지 않을 때 현재 RoI를 동적으로 업데이트하는 데 사용됩니다. 이 파라미터에 쓰기 전에 4개의 RoI 좌표 파라미터로 새 RoI를 지정해야 합니다. 기록된 값은 업데이트 프로세스에 영향을 주지 않으며 쓰기 주기만 트리거합니다. 즉, 기록된 값은 0 또는 1일 수 있습니다.

XOffset 파라미터는 왼쪽 이미지 테두리에서 RoI의 첫 번째 열까지의 수평 방향 오프셋을 지정합니다. 지정된 값은 픽셀 단위로 측정되며 BufferWidth-1 값을 초과할 수 없습니다.

Parameter XLength specifies the length of the RoI in horizontal direction in pixels. The specified value must not exceed BufferWidth and must be divisible by the output link parallelism. Also the following constraint must be met: XOffset + XLength <= BufferWidth.

YOffset 파라미터는 상단 이미지 테두리에서 RoI의 첫 번째 라인까지의 수직 방향 오프셋을 지정합니다. YOffset은 픽셀 단위로 지정해야 하며 BufferHeight-1을 초과할 수 없습니다.

Parameter YLength specifies the length of the RoI in vertical direction in pixels. The length must not exceed BufferHeight. Furthermore, the following constraint must be met: YOffset + YLength <= BufferHeight.

파라미터 CoefficientFile N은 TIF 형식으로 저장된 링크 N용 계수 이미지의 파일 이름을 지정합니다.

참고

링크 0의 Parallelism은 다른 모든 링크의 Parallelism을 결정합니다. 링크 0의 Parallelism을 설정하면 XLength 값이 새로운 Parallelism으로 나누어떨어지도록 조정됩니다. 이는 향후 VA 버전에서는 다르게 처리될 수 있습니다. 즉, 링크 XLength의 Parallelism 속성 스핀박스에서 위/아래 버튼을 사용할 때 XLength가 수정될 수 있습니다. 따라서 모든 링크가 연결되고 지정된 후에는 XLength 설정을 확인하는 것이 좋습니다. BufferWidth 및 BufferHeight 파라미터를 설정하면 좌표 중 하나가 새로운 이미지 크기를 초과할 경우 RoI 좌표가 보정됩니다. 좌표는 가능한 가장 가까운 유효 값으로 보정됩니다. CoefficientBuffer는 2D, 1D 및 0D 이미지를 지원합니다. 1D 및 0D 이미지의 경우, 연산자는 프레임 끝 또는 라인 끝 마커를 생성하지 않고 2D 이미지로 저장된 계수 이미지를 연속적으로 제공합니다. 이 연산자는 1개의 DDRRAM 뱅크를 사용합니다. 따라서 계수 이미지의 저장 공간은 연산자당 하나의 RAM 뱅크 용량(예: mE5 보드의 경우 256MByte)으로 제한됩니다. 또한 DDRRAM의 내부 포맷팅으로 인해 실제 저장 공간이 물리적 저장 공간보다 약간 적을 수 있습니다. 사용된 저장 공간은 링크 형식 및 각 링크의 픽셀 너비와 관련이 있습니다. 최적의 경우 모든 링크 픽셀 너비의 합은 하나의 RAM 뱅크 용량(즉, mE5의 경우 256)으로 나누어떨어집니다. 이 경우 모든 계수 이미지를 하나의 메모리 뱅크에 함께 저장할 수 있습니다. 그 외의 경우 저장 공간이 최적화되지 않은 상태로 사용됩니다. 하드웨어 플랫폼에 대한 자세한 내용은 Device Resources를 확인하십시오.

대역폭 최적화

Frame Grabber RAM (DRAM)을 사용하는 연산자를 통과하는 이론적 대역폭[bits/second]은 다음 공식에 따라 계산됩니다.

그러나 실제 대역폭은 DRAM 효율로 인해 항상 이론적 대역폭보다 작습니다.

오퍼레이터를 통과하는 최대 대역폭은 Bit Width와 Parallelism의 곱이 내부 RAM 포트 너비 x 2와 같을 때 도달됩니다(읽기 전용 매개변수에 해당).

	플랫폼별 값
	RAM Port Width과 System Clock은 플랫폼 종속적입니다. 개별 플랫폼에 대한 자세한 내용은 Device Resources를 참조하십시오.

지원되는 Link Format

Link Parameter	출력 링크 O[n]
Bit Width	[1, 64]
Arithmetic	{unsigned, signed}
Parallelism	any
Kernel Columns	1
Kernel Rows	1
Img Protocol	{VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D}
Color Format	any
Color Flavor	any
Max. Img Width	BufferWidth
Max. Img Height	BufferHeight

	부호 없는(unsigned) 입력의 경우 출력 bit width 범위는 [1, 64]입니다. 부호 있는(signed) 입력의 경우 범위는 [2, 64]입니다. 부호 없는 컬러 입력의 경우 범위는 [3, 63]이며, 부호 있는 컬러 입력의 경우 범위는 [6, 63]입니다.
	bit width와 parallelism의 곱은 네이티브 RAM 데이터 너비를 초과해서는 안 됩니다. 자세한 내용은 Device Resources를 확인하십시오.