# Migración a esta versión

Este tema contiene información sobre los cambios que pueden afectar a los proyectos de ViDi existentes al migrar proyectos de versiones anteriores a la actual.

## Cambios en la visualización de los gráficos superpuestos

En las versiones 3.4.0 y 4.1.0 posteriores, se han modificado los métodos abreviados de teclado que se usan para mostrar y ocultar los gráficos superpuestos en el área de visualización de imágenes. Las nuevas combinaciones de teclas son las siguientes:

- La tecla Alt más la tecla de flecha derecha o la tecla Alt más la tecla de flecha izquierda

Se utilizan para alternar entre las combinaciones de gráficos de visualización disponibles (etiquetas, marcas, etiquetas y marcas, o ningún gráfico superpuesto).

En versiones anteriores, la barra espaciadora podía usarse para mostrar u ocultar todos los gráficos superpuestos, pero ya no es así.

## Cambios en el flujo de trabajo para entrenar herramientas

En la versión 3.4.0, hay un nuevo método para especificar las imágenes/vistas que se utilizarán para entrenar una herramienta. Si va a volver a entrenar una herramienta que ya fue entrenada en una versión anterior, deberá configurarla para que use el nuevo paradigma de conjunto de entrenamiento a través del cuadro de diálogo Seleccionar conjunto de entrenamiento. Consulte los temas Conjunto de entrenamiento y Usar el cuadro de diálogo Seleccionar conjunto de entrenamiento.

## Cambios en la sintaxis del filtro de característica

En la versión 3.4.0, se modificó la sintaxis del parámetro de procesamiento Filtro de característica de la herramienta. Si estaba usando width (anchura) y height (altura) en su expresión, ahora deben calificarse con view (vista), p. ej. view.width y view.height.

Por ejemplo, en la versión 3.2 y anteriores, la sintaxis utilizada para limitar las características encontradas a aquellas en las que el centro de la característica se halla dentro de la ROI habría sido la siguiente:

x < width and x > 0 and y > 0 and y < height

En 3.4.0 y posteriores, ahora debe expresarse de la siguiente manera:

x < view.width and x > 0 and y > 0 and y < view.height

Nota:

Esta sintaxis también puede expresarse más fácilmente usando el operador in. Por ejemplo, la siguiente sintaxis podría utilizarse para simplificar la expresión:

x in [0,view.width] and y in [0,view.height]

## Funciones de superposición de la biblioteca C en desuso

ViDi proporciona dos mecanismos, la API de C y la API de .NET, para mostrar gráficos de resultados. Sin embargo, las siguientes funciones de gráficos superpuestos de la biblioteca C están en desuso en esta versión y se eliminarán en la siguiente:

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

Para acceder a los gráficos superpuestos en el futuro, deberá utilizar Cognex Designer, la API de .NET o In-Sight ViDi.

## Versiones anteriores: ViDi 3.2 a 3.3

- No se admite la importación de archivos de espacios de trabajo creados con la versión 2.1 o anteriores. Si está migrando desde la versión 2.1 o anterior de ViDi Suite, primero debe importar y luego exportar sus espacios de trabajo usando la versión 3.0, 3.1, 3.2 o 3.2.1 para poder importarlos a ViDi 3.3.0.

- ViDi 3.3.0 requiere el uso de una versión del controlador NVIDIA superior o igual a 411.31.

  Para obtener los controladores actualizados de NVIDIA, visite: https://www.nvidia.com/download/find.aspx

  Para obtener más información sobre la compatibilidad de los controladores de ViDi, visite: https://support.cognex.com/en/downloads/detail/deep-learning/3763/1033

- Se ha actualizado la funcionalidad de cliente/servidor de ViDi 3.3.0 para que use el protocolo de comunicación HTTP, y ya no es compatible con el protocolo TCP. Para utilizar el nuevo protocolo HTTP en su aplicación cliente/servidor, debe actualizar tanto el cliente como el servidor a ViDi 3.3.0. No hay compatibilidad entre versiones de cliente/servidor (p. ej., los clientes que se ejecuten en la versión 3.2.1 solo pueden conectarse a los servidores que se ejecuten en la 3.2.1, y los clientes que se ejecuten en la 3.3.0 solo pueden conectarse a los servidores que se ejecuten en la 3.3.0).

  Nota: En general, las comunicaciones HTTP ofrecen una mejor capacidad de proceso para el procesamiento de imágenes en tiempo de ejecución. Sin embargo, para topologías de red de latencia alta, las comunicaciones HTTP pueden aumentar la latencia de la interfaz durante el entrenamiento y el desarrollo.

## Versiones anteriores: ViDi 3.1 a 3.2

### Funciones de biblioteca C obsoletas

Han quedado obsoletas varias funciones de la biblioteca C, como se indica a continuación:

- Funciones de tiempo de ejecución

  Nota: Las funciones obsoletas se encuentran en un nuevo archivo de encabezado vidi_runtime_legacy.h.

  Versión anterior | Nueva versión
  --- | ---
  vidi_runtime_get_overlay | No disponible
  vidi_runtime_process_sample | vidi_runtime_sample_process
  vidi_runtime_get_image | vidi_runtime_sample_get_image

- Funciones de entrenamiento

  Nota: Las funciones obsoletas se encuentran en un nuevo archivo de encabezado vidi_training_legacy.h.

  Versión anterior | Nueva versión
  --- | ---
  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

### Paquetes NuGet obsoletos

El uso de paquetes NuGet ha quedado obsoleto y ya no se incluyen en el instalador de ViDi. Si tiene aplicaciones en tiempo de ejecución y/o de entrenamiento que hagan referencia a los paquetes NuGet de una versión anterior de ViDi, tendrá que eliminar dichas referencias y sustituirlas por referencias a las bibliotecas .dll de .NET.

Para eliminar los paquetes NuGet en Visual Studio, seleccione Herramientas -> Administrador de paquetes NuGet -> Administrar paquetes NuGet para la solución...

Para agregar los .dll de .NET en su proyecto, haga clic derecho y seleccione Agregar -> Referencia.

## Versiones anteriores: ViDi 3.0 a 3.1

- Se ha hecho un cambio para la herramienta de localización azul en el comportamiento de la fijación de las posiciones X e Y al utilizar la coincidencia de modelos. En la versión 2.1, se interpretaba que estas restricciones se aplicaban a la posición del origen de las coordenadas del modelo. En la versión 3.0, se interpretan como restricciones en la posición del centroide de los nodos en el modelo.