In-Sight® SDK 5.73 릴리스 정보

Revision: 5.7.3.5, 06/18/2019

개요

이 안내서는 Microsoft^® Windows^®용 In-Sight SDK(소프트웨어 개발 키트)에 관하여 다음 주제를 중심으로 설명합니다.

In-Sight SDK 정보
시스템 요구사항
설치
샘플 프로젝트
API 변경 사항
알려진 문제점

CvsInSightDisplay 컨트롤에 대한 자세한 내용은 In-Sight 디스플레이 컨트롤 릴리스 정보를 참조하십시오.

In-Sight SDK 정보

In-Sight SDK는 네트워크에 연결된 In-Sight 비전 시스템과 상호작용하는 사용자 정의 응용 프로그램을 개발하는데 필요한 플랫폼을 제공합니다. In-Sight SDK로 개발된 프로그램은 Form에 도킹된 단순한 In-Sight 디스플레이 컨트롤부터 작업을 로드하고 영상을 저장하며 다중 I/O 채널을 통해 통신하는 강력한 응용 프로그램에 이르기까지 매우 다양할 수 있습니다.

현지화된 버전을 포함하여 최신 릴리스 정보 및 안내서를 다운로드하려면 In-Sight 온라인 지원 센터를 방문하십시오.

참고: In-Sight Micro 1020, In-Sight 2000 시리즈 및 In-Sight 7020, 7010, 7230, 7430, 7432는 In-Sight SDK에서 지원되지 않습니다.

시스템 요구사항

이 섹션에서는 In-Sight SKD에 대한 시스템 요구사항을 설명하고 있습니다.

PC 하드웨어 최소 및 권장 요구사항

참고:

다음은 저속 생산환경에서 실행되는 단일 저해상도 In-Sight 비전 시스템에 연결된 PC에 대한 최소 하드웨어 요구사항입니다.
다음은 In-Sight 비전 시스템 4대까지 동시에 연결된 PC의 권장 하드웨어 요구사항입니다.

최소	권장
1.8GHz(또는 동급)에서 실행되는 Intel^® Celeron^® 1000M 프로세서	2.7GHz(또는 동급)으로 동작하는 Intel Core™ i7 프로세서
2GB의 가용 RAM	4GB의 가용 RAM
4GB의 가용 하드 디스크 공간	8GB의 가용 하드 디스크 공간
24비트 색으로 1024x768 해상도를 표현할 수 있는 비디오 카드(DPI 디스플레이 설정을 반드시 96DPI로 설정)	32비트 색으로 1920x1080 해상도를 표현할 수 있는 비디오 카드(DPI 디스플레이 설정을 반드시 96DPI로 설정)
In-Sight 비전 시스템 연결용 네트워크 인터페이스 카드(최소 100Mbps)	In-Sight 비전 시스템 연결용 기가비트 네트워크 인터페이스 카드

운영 체제 요구사항

In-Sight 소프트웨어는 다음 운영 체제에서 검사를 마쳤습니다.

Microsoft Windows 10 Professional(64비트)
Microsoft Windows 7 Professional, 서비스 팩 1(64비트)
Microsoft Windows Server 2016

In-Sight SDK가 다른 운영 체제에서 작동할 수 있기는 하지만 상기 요구사항을 충족하지 않는 시스템은 검사되지 않았으며 지원되지 않습니다.

지원 언어

중국어 (Chinese)
영어 (English)
프랑스어 (French)
독일어 (German)
일본어 (Japanese)
한국어 (Korean)
스페인어 (Spanish)

펌웨어 버전 지원

In-Sight 5.7.3 소프트웨어에는 두 가지 펌웨어 버전이 포함되어 있습니다.

In-Sight 5.7.3
In-Sight 4.10.5 PR1

이전 펌웨어 버전의 In-Sight 비전 시스템도 정상 작동할 수 있습니다. 하지만, 이전 펌웨어 버전에서는 일부 기능이 지원되지 않으며 완전한 테스트를 거치지 않았습니다. 최적의 성능을 위해서는 이전 버전 펌웨어를 실행 중인 비전 시스템을 지원되는 최신 펌웨어 버전으로 업데이트하십시오. 전체 모델 및 지원되는 펌웨어 버전 목록은 In-Sight^® 익스플로러 도움말 파일의 펌웨어 버전 항목을 참조하십시오.

In-Sight 펌웨어 5.7.3

In-Sight 5705 및 5705C 비전 시스템
In-Sight 7000 Gen2 시리즈 비전 시스템
In-Sight 8000 시리즈 비전 시스템
In-Sight 9000 시리즈 비전 시스템
In-Sight Advantage Engine

In-Sight 펌웨어 4.10.5 PR1

In-Sight Micro 1000 시리즈 비전 시스템
In-Sight 5000 시리즈 비전 시스템(In-Sight 5705 및 5705C 비전 시스템 제외)
In-Sight 7000 시리즈 비전 시스템(In-Sight 7000 Gen2 시리즈 비전 시스템 제외)

참고:

In-Sight Micro 1020, In-Sight 2000 시리즈 및 In-Sight 7020, 7010, 7230, 7430, 7432는 In-Sight SDK에서 지원되지 않습니다.
In-Sight 5.1.0 이상의 펌웨어를 실행하는 In-Sight 비전 시스템과 통신할 때, 비전 시스템으로 메시지를 보내어 최신 영상 및 결과를 가져와야 합니다. CvsInSightDisplay를 사용했고 이 함수가 표시된 경우에는 자동으로 처리됩니다. 아니면 새로운 결과를 받을 준비가 되었을 때 CvsInSight.AcceptUpdate() 또는 CvsInSightDisplay.AcceptUpdate()를 호출해야 합니다.
In-Sight 4.x.x 펌웨어를 실행하는 In-Sight 비전 시스템과의 통신에는 변화가 없습니다. CvsInSight.AcceptUpdate()를 호출할 필요는 없으며, 영상 및 결과 수신에 영향을 주지 않습니다.

Microsoft .NET Framework 4.5

In-Sight 소프트웨어에는 Microsoft .NET Framework 4.5가 필요합니다. Microsoft .NET Framework 4.5가 PC에서 발견되지 않는 경우, In-Sight 소프트웨어는 먼저 .NET Framework 4.5를 다운로드/설치하려고 시도할 것입니다.

참고: Microsoft .NET Framework 3.5를 이용하지 않는 시스템에서 Windows 업데이트가 진행 중일 때 In-Sight SDK를 설치하려고 하면, 다음의 오류 메시지가 나올 수 있습니다. Microsoft .NET Framework 설치 오류; 오류 코드 0x800f081f. 이 경우, Windows 업데이트가 완료되기를 기다린 후(필요 시 재부팅), In-Sight SDK를 설치하십시오.

지원되는 개발 환경

Microsoft Visual Studio 2013
Microsoft Visual Studio 2015

참고:

ActiveX 제어는 Microsoft Visual Basic 6.0, Rockwell Automation FactoryTalk® View SE(Site Edition) 및 호환되는 ActiveX 호스트 응용 프로그램에서 지원됩니다.
ToolBuilder EasyBuilder 도구를 만들려면, GUID 생성 유틸리티(guidgen.exe)도 필요합니다. 이 유틸리티에는 Microsoft Visual Studio가 포함됩니다. guidgen.exe에 대한 자세한 내용은 MSDN을 참조하십시오.

ToolBuilder 지원

In-Sight SDK는 사용자 정의 간편한 작성기 도구를 생성하는 기능을 지원합니다. 자세한 내용은 ToolBuilder 프로그래머 참조 가이드를 참조하십시오. ToolBuilder로 생성한 모든 EasyBuilder 도구를 In-Sight 익스플로러 응용 프로그램에서 사용하려면 도구를 C:\Program Files (x86)\Cognex\In-Sight\In-Sight Explorer 5.x.x\AddIns 디렉토리에 배치해야 합니다. ToolBuilder를 사용하여 EasyBuilder 도구를 만들려면 도구의 DLL이 In-Sight Explorer 5.x.x\AddIns 디렉터리에 있어야 합니다. 이전에 생성한 ToolBuilder DLL 파일을 모두 복사하여 AddIns 디렉터리에 붙여 넣으십시오.

설치

In-Sight SDK를 설치하려면 모든 관리 권한이 있는 사용자로 로그온해야 합니다.

참고: 다른 버전의 In-Sight 디스플레이 컨트롤 또는 In-Sight SDK를 사용해 개발된 COM/ActiveX 응용 프로그램은 이 버전과 호환되지 않으며 올바르게 작동하지 않습니다. 사용자 정의 응용 프로그램을 이 버전에 맞게 다시 컴파일하거나 원래 버전을 다시 설치해야 합니다. (CR# 5084)

샘플 프로젝트

In-Sight SDK 샘플 프로젝트는 다음 폴더에 설치되어 있습니다. C:\Users\Public\Documents\Cognex\In-Sight\In-Sight Sample Projects 5.x.x. 시작 메뉴의 바로가기를 이용해 이 위치를 열 수 있습니다.

알려진 문제점

참고: Cognex 기술 지원을 통해 신고된 알려진 문제점을 더 쉽게 추적할 수 있도록 문제 번호가 포함되었습니다(해당되는 경우). Cognex In-Sight 디스플레이(CvsInSightDisplay) 컨트롤과 관련된 알려진 문제점은 In-Sight 디스플레이 컨트롤 릴리스 정보를 참조하십시오.

문제#	문제
82151	In-Sight SDK가 CvsInSightDisplay.InSight.File.LoadJobFileLocally () 함수를 이용하여 로컬 PC에서 비전 시스템으로 작업을 로드하지 못합니다. 해결 방법: 로컬 PC에서 비전 시스템으로 작업을 로드할 때 다음 절차를 따르십시오. CvsInSightDisplay.InSight.File.SendFileToInSight () 함수를 이용하여 작업을 로컬 PC에서 비전 시스템으로 보냅니다. CvsInSightDisplay.InSight.File.LoadJobFile () 함수를 이용하여 비전 시스템으로부터 작업을 로드합니다.
31753	업데이트해야 하는 In-Sight SDK 항목(예: CvsInSightDisplay)은 표시된 경우에만 업데이트를 요청하며, 숨겨지거나 최소화되었을 때는 그렇지 않습니다. 해결 방법: 이 시나리오에서 업데이트가 필요한 경우, In-Sight 비전 시스템에서 새로운 결과를 가져와야 할 때 CvsInSight.AcceptUpdate() 및/또는 CvsInSightDisplay.AcceptUpdate() 호출을 추가해야 합니다. CvsInSight.ResultsChanged 이벤트에 핸들러를 연결하는 것이 좋고, 결과가 처리되면 CvsInSight.AcceptUpdate를 호출해야 합니다.
11930	SetExpression 방법을 호출하기 전에 비전 시스템이 오프라인 상태인지 확인하는 것이 좋습니다.

문제#

문제

82151

In-Sight SDK가 CvsInSightDisplay.InSight.File.LoadJobFileLocally () 함수를 이용하여 로컬 PC에서 비전 시스템으로 작업을 로드하지 못합니다.

해결 방법: 로컬 PC에서 비전 시스템으로 작업을 로드할 때 다음 절차를 따르십시오.

CvsInSightDisplay.InSight.File.SendFileToInSight () 함수를 이용하여 작업을 로컬 PC에서 비전 시스템으로 보냅니다.
CvsInSightDisplay.InSight.File.LoadJobFile () 함수를 이용하여 비전 시스템으로부터 작업을 로드합니다.

31753

업데이트해야 하는 In-Sight SDK 항목(예: CvsInSightDisplay)은 표시된 경우에만 업데이트를 요청하며, 숨겨지거나 최소화되었을 때는 그렇지 않습니다.

해결 방법: 이 시나리오에서 업데이트가 필요한 경우, In-Sight 비전 시스템에서 새로운 결과를 가져와야 할 때 CvsInSight.AcceptUpdate() 및/또는 CvsInSightDisplay.AcceptUpdate() 호출을 추가해야 합니다. CvsInSight.ResultsChanged 이벤트에 핸들러를 연결하는 것이 좋고, 결과가 처리되면 CvsInSight.AcceptUpdate를 호출해야 합니다.

11930

SetExpression 방법을 호출하기 전에 비전 시스템이 오프라인 상태인지 확인하는 것이 좋습니다.