Esta página aún no se ha traducido para esta versión. Puede ver la versión más reciente de esta página en inglés.

text

Agregar descripciones de texto a puntos de datos

Descripción

ejemplo

text(x,y,txt) agrega una descripción de texto a uno o más puntos de datos de los ejes actuales utilizando el texto especificado por txt. Para agregar texto a un punto, especifique x y y como escalares en unidades de datos. Para agregar texto a varios puntos, especifique x y y como vectores con igual longitud.

text(x,y,z,txt) coloca el texto en coordenadas 3-D.

ejemplo

text(___,Name,Value) especifica las propiedades de objeto Text mediante uno o varios pares de valor de nombre. Por ejemplo, 'FontSize',14 establece el tamaño de fuente en 14 puntos. Puede especificar propiedades de texto con cualquiera de las combinaciones de argumentos de entrada en las sintaxis anteriores. z si especifica las propiedades Position y String como pares nombre-valor, a continuación, no es necesario especificar el x, y, entradas y txt .

text(ax,___) crea el texto de 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.

ejemplo

t = text(___) devuelve uno o más objetos de texto. Utilice t para modificar las propiedades de los objetos de texto una vez creados. Para obtener una lista de propiedades y descripciones, vea Text Properties. Puede especificar un resultado con cualquiera de las sintaxis anteriores.

Ejemplos

contraer todo

Traza una curva sinusoidal. En el punto , agregue el texto Description . Utilice la marca Tex \pi para la letra griega . Utilice \leftarrow para mostrar una flecha que apunta a la izquierda.

x = 0:pi/20:2*pi;
y = sin(x);
plot(x,y)
text(pi,0,'\leftarrow sin(\pi)')

Para obtener una lista de caracteres griegos y otras marcas de Tex, vea la descripción de la propiedad Interpreter .

Trazar una línea. Añada el mismo texto a dos puntos a lo largo de la línea.

x = linspace(-5,5);
y = x.^3-12*x;
plot(x,y)

xt = [-2 2];
yt = [16 -16];
str = 'dy/dx = 0';
text(xt,yt,str)

Agregue texto diferente a cada punto especificando str como una matriz de celdas.

x = linspace(-5,5);
y = x.^3-12*x;
plot(x,y)

xt = [-2 2];
yt = [16 -16];
str = {'local max','local min'};
text(xt,yt,str)

Cree una trama de línea y añada una descripción de texto a los ejes. Mostrar texto multilínea especificando str como una matriz de celdas.

plot(1:10)
str = {'A simple plot','from 1 to 10'};
text(2,7,str)

Cree una trama de línea y añada dos descripciones de texto a los ejes. Al agregar varias descripciones de texto a los ejes, muestre texto multilínea especificando matrices de celdas anidadas.

plot(1:10)
str = {{'A simple plot','from 1 to 10'},'y = x'};
text([2 8],[7 7],str)

Cree una trama de línea y añada una descripción de texto a los ejes. Utilice la fuente roja, tamaño 14.

plot(1:10)
text(2,8,'A Simple Plot','Color','red','FontSize',14)

Cree una trama de línea y añada dos descripciones de texto a lo largo de la línea. Devuelve los objetos de texto, t.

x = linspace(-5,5);
y = x.^3-12*x;
plot(x,y)
t = text([-2 2],[16 -16],'dy/dx = 0')

t = 
  2x1 Text array:

  Text    (dy/dx = 0)
  Text    (dy/dx = 0)

La función text crea un objeto de texto para cada descripción de texto. Por lo tanto, t contiene dos objetos de texto.

Cambie el color y el tamaño de fuente del primer objeto de texto mediante t(1). A partir de R2014b, puede utilizar la notación de puntos para establecer propiedades. Si utiliza una versión anterior, utilice la función set en su lugar.

t(1).Color = 'red';
t(1).FontSize = 14;

Argumentos de entrada

contraer todo

Colocación de texto a lo largo del eje x, especificado en uno de estos formularios:

  • Escalar: permite añadir texto a un punto único.

  • Vector: permite añadir texto a varios puntos.

x y y deben ser de igual tamaño. Las unidades predeterminadas son unidades de datos. Para cambiar las unidades, establezca la propiedad Units para el objeto Text .

Para controlar la ubicación del texto con relación al punto especificado, utilice las propiedades HorizontalAlignment, VerticalAlignmenty Extent del objeto Text .

Tipos de datos: double | categorical | datetime | duration

Colocación de texto a lo largo del eje y, especificado en uno de estos formularios:

  • Escalar: permite añadir texto a un punto único.

  • Vector: permite añadir texto a varios puntos.

x y y deben ser de igual tamaño. Las unidades predeterminadas son unidades de datos. Para cambiar las unidades, establezca la propiedad Units para el objeto Text .

Para controlar la ubicación del texto con relación al punto especificado, utilice las propiedades HorizontalAlignment, VerticalAlignmenty Extent del objeto Text .

Tipos de datos: double | categorical | datetime | duration

Colocación de texto a lo largo del eje z, especificado en uno de estos formularios:

  • Escalar: permite añadir texto a un punto único.

  • Vector: permite añadir texto a varios puntos.

x , yy z deben ser tamaños iguales. Las unidades predeterminadas son unidades de datos. Para cambiar las unidades, establezca la propiedad Units para el objeto Text .

Tipos de datos: double | categorical | datetime | duration

Texto que se mostrará, especificado como vector de caracteres, cadena, array de caracteres, array de cadenas o matriz de celdas.

Texto para un punto de datos único

Para agregar texto a un único punto, especifique txt como un vector o cadena de caracteres. Por ejemplo:

Para texto multilínea:

  • Utilice una matriz de celdas, donde cada celda contiene una línea de texto. Por ejemplo:

  • Utilice una matriz de cadenas, donde cada elemento es una línea de texto. Por ejemplo:

  • Utilice una matriz de caracteres con varias filas, donde cada fila contiene el mismo número de caracteres. Por ejemplo:

  • Utilice sprintf para crear un nuevo carácter de línea. Por ejemplo:

Texto para varios puntos de datos

Para mostrar el mismo texto en cada ubicación, especifique txt como un vector o cadena de caracteres. Por ejemplo:

Para mostrar texto diferente en cada ubicación, utilice una matriz de celdas. Por ejemplo:

Para texto multilínea, utilice matrices de celdas anidadas. Por ejemplo:

Letras griegas, caracteres especiales y variables numéricas

Para incluir caracteres especiales, como superíndices, suscripciones, letras griegas o símbolos matemáticos, utilice el marcado Tex. Para obtener una lista de las marcas admitidas, vea la propiedad Interpreter .

Para incluir variables numéricas en el texto, utilice la función num2str .

v = 42;
txt = ['The value is ',num2str(v)];

Ejes de destino, especificados como un objeto Axes o un objeto PolarAxes . Si no especifica los ejes, text utiliza los ejes actuales.

Argumentos de par nombre-valor

Ejemplo: text(.5,.5,'my text','FontSize',14,'Color','red')

Las propiedades enumeradas aquí son sólo un subconjunto. Para obtener una lista completa, vea Text Properties.

Tamaño de fuente, especificado como un valor escalar mayor que cero en unidades de punto. El tamaño de fuente predeterminado depende del sistema operativo específico y de la configuración regional. Un punto equivale a 1/72 inch. Para cambiar las unidades de fuente, utilice la propiedad FontUnits .

Ejemplo: 12

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

Grosor del carácter, especificado como uno de estos valores:

  • 'normal' : Peso predeterminado definido por la fuente en particular

  • 'bold' : Contornos de caracteres más gruesos que los normales

MATLAB ® utiliza la propiedad FontWeight para seleccionar una fuente de las disponibles en el sistema. No todas las fuentes tienen un peso de fuente en negrita. Por lo tanto, especificar un peso de fuente en negrita todavía puede resultar en el peso normal de la fuente.

Nombre de fuente, se especificó un nombre de fuente admitido o 'FixedWidth'. Para mostrar e imprimir correctamente, debe elegir una fuente que admita su sistema. La fuente predeterminada depende del sistema operativo específico y de la configuración regional.

Para utilizar una fuente de ancho fijo que se vea bien en cualquier configuración regional, utilice 'FixedWidth'. El valor 'FixedWidth' se basa en la propiedad raíz FixedWidthFontName . Al establecer la propiedad raíz FixedWidthFontName , se produce una actualización inmediata de la pantalla para utilizar la nueva fuente.

Ejemplo: 'Cambria'

Color de texto, especificado como un trío RGB o una de las opciones de color enumeradas en la tabla. El valor predeterminado de [0 0 0] corresponde a negro.

Para un color personalizado, especifique un trío RGB. Un trío RGB es un vector de tres elementos cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el intervalo [0,1]; por ejemplo, [0.4 0.6 0.7]. Alternativamente, puede especificar algunos colores comunes por nombre. Esta tabla muestra las opciones de nombre de color largo y corto y los valores equivalentes de triplete RGB.

OpciónDescripciónTriplete RGB equivalente
oRojo[1 0 0]
oVerde[0 1 0]
oAzul[0 0 1]
oAmarillo[1 1 0]
oMagenta[1 0 1]
oCian[0 1 1]
oBlanco[1 1 1]
oNegro[0 0 0]
'none'Sin colorNo aplicable

Ejemplo: 'blue'

Ejemplo: [0 0 1]

Alineación horizontal del texto con respecto al valor de x en la propiedad Position , especificada como uno de los valores de esta tabla. La línea vertical indica dónde se encuentra el valor de x en relación con el texto.

ValorResultado
'left' (valor predeterminado)

'center'

'right'

Ubicación del texto, especificado como un vector de dos elementos de la forma [x y] o un vector de tres elementos de la forma [x y z]. Si omite el tercer elemento, z, MATLAB lo establece en 0.

Especifique la posición utilizando valores numéricos. Para convertir los valores DateTime o Duration en los valores numéricos apropiados para una dirección de coordenadas determinada, vea ruler2num.

De forma predeterminada, el valor de posición se define en unidades de datos. Para cambiar las unidades, utilice la propiedad Units .

Ejemplo: [0.5 0.5 0]

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

Coloque las unidades, especificadas como uno de los valores de esta tabla.

Unidades:Descripción
'data' (valor predeterminado)Coordenadas de datos.
'normalized' Normalizado con respecto a los ejes. La esquina inferior izquierda de los ejes se asigna a (0,0) y la esquina superior derecha se asigna a (1,1).
'inches'Pulgadas.
'centimeters'Centímetros.
'characters'

Basado en el tamaño predeterminado del carácter de la fuente del sistema.

  • Ancho de carácter = ancho de letra x.

  • Altura del caracter = distancia entre las líneas de base de dos lineas de texto.

'points'Puntos. Un punto equivale a 1/72 pulgadas.
'pixels'

Píxeles.

A partir de R2015b, las distancias en píxeles son independientes de la resolución del sistema en los sistemas Windows® y Macintosh :

  • En los sistemas Windows , un píxel es 1/96th de pulgada.

  • En los sistemas de Macintosh , un píxel es 1/72nd de pulgada.

En los sistemas Linux® , el tamaño de un píxel se determina mediante la resolución del sistema.

Todas las unidades, excepto 'data', se miden desde la esquina inferior izquierda de los ejes. Esta propiedad afecta a las propiedades Position y Extent .

Si especifica las propiedades Position y Units como pares Name,Value al crear el objeto Text , entonces el orden de la especificación importa. Para definir la posición con unidades determinadas, establezca la propiedad Units antes de la propiedad Position .

Interpretación de caracteres de texto, especificada como uno de estos valores:

  • 'tex' : Permite interpretar caracteres mediante un subconjunto de marcado Tex.

  • 'latex' : Permite interpretar caracteres mediante marcado de látex.

  • 'none' : Permite mostrar caracteres literales.

Tex Markup

De forma predeterminada, MATLAB admite un subconjunto de marcado Tex. Utilice el marcado Tex para agregar superíndices y subíndices, modificar el tipo de fuente y el color e incluir caracteres especiales en el texto.

Cuando se establece la propiedad Interpreter en 'tex', los modificadores admitidos son los siguientes. Los modificadores permanecen en vigencia hasta el final del texto. Los superíndices y los subíndices son una excepción porque sólo modifican el siguiente carácter o los caracteres dentro de las llaves rizadas.

ModificadorDescripciónEjemplo
^{ }Superíndice'text^{superscript}'
_{ }Subíndice'text_{subscript}'
\bfBold fuente'\bf text'
\itCursiva fuente'\it text'
\slFuente oblicua (generalmente igual que la fuente cursiva)'\sl text'
\rmNormal fuente'\rm text'
\fontname{specifier}Nombre de fuente: establezca specifier como nombre de una familia de fuentes. Puede usar esto en combinación con otros modificadores.'\fontname{Courier} text'
\fontsize{specifier}Tamaño de fuente (Font Size): permite establecer specifier como valor escalar numérico en unidades de punto para cambiar el tamaño de fuente.'\fontsize{15} text'
\color{specifier}Color de fuente — Establezca specifer como uno de estos colores: red, green, yellow, magenta, blue, black, white, gray, darkGreen, orange, o lightBlue.'\color{magenta} text'
\color[rgb]{specifier}Color de fuente personalizado: establezca specifier como triplete RGB de tres elementos.'\color[rgb]{0,0.5,0.5} text'

En esta tabla se muestran los caracteres especiales admitidos con la propiedad Interpreter establecida en 'tex'.

Secuencia de caracteresSímboloSecuencia de caracteresSímboloSecuencia de caracteresSímbolo

\alpha

a

\upsilon

Υ

\sim

~

\angle

\phi

\leq

=

\ast

*

\chi

Χ

\infty

\beta

β

\psi

Ψ

\clubsuit

\gamma

Γ

\omega

Ω

\diamondsuit

\delta

Δ

\Gamma

Γ

\heartsuit

\epsilon

ϵ

\Delta

Δ

\spadesuit

\zeta

Ζ

\Theta

Θ

\leftrightarrow

\eta

Η

\Lambda

Λ

\leftarrow

\theta

Θ

\Xi

Ξ

\Leftarrow

\vartheta

ϑ

\Pi

Π-

\uparrow

\iota

Ι

\Sigma

Σ

\rightarrow

\kappa

Κ

\Upsilon

Υ

\Rightarrow

\lambda

Λ

\Phi

F

\downarrow

\mu

µ

\Psi

Ψ

\circ

º

\nu

Ν

\Omega

Ω

\pm

±

\xi

Ξ

\forall

\geq

=

\pi

π-

\exists

\propto

\rho

Ρ

\ni

\partial

\sigma

Σ

\cong

\bullet

\varsigma

ς

\approx

\div

÷

\tau

y

\Re

\neq

\equiv

=

\oplus

\aleph

\Im

\cup

\wp

\otimes

\subseteq

\oslash

\cap

N

\in

\supseteq

\supset

\lceil

\subset

\int

\cdot

·

\o

Ο

\rfloor

\neg

¬

\nabla

\lfloor

\times

x

\ldots

...

\perp

\surd

\prime

´

\wedge

\varpi

ϖ

\0

\rceil

\rangle

\mid

|

\vee

\langle

\copyright

©

Látex marcado

Para utilizar el marcado de látex, establezca la propiedad Interpreter en 'latex'. Utilice símbolos de dólar alrededor del texto, por ejemplo, utilice '$\int_1^{20} x^2 dx$' para el modo en línea o '$$\int_1^{20} x^2 dx$$' para el modo de visualización.

El texto mostrado utiliza el estilo de fuente latex predeterminado. Las propiedades FontName, FontWeighty FontAngle no tienen ningún efecto. Para cambiar el estilo de fuente, utilice el marcado latex.

El tamaño máximo del texto que se puede utilizar con el intérprete de latex es de 1200 caracteres. Para texto multilínea, esto reduce aproximadamente 10 caracteres por línea.

Para obtener más información sobre el sistema latex, consulte el sitio web del proyecto latex en http://www.latex-Project.org/.

Argumentos de salida

contraer todo

Text objetos . Utilice los elementos de t para modificar un objeto Text específico después de crearlo. Para obtener una lista de propiedades, vea Text Properties.

Sugerencias

  • De forma predeterminada, la propiedad Clipping para los objetos de texto se establece en 'off' para que el texto pueda aparecer fuera de los ejes. Para recortar el texto a los límites de los ejes, establezca la propiedad en 'on'.

Introducido antes de R2006a