# text

creates text descriptions to data points.

## 📝 Syntax

* text(x, y, txt)
* text(x, y, z, txt)
* text(... , propertyName, propertyValue)
* text(ax, ...)
* go = text(...)

## 📥 Input argument

* x - x-coordinates: vector or matrix.
* y - y-coordinates: vector or matrix.
* z - z-coordinates: vector or matrix.
* parent - a scalar graphics object value: parent container, specified as a axes.
* text - Text to display: character vector, string scalar, string array or cell array.
* propertyName - a scalar string or row vector character.
* propertyValue - a value.

## 📤 Output argument

* go - a graphics object: text type.

## 📄 Description

figure creates figure.

| Property                | Description                                                                                                                         |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **BackgroundColor**     | Color of text box background: RGB triplet.                                                                                          |
| **Children**            | Children: \[].                                                                                                                      |
| **Color**               | Text color: RGB triplet, \[0 0 0] (default) or hexadecimal color code.                                                              |
| **EdgeColor**           | Color of box outline: RGB triplet.                                                                                                  |
| **Extent**              | Size and location of rectangle that encloses text: four-element vector.                                                             |
| **FontAngle**           | Character slant: 'italic' or 'normal' (default).                                                                                    |
| **FontName**            | Font name:                                                                                                                          |
| **FontSize**            | Font size: scalar value greater than zero.                                                                                          |
| **FontUnits**           | Font size units: 'inches', 'centimeters', 'normalized', 'pixels' or 'points' (default).                                             |
| **FontWeight**          | Character thickness: 'bold' or 'normal' (default).                                                                                  |
| **HorizontalAlignment** | Horizontal alignment of text with respect to position point: 'center', 'right', 'left' (default).                                   |
| **Interpreter**         | 'tex' (default) interpreter or 'none'.                                                                                              |
| **LineStyle**           | Line style of box outline: 'none', '--', ':', '-.' or '-' (default).                                                                |
| **LineWidth**           | Width of box outline: scalar numeric value.                                                                                         |
| **Margin**              | Space around text within the text box: scalar numeric value.                                                                        |
| **Parent**              | Parent: axes object.                                                                                                                |
| **Position**            | Location of text: two-element vector of form \[x y] or three-element vector of form \[x y z].                                       |
| **Rotation**            | Text orientation: scalar value in degrees.                                                                                          |
| **String**              | Text to display: character vector, cell array of character vectors, string array, numeric value or '' (default).                    |
| **Tag**                 | Object identifier: character vector, string scalar or '' (default).                                                                 |
| **Type**                | Type of graphics object: 'text'.                                                                                                    |
| **Units**               | Position and extent units: 'normalized', 'inches', 'centimeters', 'characters', 'points', 'pixels' or 'data' (default).             |
| **UserData**            | User data: array or \[] (default).                                                                                                  |
| **VerticalAlignment**   | Vertical alignment of text with respect to position point.                                                                          |
| **Visible**             | State of visibility: 'off' or 'on' (default).                                                                                       |
| **CreateFcn**           | Callback (function handle, string or cell) called when object is created. Set this property on an existing component has no effect. |
| **DeleteFcn**           | Callback (function handle, string or cell) called when object is deleted.                                                           |
| **BeingDeleted**        | Flag indicating that the object is being deleted.                                                                                   |

Some properties are available only for compatibility and have currently no effect on the text.

lists of the supported special characters for the 'tex' interpreter:

Superscript: ^{ } 'text^{superscript}'

Subscript: \_{ } 'text\_{subscript}'

| Character Sequence | Symbol |
| ------------------ | ------ |
| \alpha             | α      |
| \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               | Φ      |
| \downarrow         | ↓      |
| \mu                | µ      |
| \Psi               | Ψ      |
| \circ              | º      |
| \nu                | ν      |
| \Omega             | Ω      |
| \pm                | ±      |
| \xi                | ξ      |
| \forall            | ∀      |
| \geq               | ≥      |
| \pi                | π      |
| \exists            | ∃      |
| \propto            | ∝      |
| \rho               | ρ      |
| \ni                | ∍      |
| \partial           | ∂      |
| \sigma             | σ      |
| \cong              | ≅      |
| \bullet            | •      |
| \varsigma          | ς      |
| \approx            | ≈      |
| \div               | ÷      |
| \tau               | τ      |
| \Re                | ℜ      |
| \neq               | ≠      |
| \equiv             | ≡      |
| \oplus             | ⊕      |
| \aleph             | ℵ      |
| \Im                | ℑ      |
| \cup               | ∪      |
| \wp                | ℘      |
| \otimes            | ⊗      |
| \subseteq          | ⊆      |
| \oslash            | ∅      |
| \cap               | ∩      |
| \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         | ©      |

## 💡 Examples

```matlab
f = figure(1)
t = text(0.5, 0.5, 'text here');
s = t.FontSize;
t.FontSize = 12;
t.Color = 'red';

```

![](broken-reference)

```matlab
figure();
ha = {'left', 'center', 'right'};
va = {'bottom', 'middle', 'top'};
color = {'red', 'green', 'blue'};
x = [0.25 0.5 0.75];
y = x;
for t = 0:45:359;
  for nh = 1:numel (ha)
    for nv = 1:numel (va)
      text (x(nh), y(nv), 'Nelson', ...
      'Rotation', t, ...
      'HorizontalAlignment', ha{nh}, ...
      'VerticalAlignment', va{nv}, ...
      'Color', color{nv});
    end
  end
end
axis([0 1 0 1]);
title (_('Text alignment and rotation (0:45:360 degrees)'));
xlabel(_('Horizontal alignment'));
ylabel (_('Vertical alignment'));
```

![](https://160667757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LdPvJ6mJve3gz5MU4d1%2Fuploads%2Fgit-blob-cb6bbcca62f22925472cf03e39b83e5c96ee6047%2Ftext_2.svg?alt=media)

```matlab
figure();
h1 = text(0.5, 0.5, 'Nelson \copyright')
h1.String
% Nelson is full unicode, so
h2 = text(0.5, 0.3, 'OR Nelson ©')
h2.String
```

## 🔗 See also

[title](https://nelson-9.gitbook.io/nelson/markdown/en/graphics/title).

## 🕔 History

| Version | 📄 Description                       |
| ------- | ------------------------------------ |
| 1.0.0   | initial version                      |
| 1.7.0   | CreateFcn, DeleteFcn callback added. |
| --      | BeingDeleted property added.         |