love.graphics.print

Выводит текст на экран. Если шрифт Шрифт не задан, он будет создан и установлен (один раз), если необходимо.

Начиная с LOVE 0.7.1, при использовании функций перевода и масштабирования при отрисовке текста, эта функция предполагает, что масштабирование происходит в первую очередь. Если вы не учитываете это при написании скрипта, текст может оказаться не в правильном положении или даже не отобразиться на экране.

love.graphics.print и love.graphics.printf обе поддерживают кодировку UTF-8. Вам также потребуется подходящий Шрифт для специальных символов.

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

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

Функция

Синопсис

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

Аргументы

string text

Текст для отрисовки.

number x (0)

Позиция для отрисовки объекта (ось X).

number y (0)

Позиция для отрисовки объекта (ось Y).

number r (0)

Направление (радиан).

number sx (1)

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

number sy (sx)

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

number ox (0)

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

number oy (0)

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

number kx (0) Доступно с 0.8.0

Коэффициент сдвига (ось X).

number ky (0) Доступно с 0.8.0

Коэффициент сдвига (ось Y).

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

Ничего.

Функция

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

Синопсис

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

Аргументы

string text

Текст для отрисовки.

Font font

Объект шрифта, который нужно использовать.

number x (0)

Позиция текста по оси X.

number y (0)

Позиция текста по оси 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.

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

Ничего.

Функция

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

Синопсис

love.graphics.print( coloredtext, 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 x (0)

Позиция текста по оси X.

number y (0)

Позиция текста по оси 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.

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

Ничего.

Примечания

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

Функция

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

Синопсис

love.graphics.print( coloredtext, font, 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 ...

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

Font font

Объект шрифта, который нужно использовать.

number x (0)

Позиция текста по оси X.

number y (0)

Позиция текста по оси 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.

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

Ничего.

Примечания

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

Функция

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

Синопсис

love.graphics.print( text, transform )

Аргументы

string text

Текст для отрисовки.

Transform transform

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

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

Ничего.

Функция

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

Синопсис

love.graphics.print( text, font, transform )

Аргументы

string text

Текст для отрисовки.

Font font

Объект шрифта, который нужно использовать.

Transform transform

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

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

Ничего.

Функция

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

Синопсис

love.graphics.print( coloredtext, transform )

Аргументы

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

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

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

Ничего.

Примечания

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

Функция

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

Синопсис

love.graphics.print( coloredtext, font, transform )

Аргументы

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

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

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

Ничего.

Примечания

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

Примеры

Пример

function love.draw()
    love.graphics.setColor(0, 1, 0, 1)
    love.graphics.print("This is a pretty lame example.", 10, 200)
    love.graphics.setColor(1, 0, 0, 1)
    love.graphics.print("This lame example is twice as big.", 10, 250, 0, 2, 2)
    love.graphics.setColor(0, 0, 1, 1)
    love.graphics.print("This example is lamely vertical.", 300, 30, math.pi/2)
end

Примечания

В версиях 0.8.0 и более ранних, love.graphics.print останавливается на первом символе '\0' (нуль). Это может доставить проблемы, если вы добавляете нажатия клавиш в строку, так как некоторые из них являются многобайтовыми символами Юникод, которые, вероятно, будут содержать нулевые байты.

См. также

• love.graphics
• love.graphics.printf