# EditCompositeRegion

Inserta un control interactivo para región combinada en la hoja de cálculo. Cuando se hace clic sobre el control, la pantalla pasa al EditCompositeRegion - Modo gráfico interactivo en el que se puede modificar la región combinada. Una región combinada puede constar de varias subregiones. Una subregión puede ser un Annulus, un Circle, un EditPolygon o una Region. Cada subregión puede combinarse mediante una operación de adición (se incluye en el análisis de la imagen) o de sustracción (se excluye del análisis de la imagen). La operación de sustracción se conoce también con el nombre de "enmascaramiento".

## Abrir la hoja de propiedades de EditCompositeRegion

1. Haga clic con el botón derecho sobre una celda y seleccione Insertar función para abrir el Cuadro de diálogo Insert Function.
2. En la parte izquierda del cuadro de diálogo, expanda la lista de categorías de herramientas gráficas.
3. Seleccione la categoría de herramientas Controles.

4. Seleccione la función EditCompositeRegion de la lista de funciones y pulse el botón Aceptar o haga doble clic sobre el nombre de la función.

   Nota: Para acceder a la Hoja de propiedades de EditCompositeRegion, haga clic con el botón derecho sobre el botón de control de EditCompositeRegion y seleccione Edit Function

## EditCompositeRegion Entradas

## Pestaña General

En la hoja de propiedades EditCompositeRegion, la pestaña General permite definir los parámetros de la función EditCompositeRegion.

Parámetro | Descripción
Imagen | This parameter must reference a spreadsheet cell that contains an Imagen data structure; by default, this parameter references A0, the cell containing the Image data structure returned by function. This parameter can also reference other Imagen data structures, such as those returned by the Vision Tool Funciones Image or Funciones de transformación de coordenadas.
Elemento posicionador | Especifica el sistema de coordenadas de imagen en el que se define la región combinada entrada.
X | El desplazamiento en X del origen, en coordenadas del elemento posicionador.
Y | El desplazamiento en Y del origen, en coordenadas del elemento posicionador.
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)
Agregar subregiones | Si está seleccionada (por defecto), se pueden añadir subregiones mientras se está en el modo gráfico interactivo.
Quitar subregiones | Si está seleccionada (por defecto), se pueden quitar subregiones mientras se está en el modo gráfico interactivo.
Editar subregiones | Si está seleccionada (por defecto), se pueden modificar subregiones mientras se está en el modo gráfico interactivo.
Mover región entera | Si está seleccionada (por defecto), se puede desplazar toda la región combinada mientras se está en el modo gráfico interactivo.
Girar | Si está seleccionada (por defecto), se puede girar toda la región combinada mientras se está en el modo gráfico interactivo.
Nombre | Especifica una etiqueta de texto para el elemento de control de EditCompositeRegion ubicado en la hoja de cálculo.
Mostrar | Especifica el modo de visualización de la superposición gráfica de EditCompositeRegion en la imagen.
0 = ocultar todo | Se ocultará la región combinada, excepto cuando la celda que contiene la función EditCompositeRegion está resaltada en la hoja de cálculo.
2 = sólo gráficos de entrada | Se visualizará la región combinada en todo momento.

Nota: Se pueden añadir como máximo 32 subregiones a una región combinada.

## Pestaña Regiones

En la hoja de propiedades EditCompositeRegion, la pestaña Regiones permite agregar, insertar, eliminar, mover hacia arriba, mover hacia abajo y editar una lista ordenada de subregiones que conforman toda la región combinada. El tipo de subregión puede ser un Annulus, Circle, EditPolygon o Region con el que se realiza una operación de adición o sustracción.

Controles de la pestaña Región

- Agregar: Añade una nueva subregión al final de la lista.
- Insertar: Inserta una nueva subregión por encima de la subregión que está resaltada.
- Quitar: Elimina la subregión resaltada de la lista.
- Mover hacia arriba: Desplaza la subregión resaltada hacia arriba en la lista.
- Mover hacia abajo: Desplaza la subregión resaltada hacia abajo en la lista.

- Propiedades de la subregión: Visualiza las propiedades de la subregión resaltada.

## EditCompositeRegion Secuencia

La región combinada se construye secuencialmente siguiendo el orden de las subregiones en la lista. El área global de la región combinada depende del orden en que se realizan las operaciones con cada subregión.

Por ejemplo:
Al cambiar el orden en el que aparece la subregión de polígono, se modifica la región combinada. El área de la imagen con una trama de líneas azules se excluye del análisis de la imagen.

# | Tipo | Operación
--- | --- | ---
1 | Región | Agregar
2 | Círculo | Agregar
3 | Polígono | Sustraer
# | Tipo | Operación
--- | --- | ---
1 | Región | Agregar
2 | Polígono | Sustraer
3 | Círculo | Agregar

Nota: Se puede cambiar el orden de aparición de una subregión. Para ello hay que acceder a la pestaña Regiones de la hoja de propiedades de EditCompositeRegion, seleccionar allí la subregión en cuestión y desplazarla a la posición deseada mediante Mover hacia arriba o Mover hacia abajo.

## EditCompositeRegion Salida

Resultados | Un control de botón etiquetado.