Main Content

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.

Círculo

Región de interés circular

Descripción

Un objeto Circle especifica el tamaño y la posición de una región de interés (ROI) circular. Puede personalizar la apariencia y el comportamiento interactivo de la ROI.

Para obtener más información sobre el uso de esta ROI, incluidos los atajos de teclado, consulte Consejos.

Blue Circle ROI drawn over a round object in an image.

Creación

Hay dos formas de crear un objeto Circle. Para obtener más información, consulte Crear formas para definir ROI.

  • Utilice la función drawcircle. Utilice esta función cuando desee crear la ROI y establecer la apariencia en un único comando. Puede especificar el tamaño y la posición de la ROI de forma interactiva dibujándola sobre una imagen con el ratón o de forma programática utilizando argumentos nombre-valor.

  • Utilice la función images.roi.Circle aquí descrita. Utilice esta función si desea especificar la apariencia y el comportamiento de la ROI antes de especificar el tamaño y la posición de la ROI. Después de crear el objeto, puede especificar el tamaño y la posición de forma interactiva utilizando la función draw o de forma programática modificando propiedades del objeto.

Descripción

roi = images.roi.Circle crea un objeto Circle con propiedades predeterminadas.

ejemplo

roi = images.roi.Circle(ax) crea la ROI en los ejes especificados por ax.

roi = images.roi.Circle(___,Name,Value) establece propiedades utilizando argumentos nombre-valor. Puede especificar varios argumentos nombre-valor. Encierre el nombre de cada propiedad entre comillas simples.

Ejemplo: images.roi.Circle('Color','y') crea un objeto Circle de color amarillo.

Argumentos de entrada

expandir todo

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

Propiedades

expandir todo

Centro de la ROI, especificado como vector numérico de 1 por 2 de la forma [x y]. Los valores x e y son las coordenadas del punto central de la ROI. El valor de esta propiedad cambia automáticamente cuando dibuja o mueve la ROI.

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 colorNombre cortoTriplete RGBApariencia
"red""r"[1 0 0]

A rectangle colored pure red

"green""g"[0 1 0]

A rectangle colored pure green

"blue""b"[0 0 1]

A rectangle colored pure blue

"cyan" "c"[0 1 1]

A rectangle colored pure cyan

"magenta""m"[1 0 1]

A rectangle colored pure magenta

"yellow""y"[1 1 0]

A rectangle colored pure yellow

"black""k"[0 0 0]

A rectangle colored black

"white""w"[1 1 1]

A rectangle colored white

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

Triplete RGBApariencia
[0 0.4470 0.7410]

A rectangle colored medium blue

[0.8500 0.3250 0.0980]

A rectangle colored reddish-orange

[0.9290 0.6940 0.1250]

A rectangle colored dark yellow

[0.4940 0.1840 0.5560]

A rectangle colored dark purple

[0.4660 0.6740 0.1880]

A rectangle colored light green

[0.3010 0.7450 0.9330]

A rectangle colored light blue

[0.6350 0.0780 0.1840]

A rectangle colored dark red

Ejemplo: "Color","r"

Ejemplo: "Color","green"

Ejemplo: "Color",[0 0.4470 0.7410]

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.

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.

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

ValorDescripció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.

Transparencia de la cara de la ROI, especificada como número en el intervalo [0, 1]. Cuando el valor es 1, la cara de la ROI es completamente opaca. Cuando el valor es 0, la cara de la ROI es completamente transparente.

La cara de la ROI puede capturar clics, especificado como un 1 numérico o lógico (true) o un 0 (false). Cuando el valor es true, la cara de la ROI captura los clics del ratón. Cuando el valor es false, la cara de la ROI no captura los clics del ratón.

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

ValorDescripció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.

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

ValorDescripción
"all"La ROI es totalmente interactiva (de forma predeterminada).
"none"La ROI no es interactiva y no hay puntos de arrastre visibles.
"translate"La ROI se puede desplazar dentro del área de dibujo, pero no se puede remodelar.
"reshape"La ROI se puede remodelar, pero no desplazar.

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

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.

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 colorNombre cortoTriplete RGBApariencia
"red""r"[1 0 0]

A rectangle colored pure red

"green""g"[0 1 0]

A rectangle colored pure green

"blue""b"[0 0 1]

A rectangle colored pure blue

"cyan" "c"[0 1 1]

A rectangle colored pure cyan

"magenta""m"[1 0 1]

A rectangle colored pure magenta

"yellow""y"[1 1 0]

A rectangle colored pure yellow

"black""k"[0 0 0]

A rectangle colored black

"white""w"[1 1 1]

A rectangle colored white

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

Triplete RGBApariencia
[0 0.4470 0.7410]

A rectangle colored medium blue

[0.8500 0.3250 0.0980]

A rectangle colored reddish-orange

[0.9290 0.6940 0.1250]

A rectangle colored dark yellow

[0.4940 0.1840 0.5560]

A rectangle colored dark purple

[0.4660 0.6740 0.1880]

A rectangle colored light green

[0.3010 0.7450 0.9330]

A rectangle colored light blue

[0.6350 0.0780 0.1840]

A rectangle colored dark red

Ejemplo: "LabelTextColor","r"

Ejemplo: "LabelTextColor","green"

Ejemplo: "LabelTextColor",[0 0.4470 0.7410]

Visibilidad de etiquetas, especificada como uno de estos valores.

ValorDescripció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.

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.

Tamaño del marcador, especificado como número positivo en puntos. El valor predeterminado es ocho veces el número de puntos por píxel de pantalla, de modo que los marcadores tienen un tamaño de ocho píxeles.

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

Radio del círculo, especificado como número no negativo. También puede establecer esta propiedad dibujando o redimensionando el círculo.

Estado de selección de la ROI, especificado como un 0 numérico o lógico (false) o un 1 (true). También puede establecer esta propiedad de forma interactiva. Por ejemplo, haciendo clic en la ROI se selecciona la ROI y se establece esta propiedad en true. De forma similar, pulsando la tecla Ctrl y haciendo clic en la ROI se quita la selección de la ROI y se establece el valor de esta propiedad en false.

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 colorNombre cortoTriplete RGBApariencia
"red""r"[1 0 0]

A rectangle colored pure red

"green""g"[0 1 0]

A rectangle colored pure green

"blue""b"[0 0 1]

A rectangle colored pure blue

"cyan" "c"[0 1 1]

A rectangle colored pure cyan

"magenta""m"[1 0 1]

A rectangle colored pure magenta

"yellow""y"[1 1 0]

A rectangle colored pure yellow

"black""k"[0 0 0]

A rectangle colored black

"white""w"[1 1 1]

A rectangle colored white

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

Triplete RGBApariencia
[0 0.4470 0.7410]

A rectangle colored medium blue

[0.8500 0.3250 0.0980]

A rectangle colored reddish-orange

[0.9290 0.6940 0.1250]

A rectangle colored dark yellow

[0.4940 0.1840 0.5560]

A rectangle colored dark purple

[0.4660 0.6740 0.1880]

A rectangle colored light green

[0.3010 0.7450 0.9330]

A rectangle colored light blue

[0.6350 0.0780 0.1840]

A rectangle colored dark red

Ejemplo: "SelectedColor","r"

Ejemplo: "SelectedColor","green"

Ejemplo: "SelectedColor",[0 0.4470 0.7410]

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 colorNombre cortoTriplete RGBApariencia
"red""r"[1 0 0]

A rectangle colored pure red

"green""g"[0 1 0]

A rectangle colored pure green

"blue""b"[0 0 1]

A rectangle colored pure blue

"cyan" "c"[0 1 1]

A rectangle colored pure cyan

"magenta""m"[1 0 1]

A rectangle colored pure magenta

"yellow""y"[1 1 0]

A rectangle colored pure yellow

"black""k"[0 0 0]

A rectangle colored black

"white""w"[1 1 1]

A rectangle colored white

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

Triplete RGBApariencia
[0 0.4470 0.7410]

A rectangle colored medium blue

[0.8500 0.3250 0.0980]

A rectangle colored reddish-orange

[0.9290 0.6940 0.1250]

A rectangle colored dark yellow

[0.4940 0.1840 0.5560]

A rectangle colored dark purple

[0.4660 0.6740 0.1880]

A rectangle colored light green

[0.3010 0.7450 0.9330]

A rectangle colored light blue

[0.6350 0.0780 0.1840]

A rectangle colored dark red

Ejemplo: "StripeColor","r"

Ejemplo: "StripeColor","green"

Ejemplo: "StripeColor",[0 0.4470 0.7410]

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.

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 Círculo no usa estos datos.

Esta propiedad o parámetro es de solo lectura.

Ubicaciones de los puntos en el perímetro del círculo, especificadas como matriz numérica de n por 2, donde n es el número total de vértices.

Visibilidad de la ROI, especificada como "on" u "off", o como un 1 numérico o lógico (true) o un 0 (false). 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.

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

Funciones del objeto

addlistenerCreate event listener bound to event source
beginDrawingFromPointBegin drawing ROI from specified point
bringToFrontBring ROI to front of Axes stacking order
createMaskCrear una imagen de máscara binaria a partir de una ROI
drawIniciar dibujo de ROI de forma interactiva
inROIConsultar si determinados puntos se encuentran en una ROI
waitBlock MATLAB command line until ROI operation is finished

Ejemplos

contraer todo

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

I = imread('baby.jpg');
figure
imshow(I)

Cree una ROI circular en la imagen. Utilice la propiedad 'Center' para especificar la ubicación y la propiedad 'Radius' para especificar el tamaño. Para ROI creadas de forma programática, si desea que la ROI se dibuje en unos ejes concretos, deberá especificar esos ejes como argumento de entrada. De lo contrario, se crea una instancia de la clase images.roi.Circle, pero no se muestra. En este ejemplo, especifique los ejes actuales (gca) para dibujar la ROI en la imagen en esos ejes.

h = images.roi.Circle(gca,'Center',[1000 1000],'Radius',500);

Lea una imagen en el área de trabajo.

I = imread('cameraman.tif');

Muestre la imagen.

imshow(I);

Dibuje una ROI circular en la imagen. Dado que este ejemplo especifica el tamaño y la ubicación de la ROI, no es necesario llamar al método draw para activar el dibujo interactivo.

roi = images.roi.Circle(gca,'Center',[100 100],'Radius',50);

Configure receptores de eventos de ROI en movimiento. Cuando la mueve, la ROI envía notificaciones de estos eventos y ejecuta la función de callback que especifique.

addlistener(roi,'MovingROI',@allevents);
addlistener(roi,'ROIMoved',@allevents);

La función de callback allevents muestra en la línea de comandos el centro actual y el radio actual de la ROI Circle.

function allevents(src,evt)
evname = evt.EventName;
    switch(evname)
        case{'MovingROI'}
            disp(['ROI moving Current Center: ' mat2str(evt.CurrentCenter)]);
            disp(['ROI moving Current Radius: ' mat2str(evt.CurrentRadius)]);
        case{'ROIMoved'}
            disp(['ROI moved Current Center: ' mat2str(evt.CurrentCenter)]);
            disp(['ROI moved Current Radius: ' mat2str(evt.CurrentRadius)]);
    end
end

Más acerca de

expandir todo

Sugerencias

  • Para dibujar la ROI de forma interactiva utilizando las funciones draw o drawcircle, sitúe el cursor sobre los ejes y haga clic y arrastre para crear la forma. Para acabar el dibujo, suelte el puntero.

  • La ROI admite la siguiente interactividad, incluidos los atajos de teclado.

    ComportamientoAtajo de teclado
    Acabar el dibujo de la ROI.

    Soltar el cursor del ratón.

    Cancelar el dibujo de la ROI.Pulse Esc. La función devuelve un objeto de ROI válido con una propiedad Position vacía.
    Redimensionar (remodelar) la ROI.

    Sitúe el puntero sobre un vértice y, a continuación, haga clic y arrastre.

    Mover la ROI.Sitúe el cursor en cualquier lugar dentro de la ROI, pulse y mantenga pulsado el ratón, y mueva la ROI por la imagen.
    Eliminar la ROI.Sitúe el cursor en el círculo, haga clic con el botón secundario y seleccione Delete Circle en el menú contextual. También puede eliminar la ROI de forma programática utilizando la función delete.
  • Para obtener información sobre el uso de una ROI en una app creada con App Designer, consulte Utilizar ROI en apps creadas con App Designer.

Historial de versiones

Introducido en R2018b

expandir todo