Contenido principal

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

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.

ejemplo

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

expandir todo

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.

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

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

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

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

expandir todo

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.

Blue point displayed over an image, with a context menu that gives options to copy the position, set the color, or delete the point.

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

Comportamiento interactivoDescripción
Mover el puntoMueva 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 puntoMueva 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 puntoMueva 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.

addNewPositionCallbackAdd new-position callback to ROI object
createMask(No recomendado) Crear una máscara dentro de una imagen
deleteDelete handle object
getColorObtener el color utilizado para dibujar un objeto de ROI
getPositionDevolver la posición actual de un objeto de ROI
getPositionConstraintFcnReturn function handle to current position constraint function
removeNewPositionCallbackRemove 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
setConstrainedPositionSet ROI object to new position
setPosition(Not recommended) Move ROI object to new position
setPositionConstraintFcnSet position constraint function of ROI object
setStringSet text label for point ROI object
wait(Not recommended) Block MATLAB command line until ROI creation is finished

Ejemplos

contraer todo

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

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

contraer todo