rectangle

Crear un rectángulo con esquinas rectas o curvas

Sintaxis

rectangle('Position',pos)

rectangle('Position',pos,'Curvature',cur)

rectangle(___,Name,Value)

rectangle(ax,___)

r = rectangle(___)

Descripción

rectangle('Position',pos) crea un rectángulo en coordenadas 2D. Especifique pos como vector de cuatro elementos con el formato [x y w h] en unidades de datos. Los elementos x e y determinan la ubicación, y los elementos w y h determinan el tamaño. La función representa en los ejes actuales sin borrar contenido existente de los ejes.

rectangle('Position',pos,'Curvature',cur) añade curvatura a los lados del rectángulo. Para curvaturas diferentes en los lados horizontales y verticales, especifique cur como vector de dos elementos con el formato [horizontal vertical]. Para la misma longitud de curvatura en todos los lados, especifique cur como un valor escalar. Especifique valores entre 0 (sin curvatura) y 1 (curvatura máxima). Utilice [1 1] para crear una elipse o un círculo.

rectangle(___,Name,Value) especifica las propiedades del rectángulo utilizando uno o más argumentos de par nombre-valor. Por ejemplo, 'FaceColor','red' especifica que el color de relleno sea el rojo. Puede especificar propiedades del rectángulo con cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

rectangle(ax,___) crea el rectángulo en los ejes especificados por ax en lugar de en los ejes actuales (gca). La opción ax puede preceder a cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

r = rectangle(___) devuelve el objeto rectángulo. Utilice r para modificar las propiedades del rectángulo después de crearlo. Para obtener una lista de las propiedades, consulte Rectangle Properties. Puede devolver una salida con cualquiera de las sintaxis anteriores.

Ejemplos

Dibujar un rectángulo

Dibuje un rectángulo que tenga una esquina inferior izquierda en el punto (1,2). Cree el ancho del rectángulo de 5 unidades y la altura de 6 unidades. A continuación, cambie los límites de los ejes.

rectangle('Position',[1 2 5 6])
axis([0 10 0 10])

Dibujar un rectángulo con bordes curvos

Dibuje un rectángulo que tenga una esquina inferior izquierda en el (0,0) y una esquina superior derecha en el (2,4). Cree el rectángulo con esquinas curvas especificando la curvatura como el valor escalar 0.2. Para las unidades de datos de igual longitud a lo largo del eje x y el eje y, utilice axis equal.

figure
rectangle('Position',[0 0 2 4],'Curvature',0.2)
axis equal

Añada un segundo rectángulo que tenga el lado más corto completamente curvo especificando la curvatura como el valor escalar 1.

rectangle('Position',[3 0 2 4],'Curvature',1)

Añada un tercer rectángulo y utilice curvaturas diferentes en los lados horizontales y verticales. Utilice una curvatura horizontal de 0,5 para hacer un 50 por ciento de cada lado horizontal curvo. Utilice una curvatura vertical de 1 para hacer ambos lados verticales completamente curvos.

rectangle('Position',[6 0 2 4],'Curvature',[0.5,1])

Dibujar un círculo

Dibuje un círculo estableciendo la propiedad Curvature en [1 1]. Dibuje el círculo de manera que rellene el área rectangular entre los puntos (2,4) y (4,6). La propiedad Position define el rectángulo más pequeño que contiene el círculo.

pos = [2 4 2 2]; 
rectangle('Position',pos,'Curvature',[1 1])
axis equal

Dibuje un rectángulo rojo con los mismos valores de posición para mostrar cómo el círculo rellena el área rectangular.

rectangle('Position',pos,'EdgeColor','r')

Especificar el color de contorno y de relleno de un rectángulo

Dibuje un rectángulo y especifique el color de relleno, color de contorno y ancho del contorno.

rectangle('Position',[1,2,5,10],'FaceColor',[0 .5 .5],'EdgeColor','b',...
    'LineWidth',3)

Modificar un rectángulo después de crearlo

Añada un rectángulo a los ejes actuales y devuelva el objeto rectángulo, r.

r = rectangle('Position',[0 0 1 1]')

r = 
  Rectangle with properties:

    FaceColor: 'none'
    EdgeColor: [0 0 0]
    LineWidth: 0.5000
    LineStyle: '-'
    Curvature: [0 0]
     Position: [0 0 1 1]

  Use GET to show all properties

Modifique el rectángulo después de crearlo utilizando r. Cambie el color del relleno, color de contorno y ancho del contorno.

r.FaceColor = [0 .5 .5];
r.EdgeColor = 'b';
r.LineWidth = 3;

Argumentos de entrada

pos — Tamaño y ubicación del rectángulo

vector de cuatro elementos con el formato [x y w h]

Tamaño y ubicación del rectángulo, especificados como un vector de cuatro elementos con el formato [x y w h]. Los elementos x e y definen la coordenada para la esquina inferior izquierda del rectángulo. Los elementos w y h definen las dimensiones del rectángulo.

Todos los valores están en unidades de datos.

Ejemplo: rectangle('Position',[0.5 0.5 0.3 0.4])

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

cur — Cantidad de curvatura horizontal y vertical

[0 0] (predeterminado) | vector de dos elementos | escalar

Cantidad de curvatura horizontal y vertical, especificada como un vector de dos elementos o un valor escalar. Utilice esta propiedad para modificar la forma del rectángulo de rectangular a elipsoidal.

La curvatura horizontal es la fracción del ancho que es curva a lo largo de los bordes superior e inferior. La curvatura vertical es la fracción de la altura que es curva a lo largo de los bordes izquierdo y derecho.

• Para utilizar diferentes curvaturas horizontales y verticales, especifique un vector de dos elementos con el formato [horizontal vertical]. El elemento horizontal determina la curvatura horizontal y el elemento vertical determina la curvatura vertical. Especifique los valores entre 0 (sin curvatura) y 1 (curvatura máxima). Por ejemplo, un valor de [0 0] crea un rectángulo con bordes cuadrados y un valor de [1 1] crea una elipse.

• Para utilizar la misma curvatura para los bordes horizontal y vertical, especifique un valor escalar entre 0 y 1, ambos incluidos. La dimensión más corta determina la longitud de la curvatura.

Ejemplo: [0.5 0.6]

Ejemplo: 0.75

Tipos de datos: double

ax — Objeto de ejes

objeto de ejes

Objeto de ejes. Si no especifica un objeto de ejes, rectangle utiliza los ejes actuales.

Argumentos de par nombre-valor

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

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

Ejemplo: rectangle('Position',[0 0 1 1],'EdgeColor','k','FaceColor',[0 .5 .5])

FaceColor — Color de relleno

"none" (predeterminado) | Triplete RGB | código de color hexadecimal | "r" | "g" | "b" | ...

Color de relleno, especificado como triplete RGB, código de color hexadecimal, nombre de color o nombre corto.

Para definir un color personalizado, especifique un triplete RGB o un código de color hexadecimal.

• Un triplete RGB es un vector fila de tres elementos, cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el rango [0,1], por ejemplo [0.4 0.6 0.7].

• Un código de color hexadecimal es un escalar de cadena o un vector de caracteres que comienza con el símbolo de almohadilla (#) seguido de tres o seis dígitos hexadecimales, que pueden oscilar entre 0 y F. Los valores no distinguen entre mayúsculas y minúsculas. Por lo tanto, los códigos de color "#FF8800", "#ff8800", "#F80" y "#f80" son equivalentes.

Como alternativa, puede especificar algunos colores frecuentes por su nombre. En esta tabla se enumeran las opciones de color con su nombre, los tripletes RGB equivalentes y los códigos de color hexadecimales.

Nombre del color	Nombre corto	Triplete RGB	Código de color hexadecimal	Apariencia
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	No se aplica	No se aplica	No se aplica	Sin color

A continuación, se indican los tripletes RGB y los códigos de color hexadecimales de los colores predeterminados que MATLAB^® utiliza en muchos tipos de gráficas.

Triplete RGB	Código de color hexadecimal	Apariencia
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

Ejemplo: "blue"

Ejemplo: [0 0 1]

Ejemplo: "#0000FF"

EdgeColor — Color del contorno

[0 0 0] (predeterminado) | Triplete RGB | código de color hexadecimal | 'r' | 'g' | 'b' | ...

Color del contorno, especificado como triplete RGB, código de color hexadecimal, nombre de color o nombre corto. El valor predeterminado del triplete RGB [0 0 0] se corresponde con el negro.

Para definir un color personalizado, especifique un triplete RGB o un código de color hexadecimal.

• Un triplete RGB es un vector fila de tres elementos, cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el rango [0,1], por ejemplo [0.4 0.6 0.7].

• Un código de color hexadecimal es un escalar de cadena o un vector de caracteres que comienza con el símbolo de almohadilla (#) seguido de tres o seis dígitos hexadecimales, que pueden oscilar entre 0 y F. Los valores no distinguen entre mayúsculas y minúsculas. Por lo tanto, los códigos de color "#FF8800", "#ff8800", "#F80" y "#f80" son equivalentes.

Como alternativa, puede especificar algunos colores frecuentes por su nombre. En esta tabla se enumeran las opciones de color con su nombre, los tripletes RGB equivalentes y los códigos de color hexadecimales.

Nombre del color	Nombre corto	Triplete RGB	Código de color hexadecimal	Apariencia
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	No se aplica	No se aplica	No se aplica	Sin color

A continuación, se indican los tripletes RGB y los códigos de color hexadecimales de los colores predeterminados que MATLAB utiliza en muchos tipos de gráficas.

Triplete RGB	Código de color hexadecimal	Apariencia
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

Ejemplo: 'blue'

Ejemplo: [0 0 1]

Ejemplo: '#0000FF'

LineWidth — Ancho de línea

0.5 (predeterminado) | valor positivo

Ancho de línea, especificado como valor positivo en unidades de puntos.

Ejemplo: 0.75

LineStyle — Estilo de línea

"-" (predeterminado) | "--" | ":" | "-." | "none"

Estilo de línea, especificado como una de las opciones enumeradas en esta tabla.

Estilo de línea	Descripción	Línea resultante
"-"	Línea continua
"--"	Línea discontinua
":"	Línea de puntos
"-."	Línea de puntos y rayas
"none"	Sin línea	Sin línea

Historial de versiones

Introducido antes de R2006a

Consulte también

Funciones

• line | patch | annotation

Propiedades

• Rectangle Properties