# ScaleImage

La función ScaleImage cambia el número de píxeles de una imagen de entrada o región de interés (RDI) para generar una versión reducida o ampliada, sin giros o encorvamientos, de la imagen. La función visualiza la imagen así generada en la esquina superior izquierda de la hoja de cálculo del In-Sight.

## ScaleImage Entradas

Parámetro | Descripción
Imagen | Este parámetro ha de utilizar Referencias de celda contenidas en una celda de la hoja de cálculo que contiene una estructura de datos Imagen; por defecto, este parámetro hace referencia a A0, la celda que contiene la estructura de datos Image devuelta por la función . Este parámetro puede hacer también referencia a otras estructuras de datos Image, como las devueltas por las Funciones Image del conjunto Vision Tools.
Elemento posicionador | Define la región de interés (RDI) con relación a un Fixture entrado o al sistema de coordenadas de imagen proporcionado por una función de Vision Tools. Establecer la RDI con relación al un elemento posicionador permite asegurar que si se gira o desplaza el elemento posicionador, se girará o desplazará en consonancia la RDI, manteniéndose fija la relación entre ambos. El valor de configuración predeterminado es (0,0,0), la esquina superior izquierda de la imagen.
X | El desplazamiento en X, en coordenadas de la imagen.
Y | El desplazamiento en Y, en coordenadas de la imagen.
Theta | La rotación desde el eje X de la imagen, en el sistema de coordenadas de imagen. (+/-360 grados en el sentido de las agujas del reloj)
Región | También conocida como región de interés (RDI), especifica la región de la imagen que se somete a análisis. Haga doble clic sobre el parámetro Región para crear un Modo gráfico interactivo que permite transformar y girar. Seleccione este parámetro y pulse el botón «Maximizar región» en la barra de herramientas de edición de tareas de la hoja de propiedades a fin de expandir automáticamente la región hasta cubrir toda la imagen.
X | El desplazamiento en X del origen, en coordenadas del elemento posicionador.
Y | El desplazamiento en Y del origen, en coordenadas del elemento posicionador.
Ancho | El tamaño de la región en la dirección del eje X.
Altura | El tamaño de la región en la dirección del eje Y.
Ángulo | La orientación en coordenadas del elemento posicionador.
Curva | La desviación angular entre el eje X de la región y la línea limítrofe del lado opuesto.
Escala X | Especifica el porcentaje de escalado a aplicar en la dirección X de la región(10–1000; por defecto = 50.) Nota: Valores entre 100 y 1000 especifican aumento de escala. Por ejemplo, si los dos porcentajes especificados son de 200, la imagen remuestreada será el doble de grande que la región especificada.
Escala Y | Especifica el porcentaje de escalado en la dirección Y de la región(10–1000; por defecto = 50.) Nota: Valores entre 100 y 1000 especifican aumento de escala. Por ejemplo, si los dos parámetros de escala están configurados con el valor de 200, la imagen generada será el doble de grande que la región especificada.
Pantalla X | Especifica la coordenada X (por defecto = 0), definida con respecto a la esquina superior izquierda, en la que se visualizará la imagen escalada. Nota: Si se especifica un valor de -1, la función situará la imagen escalada en la misma coordenada X que la de la imagen de entrada: Si la imagen tratada es una imagen capturada, se utilizará la coordenada X inicial especificada en la función . Por ello, si se configura una función ScaleImage con los parámetros Pantalla X y Pantalla Y ambos puestos en (0,0) y la imagen es una parte de una imagen capturada, la función ScaleImage situará la imagen que proporciona exactamente encima de la imagen capturada. Si la imagen es una proporcionada por otra función del conjunto Vision Tools, por ejemplo, la herramienta de tratamiento de Imagen denominada Filter, se utilizará la coordenada X que define la imagen de entrada. Por ejemplo, si la función PointFilter tiene definidas las coordenadas X/Y en 100/100, entonces la función de referencia ScaleImage, configurada con un valor -1, visualizará la imagen en la coordenada X igual a 100.
Pantalla Y | Especifica la coordenada Y (por defecto = 0), definida con respecto a la esquina superior izquierda, en la que se visualizará la imagen escalada.
Mostrar | Especifica qué superposiciones gráficas han de visualizarse sobre la imagen.
0 = ocultar todo (por defecto) | Se ocultarán la imagen generada y los contornos de la región de entrada, excepto cuando la celda que contiene la función ScaleImage está seleccionada en la hoja de cálculo.
1 = solo gráficos de resultados | Se visualizará en todo momento la imagen ampliada o reducida en número de píxeles.
2 = sólo gráficos de entrada | Se visualizará en todo momento el contorno de la región de entrada.

## ScaleImage Salidas

Devuelve | Una estructura de datos Image que contiene la imagen procesada, o #ERR si alguno de los parámetros de entrada no es válido.

## Ejemplo con ScaleImage

En este ejemplo, el objeto de la imagen de entrada es una botella. El propósito de este ejemplo es escalar al 50% el tamaño de la botella.

Tras insertar la función en la hoja de cálculo de In-Sight, el usuario define la RDI haciendo doble clic sobre la palabra «Region» en la hoja de propiedades, tras lo cual desaparece la hoja y se visualiza el recuadro rojo de la RDI sobre la imagen. El usuario desplaza el recuadro o cambia su tamaño utilizando el cursor y hace clic sobre el botón OK en la barra de herramientas de edición de tareas para confirmar la selección y volver a la hoja de propiedades. (Se puede confirmar también la selección pulsando la tecla Entrar o haciendo doble clic sobre la RDI).

Tras escribir «50» en los campos «X Scale» e «Y Scale», aceptar la configuración predeterminada de los demás parámetros y hacer clic sobre OK en la hoja de propiedades, se completa la configuración de este ejemplo y se aplica la función a la imagen de entrada.

A continuación, puede verse una imagen escalada al 50% de la botella.

Se puede utilizar también la función ScaleImage para «enderezar» objetos o «deshacer la posición girada» de objetos, lo que puede facilitar la tarea a otras herramientas que utilicen como referencia la imagen procesada. En el siguiente ejemplo, el objeto es un segmento ligeramente curvado que se visualiza sin superposiciones (lo que se consigue haciendo clic sobre Overlay en el menú View). Se quiere escalar también este segmento al 50% de su tamaño actual para que tanto la imagen de entrada como la de salida puedan caber fácilmente en la misma vista.

Tras insertar la función, definir la RDI y especificar «50» en los campos «X Scale» e «Y Scale» de la hoja de propiedades (descritos anteriormente en el ejemplo de la botella), el usuario incrementa los valores indicados en los campos Angle y Curve (situados bajo el parámetro Region) hasta ver el objeto enderezado. Tras aceptar los ajustes predeterminados de los demás parámetros y hacer clic sobre OK en la hoja de propiedades, se completa la configuración para este ejemplo y se aplica la función a la imagen entrada. A continuación, puede verse una imagen del objeto doblado por el centro y, en la esquina superior izquierda, la imagen de la versión más pequeña y «enderezada» del objeto.

En este ejemplo, se utilizó un ángulo de 17.390 y un valor de curva de -36.389 para enderezar el segmento curvado.