# WriteImage

현재 이미지를 로컬 장치 또는 FTP/SFTP 서버에 저장하려면 WriteImage 함수를 사용합니다. 선택적으로 이미지 위에 오버레이 그래픽을 포함하는 SVG 파일을 만들 수도 있습니다.

참고 :

- 온라인이거나 오프라인 상태이거나 선택한 저장 위치에 파일을 저장할 수 있습니다.
- 많은 이미지 파일을 저장하도록 작업을 구성하는 경우 FTP 서버 또는 SFTP 서버 스토리지 설정 선택을 권장합니다. In-Sight 장치에 많은 이미지 파일을 저장한 경우(예: 이벤트 매개 변수가, 사용 가능한 메모리 저장 공간이 부족하여 심각한 문제가 발생할 수 있습니다.

## WriteImage 입력

매개 변수 | 설명
이미지 | Image 구조체를 포함하는 셀 참조를 지정합니다. 기본 참조는 A0 셀의 Image 데이터 구조입니다.
이벤트 | 업데이트를 강제하는 이벤트를 지정합니다. 이 매개 변수는 타임스탬프가 있는 이벤트에 대한 참조여야 합니다. 예를 들어 다음 중 하나여야 합니다. Event 함수가 포함된 셀. Button 함수가 포함된 셀. 참고 : 기본적으로 이벤트 참조 값은 0입니다. 기본값을 변경하지 않으면 WriteImage가 스프레드시트에 처음 삽입될 때 "쓰기" 버튼이 자동으로 생성되어 참조됩니다.
스토리지 | 이미지를 로컬 장치에 저장할지 FTP/SFTP 서버에 저장할지 지정합니다. 저장 위치는 연결된 장치 및 함수의 스토리지 설정에 따라 다릅니다.
스토리지 설정 | 연결 장치 | 저장 위치
--- | --- | ---
로컬 장치 | In-Sight 장치 | In-Sight 장치 In-Sight 장치에 설치된 SD 카드 참고 : 파일을 보려면 FileZilla 클라이언트 등의 FTP 소프트웨어를 사용해야 합니다. 자세한 내용은In-Sight 장치에 저장된 파일을 보는 방법을 참조하십시오. SD 카드 스토리지를 사용하는 경우 작업을 실행하기 전에 SD 카드를 연결했는지 확인하십시오. SD 카드를 연결하지 않고 SD 카드 스토리지를 구성하면 파일이 내부 플래시 드라이브의 /sdcard 디렉터리에 저장됩니다.
PC | PC 참고 : PC 저장은 FTP 서버를 통해서만 지원됩니다.
FTP 서버 | 모든 장치 | 지정된 FTP 서버
SFTP 서버 | 모든 장치 | 지정된 SFTP 서버
서버 | 네트워크에서 이미지 파일이 쓰여질 서버 이름(또는 IP 주소)을 지정합니다. FTP 서버는 In-Sight 에뮬레이터일 수도 있고 네트워크에서 FTP 서버로 인식되는 기타 장치가 될 수 도 있습니다. 참고 : 이 옵션은 FTP 서버 또는 SFTP 서버를 스토리지 유형으로 지정한 경우에만 활성화됩니다. 특정 포트가 필요한 경우 서버 이름에 해당 포트를 추가할 수 있습니다. 예를 들어, FTP/SFTP 서버가 포트 50021을 사용하는 경우 "127.0.0.1:50021"을 입력합니다.
사용자 이름 | FTP/SFTP 서버의 유효한 사용자 이름을 지정합니다. 이 필드를 비워두면 "admin"이 사용됩니다. 참고 : 이 옵션은 FTP 서버 또는 SFTP 서버를 스토리지 유형으로 지정한 경우에만 활성화됩니다.
암호 | FTP/SFTP 서버의 암호를 지정합니다. 암호는 대소문자를 구별합니다. FTP/SFTP 서버에 암호가 없는 경우 이 필드를 비워도 됩니다. 참고 : 이 옵션은 FTP 서버 또는 SFTP 서버를 스토리지 유형으로 지정한 경우에만 활성화됩니다. 보안상의 이유로, 입력된 암호는 속성 시트와 수식 바에서 "*"로 표시됩니다. 암호는 암호화된 형식으로 잡 파일에 저장됩니다.
파일 경로 | 파일을 저장할 위치를 지정합니다. PC에 저장하는 경우 운영 체제 쓰기 권한이 있는 모든 위치에 파일을 쓸 수 있습니다. 이 필드에는 하드 코드된 경로(예: X:/, X:/Subdir), UNC 경로(예: //Cognex/shared/), 매핑된 드라이브(예: M:/Subdir), 상대 경로(../../Subdir) 등을 입력할 수 있습니다. In-Sight 장치 또는 PC에 경로가 없는 경우 이 함수는 #ERR을 반환합니다. FTP/SFTP 서버에서 경로 또는 FTP/SFTP 자격 증명이 유효하지 않은 경우 이 함수는 #ERR을 반환하지 않습니다. FTP 서버에 파일을 쓸 때 파일 경로도 지정할 수 있습니다. SFTP 서버에 파일을 쓸 때 절대 파일 경로도 지정할 수 있습니다. 경로에 ~ 접두사를 붙이면 SFTP 서버 사용자의 홈 디렉토리에 상대적으로 파일이 추가됩니다. 이 필드를 비워두면 파일이 다음 기본 위치 중 하나로 전송됩니다. In-Sight 장치: 장치의 루트 디렉토리. FTP 서버: 지정된 FTP 서버의 기본 디렉토리. SFTP 서버: 지정된 SFTP 서버의 루트 디렉토리.
파일 이름 | 이미지 파일의 이름을 지정합니다. SVG 파일의 이름도 정의합니다. 참고 : 사용 가능한 문자는 운영 체제의 제한을 따릅니다. 파일 이름의 값 추가 매개 변수의 형식을 지정할 수 있습니다. 자세한 내용은 이 항목의 값 매개 변수 형식 지정 섹션을 참조하십시오.
파일 유형 | 이미지의 파일 형식을 지정합니다.
0 = BMP(기본값) | Windows 비트맵 형식(.BMP 확장자).
1 = JPEG | 표준 인코딩 JPEG 형식(.JPG 확장자).
2 = PNG | 표준 인코딩 PNG 형식(.PNG 확장자)
최대 추가 값 | 정의된 파일 이름을 사용하여 쓸 수 있는 고유한 영상 파일의 최대 값(0 - 9999999, 기본값 = 999)을 정의합니다. 이미지 파일이 기록될 때마다 카운터가 증가하고 형식 지정자를 사용하지 않으면 지정된 파일 이름 끝에 카운터가 추가됩니다. 그렇지 않으면 서식 지정자의 위치에 카운터가 추가됩니다. 카운터가 최대 추가 값에 도달하면 자동으로 재설정되며, 동일한 이름을 가진 새 파일이 기존 영상 파일을 덮어씁니다. 이 값이 -1 또는 범위 초과 값으로 설정되면 파일 이름에 카운터가 추가되지 않습니다.
재설정 | 지정된 파일 이름에 0이 추가되는 카운터를 다시 시작합니다. 재설정 후 대상 위치에 있는 기존 이미지 파일을 동일한 이름의 새 파일로 덮어씁니다.
0 = 꺼짐(기본값) | 이미지가 기록될 때마다 카운터는 최대 추가 값까지 계속 증가합니다.
1 = 켜짐 | 카운터가 0으로 재설정됩니다.
참고 : 기본적으로 재설정 확인란은 선택되어 있지 않습니다. 기본 설정을 변경하지 않으면 WriteImage 함수가 스프레드시트에 처음으로 삽입될 때 "재설정" 버튼이 자동으로 생성되어 참조됩니다.
오버레이 그래픽 | 오버레이 그래픽이 있는 SVG 파일을 생성할지 여부를 지정합니다. SVG 파일과 이미지 파일을 보려면 SVG 파일 형식을 지원하는 웹 브라우저로 SVG 파일을 엽니다. SVG 파일에는 SVG 파일과 연계되어 촬상된 영상에 연결된 내부 링크가 포함되어 있고, SVG 파일을 브라우저로 열면 오버레이 그래픽과 함께 촬상된 영상에 연결된 링크가 따라와서 표시됩니다.
0 = 꺼짐 | 이미지만 전송됩니다.
1 = 켜짐(기본값) | 이미지와 SVG 파일이 모두 전송됩니다. 활성화되면 그래픽 오버레이 데이터가 포함된 SVG 파일이 이미지에 대해 지정된 동일한 디렉토리에 저장됩니다. 오버레이 그래픽 데이터와 이미지를 함께 보려면 웹 브라우저를 사용합니다.
참고 : 활성화된 경우, SVG 파일에는 파일 이름 매개 변수에 지정된 이름이 들어갑니다. 그래픽이 웹 브라우저와 같은 타사 응용 프로그램으로 렌더링되었기 때문에 오버레이 그래픽 데이터가 픽셀 대 픽셀로 정확하게 일치하지 않습니다.

## WriteImage 출력

반환 | 참조된 이벤트가 업데이트될 때마다 지정된 Image 데이터 구조에 포함된 이미지 데이터를 로컬 장치 또는 FTP/SFTP 서버에 쓰는 WriteImage 데이터 구조. 입력 매개 변수가 유효하지 않거나 파일 대기열이 가득 찬 경우 #ERR을 반환합니다. In-Sight D900 시리즈 비전 시스템의 메모리 스토리지가 가득 차면 #ERR을 반환합니다. 참고 : FTP/SFTP 서버 경로 또는 파일 이름이 잘못되어도 #ERR을 반환하지 않습니다. 팁 : #ERR 위로 마우스를 가져가면 다음 오류 메시지가 표시됩니다.
메시지 | 오류 이유
--- | ---
#ERR: 파일을 열 수 없음: 파일 경로/파일 이름 | 지정된 파일 경로 또는 파일 이름 매개 변수가 잘못되었습니다(즉, 파일 경로가 생성되지 않음).
#ERR: 오류 0:7:2: 파일 경로/파일 이름 | 비전 시스템의 메모리 스토리지가 가득 찼습니다.
결과 | WriteImage가 처음으로 스프레드시트에 삽입되고 이벤트 및/또는 재설정 매개 변수가 기본 설정인 경우 스프레드시트에서 쓰기 및/또는 재설정 버튼이 자동으로 생성되어 참조됩니다.

## 값 매개 변수 형식 지정

'|' 문자를 사용하여 이름이 정렬되도록 값 매개 변수의 형식을 지정할 수 있습니다. '|' 를 사용하면 값이 0이거나 비어 있습니다. '|' 바로 뒤의 문자가 0이면 0으로 채워집니다. 그렇지 않으면 공백으로 채워집니다. 다음 문자는 0 또는 ' '의 삽입 방법을 나타냅니다. 파일 이름에 '|' 문자가 다수 포함되면 마지막 문자가 형식 표시기로 사용됩니다. '|' 문자 뒤에 숫자가 오지 않으면 운영 체제의 제약 이후에 '|'가 이름의 일부로 사용됩니다.

파일 이름이 MyImage로 설정되면 저장되는 파일 이름은 다음과 같습니다.

파일 이름이 MyImage|03로 설정되면, 저장되는 파일 이름은 다음과 같습니다.

파일 이름이 MyImage|3로 설정되면, 저장되는 파일 이름은 다음과 같습니다.

'|'가 파일 이름 중간에 있으면 값 추가가 인라인으로 삽입됩니다. 예를 들어 파일 이름이 Fail_Image|03JobX로 설정되면, 저장되는 파일 이름은 다음과 같습니다.