# 이 릴리스로 마이그레이션

이 항목에서는 기존 ViDi 프로젝트를 이전 릴리스에서 현재 릴리스로마이그레이션할 때 기존 프로젝트에 영향을 미칠 수 있는 변경 사항을 다룹니다.

### C 라이브러리 오버레이 함수 사용 중단

ViDi는 결과 그래픽을 표시하기 위해 C API와 .NET API의 두 가지 메커니즘을 제공합니다. 하지만 다음의 C 라이브러리 오버레이 함수는 이 릴리스에서 사용 중단되고 다음 릴리스에서 제거될 것입니다.

- vidi_training_tool_get_overlay ();
- vidi_runtime_sample_get_overlay ();
- vidi_runtime_get_overlay ();
- vidi_training_sample_get_overlay();

미래에 오버레이 그래픽을 이용하려면, Cognex Designer, .NET API, In-Sight ViDi 등을 사용해야 합니다.

### 도구 트레이닝 워크플로의 변경

3.4.0 릴리스에는 도구를 트레이닝하는 데 이용할 이미지/보기를 지정하는 새로운 방법이 있습니다. 이전 버전에서 트레이닝된 도구를 다시 트레이닝하려면, 트레이닝 집합 선택 대화 상자를 통해 새로운 트레이닝 집합 패러다임을 이용하도록 도구를 구성해야 합니다. '트레이닝 집합'과 '트레이닝 집합 선택 대화 상자 이용' 항목을 참고하십시오.

## 이전 릴리스 - ViDi 3.2 - 3.3

- 2.1 이전 버전에서 생성된 작업 영역 아카이브 가져오기가 지원되지 않습니다. ViDi Suite 2.1 이전 버전에서 마이그레이션을 하는 경우, 먼저 3.0, 3.1, 3.2, 3.2.1 버전을 이용해 작업 영역을 가져오고 내보낸 후 ViDi 3.3.0으로 가져와야 합니다.

- ViDi 3.3.0에는 411.31 이상의 NVIDIA 드라이버가 필요합니다.

  업데이트된 NVIDIA 드라이버는 https://www.nvidia.com/download/find.aspx에서 구할 수 있습니다.

  ViDi 드라이버 호환성에 대한 자세한 내용은 https://support.cognex.com/en/downloads/detail/deep-learning/3763/1033를 참고하십시오.

- ViDi3.3.0의 클라이언트/서버 기능이 HTTP통신 프로토콜을 이용하도록 업데이트되었고, 이제 TCP 프로토콜은 지원하지 않습니다. 클라이언트/서버 응용 프로그램에서 HTTP 프로토콜을 이용하려면, 클라이언트와 서버를 모두 ViDi 3.3.0으로 업그레이드해야 합니다. 버전 간 클라이언트/서버 호환성은 없습니다(예: 3.2.1을 실행 중인 클라이언트는 3.2.1을 실행 중인 서버만 연결할 수 있고, 3.3.0을 실행 중인 클라이언트는 3.3.0을 실행 중인 서버만 연결할 수 있음).

  참고 : HTTP 통신은 일반적으로 런타임 이미지 처리시 더 나은 처리량을 제공합니다. 하지만 긴 대기 시간 네트워크 토폴로지에서는 HTTP 통신이 트레이닝 및 개발 중 인터페이스 대기 시간이 늘어날 수 있습니다.

## 이전 릴리스 - ViDi 3.1 - 3.2

### C 라이브러리 함수 사용 중단

다음과 같은 다수의 C 라이브러리 함수가 사용 중단되었습니다.

- 런타임 함수

  참고 : 사용 중단된 함수는 새로운 vidi_runtime_legacy.h 헤더 파일에 있습니다.

  이전 버전 | 새 버전
  --- | ---
  vidi_runtime_get_overlay | 불가
  vidi_runtime_process_sample | vidi_runtime_sample_process
  vidi_runtime_get_image | vidi_runtime_sample_get_image

- 트레이닝 함수

  참고 : 사용 중단된 함수는 새로운 vidi_training_legacy.h 헤더 파일에 있습니다.

  이전 버전 | 새 버전
  --- | ---
  vidi_training_stream_process_sample | vidi_training_sample_process
  vidi_training_blue_add_feature | vidi_training_blue_set_feature
  vidi_training_blue_add_model | vidi_training_blue_create_model
  vidi_training_tool_set_mask | vidi_training_roi_set_mask
  vidi_training_tool_get_mask | vidi_training_roi_get_mask
  vidi_training_ini_sample | vidi_training_add_sample
  vidi_training_process_sample | vidi_training_sample_process

### NuGet 패키지 사용 중단

NuGet 패키지가 사용 중단되었으며, ViDi 설치 파일에 포함되지 않습니다. 이전 ViDi 릴리스에서 NuGet 패키지를 참조하는 런타임 또는 트레이닝 응용 프로그램이 있다면, 이러한 참조를 제거하고 대신 .NET .dll 라이브러리를 참조하게 해야 합니다.

Visual Studio에서 NuGet 패키지를 제거하려면 도구 -> NuGet 패키지 관리자 -> 솔루션용 NuGet 패키지 관리...를 선택하십시오.

.NET .dll을 추가하려면, 프로젝트에서 오른쪽 클릭한 후 추가 -> 참조를 선택하십시오.

## 이전 릴리스 - ViDi 3.0 - 3.1

- Blue 위치 도구에서 모델 일치를 이용할 때 X 및 Y 위치 클램핑의 행태에 변화가 있었습니다. 2.1 버전에서는 이러한 제약이 모델 좌표의 원점 위치에 적용되는 것으로 해석되었습니다. 3.0 버전에서는 모델 내에서 노드의 중심 위치에 대한 제약으로 해석됩니다.