impoint

(No recomendado) Crear un punto que se pueda arrastrar

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

Descripción

Un objeto impoint encapsula un punto interactivo sobre una imagen.

Puede ajustar el tamaño y la posición del punto con el ratón. El punto 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 = impoint

h = impoint(hparent)

h = impoint(hparent,position)

h = impoint(hparent,x,y)

h = impoint(___,"PositionConstraintFcn",fcn)

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 que se puede arrastrar con las coordenadas definidas por position.

h = impoint(hparent,x,y) crea un punto que se puede arrastrar con las coordenadas (x, y) definidas por x e y.

h = impoint(___,"PositionConstraintFcn",fcn) también especifica a dónde se puede arrastrar el punto utilizando una función de restricción de posición, fcn.

Argumentos de entrada

hparent — Identificador del objeto principal

Identificador

Identificador del objeto principal, especificado como identificador. El objeto principal es normalmente un objeto de ejes, pero también puede ser cualquier otro objeto que pueda ser el objeto principal de un objeto hggroup.

position — Posición del punto

Vector de 2 elementos

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

x — Coordenada x del punto

Escalar numérico

Coordenada x del punto, especificada como un escalar numérico.

y — Coordenada y del punto

Escalar numérico

Coordenada y del punto, especificada como un escalar numérico.

fcn — Función de restricción de posición

identificador de función

Función de restricción de posición, especificada como un identificador de función. Se llama a fcn siempre que se arrastra el ratón. Puede utilizar esta función para controlar a dónde puede arrastrarse la elipse. Para obtener información sobre identificadores de función válidos, consulte la ayuda para la función setPositionConstraintFcn.

Propiedades

Deletable — La ROI se puede eliminar

true (predeterminado) | false

La ROI se puede eliminar, especificado como true o false.

Tipos de datos: logical

Uso

Cuando llama a impoint con una sintaxis interactiva, el puntero cambia a un retículo cuando está sobre la imagen. Haga clic y arrastre con el ratón para especificar la posición del punto. El punto también admite un menú contextual que puede utilizar para controlar aspectos de su apariencia y comportamiento.

En esta tabla, se describen los comportamientos interactivos compatibles con impoint.

Comportamiento interactivo	Descripción
Mover el punto	Mueva el puntero del ratón sobre el punto. El puntero cambia a una forma de flor . Haga clic y arrastre con el ratón para mover el rectángulo.
Cambiar el color usado para mostrar el punto	Mueva el puntero del ratón sobre el punto. Haga clic con el botón secundario, seleccione Set Color en el menú contextual y especifique el color que desea utilizar.
Recuperar las coordenadas del punto	Mueva el puntero del ratón sobre el punto. Haga clic con el botón secundario y seleccione Copy Position en el menú contextual para copiar un arreglo de 1 por 2 en el portapapeles que especifica las coordenadas del punto [X Y].
Eliminar el punto	Mueva el puntero sobre el punto. Haga clic con el botón secundario y seleccione Delete en el menú contextual. Para eliminar esta opción del menú contextual, establezca la propiedad Deletable en false: h = impoint(); h.Deletable = false;

Funciones del objeto

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

addNewPositionCallback	Add new-position callback to ROI object
createMask	(No recomendado) Crear una máscara dentro de una imagen
delete	Delete handle object
getColor	Obtener el color utilizado para dibujar un objeto de ROI
getPosition	Devolver la posición actual de un objeto de ROI
getPositionConstraintFcn	Return function handle to current position constraint function
removeNewPositionCallback	Remove new-position callback from ROI object
resume	(Not recommended) Resume execution of MATLAB command line
setColor	(No recomendado) Establecer el color utilizado para dibujar un objeto de ROI
setConstrainedPosition	Set ROI object to new position
setPosition	(Not recommended) Move ROI object to new position
setPositionConstraintFcn	Set position constraint function of ROI object
setString	Set text label for point ROI object
wait	(Not recommended) Block MATLAB command line until ROI creation is finished

Ejemplos

Aplicar la restricción de límites cuando se desplaza un punto

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

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))));

Construya una función de restricción de límites utilizando makeConstrainToRectFcn.

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

Aplique la función de restricción de límites utilizando setPositionConstraintFcn.

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

Hacer clic y arrastrar para mover un punto

Coloque un punto de manera interactiva. Utilice wait para bloquear la línea de comandos de MATLAB^®. Haga doble clic en el punto para resume (continuar) la ejecución de la línea de comandos de MATLAB.

imshow("pout.tif")
h = impoint(gca,[]);
position = wait(h);

Sugerencias

Si utiliza impoint con ejes que contienen 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 soltarlo. Cuando se utiliza con un eje creado por la función plot, los límites de los ejes se expanden automáticamente para adaptarse al movimiento del punto.

Historial de versiones

Introducido antes de R2006a

R2018b: No se recomienda el uso de impoint

A partir de la versión R2018b, un nuevo conjunto de objetos de ROI reemplaza el conjunto existente. Los nuevos objetos proporcionan más prestaciones funcionales, como la transparencia del color de la cara. Las nuevas clases también admiten eventos que puede utilizar para responder a cambios en la ROI, como cuando se mueve o se hace clic en ella. Aunque no está previsto eliminar los antiguos objetos de ROI por el momento, cambie a las nuevas ROI para aprovechar las prestaciones y flexibilidad adicionales. Para obtener más información sobre la creación de ROI utilizando las nuevas funciones de ROI, consulte Crear formas para definir ROI.

Reemplace el uso del objeto de ROI impoint con el nuevo objeto de ROI Point. 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 no recomendado	Reemplazo recomendado
En este ejemplo se crea una ROI de punto. imshow("cameraman.tif"); h = impoint(gca,[25 50]);	Este código es equivalente y sustituye el antiguo objeto de ROI 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 sobre el tamaño y la posición como un argumento nombre-valor. imshow("cameraman.tif"); h = drawpoint(gca,"Position",[25 50]);

Otras actualizaciones del código de ROI

Actualice el 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 impoint simplemente accediendo o estableciendo el valor de una propiedad del objeto de ROI Point. Por ejemplo, reemplace las llamadas a getColor o setColor con el uso de la propiedad Color. En algunos casos, debe reemplazar la función de objeto impoint con una función de objeto de la nueva ROI Point. Cada una de las funciones individuales del objeto de ROI impoint incluye información sobre migrar al nuevo objeto de ROI Point. Para obtener una visión general acerca de la migración, consulte ROI Migration.

Consulte también

Point | drawpoint

Temas

• Crear formas para definir ROI
• ROI Migration