Текст:addf

Доступно с LÖVE 0.10.0
Эта функция не поддерживается в более ранних версиях.

Добавляет дополнительный форматированный/цветной текст к объекту Text в указанной позиции.

Предел обрезки слов применяется до любого масштабирования, вращения и других преобразований координат. Следовательно, количество текста на строке остается постоянным при одинаковом пределе обрезки, даже если изменяются аргументы масштаба.

Текст может выглядеть размытым, если он отрисовывается в нецелых пиксельных координатах.

Функция

Синопсис

index = Text:addf( textstring, wraplimit, alignmode, x, y, angle, sx, sy, ox, oy, kx, ky )

Аргументы

string textstring

Текст, который нужно добавить к объекту.

number wraplimit

Максимальная ширина текста в пикселях перед автоматическим переносом на новую строку.

AlignMode align

Выравнивание текста.

number x

Позиция нового текста (ось X).

number y

Позиция нового текста (ось Y).

number angle (0)

Ориентация (радиан).

number sx (1)

Коэффициент масштаба (ось X).

number sy (sx)

Коэффициент масштаба (ось Y).

number ox (0)

Смещение начала (ось X).

number oy (0)

Смещение начала (ось Y).

number kx (0)

Коэффициент наклона (ось X).

number ky (0)

Коэффициент наклона (ось Y).

Возвращает

number index

Номер индекса, который можно использовать с Text:getWidth или Text:getHeight.

Функция

Синопсис

index = Text:addf( coloredtext, wraplimit, alignmode, x, y, angle, sx, sy, ox, oy, kx, ky )

Аргументы

table coloredtext

Таблица, содержащая цвета и строки для добавления в объект, в формате {color1, string1, color2, string2, ...}.

table color1

Таблица, содержащая значения красного, зелёного, синего и (необязательного) альфа-компонентов для использования в качестве цвета для следующей строки в таблице, в формате {red, green, blue, alpha}.

string string1

Строка текста, цвет которой задаётся предыдущим цветом.

table color2

Таблица, содержащая значения красного, зелёного, синего и (необязательного) альфа-компонентов для использования в качестве цвета для следующей строки в таблице, в формате {red, green, blue, alpha}.

string string2

Строка текста, цвет которой задаётся предыдущим цветом.

tables and strings ...

Дополнительные цвета и строки.

number wraplimit

Максимальная ширина текста в пикселях перед автоматическим переносом на новую строку.

AlignMode align

Выравнивание текста.

number x

Позиция нового текста (ось X).

number y

Позиция нового текста (ось Y).

number angle (0)

Ориентация (радиан).

number sx (1)

Коэффициент масштаба (ось X).

number sy (sx)

Коэффициент масштаба (ось Y).

number ox (0)

Смещение начала (ось X).

number oy (0)

Смещение начала (ось Y).

number kx (0)

Коэффициент наклона (ось X).

number ky (0)

Коэффициент наклона (ось Y).

Возвращает

number index

Номер индекса, который можно использовать с Text:getWidth или Text:getHeight.

Примечания

Цвет, установленный с помощью love.graphics.setColor, будет комбинироваться (умножаться) с цветами текста при отрисовке объекта Text.

См. также

• Text
• Text:add
• Text:set
• Text:setf
• Text:clear