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.

imline

Crear línea arrastrable y redimensionable

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

Descripción

Un objeto encapsula una línea interactiva sobre una imagen.imline

Puede ajustar el tamaño y la posición de la línea con el ratón. La línea 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 = imline

h = imline(hparent)

h = imline(hparent,position)

h = imline(hparent,x,y)

h = imline(___,Name,Value)

Descripción

h = imline comienza la colocación interactiva de una línea en los ejes actuales y devuelve un objeto.imline

h = imline(hparent) comienza la colocación interactiva de una línea en el objeto especificado por .hparent

h = imline(hparent,position) crea una línea arrastrable y redimensionable, con coordenadas definidas por .position

h = imline(hparent,x,y) crea una línea arrastrable y redimensionable, con - y -coordenadas de los puntos finales definidos por y .xyxy

h = imline(___,Name,Value) especifica pares nombre-valor que controlan el comportamiento de la línea.

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 puntos finales de línea

Vector de 2 elementos

Posición de los puntos finales de línea, especificada como una matriz de 2 por 2 del formulario.[x1 y1; x2 y2]

x — -coordenadas de los puntos finales de líneax

Vector de 2 elementos

-coordenadas de los puntos finales de línea, especificadas como un vector de 2 elementos del formulario.xx = [x1 x2]

y — -coordenadas de los puntos finales de líneay

Vector de 2 elementos

-coordenadas de los puntos finales de línea, especificadas como un vector de 2 elementos del formulario.yy = [y1 y2]

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 línea. 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 miraimlinecuando sobre la imagen. Haga clic y arrastre el ratón para especificar la posición y la longitud de la línea. La línea admite un menú contextual que puede utilizar para controlar aspectos de su apariencia y comportamiento.

La tabla describe el comportamiento interactivo admitido por .imline

Comportamiento interactivo	Descripción
Mover la línea.	Mueva el puntero sobre la línea. El puntero cambia a una forma de fleur. Haga clic y arrastre el ratón para mover la línea.
Mover los puntos finales de la línea.	Mueva el puntero sobre cualquiera de los extremos de la línea. El puntero cambia al dedo señalador,. Haga clic y arrastre el ratón para cambiar el tamaño de la línea.
Cambiar el color utilizado para mostrar la línea.	Mueva el puntero sobre la línea. Haga clic con el botón derecho y seleccione en el menú contextual.Set Color
Recuperar las coordenadas de los puntos finales de la línea.	Mueva el puntero sobre la línea. Haga clic con el botón derecho y seleccione en el menú contextual. copia una matriz 2 por 2 en el portapapeles especificando las coordenadas de los puntos finales de la línea en el formulario.Copy Positionimline[X1 Y1; X2 Y2]
Eliminación de la línea	Mueva el puntero en la parte superior de la línea. 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 = imline(); h.Deletable = false;

Funciones del objeto

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

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

Ejemplos

Actualizar título cuando la línea se mueve

Utilice un color personalizado para mostrar la línea. Utilice la función.addNewPositionCallback Mueva la línea, tenga en cuenta que el vector de posición 2 por 2 de la línea se muestra en el título sobre la imagen. Explore el menú contextual de la línea haciendo clic con el botón derecho en la línea.

imshow('pout.tif') h = imline(gca,[10 100],[100 100]); setColor(h,[0 1 0]); id = addNewPositionCallback(h,@(pos) title(mat2str(pos,3)));

Después de observar el comportamiento de devolución de llamada, quite la devolución de llamada mediante la función.removeNewPositionCallback

removeNewPositionCallback(h,id);

Haga clic y arrastre para colocar la línea

Coloque una línea de forma interactiva haciendo clic y arrastrando. Se utiliza para bloquear la línea de comandos.waitMATLAB^® Haga doble clic en la línea para ejecutar la línea de comandos.resumeMATLAB

imshow('pout.tif') h = imline; 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 línea fuera de la extensión de la imagen y perder la línea.imline 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 línea.plot

• Se utiliza para crear una línea interactiva con un cuadro de texto que muestra la distancia entre los puntos finales de línea.imdistline

Consideraciones de compatibilidad

no se recomiendaimline

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.imlineLine También puede utilizar la función de conveniencia de creación de ROI.drawline

Actualizar el código de creación de ROI

Actualice todas las instancias de .imline

Uso desalentado	Reemplazo recomendado
En este ejemplo se crea un ROI de línea. imshow('cameraman.tif'); h = imline(gca,[10 10; 100 150]);	Aquí hay código equivalente, reemplazando el antiguo ROI con el nuevo objeto de ROI equivalente. 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 nombre,valor. imshow('cameraman.tif'); h = drawline(gca,'Position',[10 10; 100 150]);

Otras actualizaciones del código de ROI

Actualizar instancias donde el código utiliza una de las funciones de objeto de .imline En muchos casos, se reemplaza la llamada a una función de objeto simplemente accediendo o estableciendo el valor de una propiedad de objeto de ROI.Line 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.imlineLine Cada una de las funciones de objeto de ROI individuales incluye información sobre la migración al nuevo objeto de ROI.imlineLine Para obtener información general sobre la migración, consulte .Migración de ROI

Consulte también

imdistline | imellipse | imfreehand | impoint | impoly | imrect | imroi | makeConstrainToRectFcn

Introducido antes de R2006a