gtext

Добавление текста к фигуре с помощью мыши

Синтаксис

gtext (str)

gtext (str, имя, значение)

t = gtext (___)

Описание

gtext(str) вставляет текст, str, в месте, выбранном с помощью мыши. При наведении курсора на окно фигуры указатель становится перекрестием. gtext ожидает выбора местоположения. Переместите указатель в нужное место и либо щелкните фигуру, либо нажмите любую клавишу, кроме Enter.

gtext(str,Name,Value) задает свойства текста, используя один или несколько аргументов пары имя-значение. Например, 'FontSize',14 указывает 14-точечный шрифт.

t = gtext(___) возвращает массив текстовых объектов, созданных gtext. Использовать t для изменения свойств текстовых объектов после их создания. Список свойств и описаний см. в разделе Свойства текста. Можно вернуть выходной аргумент, используя любой из аргументов из предыдущих синтаксисов.

Примеры

свернуть все

Добавление текста на рисунок с помощью мыши

Создание простого линейного графика и использование gtext для добавления текста к рисунку с помощью мыши.

plot(1:10)
gtext('My Plot')

Щелкните на рисунке для размещения текста в выбранном месте.

Задать размер и цвет шрифта

Создайте простой график линии и добавьте текст к фигуре с помощью мыши. Используйте красный 14-точечный шрифт.

plot(1:10)
gtext('My Plot','Color','red','FontSize',14)

Щелкните рисунок, на котором требуется отобразить текст.

Изменить текст после создания

Создайте простой график линии и добавьте текст к фигуре с помощью мыши. Возвращает созданный текстовый объект, t.

plot(1:10)
t = gtext('My Plot')

Щелкните фигуру, чтобы разместить текст и создать текстовый объект.

t = 

  Text (My Plot) with properties:

                 String: 'My Plot'
               FontSize: 10
             FontWeight: 'normal'
               FontName: 'Helvetica'
                  Color: [0 0 0]
    HorizontalAlignment: 'left'
               Position: [4.3906 5.3950 0]
                  Units: 'data'

  Show all properties

Использовать t изменение размера шрифта и цвета текста путем задания свойств текста. Для задания свойств используйте точечную нотацию.

t.Color = 'red';
t.FontSize = 14;

Входные аргументы

свернуть все

`str` - Текст для отображения
символьный вектор | массив ячеек символьных векторов | символьный массив | строковый массив

Текст для отображения, указанный в одной из следующих форм:

Символьный вектор - отображение текста одним щелчком, например:
```
gtext('my text')
```
Массив ячеек символьных векторов - отображение одной строки массива с каждым щелчком мыши. Например, этот код отображается first первым щелчком и second вторым щелчком.
```
gtext({'first';'second'})
```
Для отображения многострочного текста укажите несколько символьных векторов в строке.
```
gtext({'first','new line';'second','new line'})
```
Символьный массив - отображение одной строки массива с каждым щелчком мыши. Каждая строка должна содержать одинаковое количество символов, например:
```
gtext(['one';'two'])
```
Строковый массив - отображение одной строки массива с каждым щелчком. Например:
```
gtext(["one";"two"])
```

Чтобы включить специальные символы, такие как надстрочные, подстрочные, греческие буквы или математические символы, используйте разметку TeX. Список поддерживаемых пометок см. в разделе Interpreter собственность.

Аргументы пары «имя-значение»

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: text(.5,.5,'my text','FontSize',14,'Color','red')

Перечисленные здесь свойства являются только подмножеством. Полный список см. в разделе Свойства текста.

Примечание

Вы не можете указать Position свойство text как пара имя-значение во время создания текста. gtext игнорирует указанное значение.

`'FontSize'` - Размер шрифта
скалярное значение больше нуля

Размер шрифта, заданный как скалярное значение, большее нуля в единицах измерения точки. Размер шрифта по умолчанию зависит от конкретной операционной системы и языка. Одна точка равна 1/72 дюйм. Для изменения единиц шрифта используйте FontUnits собственность.

Пример: 12

`'FontWeight'` - Толщина символа
`'normal'` (по умолчанию) | `'bold'`

Толщина символа, указанная как 'normal' или 'bold'.

MATLAB ® использует FontWeight для выбора шрифта из доступных в системе. Не все шрифты имеют жирный вес. Поэтому задание полужирного веса шрифта может привести к нормальному весу шрифта.

`'FontName'` - Название шрифта
поддерживаемое имя шрифта | `'FixedWidth'`

Имя шрифта, указанное как имя поддерживаемого шрифта или 'FixedWidth'. Для правильного отображения и печати текста необходимо выбрать шрифт, поддерживаемый системой. Шрифт по умолчанию зависит от операционной системы и языка.

Чтобы использовать шрифт фиксированной ширины, который хорошо выглядит в любом языковом стандарте, используйте 'FixedWidth'. Шрифт фиксированной ширины зависит от корня FixedWidthFontName собственность. Установка корня FixedWidthFontName приводит к немедленному обновлению отображения для использования нового шрифта.

`'Color'` - Цвет текста
`[0 0 0]` (по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

Цвет текста, указанный как триплет RGB, шестнадцатеричный код цвета, имя цвета или короткое имя. Значение по умолчанию [0 0 0] соответствует черному.

Для пользовательского цвета укажите триплет RGB или шестнадцатеричный цветовой код.

Триплет RGB - это трехэлементный вектор строки, элементы которого задают интенсивности красной, зеленой и синей составляющих цвета. Интенсивности должны находиться в диапазоне [0,1]; например, [0.4 0.6 0.7].
Шестнадцатеричный цветовой код - это символьный вектор или строковый скаляр, начинающийся с хэш-символа (#), за которыми следуют три или шесть шестнадцатеричных цифр, которые могут варьироваться от 0 кому F. Значения не чувствительны к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Можно также задать некоторые общие цвета по имени. В этой таблице перечислены параметры именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Имя цвета	Краткое имя	Триплет RGB	Шестнадцатеричный цветовой код	Внешность
`'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'`	Неприменимо	Неприменимо	Неприменимо	Без цвета

Вот триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB, используемых на многих типах графиков.

Триплет RGB	Шестнадцатеричный цветовой код	Внешность
`[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'`

Пример: 'blue'

Пример: [0 0 1]

Пример: '#0000FF'

`'HorizontalAlignment'` - Выравнивание текста по горизонтали относительно точки положения
`'left'` (по умолчанию) | `'center'` | `'right'`

Выравнивание текста по горизонтали относительно x значение в поле Position , указанное как одно из значений в этой таблице. Вертикальная линия указывает, где x значение лежит по отношению к тексту.

Стоимость Результат

Стоимость	Результат
`'left'` (по умолчанию)
`'center'`
`'right'`

'left' (по умолчанию)

'center'

'right'

`'Interpreter'` - Текстовый интерпретатор
`'tex'` (по умолчанию) | `'latex'` | `'none'`

Текстовый интерпретатор, указанный как одно из следующих значений:

'tex' - интерпретировать символы с помощью подмножества разметки TeX.
'latex' - Интерпретировать символы с помощью разметки LaTeX.
'none' - Отображение буквенных символов.

Разметка TeX

По умолчанию MATLAB поддерживает подмножество разметки TeX. Используйте разметку TeX для добавления надстрочных и подстрочных индексов, изменения типа и цвета шрифта и включения в текст специальных символов.

Модификаторы остаются в силе до конца текста. Надстрочные и подстрочные индексы являются исключением, поскольку они изменяют только следующий символ или символы в фигурных скобках. При установке для интерпретатора значения 'tex'поддерживаются следующие модификаторы.

Модификатор	Описание	Пример
`^{ }`	Верхний индекс	`'text^{superscript}'`
`_{ }`	Нижний индекс	`'text_{subscript}'`
`\bf`	Полужирный шрифт	`'\bf text'`
`\it`	Курсивный шрифт	`'\it text'`
`\sl`	Косой шрифт (обычно такой же, как курсив)	`'\sl text'`
`\rm`	Обычный шрифт	`'\rm text'`
`\fontname{specifier}`	Имя шрифта - Заменить `specifier` с именем семейства шрифтов. Это можно использовать в сочетании с другими модификаторами.	`'\fontname{Courier} text'`
`\fontsize{specifier}`	Размер шрифта - Заменить`specifier` с числовым скалярным значением в единицах измерения точки.	`'\fontsize{15} text'`
`\color{specifier}`	Цвет шрифта - Заменить `specifier` с одним из следующих цветов: `red`, `green`, `yellow`, `magenta`, `blue`, `black`, `white`, `gray`, `darkGreen`, `orange`, или `lightBlue`.	`'\color{magenta} text'`
`\color[rgb]{specifier}`	Цвет пользовательского шрифта - Заменить `specifier` с трехэлементным триплетом RGB.	`'\color[rgb]{0,0.5,0.5} text'`

В этой таблице перечислены поддерживаемые специальные символы для 'tex' переводчик.

Последовательность символов	Символ	Последовательность символов	Символ	Последовательность символов	Символ
`\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`	©

Разметка LaTeX

Чтобы использовать разметку LaTeX, установите для интерпретатора значение 'latex'. Для встроенного режима окружить разметку однодолларовыми знаками ($). Для режима отображения обведите разметку двойными знаками доллара ($$).

Режим LaTeX	Пример	Результат
Действующий	'$\int_1^{20} x^2 dx$'
Показ	'$$\int_1^{20} x^2 dx$$'

Режим LaTeX

Пример

Результат

Действующий

'$\int_1^{20} x^2 dx$'

Equation with LaTeX inline mode.

Показ

'$$\int_1^{20} x^2 dx$$'

Equation with LaTeX display mode.

В отображаемом тексте используется стиль шрифта LaTeX по умолчанию. FontName, FontWeight, и FontAngle свойства не имеют эффекта. Чтобы изменить стиль шрифта, используйте разметку LaTeX.

Максимальный размер текста, который можно использовать с интерпретатором LaTeX, составляет 1200 символов. Для многострочного текста это уменьшает приблизительно на 10 символов на строку.

Примеры использования TeX и LaTeX см. в разделе Греческие буквы и специальные символы в тексте диаграммы. Дополнительные сведения о системе LaTeX см. на веб-сайте проекта LaTeX по адресу https://www.latex-project.org/.

Алгоритмы

gtext использует ginput и text функции.

См. также

Представлен до R2006a

Документация

gtext

Синтаксис

Описание

Примеры

Добавление текста на рисунок с помощью мыши

Задать размер и цвет шрифта

Изменить текст после создания

Входные аргументы

`str` - Текст для отображения
символьный вектор | массив ячеек символьных векторов | символьный массив | строковый массив

Аргументы пары «имя-значение»

`'FontSize'` - Размер шрифта
скалярное значение больше нуля

`'FontWeight'` - Толщина символа
`'normal'` (по умолчанию) | `'bold'`

`'FontName'` - Название шрифта
поддерживаемое имя шрифта | `'FixedWidth'`

`'Color'` - Цвет текста
`[0 0 0]` (по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

`'HorizontalAlignment'` - Выравнивание текста по горизонтали относительно точки положения
`'left'` (по умолчанию) | `'center'` | `'right'`

`'Interpreter'` - Текстовый интерпретатор
`'tex'` (по умолчанию) | `'latex'` | `'none'`

Разметка TeX

Разметка LaTeX

Алгоритмы

См. также

Функции

Свойства

Темы

Документация MATLAB

Поддержка

Документация

gtext

Синтаксис

Описание

Примеры

Добавление текста на рисунок с помощью мыши

Задать размер и цвет шрифта

Изменить текст после создания

Входные аргументы

str - Текст для отображения символьный вектор | массив ячеек символьных векторов | символьный массив | строковый массив

Аргументы пары «имя-значение»

'FontSize' - Размер шрифта скалярное значение больше нуля

'FontWeight' - Толщина символа 'normal' (по умолчанию) | 'bold'

'FontName' - Название шрифта поддерживаемое имя шрифта | 'FixedWidth'

'Color' - Цвет текста [0 0 0] (по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | 'r' | 'g' | 'b' | ...

'HorizontalAlignment' - Выравнивание текста по горизонтали относительно точки положения 'left' (по умолчанию) | 'center' | 'right'

'Interpreter' - Текстовый интерпретатор 'tex' (по умолчанию) | 'latex' | 'none'

Разметка TeX

Разметка LaTeX

Алгоритмы

См. также

Функции

Свойства

Темы

Документация MATLAB

Поддержка

`str` - Текст для отображения
символьный вектор | массив ячеек символьных векторов | символьный массив | строковый массив

`'FontSize'` - Размер шрифта
скалярное значение больше нуля

`'FontWeight'` - Толщина символа
`'normal'` (по умолчанию) | `'bold'`

`'FontName'` - Название шрифта
поддерживаемое имя шрифта | `'FixedWidth'`

`'Color'` - Цвет текста
`[0 0 0]` (по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

`'HorizontalAlignment'` - Выравнивание текста по горизонтали относительно точки положения
`'left'` (по умолчанию) | `'center'` | `'right'`

`'Interpreter'` - Текстовый интерпретатор
`'tex'` (по умолчанию) | `'latex'` | `'none'`