love.graphics.draw

Отображает объект Drawable (например, Image, Canvas, SpriteBatch, ParticleSystem, Mesh, Text или Video) на экране с необязательным вращением, масштабированием и наклоном.

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

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

Обратите внимание, что смещения применяются до вращения, масштабирования или наклона; масштабирование и наклон применяются до вращения.

Правый и нижний края объекта смещаются под углом, определенным коэффициентами наклона.

При использовании стандартного шейдера все, что нарисовано с помощью этой функции, будет затонировано в соответствии с текущим выбранным цветом. Установите его в чисто белый цвет, чтобы сохранить исходные цвета объекта.

Функция

Синопсис

love.graphics.draw( drawable, x, y, r, sx, sy, ox, oy, kx, ky )

Аргументы

Drawable drawable

Объект drawable.

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 0.9.0
Заменяет love.graphics.drawq.

Синопсис

love.graphics.draw( texture, quad, x, y, r, sx, sy, ox, oy, kx, ky )

Аргументы

Texture texture

Текстура (Image или Canvas) для текстурирования Quad.

Quad quad

Quad для отрисовки на экране.

number x

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

number y

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

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.draw( drawable, transform )

Аргументы

Drawable drawable

Объект drawable.

Transform transform

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

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

Ничего.

Функция

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

Синопсис

love.graphics.draw( texture, quad, transform )

Аргументы

Texture texture

Текстура (Image или Canvas) для текстурирования Quad.

Quad quad

Quad для отрисовки на экране.

Transform transform

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

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

Ничего.

Примеры

Отрисовка изображения (Hamster Ball) в точке 100x100

function love.load()
   hamster = love.graphics.newImage("hamster.png")
end
function love.draw()
   love.graphics.draw(hamster, 100, 100)
end

Отрисовка изображения (Hamster Ball) из центра в точке 100x100, повернутого на 90 градусов

function love.load()
   hamster = love.graphics.newImage("hamster.png")
   width = hamster:getWidth()
   height = hamster:getHeight()
end
function love.draw()
   love.graphics.draw(hamster, 100, 100, math.rad(90), 1, 1, width / 2, height / 2)
end

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

Отображение верхней половины изображения (Hamster Ball) в точке 100x100

function love.load()
   image = love.graphics.newImage("hamster.png")
   quad = love.graphics.newQuad(0, 0, 128, 64, image:getWidth(), image:getHeight())
end
 
function love.draw()
	love.graphics.draw(image, quad, 100, 100)
end

См. также

• love.graphics