love.graphics.printf

Отображает форматированный текст с обёртыванием по словам и выравниванием.

См. дополнительные замечания в love.graphics.print.

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

В версии 0.9.2 и более ранних версиях обёртывание осуществлялось путём разделения слов по пробелам и их последующего объединения для обеспечения корректного отображения в пределах заданного предела. Однако, из-за этого способа, дополнительные пробелы между словами могли пропадать при выводе на экран, а некоторые строки могли превышать предоставленный предел обёртывания. В версии 0.10.0 и более новых версиях это больше не происходит.

В версиях до 11.0 значения цвета и байтовых компонентов находились в диапазоне от 0 до 255 вместо 0 до 1.

Выравнивание работает не так, как можно ожидать! Оно выравнивается не по заданным координатам x/y, а по прямоугольнику, где предел — ширина.

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

Функция

Описание

love.graphics.printf( text, x, y, limit, align, r, sx, sy, ox, oy, kx, ky )

Аргументы

string text

Строка текста.

number x

Позиция по оси x.

number y

Позиция по оси y.

number limit

Обрезать строку после этого количества пикселей по горизонтали.

AlignMode align ("left")

Выравнивание.

number r (0) Доступно начиная с 0.9.0

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

number sx (1) Доступно начиная с 0.9.0

Масштабный коэффициент (ось x).

number sy (sx) Доступно начиная с 0.9.0

Масштабный коэффициент (ось y).

number ox (0) Доступно начиная с 0.9.0

Смещение начала координат (ось x).

number oy (0) Доступно начиная с 0.9.0

Смещение начала координат (ось y).

number kx (0) Доступно начиная с 0.9.0

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

number ky (0) Доступно начиная с 0.9.0

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

Возвращаемое значение

Ничего.

Функция

Доступно начиная с LÖVE 11.0
Данный вариант не поддерживается в более ранних версиях.

Описание

love.graphics.printf( text, font, x, y, limit, align, r, sx, sy, ox, oy, kx, ky )

Аргументы

string text

Строка текста.

Font font

Объект шрифта.

number x

Позиция по оси x.

number y

Позиция по оси y.

number limit

Обрезать строку после этого количества пикселей по горизонтали.

AlignMode align ("left")

Выравнивание.

number r (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).

Возвращаемое значение

Ничего.

Функция

Доступно начиная с LÖVE 11.0
Данный вариант не поддерживается в более ранних версиях.

Описание

love.graphics.printf( text, transform, limit, align )

Аргументы

string text

Строка текста.

Transform transform

Объект преобразования.

number limit

Обрезать строку после этого количества пикселей по горизонтали.

AlignMode align ("left")

Выравнивание.

Возвращаемое значение

Ничего.

Функция

Доступно начиная с LÖVE 11.0
Данный вариант не поддерживается в более ранних версиях.

Описание

love.graphics.printf( text, font, transform, limit, align )

Аргументы

string text

Строка текста.

Font font

Объект шрифта.

Transform transform

Объект преобразования.

number limit

Обрезать строку после этого количества пикселей по горизонтали.

AlignMode align ("left")

Выравнивание.

Возвращаемое значение

Ничего.

Функция

Доступно начиная с LÖVE 0.10.0
Данный вариант не поддерживается в более ранних версиях.

Описание

love.graphics.printf( coloredtext, x, y, limit, align, 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 x

Позиция текста (ось x).

number y

Позиция текста (ось y).

number limit

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

AlignMode align

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

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).

Возвращаемое значение

Ничего.

Примечания

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

Функция

Доступно начиная с LÖVE 11.0
Данный вариант не поддерживается в более ранних версиях.

Описание

love.graphics.printf( coloredtext, font, x, y, limit, align, 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 ...

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

Font font

Объект шрифта.

number x

Позиция по оси x.

number y

Позиция по оси y.

number limit

Обрезать строку после этого количества пикселей по горизонтали.

AlignMode align ("left")

Выравнивание.

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).

Возвращаемое значение

Ничего.

Примечания

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

Функция

Доступно начиная с LÖVE 11.0
Данный вариант не поддерживается в более ранних версиях.

Описание

love.graphics.printf( coloredtext, transform, limit, align )

Аргументы

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 ...

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

Transform transform

Объект преобразования.

number limit

Обрезать строку после этого количества пикселей по горизонтали.

AlignMode align ("left")

Выравнивание.

Возвращаемое значение

Ничего.

Примечания

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

Функция

Доступно начиная с LÖVE 11.0
Данный вариант не поддерживается в более ранних версиях.

Краткое описание

love.graphics.printf( coloredtext, font, transform, limit, align )

Аргументы

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 ...

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

Font font

Объект шрифта для использования.

Transform transform

Объект преобразования.

number limit

Разрыв строки после указанного количества горизонтальных пикселей.

AlignMode align ("left")

Выравнивание.

Возвращаемое значение

Ничего.

Примечания

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

Примеры

Отображение текста на экране с правым выравниванием и горизонтальным ограничением в 125 пикселей.

love.graphics.printf("This text is aligned right, and wraps when it gets too big.", 25, 25, 125, "right")

Примечания

Обратите внимание, что аргумент ограничения влияет на положение текста при выравнивании по центру и справа.

love.graphics.printf("This text is aligned center",100, 100, 200,"center") -- center your text around x = 200/2 + 100 = 200
love.graphics.printf("This text is aligned right",100, 100, 200,"right") -- align right to x = 100 + 200 = 300

См. также

• love.graphics
• Font:getWrap