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.

impoint

Crear punto arrastrable

no se recomienda.impoint Utilice el nuevo objeto de ROI en su lugar.Point También puede utilizar la nueva función de conveniencia de creación de ROI.drawpoint Para obtener más información, consulte .Consideraciones de compatibilidad

Descripción

Un objeto encapsula un punto interactivo sobre una imagen.impoint

Puede ajustar la posición del punto con el ratón. El punto también tiene un menú contextual que controla los aspectos de su apariencia y comportamiento. Para obtener más información, consulte .Uso

Creación

Sintaxis

h = impoint

h = impoint(hparent)

h = impoint(hparent,position)

h = impoint(hparent,x,y)

h = impoint(___,Name,Value)

Descripción

h = impoint comienza la colocación interactiva de un punto en los ejes actuales y devuelve un objeto.impoint

h = impoint(hparent) comienza la colocación interactiva de un punto en el objeto especificado por .hparent

h = impoint(hparent,position) crea un punto arrastrable con coordenadas definidas por .position

h = impoint(hparent,x,y) crea un punto arrastrable con - y -coordenadas del punto definido por y .xyxy

h = impoint(___,Name,Value) especifica pares nombre-valor que controlan el comportamiento del punto.

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 del punto

Vector de 2 elementos

Posición del punto, especificada como un vector de 2 elementos de la forma.[x y]

x, y — - o -coordenada del puntoxy

escalar numérico

- o -coordenada del punto, especificado como un escalar numérico.xy

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

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 miraimpointcuando sobre la imagen. Haga clic y arrastre el ratón para especificar la posición del punto. El punto admite un menú contextual que puede usar para controlar aspectos de su apariencia y comportamiento.

La tabla describe el comportamiento interactivo admitido por .impoint

Comportamiento interactivo	Descripción
Mover el punto.	Mueva el puntero del ratón sobre el punto. El puntero del ratón cambia a una forma de fleur. Haga clic y arrastre el ratón para mover el punto.
Cambiar el color utilizado para mostrar el punto.	Mueva el puntero del ratón sobre el punto. Haga clic con el botón derecho y seleccione en el menú contextual y especifique el color que desea utilizar.Set Color
Recuperar las coordenadas del punto.	Mueva el puntero del ratón sobre el punto. Haga clic con el botón derecho y seleccione en el menú contextual para copiar una matriz 1 por 2 en el portapapeles especificando las coordenadas del punto.Copy Position[X Y]
Eliminación del punto	Mueva el puntero enlació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 = impoint(); h.Deletable = false;

Funciones del objeto

Cada objeto admite una serie de funciones.impoint Escriba para ver una lista completa.methods impoint

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
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
setString	Establecer etiqueta de texto para el objeto de ROI de punto
wait	(No recomendado) Bloquear la línea de comandos hasta que finalice la creación del ROIMATLAB

Ejemplos

Aplicar restricción de contorno cuando se mueve punto

Utilice funciones para establecer el color personalizado, establecer una etiqueta, aplicar una restricción de contorno y actualizar la posición en el título a medida que se mueve el punto.impoint

imshow('rice.png') h = impoint(gca,100,200);

Actualice el título con la nueva posición utilizando .addNewPositionCallback

addNewPositionCallback(h,@(h) title(sprintf('(%1.0f,%1.0f)',h(1),h(2))));

Construir una función de restricción de contorno mediante .makeConstrainToRectFcn

fcn = makeConstrainToRectFcn('impoint',get(gca,'XLim'),get(gca,'YLim')); 

Aplique la función de restricción de contorno mediante .setPositionConstraintFcn

setPositionConstraintFcn(h,fcn); setColor(h,'r'); setString(h,'Point label');

Haga clic y arrastre para mover punto

Coloque interactivamente un punto. Se utiliza para bloquear la línea de comandos.waitMATLAB^® Haga doble clic en el punto a la ejecución de la línea de comandosresumeMATLAB

imshow('pout.tif') h = impoint(gca,[]); 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 arrastre, los usuarios pueden arrastrar el punto fuera de la extensión de la imagen y perder el punto.impoint Cuando se utiliza con ejes creados por la función, los límites de los ejes se expanden automáticamente para acomodar el movimiento del punto.plot

Consideraciones de compatibilidad

no se recomiendaimpoint

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 nuevo objeto ROI.impointPoint También puede utilizar la función de conveniencia de creación de ROI.drawpoint

Actualizar el código de creación de ROI

Actualice todas las instancias de .impoint

Uso desalentado	Reemplazo recomendado
En este ejemplo se crea un ROI de puntos. imshow('cameraman.tif'); h = impoint(gca,[25 50]);	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 tamaño y posición como un par de nombre, valor imshow('cameraman.tif'); h = drawpoint(gca,'Position',[25 50]);

Otras actualizaciones del código de ROI

Actualizar código que utiliza cualquiera de las funciones de objeto del objeto DE ROI.impoint 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.impointPoint 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.impointPoint Cada una de las funciones de objeto de ROI individuales incluye información sobre la migración al nuevo objeto de ROI.impointPoint Para obtener información general sobre la migración, consulte .Migración de ROI

Consulte también

imellipse | imfreehand | imline | impoly | imrect | imroi | makeConstrainToRectFcn

Introducido antes de R2006a