La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

drawcrosshair

Crear una ROI de retículo personalizable

Sintaxis

roi = drawcrosshair

roi = drawcrosshair(ax)

roi = drawcrosshair(___,Name=Value)

Descripción

La función drawcrosshair crea un objeto Crosshair que especifica la posición de una región de interés (ROI) de retículo. Puede crear la ROI de forma interactiva dibujándola sobre una imagen con el ratón o de forma programática utilizando argumentos de nombre-valor. También puede especificar la apariencia inicial y el comportamiento de la ROI.

Después de crear la ROI, puede utilizar las propiedades del objeto, sus funciones y las notificaciones de eventos para personalizar su forma, posición, apariencia y comportamiento. Para obtener más información sobre estas prestaciones, consulte Consejos.

roi = drawcrosshair crea un objeto Crosshair y permite dibujar de forma interactiva la ROI en los ejes actuales. La ROI de retículo está formada por dos líneas perpendiculares que ocupan toda la altura y el ancho de los ejes.

Para dibujar la ROI, mueva el cursor sobre los ejes y haga clic. Para obtener más información sobre el uso de la ROI, incluidos los atajos de teclado y las opciones del menú contextual, consulte Consejos.

roi = drawcrosshair(ax) comienza la colocación interactiva de una ROI en los ejes especificados por ax.

roi = drawcrosshair(___,Name=Value) personaliza la apariencia y el comportamiento de la ROI usando uno o más argumentos nombre-valor.

Ejemplos

Crear una ROI de retículo y modificar sus propiedades

Este ejemplo muestra cómo crear una ROI de retículo de forma interactiva y de forma programática.

Crear una ROI de retículo de forma interactiva

Lea una imagen en el área de trabajo y muéstrela.

figure
imshow("pears.png")

Cree una ROI de retículo en la imagen utilizando la función drawcrosshair de forma interactiva. Mueva el cursor sobre cualquier punto de la imagen y haga clic para dibujar la ROI. Haga clic en el centro de la ROI (el punto en que la línea horizontal se cruza con la vertical) para dibujar la ROI en la imagen.

h1 = drawcrosshair;

Crear una ROI de retículo de forma programática

Lea una imagen en el área de trabajo y muéstrela.

figure
imshow("strawberries.jpg")

Cree una ROI de retículo en la imagen utilizando la función drawcrosshair. Especifique la posición inicial de la ROI utilizando el argumento nombre-valor Position.

h2 = drawcrosshair(Position=[100 100]);

Modificar la apariencia de la ROI de retículo utilizando propiedades

Después de crear un objeto Crosshair usando la función drawcrosshair, puede cambiar la apariencia de la ROI establecindo las propiedades del objeto.

Establezca la propiedad StripeColor para que el borde sea de color verde.

h2.StripeColor = "green";

Mostrar el valor del píxel especificado por la ROI de retículo

Lea una imagen en el área de trabajo y muéstrela.

img = imread('coins.png');
hAx = gca;
imObj = imshow(img,'Parent',hAx);
imObj.Parent.Visible = 'on';

Cree una ROI de retículo.

h = drawcrosshair('Parent',hAx,'Position',[50 50],'LineWidth',1,'Color','y');

Utilice la función de objeto addlistener para recibir una notificación cuando se mueva la ROI. Especifique la función de callback cuando se produzca el evento. Cuando mueve la ROI de retículo, el código muestra la posición del retículo en el título y el valor del píxel en la ubicación de la etiqueta de la ROI.

addlistener(h,'MovingROI',@(src,data)displayInfo(src,data,hAx,img));

Esta es la función de callback que muestra el valor del píxel especificado por la ROI de retículo.

function displayInfo(src,data,hAx,img)
pos = ceil(data.CurrentPosition);
pixval = img(pos(2),pos(1));
src.Label = mat2str(pixval);
title(mat2str(pos));
end

Argumentos de entrada

ax — Objeto principal de la ROI

gca (predeterminado) | objeto Axes | objeto UIAxes

Objeto principal de la ROI, especificado como un objeto Axes o un objeto UIAxes. Para obtener información sobre el uso de una ROI en un conjunto de ejes de la interfaz de usuario, incluidas limitaciones importantes, consulte Utilizar ROI en apps creadas con App Designer.

Argumentos de par nombre-valor

Especifique pares de argumentos opcionales como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos de nombre-valor deben aparecer después de otros argumentos. Sin embargo, el orden de los pares no importa.

Ejemplo: roi = drawcrosshair(Color="y") crea un objeto Crosshair de color amarillo.

En las versiones anteriores a la R2021a, use comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: roi = drawcrosshair("Color","y") crea un objeto Crosshair de color amarillo.

Forma y posición

Position — Posición de la ROI

Vector numérico de 1 por 2

Posición de la ROI, especificada como vector numérico de 1 por 2 con la forma [xy]. Los valores x e y especifican las coordenadas en que la línea horizontal se cruza con la vertical en la ROI de retículo.

Color y estilo

Color — Color de la ROI

[0 0.4470 0.7410] (predeterminado) | Triplete RGB | Nombre del color | Nombre corto del color

Color de la ROI, especificado como triplete RGB, nombre de color o nombre corto de color.

Puede especificar cualquier color utilizando un triplete RGB. Un triplete RGB es un vector fila de 3 elementos cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el intervalo [0, 1].

Puede especificar algunos colores habituales por su nombre como un escalar de cadena o un vector de caracteres. En esta tabla se enumeran las opciones de color con nombre y los tripletes RGB equivalentes.

Nombre del color	Nombre corto	Triplete RGB	Apariencia
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"cyan"	"c"	[0 1 1]
"magenta"	"m"	[1 0 1]
"yellow"	"y"	[1 1 0]
"black"	"k"	[0 0 0]
"white"	"w"	[1 1 1]

Aquí están los tripletes RGB para los colores por defecto que MATLAB^® utiliza en muchos tipos de gráficas.

Triplete RGB	Apariencia
[0 0.4470 0.7410]
[0.8500 0.3250 0.0980]
[0.9290 0.6940 0.1250]
[0.4940 0.1840 0.5560]
[0.4660 0.6740 0.1880]
[0.3010 0.7450 0.9330]
[0.6350 0.0780 0.1840]

Ejemplo: Color="r"

Ejemplo: Color="green"

Ejemplo: Color=[0 0.4470 0.7410]

LineWidth — Ancho del borde de la ROI

número positivo

Ancho del borde de la ROI, especificado como número positivo en puntos. El valor predeterminado es tres veces el número de puntos por píxel de pantalla, de modo que el borde tiene tres píxeles de ancho.

SelectedColor — Color de la ROI cuando se selecciona

"none" (predeterminado) | Triplete RGB | Nombre del color | Nombre corto del color

Color de la ROI cuando se selecciona, especificado como triplete RGB, nombre de color, nombre corto de color o "none". Si especifica "none", el valor de Color define el color de la ROI en todos los estados, seleccionados o no.

Puede especificar cualquier color utilizando un triplete RGB. Un triplete RGB es un vector fila de 3 elementos cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el intervalo [0, 1].

Puede especificar algunos colores habituales por su nombre como un escalar de cadena o un vector de caracteres. En esta tabla se enumeran las opciones de color con nombre y los tripletes RGB equivalentes.

Nombre del color	Nombre corto	Triplete RGB	Apariencia
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"cyan"	"c"	[0 1 1]
"magenta"	"m"	[1 0 1]
"yellow"	"y"	[1 1 0]
"black"	"k"	[0 0 0]
"white"	"w"	[1 1 1]

Aquí están los tripletes RGB para los colores por defecto que MATLAB utiliza en muchos tipos de gráficas.

Triplete RGB	Apariencia
[0 0.4470 0.7410]
[0.8500 0.3250 0.0980]
[0.9290 0.6940 0.1250]
[0.4940 0.1840 0.5560]
[0.4660 0.6740 0.1880]
[0.3010 0.7450 0.9330]
[0.6350 0.0780 0.1840]

Ejemplo: SelectedColor="r"

Ejemplo: SelectedColor="green"

Ejemplo: SelectedColor=[0 0.4470 0.7410]

StripeColor — Color del borde de la ROI

"none" (predeterminado) | Triplete RGB | Nombre del color | Nombre corto del color

Color del borde de la ROI, especificado como triplete RGB, nombre de color, nombre corto de color o "none". Si especifica "none", el borde de la ROI es un color sólido especificado por Color. De lo contrario, el borde de la ROI aparece a rayas, con colores que van alternando entre los especificados por Color y StripeColor.

Puede especificar cualquier color utilizando un triplete RGB. Un triplete RGB es un vector fila de 3 elementos cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el intervalo [0, 1].

Puede especificar algunos colores habituales por su nombre como un escalar de cadena o un vector de caracteres. En esta tabla se enumeran las opciones de color con nombre y los tripletes RGB equivalentes.

Nombre del color	Nombre corto	Triplete RGB	Apariencia
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"cyan"	"c"	[0 1 1]
"magenta"	"m"	[1 0 1]
"yellow"	"y"	[1 1 0]
"black"	"k"	[0 0 0]
"white"	"w"	[1 1 1]

Aquí están los tripletes RGB para los colores por defecto que MATLAB utiliza en muchos tipos de gráficas.

Triplete RGB	Apariencia
[0 0.4470 0.7410]
[0.8500 0.3250 0.0980]
[0.9290 0.6940 0.1250]
[0.4940 0.1840 0.5560]
[0.4660 0.6740 0.1880]
[0.3010 0.7450 0.9330]
[0.6350 0.0780 0.1840]

Ejemplo: StripeColor="r"

Ejemplo: StripeColor="green"

Ejemplo: StripeColor=[0 0.4470 0.7410]

Visible — Visibilidad de la ROI

"on" (predeterminado) | "off" | valor lógico on/off

Visibilidad de la ROI, especificada como "on" u "off", o como un 0 (false) o un 1 (true) numérico o lógico. El valor "on" equivale a true y "off" equivale a false. El valor se almacena como un valor lógico on/off de tipo OnOffSwitchState.

Valor	Descripción
"on"	Muestra la ROI.
"off"	Oculta la ROI sin eliminarla. Es posible acceder a las propiedades de una ROI invisible.

Etiquetas

Label — Etiqueta de la ROI

'' (predeterminado) | vector de caracteres | escalar de cadena

Etiqueta de la ROI, especificada como vector de caracteres o escalar de cadena. De forma predeterminada, la ROI no tiene etiqueta ('').

LabelAlpha — Transparencia del fondo del texto

1 (predeterminado) | Número en el intervalo [0, 1]

Transparencia del fondo del texto, especificada como número en el intervalo [0, 1]. Cuando se establece en 1, el fondo del texto es completamente opaco. Cuando se establece en 0, el fondo del texto es completamente transparente.

LabelTextColor — Color del texto de la etiqueta

"black" (predeterminado) | Triplete RGB | Nombre del color | Nombre corto del color

Color del texto de la etiqueta, especificado como triplete RGB, nombre de color o nombre corto de color.

Puede especificar cualquier color utilizando un triplete RGB. Un triplete RGB es un vector fila de 3 elementos cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el intervalo [0, 1].

Puede especificar algunos colores habituales por su nombre como un escalar de cadena o un vector de caracteres. En esta tabla se enumeran las opciones de color con nombre y los tripletes RGB equivalentes.

Nombre del color	Nombre corto	Triplete RGB	Apariencia
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"cyan"	"c"	[0 1 1]
"magenta"	"m"	[1 0 1]
"yellow"	"y"	[1 1 0]
"black"	"k"	[0 0 0]
"white"	"w"	[1 1 1]

Aquí están los tripletes RGB para los colores por defecto que MATLAB utiliza en muchos tipos de gráficas.

Triplete RGB	Apariencia
[0 0.4470 0.7410]
[0.8500 0.3250 0.0980]
[0.9290 0.6940 0.1250]
[0.4940 0.1840 0.5560]
[0.4660 0.6740 0.1880]
[0.3010 0.7450 0.9330]
[0.6350 0.0780 0.1840]

Ejemplo: LabelTextColor="r"

Ejemplo: LabelTextColor="green"

Ejemplo: LabelTextColor=[0 0.4470 0.7410]

LabelVisible — Visibilidad de etiquetas

"on" (predeterminado) | "off" | "hover"

Visibilidad de etiquetas, especificada como uno de estos valores.

Valor	Descripción
"on"	La etiqueta está visible cuando la ROI también lo está.
"hover"	La etiqueta solo está visible solo cuando se pasa el ratón por encima de la ROI.
"off"	La etiqueta no está visible.

Interactividad

ContextMenu — Menú contextual

objeto ContextMenu

Menú contextual que aparece al hacer clic con el botón secundario en la ROI, especificado como objeto ContextMenu. Puede crear un menú contextual personalizado utilizando la función uicontextmenu y configurando después las propiedades del menú contextual.

Deletable — El menú contextual ofrece la opción de eliminar la ROI

true o 1 (predeterminado) | false o 0

El menú contextual proporciona una opción para eliminar la ROI, especificada como un 1 numérico o lógico (true) o un 0 (false). Cuando el valor es true, puede eliminar la ROI de forma interactiva mediante el menú contextual. Cuando el valor es false, la opción del menú contextual para eliminar la ROI está desactivada.

En ambos casos, puede eliminar la ROI fuera del menú contextual utilizando la función delete.

DrawingArea — Área de los ejes en la que puede colocar de forma interactiva la ROI

"auto" (predeterminado) | "unlimited" | [x,y,w,h]

Área de los ejes en la que puede colocar de forma interactiva la ROI, especificada como uno de los valores de esta tabla.

Valor	Descripción
"auto"	El área de dibujo son los límites actuales de los ejes (valor predeterminado).
"unlimited"	El área de dibujo no tiene límites y las ROI se pueden dibujar o arrastrar para que se extiendan más allá de los límites de los ejes.
[x,y,w,h]	El área de dibujo se restringe a una región rectangular que comienza en (x, y) y se extiende hasta w de ancho y h de alto.

InteractionsAllowed — Interactividad de la ROI

"all" (predeterminado) | "none"

Interactividad de la ROI, especificada como uno de los valores de esta tabla.

Valor	Descripción
"all"	La ROI es totalmente interactiva.
"none"	La ROI no es interactiva y no hay puntos de arrastre visibles.

Selected — Estado de selección de la ROI

false, 0 u "off" (predeterminado) | true, 1 u "on"

Estado de selección de la ROI, especificado como "off" u "on", o como un 0 (false) o un 1 (true) numérico o lógico. El valor "off" equivale a false y "on" equivale a true.

Principal/Secundario

HandleVisibility — Visibilidad del identificador de la ROI en la propiedad Children del objeto principal

"on" (predeterminado) | "off" | "callback"

Visibilidad del identificador de la ROI en la propiedad Children del objeto principal, especificada como uno de los valores de esta tabla.

Valor	Descripción
"on"	El identificador del objeto está siempre visible (valor predeterminado).
"off"	El identificador del objeto está oculto en todo momento.
"callback"	El identificador del objeto está visible desde los callbacks o funciones llamadas por callbacks, pero no desde las funciones llamadas desde la línea de comandos.

Parent — Objeto principal de la ROI

objeto Axes | objeto UIAxes

Objeto principal de la ROI, especificado como Axes o UIAxes. Para obtener información sobre el uso de una ROI en un conjunto de ejes de la interfaz de usuario, incluidas limitaciones importantes, consulte Utilizar ROI en apps creadas con App Designer.

Identificadores

Tag — Etiqueta que se asocia a la ROI

'' (predeterminado) | vector de caracteres | escalar de cadena

Etiqueta que se asocia a la ROI, especificada como vector de caracteres o escalar de cadena. Use el valor de la etiqueta para encontrar el objeto de ROI en una jerarquía de objetos utilizando la función findobj.

UserData — Datos que se asocian a la ROI

cualquier dato de MATLAB

Datos que se asocian a la ROI, especificados como cualquier dato de MATLAB. Por ejemplo, puede especificar un escalar, un vector, una matriz, un arreglo de celdas, una cadena, un arreglo de caracteres, una tabla o una estructura. El objeto drawcrosshair no usa estos datos.

Argumentos de salida

roi — ROI de retículo

objeto Crosshair

ROI de retículo, devuelta como un objeto Crosshair.

Sugerencias

• En esta tabla, se describe cómo realizar tareas comunes con una ROI de retículo.

  Tarea	Descripción
  Cancelar la operación de dibujo.	Empiece a dibujar la ROI y pulse Esc antes de soltar el ratón. La función devuelve un objeto de ROI válido con una propiedad Position vacía.
  Mover la ROI.	Sitúe el puntero sobre la ROI. El puntero cambia a una forma de flor. Haga clic y arrastre para mover la ROI.
  Eliminar la ROI.	Sitúe el puntero sobre la ROI y haga clic con el botón secundario para ver el menú contextual. Seleccione Delete Crosshair del menú. También puede eliminar la ROI utilizando la función delete.

• La función drawcrosshair crea un objeto Crosshair. Después de crear el objeto, puede modificar la posición, apariencia y comportamiento de la ROI mediante las siguientes prestaciones del objeto.

  Prestación	Soporte
  Propiedades del objeto	Los objetos de ROI tienen propiedades que especifican su forma, posición, apariencia y comportamiento. Después de crear el objeto de ROI, cambie las propiedades utilizando la notación de puntos. Por ejemplo, para cambiar el color de roi a amarillo, configure la propiedad Color: roi.Color = 'yellow'
  Funciones de objeto	Los objetos de ROI tienen funciones de objeto que operan sobre las ROI. Por ejemplo, si desea pausar la línea de comandos de MATLAB después de crear una ROI, utilice la función wait.
  Notificaciones de eventos	Los objetos de ROI pueden notificar al código cuando se producen ciertos eventos, como cuando se hace clic en la ROI o cuando la ROI se mueve. Para recibir notificaciones de eventos, configure receptores. Cuando la ROI notifica a su aplicación a través del receptor, devuelve datos específicos del evento. Por ejemplo, con el evento ROIMoved, el objeto de ROI devuelve su posición anterior y su posición actual. Puede especificar una función de callback que se ejecute cuando se produzca un evento.

  Para ver un ejemplo de cómo utilizar receptores de eventos con el objeto Crosshair, consulte Mostrar el valor del píxel especificado por la ROI de retículo.

Historial de versiones

Introducido en R2019b

R2020a: No se recomienda el uso del argumento de nombre-valor UIContextMenu

A partir de la versión R2020a, no se recomienda usar el argumento de nombre-valor UIContextMenu para asignar un menú contextual a un objeto de ROI. Utilice en su lugar el argumento de nombre-valor ContextMenu. Los valores son los mismos.

De momento no está previsto eliminar el soporte para el argumento de nombre-valor UIContextMenu.

Consulte también

Crosshair | drawline | drawpoint | drawpolyline

Temas

• Crear formas para definir ROI