impoly

Crear polígono arrastrable y redimensionable

no se recomienda.impoly Utilice el nuevo objeto en su lugar.Polygon También puede utilizar la nueva función de conveniencia de creación de ROI.drawpolygon Otra opción es el objeto, que le permite crear un polígono abierto o una forma.PolylinePolilínea Para obtener más información, consulte .Consideraciones de compatibilidad

Descripción

Un objeto encapsula un polígono interactivo sobre una imagen.impoly

Puede agregar vértices y ajustar el tamaño y la posición del polígono utilizando el ratón. El polígono también tiene un menú contextual que controla aspectos de su apariencia y comportamiento. Para obtener más información, consulte .Uso

Creación

Sintaxis

h = impoly

h = impoly(hparent)

h = impoly(hparent,position)

h = impoly(___,Name,Value)

Descripción

h = impoly comienza la colocación interactiva de un polígono en los ejes actuales y devuelve un objeto.impoly

h = impoly(hparent) comienza la colocación interactiva de un polígono en el objeto especificado por .hparent

h = impoly(hparent,position) crea un polígono arrastrable y redimensionable con vértices en coordenadas definidas por .position

h = impoly(___,Name,Value) especifica pares nombre-valor que controlan el comportamiento del polígono.

Argumentos de entrada

hparent — Controlar al objeto primario

Manejar

Controlar el objeto primario, especificado como un identificador. El elemento primario suele ser un objeto de ejes, pero también puede ser cualquier otro objeto que pueda ser el elemento primario de un objeto.hggroup

position — Posición de los vértices poligonales

Matriz -by-2n

Posición de vértices poligonales, especificados como una matriz -by-2.n Las dos columnas definen la coordenada - y -, respectivamente, de cada uno de los vértices.xyn

Argumentos de par nombre-valor

Especifique pares opcionales separados por comas de argumentos. es el nombre del argumento y es el valor correspondiente. deben aparecer entre comillas.Name,ValueNameValueName Puede especificar varios argumentos de par de nombre y valor en cualquier orden como .Name1,Value1,...,NameN,ValueN

'PositionConstraintFcn' — Función de restricción de posición

manija de la función

Función de restricción de posición, especificada como el par separado por comas que consta de y un identificador de función. se llama cada vez que se arrastra el ratón.'PositionConstraintFcn'fcn Puede utilizar esta función para controlar dónde se puede arrastrar el polígono. Consulte la ayuda de la función para obtener información sobre los identificadores de función válidos.setPositionConstraintFcn

'Closed' — El polígono está cerrado

true (predeterminado) | false

El polígono está cerrado, especificado como el par separado por comas que consta de y o .'Closed'truefalse Cuando se establece en (valor predeterminado), crea un polígono cerrado, es decir, dibuja una línea recta entre el último vértice especificado y el primer vértice especificado para crear una región cerrada.trueimpoly Cuando es , no conecta el último vértice con el primer vértice, creando un polígono abierto (o polilínea).Closedfalseimpoly

Tipos de datos: logical

Propiedades

Deletable — El ROI se puede eliminar

true (predeterminado) | false

El ROI se puede eliminar, especificar como o .truefalse

Tipos de datos: logical

Uso

Cuando se llama con una sintaxis interactiva, el puntero cambia a un punto de miraimpolycuando sobre la imagen. Haga clic y arrastre el ratón para definir los vértices del polígono y ajustar el tamaño, la forma y la posición del polígono. De forma predeterminada, dibuja una línea recta que conecta el último punto que dibujó con el primer punto, pero puede controlar este comportamiento mediante el parámetro.impolyClosed

El polígono también admite un menú contextual que puede utilizar para controlar aspectos de su apariencia y comportamiento. Las opciones del menú contextual varían tanto si coloca el puntero en un borde del polígono (o en cualquier lugar dentro de la región) como en uno de los vértices. La figura muestra el menú contextual cuando el puntero está en el polígono pero no en un vértice.

La tabla enumera los comportamientos interactivos admitidos por .impoly

Comportamiento interactivo	Descripción
Cerrando el polígono.	Utilice cualquiera de los siguientes mecanismos: Mueva el puntero sobre el vértice inicial del polígono seleccionado. El puntero cambia a un círculo. Haga clic en cualquiera de los botones del ratón. Haga doble clic en el botón izquierdo del ratón. Esta acción crea un vértice en el punto debajo del ratón y dibuja una línea recta que conecta este vértice con el vértice inicial. Haga clic con el botón derecho del ratón. Esta acción dibuja una línea que conecta el último vértice seleccionado con el vértice inicial; no crea un nuevo vértice.
Agregar un nuevo vértice.	Mueva el puntero sobre un borde del polígono. Mantenga pulsada la tecla .Un La forma del puntero cambia. Haga clic en el botón izquierdo del ratón para crear un nuevo vértice en esa posición en la línea.
Mover un vértice. (Remodelar el polígono.)	Mueva el puntero sobre un vértice. El puntero cambia a un círculo. Haga clic y arrastre el vértice a su nueva posición.
Eliminación de un vértice.	Mueva el puntero sobre un vértice. La forma cambia a un círculo. Haga clic con el botón derecho y seleccione en el menú contextual de vértices.Delete Vertex Esta acción elimina el vértice y ajusta la forma del polígono, dibujando una nueva línea recta entre los dos vértices que eran vecinos del vértice eliminado.
Eliminación del polígono	Mueva el puntero dentro del polígono o en una de las líneas que definen el polígono, no en un vértice. Haga clic con el botón derecho y seleccione en el menú contextual.Delete Para quitar esta opción del menú contextual, establezca la propiedad en false:Deletableh = impoly(); h.Deletable = false;
Mover el polígono.	Mueva el puntero dentro del polígono. El puntero cambia a una forma de fleur. Haga clic y arrastre el ratón para mover el polígono.
Cambiar el color del polígono	Mueva el puntero dentro del polígono. Haga clic con el botón derecho y seleccione en el menú contextual.Set Color
Recuperar las coordenadas de los vértices	Mueva el puntero dentro del polígono. Haga clic con el botón derecho y seleccione en el menú contextual. copia una matriz -by-2 que contiene las coordenadas - y -de cada vértice en el portapapeles. es el número de vértices que especificó.Copy Positionimpolynxyn

Funciones del objeto

Cada objeto admite una serie de métodos.impoly Escriba para ver una lista completa.methods impoly

addNewPositionCallback	Añadir devolución de llamada de nueva posición al objeto ROI
createMask	Crear máscara dentro de la imagen
delete	Delete handle object
getColor	Obtener el color utilizado para dibujar objetos de ROI
getPosition	Devolver la posición actual del objeto ROI
getPositionConstraintFcn	Mango de función de retorno a la función de restricción de posición actual
removeNewPositionCallback	Eliminar devolución de llamada de nueva posición del objeto ROI
resume	(No recomendado) Reanudar la ejecución de la línea de comandosMATLAB
setClosed	Establecer el comportamiento de cierre del objeto ROI
setColor	Establecer el color utilizado para dibujar el objeto ROI
setConstrainedPosition	Establezca el objeto de ROI en una nueva posición
setPosition	Mover el objeto ROI a una nueva posición
setPositionConstraintFcn	Establecer la función de restricción de posición del objeto ROI
setVerticesDraggable	Establecer el comportamiento de vértices del objeto ROI
wait	(No recomendado) Bloquear la línea de comandos hasta que finalice la creación del ROIMATLAB

Ejemplos

Dibujar polígono en la imagen y especificar la función de restricción de posición

Mostrar una imagen.

imshow('gantrycrane.png')

Dibuje un polígono en la imagen, especificando la ubicación de cinco vértices.

h = impoly(gca,[188,30; 189,142; 93,141; 13,41; 14,29]);

Establezca el color del polígono en amarillo.

setColor(h,'yellow');

Defina una función para la nueva devolución de llamada de posición. Esta función muestra la posición actual del polígono cada vez que se mueve.

addNewPositionCallback(h, @(p) title(mat2str(p,3))); 

Cree la función que restringe el movimiento del polígono utilizando , especificando el límite de la imagen como límites.makeConstrainToRectFcn Aplique la función de restricción de contorno mediante .setPositionConstraintFcn

fcn = makeConstrainToRectFcn('impoly',get(gca,'XLim'),get(gca,'YLim')); setPositionConstraintFcn(h,fcn); 

Crear interactivamente un polígono haciendo clic para especificar ubicaciones de vértices

Visualizar imagen.

figure imshow('gantrycrane.png');

Cree un polígono, especificando varios vértices, pero déjelo sin terminar para que pueda terminarlo de forma interactiva. El ejemplo se establece en para que el polígono se deja abierto.Closedfalse Al mover el cursor sobre uno de los puntos finales del polígono, la forma del cursor cambia a un círculo.

h = impoly(gca,[203,30; 202,142; 294,142],'Closed',false); 

Complete el polígono. Coge uno de los extremos de las líneas existentes. Extienda la línea arrastrándola a otra esquina de la forma que desee crear. A continuación, mientras coloca el cursor sobre la línea, mantenga pulsada la tecla para añadir un vértice a la línea.A Una vez creado el vértice, puede arrastrarlo a cualquier lugar que desee para crear la forma que desee. Continúe arrastrando la línea y agregando vértices como desee. Para obtener más información, consulte .Uso

Sugerencias

Si utiliza con un eje que contiene un objeto de imagen y no especifica una función de restricción de posición, los usuarios pueden arrastrar el polígono fuera de la extensión de la imagen y perder el polígono.impoly Cuando se utiliza con un eje creado por la función, los límites de los ejes se expanden automáticamente cuando el polígono se arrastra fuera de la extensión de los ejes.plot

Consideraciones de compatibilidad

no se recomiendaimpoly

No se recomienda a partir de R2018b

A partir de R2018b, un nuevo conjunto de objetos de ROI reemplaza al conjunto existente de objetos de ROI. Los nuevos objetos proporcionan capacidades más funcionales, como la transparencia del color de la cara. Las nuevas clases también admiten eventos que puede usar para responder a cambios en el ROI, como mover o hacer clic en ellos. Aunque no hay planes para eliminar los objetos de ROI antiguos en este momento, cambie a los nuevos ROI para aprovechar las capacidades adicionales y la flexibilidad. Para obtener más información sobre la creación de ROI mediante las nuevas funciones de ROI, consulte .Descripción general de la creación del ROI

Reemplace el uso del objeto por el objeto u.impolyPolygonPolyline También puede utilizar la función o para crear estos objetos.drawpolygondrawpolyline

Actualizar el código de creación de ROI

Actualice todas las instancias de .impoly

Uso desalentado	Reemplazo recomendado
En este ejemplo se crea un ROI poligonal cerrado. imshow('cameraman.tif'); h = impoly(gca,[10 10; 10 100; 80 100]);	Aquí hay código equivalente, reemplazando el objeto de ROI antiguo con el nuevo objeto de ROI. En este ejemplo se utiliza la función de conveniencia de creación de ROI. Tenga en cuenta que debe especificar la información de posición como un par de nombre, valor imshow('cameraman.tif'); h = drawpolygon(gca,'Position',[10 10; 10 100; 80 100]);

Otras actualizaciones del código de ROI

Actualizar código que utiliza cualquiera de los métodos de objeto del objeto de ROI.impoly En muchos casos, puede reemplazar la llamada a un método de objeto simplemente accediendo o estableciendo el valor de una propiedad de objeto de ROI.impolyPolygon Por ejemplo, reemplace las llamadas o con el uso de la propiedad.getColorsetColorColor En algunos casos, debe reemplazar el método de objeto con un método de objeto del nuevo ROI.impoly La documentación de cada método de objeto de ROI incluye información sobre la migración al nuevo objeto de ROI.impoly Para obtener información general sobre la migración, consulte .Migración de ROI

Consulte también

imellipse | imfreehand | imline | impoint | imrect | imroi | makeConstrainToRectFcn

Introducido en R2007b