SpriteBatch:attachAttribute

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

Присоединяет атрибут вершины из Mesh к этому SpriteBatch для использования при отрисовке. Это можно комбинировать с Shader, чтобы дополнить SpriteBatch атрибутами вершины или дополнительной информацией вместо просто цветов спрайта.

Каждый спрайт в SpriteBatch имеет 4 вершины в следующем порядке: верхний левый, нижний левый, верхний правый, нижний правый. Индекс, возвращаемый SpriteBatch:add (и используемый SpriteBatch:set), можно использовать для определения первой вершины конкретного спрайта по формуле 1 + 4 * ( id - 1 ).

Функция

Синопсис

SpriteBatch:attachAttribute( name, mesh )

Аргументы

string name

Имя атрибута вершины для присоединения.

Mesh mesh

Mesh, откуда получить атрибут вершины.

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

Ничего.

Примечания

Если Mesh не был создан с пользовательским форматом вершин, у него будут 3 атрибута вершины с именами VertexPosition, VertexTexCoord, и VertexColor. Если атрибуты вершин с этими именами будут добавлены в SpriteBatch, они переопределят позиции спрайта, координаты текстуры и цвета спрайта в SpriteBatch соответственно.

Пользовательские именованные атрибуты можно получить в шейдере вершины, объявив их как attribute vec4 MyCustomAttributeName; в верхней части кода шейдера вершины. Имя должно совпадать с тем, что было указано в формате вершин Mesh и в аргументе name функции SpriteBatch:attachAttribute.

Mesh должен иметь как минимум 4 * SpriteBatch:getBufferSize вершин, чтобы его можно было присоединить к SpriteBatch.

См. также

• SpriteBatch
• Mesh
• Mesh:getVertexFormat
• love.graphics.draw