imellipse

(No recomendado) Crear una elipse que se puede arrastrar

No se recomienda el uso de imellipse. Utilice en su lugar el objeto de ROI Ellipse. También puede utilizar la función de conveniencia de creación de ROI drawellipse. Si ha utilizado imellipse para crear una ROI circular, utilice en su lugar el objeto de ROI Circle. Para obtener más información, consulte Historial de versiones.

Descripción

Un objeto imellipse encapsula una elipse interactiva sobre una imagen.

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

h = imellipse(hparent)

h = imellipse(hparent,position)

h = imellipse(___,"PositionConstraintFcn",fcn)

Descripción

h = imellipse comienza la colocación interactiva de una elipse en los ejes actuales y devuelve un objeto imellipse.

h = imellipse(hparent) comienza la colocación interactiva de una elipse en el objeto especificado por hparent.

h = imellipse(hparent,position) crea una elipse que se puede arrastrar a la posición position del objeto especificado por hparent.

h = imellipse(___,"PositionConstraintFcn",fcn) también especifica a dónde se puede arrastrar la elipse utilizando una función de restricción de posición, fcn.

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.

position — Posición de la elipse

Vector de 4 elementos

Posición de la elipse definida por un rectángulo delimitador, especificada como vector de 4 elementos con la forma [xmin ymin width height]. El tamaño inicial del rectángulo delimitador es width por height y la esquina superior izquierda del rectángulo está en la coordenada (x, y) (xmin,ymin).

fcn — Función de restricción de posición

identificador de función

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

Deletable — La ROI se puede eliminar

true (predeterminado) | false

La ROI se puede eliminar, especificado como true o false.

Tipos de datos: logical

Uso

Cuando llama a imellipse con una sintaxis interactiva, el puntero cambia a un retículo cuando está sobre una imagen. Haga clic y arrastre con el ratón para especificar el tamaño y la posición de la elipse. La elipse también admite un menú contextual que puede utilizar para controlar aspectos de su apariencia y comportamiento. Haga clic con el botón secundario en la elipse para acceder a este menú contextual.

En esta tabla se enumeran los comportamientos interactivos compatibles con imellipse.

Comportamiento interactivo	Descripción
Mover toda la elipse	Mueva el puntero dentro de la elipse. El puntero cambia a una forma de flor . Haga clic y arrastre con el ratón para mover la elipse.
Cambiar el tamaño de la elipse	Mueva el puntero sobre un control de redimensionamiento de la elipse. El puntero cambia a la forma de una flecha con dos extremos . Haga clic y arrastre con el ratón para cambiar el tamaño de la elipse.
Cambiar el color usado para mostrar la elipse	Mueva el puntero dentro de la elipse. Haga clic con el botón secundario y seleccione Set Color en el menú contextual.
Recuperar la posición actual de la elipse	Mueva el puntero dentro de la elipse. Haga clic con el botón secundario y seleccione Copy Position en el menú contextual. imellipse copia un vector de posición de cuatro elementos [xmin ymin width height] en el portapapeles.
Mantener la relación de aspecto actual de la elipse durante el cambio de tamaño	Mueva el puntero dentro de la elipse. Haga clic con el botón secundario y seleccione Fix Aspect Ratio en el menú contextual.
Eliminar la elipse	Mueva el puntero dentro de la elipse. 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 = imellipse(); h.Deletable = false;

Funciones del objeto

Cada objeto imellipse admite varios métodos. Escriba methods imellipse para ver una lista completa.

addNewPositionCallback	Add new-position callback to ROI object
createMask	(No recomendado) Crear una máscara dentro de una imagen
delete	Delete handle object
getColor	Obtener el color utilizado para dibujar un objeto de ROI
getPosition	Devolver la posición actual de un objeto de ROI
getPositionConstraintFcn	Return function handle to current position constraint function
getVertices	Return vertices on perimeter of ellipse ROI object
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
setFixedAspectRatioMode	Preserve aspect ratio when resizing ROI object
setPosition	(Not recommended) Move ROI object to new position
setPositionConstraintFcn	Set position constraint function of ROI object
setResizable	Set resize behavior of ROI object
wait	(Not recommended) Block MATLAB command line until ROI creation is finished

Ejemplos

Actualizar el título cuando se mueve la elipse

Cree una elipse.

imshow("coins.png")
h = imellipse(gca,[10 10 100 100]);

Utilice callbacks para mostrar la posición actualizada en el título de la figura. El ejemplo ilustra el uso de makeConstrainToRectFcn para mantener la elipse dentro de los rangos originales XLim e YLim.

addNewPositionCallback(h,@(p) title(mat2str(p,3)));
fcn = makeConstrainToRectFcn("imellipse",get(gca,"XLim"),get(gca,"YLim"));
setPositionConstraintFcn(h,fcn);

Hacer clic y arrastrar para colocar una elipse

Coloque una elipse de manera interactiva haciendo clic y arrastrando. Utilice wait para bloquear la línea de comandos de MATLAB^®. Haga doble clic en la elipse para reanudar la ejecución de la línea de comandos de MATLAB.

imshow("coins.png")
h = imellipse;
position = wait(h);

Sugerencias

Si utiliza imellipse con unos ejes que contienen un objeto de imagen y no especifica una función de restricción de posición, los usuarios pueden arrastrar la elipse fuera de la extensión de la imagen y soltarla. 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 de la elipse.

Historial de versiones

Introducido en R2007b

R2018b: No se recomienda el uso de imellipse

A partir de la versión R2018b, un nuevo conjunto de objetos de ROI reemplaza el conjunto existente. Los nuevos objetos proporcionan más prestaciones funcionales, como la transparencia del color de la cara. Las nuevas clases también admiten eventos que puede utilizar para responder a cambios en la ROI, como cuando se mueve o se hace clic en ella. Aunque no está previsto eliminar los antiguos objetos de ROI por el momento, cambie a las nuevas ROI para aprovechar las prestaciones y flexibilidad adicionales. Para obtener más información sobre la creación de ROI utilizando las nuevas funciones de ROI, consulte Crear formas para definir ROI.

Reemplace el uso del objeto imellipse con el nuevo objeto de ROI Ellipse. También puede utilizar la función de conveniencia de ROI drawellipse.

Actualizar el código de creación de ROI

Actualice todas las instancias de imellipse.

Uso no recomendado

Reemplazo recomendado

Este ejemplo crea una ROI elíptica. imshow("cameraman.tif"); h = imellipse(gca,[10 10 100 150]);

Este código es casi equivalente y sustituye el antiguo objeto de ROI con el nuevo objeto de ROI. Tenga en cuenta que, con las ROI anteriores, definía una elipse por medio del tamaño del rectángulo delimitador [x,y,width,height]. Con las nuevas ROI, se define una elipse especificando el punto central de la elipse y la longitud de los ejes semimayor y semimenor. imshow("cameraman.tif"); h = drawellipse(gca,"Center",[65 90],"Semi",[50 75]);

Otras actualizaciones del código de ROI

Actualice el código que utiliza cualquiera de las funciones de objeto del objeto de ROI imellipse. En muchos casos, puede reemplazar la llamada a una función de objeto imellipse simplemente accediendo o estableciendo el valor de una propiedad del objeto de ROI Ellipse. Por ejemplo, reemplace las llamadas a getColor o setColor con el uso de la propiedad Color. En algunos casos, debe reemplazar la función de objeto imellipse con una función de objeto de la nueva ROI Ellipse. Cada uno de los métodos individuales del objeto de ROI imellipse incluye información acerca de la migración al nuevo objeto de ROI Ellipse. Para obtener una visión general acerca de la migración, consulte ROI Migration.

Consulte también

Ellipse | drawellipse

Temas

• Crear formas para definir ROI
• ROI Migration