VisualApplets
Operator Reference

Operator Library: Memory

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

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

imaFlex CXP-12 Quad 및 imaFlex CXP-12 Penta 플랫폼에서는 CoefficientBuffer가 지원되지 않습니다. '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에 저장된 계수 이미지의 수와 일치합니다. 계수 이미지는 이미지 억퀴지션이 실행되지 않는 동안 소프트웨어를 통해서만 FPGA 버퍼에 업로드할 수 있습니다. 이는 LoadCoefficients 파라미터에 값을 써서 수행됩니다.

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

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

CoefficientBuffer는 ROI(Region of Interest) 관리도 지원합니다. 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 bit 링크에는 8 bit 이미지 파일의 픽셀 3개가 필요합니다. 따라서 이미지 파일의 이미지 너비는 BufferWidth 파라미터보다 3배 더 커야 합니다.

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

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

대역폭 최적화

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

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

연산자를 통과하는 최대 대역폭 is Bit Width와 Parallelism의 곱이 내부 RAM Port Width x 2와 같을 때 도달합니다(읽기 전용 파라미터의 경우 해당됨).

	플랫폼별 값
	RAM Port Width와 System Clock은 플랫폼별로 다릅니다. 개별 플랫폼에 대한 자세한 내용은 Device Resources를 참조하세요.

Supported 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

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