imdistline

Herramienta Distance

Descripción

Un objeto imdistline encapsula una herramienta Distance, que consta de una línea interactiva sobre una imagen, junto con una etiqueta de texto que muestra la distancia entre los puntos finales de la línea.

Puede ajustar el tamaño y la posición de la línea utilizando 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 Usage.

Creación

Sintaxis

h = imdistline

h = imdistline(hparent)

h = imdistline(___,x,y)

Descripción

h = imdistline crea una herramienta Distance en los ejes actuales. La función devuelve h, un identificador de un objeto imdistline.

h = imdistline(hparent) crea una herramienta Distance que se puede arrastrar en el objeto especificado por hparent.

h = imdistline(___,x,y) crea una herramienta Distance con puntos finales en las posiciones especificadas por x e y.

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.

x — Coordenadas x de los puntos finales

Vector numérico de 2 elementos

Coordenadas x de los puntos finales, especificadas como vector numérico de 2 elementos.

Ejemplo: h = imdistline(gca,[10 100],[20 40]); establece el primer punto final en la coordenada (x, y) (10, 20) y el segundo punto final en la coordenada (100, 40).

y — Coordenadas y de los puntos finales

Vector numérico de 2 elementos

Coordenadas y de los puntos finales, especificadas como vector numérico de 2 elementos.

Ejemplo: h = imdistline(gca,[10 100],[20 40]); establece el primer punto final en la coordenada (x, y) (10, 20) y el segundo punto final en la coordenada (100, 40).

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

Para mover la herramienta Distance, sitúe el puntero sobre la línea; la forma cambia a la flor, . Haga clic en la línea con el ratón y arrástrela. Para cambiar el tamaño de la herramienta Distance, mueva el puntero sobre cualquiera de los puntos finales de la línea; la forma cambia al dedo señalador, . Haga clic en el punto final de la línea con el ratón y arrástrelo.

La línea también admite un menú contextual que permite controlar varios aspectos de su funcionamiento y apariencia. Haga clic con el botón secundario en la línea para acceder al menú contextual.

Comportamiento de la herramienta Distance	Elemento del menú contextual
Exportar los datos de punto final y distancia al espacio de trabajo	Seleccione Export to Workspace en el menú contextual.
Activar y desactivar la etiqueta de distancia	Seleccione Show Distance Label en el menú contextual.
Especificar las restricciones de arrastre horizontal y vertical	Seleccione Constrain Drag en el menú contextual.
Cambiar el color usado para visualizar la línea	Seleccione Set Color en el menú contextual.
Eliminar el objeto de la herramienta Distance	Seleccione Delete en el menú contextual.

Funciones del objeto

addNewPositionCallback	Add new-position callback to ROI object
createMask	(No recomendado) Crear una máscara dentro de una imagen
delete	Delete handle object
getAngleFromHorizontal	Return angle between Distance tool and horizontal axis
getColor	Get color used to draw ROI object
getDistance	Devolver la distancia entre puntos finales de la herramienta Distance
getLabelHandle	Return handle to text label of Distance tool
getLabelTextFormatter	Return format of text label of Distance tool
getLabelVisible	Return visibility of text label of Distance tool
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
setLabelTextFormatter	Set format used to display text label of Distance tool
setLabelVisible	Set visibility of text label of Distance tool
setPosition	(Not recommended) Move ROI object to new position
setPositionConstraintFcn	Set position constraint function of ROI object
wait	(Not recommended) Block MATLAB command line until ROI creation is finished

Ejemplos

Insertar una herramienta Distance en una imagen

Inserte una herramienta Distance en una imagen. Utilice makeConstrainToRectFcn para especificar una función de restricción de arrastre que evite que la herramienta Distance se arrastre fuera de la extensión de la imagen. Haga clic con el botón secundario en la herramienta Distance y explore las opciones del menú contextual.

imshow('pout.tif')
h = imdistline;
fcn = makeConstrainToRectFcn('imline',get(gca,'XLim'),get(gca,'YLim'));
setDragConstraintFcn(h,fcn);   

Colocar los puntos finales de la herramienta Distance

Coloque los puntos finales de la herramienta Distance en las ubicaciones especificadas.

imshow('pout.tif')
h = imdistline(gca,[10 100],[10 100]);

Elimine la herramienta Distance.

delete(h)

Utilizar la herramienta Distance con referencia espacial

Utilice la herramienta Distance con XData e YData de la imagen asociada en unidades que no sean píxeles. Este ejemplo requiere la imagen boston.tif del software Mapping Toolbox™, que incluye material con derechos de autor de GeoEye™, todos los derechos reservados.

start_row = 1478;
end_row = 2246;
meters_per_pixel = 1;
rows = [start_row meters_per_pixel end_row];
start_col = 349;
end_col = 1117;
cols = [start_col meters_per_pixel end_col];
img  = imread('boston.tif','PixelRegion',{rows,cols});
figure
hImg = imshow(img);
title('1 meter per pixel')

Especifique la posición inicial de la herramienta Distance en Harvard Bridge.

hline = imdistline(gca,[271 471],[108 650]);
setLabelTextFormatter(hline,'%02.0f meters');

Repita el proceso, pero trabaje con una imagen muestreada de 2 metros por píxel. Verifique que se obtenga la misma distancia.

meters_per_pixel = 2;
rows = [start_row meters_per_pixel end_row];
cols = [start_col meters_per_pixel end_col];
img  = imread('boston.tif','PixelRegion',{rows,cols});
figure  
hImg = imshow(img);
title('2 meters per pixel')

Convierta XData e YData a metros utilizando el factor de conversión.

XDataInMeters = get(hImg,'XData')*meters_per_pixel; 
YDataInMeters = get(hImg,'YData')*meters_per_pixel;

Establezca XData e YData de la imagen para reflejar las unidades deseadas.

set(hImg,'XData',XDataInMeters,'YData',YDataInMeters);    
set(gca,'XLim',XDataInMeters,'YLim',YDataInMeters);

Especifique la posición inicial de la herramienta Distance en Harvard Bridge.

hline = imdistline(gca,[271 471],[108 650]);
setLabelTextFormatter(hline,'%02.0f meters');

Sugerencias

• Si utiliza imdistline con ejes que contienen un objeto de imagen y no especifica una función de restricción de arrastre, puede arrastrar la línea fuera de la extensión de la imagen. Cuando se utiliza con ejes creados por la función plot, los límites de los ejes se expanden automáticamente para adaptarse al movimiento de la línea.

• También puede utilizar el objeto de ROI Line para crear una herramienta de distancia interactiva personalizable. Para ver un ejemplo, consulte Measure Distances in an Image.

Historial de versiones

Introducido antes de R2006a

Consulte también

Line | drawline