Esta página aún no se ha traducido para esta versión. Puede ver la versión más reciente de esta página en inglés.

imfreehand

Crear región a mano alzada arrastrable

no se recomienda.imfreehand Utilice el nuevo objeto de ROI en su lugar.Freehand También puede utilizar la nueva función de conveniencia de creación de ROI.drawfreehand Otra opción es el objeto, que le permite dibujar a mano una forma que sigue automáticamente los bordes de la imagen subyacente.AssistedFreehand Para obtener más información, consulte .Consideraciones de compatibilidad

Descripción

Un objeto encapsula una región a mano alzada interactiva sobre una imagen.imfreehand

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 = imfreehand

h = imfreehand(hparent)

h = imfreehand(___,Name,Value)

Descripción

h = imfreehand comienza la colocación interactiva de una región a mano alzada en los ejes actuales y devuelve un objeto.imfreehand

h = imfreehand(hparent) comienza la colocación interactiva de una región a mano alzada en el objeto especificado por .hparent

h = imfreehand(___,Name,Value) especifica pares nombre-valor que controlan el comportamiento de la región a mano alzada.

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

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 la región a mano alzada. Consulte la ayuda de la función para obtener información sobre los identificadores de función válidos.setPositionConstraintFcn

'Closed' — La región a mano alzada está cerrada

true (predeterminado) | false

La región a mano alzada está cerrada, especificada como el par separado por comas que consta de y o .'Closed'truefalse Cuando se establece en (valor predeterminado), dibuja una línea recta para conectar los puntos finales de la línea a mano alzada para crear una región cerrada.trueimfreehand Si se establece en , deja la región abierta.falseimfreehand

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 miraimfreehandcuando se coloca sobre una imagen. Haga clic y arrastre el ratón para dibujar la región a mano alzada y ajustar la posición de la región. 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.imfreehandClosed

La región a mano alzada también admite un menú contextual que puede usar para controlar aspectos de su apariencia y comportamiento.

La tabla enumera las características interactivas admitidas por .imfreehand

Comportamiento interactivo	Descripción
Mover la región.	Mueva el puntero dentro de la región a mano alzada. El puntero cambia a una forma de fleur. Haga clic y mantenga pulsado el botón izquierdo del ratón para mover la región.
Cambiar el color utilizado para dibujar la región.	Mueva el puntero dentro de la región a mano alzada. Haga clic con el botón derecho y seleccione en el menú contextual.Set Color
Recuperar la posición actual de la región a mano alzada.	Mueva el puntero dentro de la región a mano alzada. Haga clic con el botón derecho y seleccione en el menú contextual. copia una matriz de coordenadas -by-2 en el límite del ROI en el portapapeles.Copy Positionimfreehandn
Eliminación de la región	Mueva el puntero dentro de la región. 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 = imfreehand(); h.Deletable = false;

Funciones del objeto

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

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
setPositionConstraintFcn	Establecer la función de restricción de posición del objeto ROI
wait	(No recomendado) Bloquear la línea de comandos hasta que finalice la creación del ROIMATLAB

Ejemplos

Haga clic y arrastre para colocar la región a mano alzada

Coloque interactivamente una región de interés a mano alzada cerrada haciendo clic y arrastrando sobre una imagen.

imshow('pout.tif') h = imfreehand;    

Mueva interactivamente la región a mano alzada haciendo clic y arrastrando. Utilice la función para bloquear la línea de comandos.waitMATLAB^® Haga doble clic en la región a mano alzada para reanudar la ejecución de la línea de comandos.MATLAB

position = wait(h);  

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 la región a mano alzada fuera de la extensión de la imagen y perder la región a mano alzada.imfreehand Cuando se utiliza con ejes creados por la función, los límites de los ejes se expanden automáticamente para acomodar el movimiento de la región a mano alzada.plot

• Para cancelar la ubicación interactiva, pulse la tecla Esc. devuelve un objeto vacío.imfreehand

Consideraciones de compatibilidad

no se recomiendaimfreehand

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 ROI por el objeto u.imfreehandFreehandAssistedFreehand También puede utilizar las funciones de conveniencia de ROI o .drawfreehanddrawassisted

Actualizar el código de creación de ROI

Actualice todas las instancias de .imfreehand

Uso desalentado	Reemplazo recomendado
Este ejemplo permite dibujar un ROI a mano alzada. imshow('cameraman.tif'); h = imfreehand	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. imshow('cameraman.tif'); h = drawfreehand

Otras actualizaciones del código de ROI

Actualizar código que utiliza cualquiera de las funciones de objeto del objeto DE ROI.imfreehand En muchos casos, puede reemplazar la llamada a una función de objeto simplemente accediendo o estableciendo el valor de una propiedad de objeto de ROI.imfreehandFreehand Por ejemplo, reemplace las llamadas o con el uso de la propiedad.getColorsetColorColor En algunos casos, debe reemplazar la función de objeto con una función de objeto del nuevo ROI.imfreehandFreehand Cada una de las funciones de objeto de ROI individuales incluye información sobre la migración al nuevo objeto de ROI.imfreehandFreehand Para obtener información general sobre la migración, consulte .Migración de ROI

Consulte también

imellipse | imline | impoint | impoly | imrect | imroi | iptgetapi | makeConstrainToRectFcn

Introducido en R2007b