# ApplyAcquisitionSettings

AcquireImage 속성 시트에서 매개 변수를 선택하고 해당 매개 변수를 스프레드시트로 끌어와서 ApplyAcquisitionSettings 함수를 추가할 수 있습니다. ApplyAcquisitionSettings 함수는 AcquireImage 함수에 표시되는 촬상 매개 변수의 세터 역할을 합니다. 이 함수는 런타임에 스프레드시트에서 빠르고 쉽게 촬상 설정을 수정하거나 AcquireImage 속성 시트를 열지 않고도 FFP(외부 통신) 또는 비전 도구의 출력에 따라 설정을 업데이트하려는 경우에 유용합니다.

ApplyAcquisitionSettings 함수는 다음 매개 변수를 지원합니다.

- 트리거 유형, 디바운스(ms), 지연(ms), 노출(ms), 오프셋, 게인, 방향, 시작 행, 행 수
- 조명: 모드, 강도, 뱅크 활성화, 항상 켜짐
- 하이 다이내믹 레인지: HDR 모드, HDR+ 커널 크기

참고 :

- AcquireImage 속성 시트에서 다른 매개 변수(예: 트리거 모드)는 스프레드시트로 끌어 놓을 수 없습니다.

- 연결된 장치가 지원하지 않는 매개 변수는 회색으로 표시되며 끌어 놓을 수 없습니다.
- 함수에는 인수가 없으므로 해당 셀을 셀 템플릿으로 내보낼 때 구성된 촬상 설정이 유지되지 않습니다. 촬상 설정을 내보내려면 스프레드시트에 ApplyAcquisitionSettings를 추가하고, 유지하려는 매개 변수를 활성화하고, 원하는 값으로 설정한 다음, ApplyAcquisitionSettings를 셀 템플릿으로 내보냅니다. ApplyAcquisitionSettings이 포함된 셀 템플릿을 가져오면 ApplyAcquisitionSettings 셀이 실행된 후 촬상 설정이 함수에 적용됩니다. 스프레드시트 셀 템플릿에 대한 자세한 내용은 템플릿으로 셀 내보내기 및 템플릿에서 셀 가져오기 항목을 참조하십시오.

## ApplyAcquisitionSettings 사용 방법

1. 셀 A0에서 AcquireImage 속성 시트를 엽니다.
2. AcquireImage 속성 시트에서 스프레드시트로 매개 변수를 끌어옵니다.

3. ApplyAcquisitionSettings 함수가 스프레드시트에 추가되고 AcquisitionSettings 데이터 구조, 매개 변수의 레이블, 편집 컨트롤을 반환합니다. 예를 들어 디바운스(ms) 매개 변수를 스프레드시트로 끌어서 놓으면 AcquisitionSettings 데이터 구조, "디바운스(ms)" 레이블, 편집 컨트롤이 스프레드시트에 채워집니다.

4. 확인을 클릭해 AcquireImage 속성 시트를 닫습니다.

5. 스프레드시트에 다른 촬상 매개 변수를 추가하려면 ApplyAcquisitionSettings 속성 시트를 엽니다.

   참고 : 첫 번째 ApplyAcquisitionSettings 함수가 생성된 이후 ApplyAcquisitionSettings 속성 시트에서 매개 변수를 끌어오는 것이 좋습니다. AcquireImage에서 다수의 매개 변수를 끌어 오면 다수의 ApplyAcquisitionSettings 함수를 생성하는 것이며, 각각에 어떤 매개 변수가 설정되는지 명확하지 않습니다.

6. 원하는 매개 변수의 확인란에 체크합니다. 예를 들어 스프레드시트에 지연(ms) 매개 변수를 추가하려면 지연(ms) 매개 변수 확인란에 체크합니다.

7. 매개 변수를 스프레드시트로 끌어서 놓습니다.

8. 매개 변수의 레이블과 편집 컨트롤이 스프레드시트에 채워집니다. 예를 들어 지연(ms) 매개 변수를 스프레드시트로 끌어서 놓으면 "지연" 레이블과 편집 컨트롤이 스프레드시트에 채워집니다.

9. 원하는 매개 변수를 모두 추가할 때까지 5-8단계를 반복합니다.
10. 필요에 따라 편집 컨트롤에서 값을 수정합니다.

11. 새 값은 다음 이미지 촬상 시 적용됩니다.

    참고 : 카메라 트리거 모드를 사용하는 경우 다음 장치 트리거 후에 새 값이 적용됩니다.

참고 :

- 스프레드시트에 ApplyAcquisitionSettings 함수가 두 개 이상인 경우 이미지 촬상에서는 마지막으로 업데이트된 값만 사용됩니다.
- AcquireImage 또는 ApplyAcquisitionSettings 속성 시트로부터 스프레드시트로 매개 변수를 끌어올 때만 매개 변수의 레이블 및 편집 컨트롤이 채워집니다. 다른 방법(예: 셀에 ApplyAcquisitionSettings를 입력)으로 ApplyAcquisitionSettings를 삽입하면 AcquisitionSettings 데이터 구조만 채워집니다.
- ApplyAcquisitionSettings 속성 시트에서 매개 변수의 체크를 해제하면 스프레드시트 상의 연결된 편집 컨트롤이 더 이상 AcquireImage 함수의 값을 덮어쓰지 않습니다.

## ApplyAcquisitionSettings 출력

지원되는 매개 변수를 AcquireImage 속성 시트에서 스프레드시트로 끌어서 놓으면 다음이 반환됩니다.

반환 | AcquisitionSettings 데이터 구조 매개 변수의 레이블 매개 변수에 대한 편집 컨트롤