plot::Text2d

2D текст

Блокноты MuPAD® будут демонтированы в будущем релизе. Используйте live скрипты MATLAB® вместо этого.

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

Синтаксис

plot::Text2d(text, [x, y], <a = amin .. amax>, options)

Описание

plot::Text2d чертит текст в данном положении (x, y) (“точка привязки”). Атрибуты VerticalAlignment и HorizontalAlignment определите выравнивание текста w.r.t. его привязка.

Размер, цвет текста, типом шрифта и т.д. управляет атрибут TextFont.

Текст может состоять из нескольких линий. Символ новой строки в MuPAD® представляет в виде строки ist \n. Например: "first line\nsecond line".

Атрибут TextRotation позволяет вращать текст на экране.

Текст текстового объекта может быть анимирован, если он передается как процедура, которая возвращает текстовую строку во время времени выполнения. См. Пример 5.

Атрибуты

АтрибутЦельЗначение по умолчанию
AffectViewingBoxвлияние объектов на ViewingBox из сценыTRUE
Framesколичество систем координат в анимации50
HorizontalAlignmentвыравнивание по горизонтали текстовых объектов w.r.t. их координатыLeft
Legendделает запись легенды 
LegendTextкороткий объяснительный текст для легенды 
LegendEntryдобавить этот объект в легенду?FALSE
Nameимя объекта графика (для браузера и легенды) 
ParameterEndзакончите значение параметра анимации 
ParameterNameимя параметра анимации 
ParameterBeginначальное значение параметра анимации 
ParameterRangeобласть значений параметра анимации 
Positionположения камер, световых сигналов и текстовых объектов 
PositionXx-положения камер, световых сигналов и текстовых объектов 
PositionYy-положения камер, световых сигналов и текстовых объектов 
Textтекст текстового объекта 
TextFontшрифт текстовых объектов[" sans-serif ", 11]
TextRotationвращение 2D текста0
TimeEndвремя окончания анимации10.0
TimeBeginвремя начала анимации0.0
TimeRangeоперативный промежуток анимации0.0.. 10.0
Titleобъектный заголовок 
TitleFontшрифт объектных заголовков[" sans-serif ", 11]
TitlePositionположение объектных заголовков 
TitleAlignmentвыравнивание по горизонтали заголовков w.r.t. их координатыCenter
TitlePositionXположение объектных заголовков, x компонент 
TitlePositionYположение объектных заголовков, y компонент 
VerticalAlignmentвыравнивание по вертикали текстовых объектов w.r.t. их координатыBaseLine
VisibleвидимостьTRUE
VisibleAfterобъект, видимый после этой временной стоимости 
VisibleBeforeобъект, видимый до этой временной стоимости 
VisibleFromToобъект, видимый в это время, располагается 
VisibleAfterEndобъект, видимый после его законченного времени анимации?TRUE
VisibleBeforeBeginобъект, видимый перед его временем анимации, запускается?TRUE

Примеры

Пример 1

Мы чертим текстовую строку 'Hello World!' в точке привязки (1, 2), который обозначается красной точкой:

plot(plot::Rectangle(0..2, 0..4),
     plot::Point2d([1, 2]),
     plot::Text2d("Hello world!", [1, 2],
                  HorizontalAlignment = Center), 
     Axes = Frame, TextFont = [24],
     PointColor = RGB::Red, PointSize = 3*unit::mm)

Пример 2

Мы анимируем точки привязки следующих текстов и демонстрируем различные возможности выравнивания:

plot(plot::Circle2d(1),
     plot::Point2d([sin(a), cos(a)], a = 0..2*PI), 
     plot::Point2d([cos(a), -sin(a)], a = 0..2*PI),
     plot::Point2d([-sin(a), -cos(a)], a = 0..2*PI),
     plot::Point2d([-cos(a), sin(a)], a = 0..2*PI),
     PointColor = RGB::Red, PointSize = 3*unit::mm,
     plot::Text2d("Hello (1)", [sin(a), cos(a)], a = 0..2*PI),
     plot::Text2d("Hello (2)", [cos(a), -sin(a)], a = 0..2*PI,
                  HorizontalAlignment = Left,
                  VerticalAlignment = BaseLine),
     plot::Text2d("Hello (3)", [-sin(a), -cos(a)], a = 0..2*PI,
                  HorizontalAlignment = Center,
                  VerticalAlignment = Top),
     plot::Text2d("Hello (4)", [-cos(a), sin(a)], a = 0..2*PI,
                  HorizontalAlignment = Right,
                  VerticalAlignment = Bottom),
     TextFont = [Italic, 24], Axes = Frame)

Пример 3

Текст может состоять из нескольких линий. Символом новой строки в строках MuPAD является \n:

plot(plot::Text2d("A text can\nhave several\nlines", 
                  [sin(a), cos(a)], a = 0..2*PI),
     Axes = Frame, TextFont = [20])

Пример 4

Атрибут TextRotation позволяет вращать 2D текст на экране:

plot(plot::Circle2d(sqrt(2)),
     plot::Text2d("Hello (1)", [ 1, 1], 
                  HorizontalAlignment = Left,
                  TextRotation = PI/4),
     plot::Text2d("Hello (2)", [ 1,-1], 
                  HorizontalAlignment = Left,
                  TextRotation = -PI/4),
     plot::Text2d("Hello (3)", [-1,-1], 
                  HorizontalAlignment = Right,
                  TextRotation = PI/4),
     plot::Text2d("Hello (4)", [-1, 1], 
                  HorizontalAlignment = Right,
                  TextRotation = -PI/4),
     HorizontalAlignment = Left, TextFont = [20])

Пример 5

Текст текстового объекта может быть анимирован, если текстовая строка предоставлена процедурой. Мы используем stringlib::formatf чтобы отформатировать параметр анимации, который передается процедуре как число с плавающей запятой для каждой системы координат анимации:

plot(plot::Rectangle(-1..1, -1..1),
     plot::Text2d(a -> stringlib::formatf(a, 2, 5)." sec",
                  [0, 0], a = 0..20),
     TextFont = [60], 
     HorizontalAlignment = Center, VerticalAlignment = Center,
     Axes = Frame, Frames = 201, TimeRange = 0..20)

Параметры

text

Текст: строка. В качестве альтернативы процедура, которая принимает входной параметр того a (параметр анимации) и возвращает строку.

text эквивалентно атрибуту Text.

xY

Положение текста. Координаты x и y должны быть действительные численные значения или арифметические выражения параметра анимации a.

xY эквивалентны атрибутам Position, PositionX, PositionY.

a

Параметр анимации, заданный как a = amin..amax, где amin начальное значение параметров и amax итоговое значение параметров.

Смотрите также

Функции MuPAD

MuPAD графические примитивы

Для просмотра документации необходимо авторизоваться на сайте