Mesh:setVertices

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

Заменяет диапазон вершин в сетке новыми. Общее количество вершин в сетке не может быть изменено после её создания. Часто это более эффективно, чем вызов Mesh:setVertex в цикле.

Функция

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

Синтаксис

Mesh:setVertices( vertices, startvertex, count )

Аргументы

table vertices

Таблица, заполненная таблицами информации о вершинах для каждой вершины, в формате {vertex, ...}, где каждая вершина — таблица в формате {attributecomponent, ...}.

number attributecomponent

Первый компонент первого атрибута вершины в вершине.

number ...

Дополнительные компоненты всех атрибутов вершин в вершине.

number startvertex (1)

Индекс первой вершины для замены.

number count (all) Доступно начиная с 11.3

Количество вершин для замены.

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

Ничего.

Примечания

Значения в каждой таблице вершин упорядочены так же, как атрибуты вершин в формате вершин сетки формате вершин. Стандартная сетка, которая не была создана с пользовательским форматом вершин, будет использовать два числа координат позиции, два числа координат текстуры и четыре компонента цвета на вершину: x, y, u, v, r, g, b, a.

Если для определенного компонента атрибута вершины не указано значение, оно будет установлено по умолчанию в 0, если его тип данных — «float», или в 255, если тип данных — «byte».

Функция

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

Устанавливает компоненты вершин сетки, копируя их напрямую из памяти объекта Data.

Синтаксис

Mesh:setVertices( data, startvertex, count )

Аргументы

Data data

Объект Data для копирования. Содержимое Data должно соответствовать структуре формата вершин этой сетки.

number startvertex (1)

Индекс первой вершины для замены.

number count (all) Доступно начиная с 11.3

Количество вершин для замены.

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

Ничего.

Примечания

Если для заполнения объекта Data используется LuaJIT's FFI через Data:getPointer и ffi.cast, этот вариант может быть значительно более эффективным, чем другие методы установки данных вершин Mesh.

Функция

Устанавливает компоненты вершин сетки, которая не была создана с пользовательским форматом вершин.

Синтаксис

Mesh:setVertices( vertices )

Аргументы

table vertices

Таблица, заполненная таблицами информации о вершинах для каждой вершины следующим образом:

number [1]

Позиция вершины по оси X.

number [2]

Позиция вершины по оси Y.

number [3]

Горизонтальная компонента координаты текстуры. Координаты текстуры обычно находятся в диапазоне [0, 1], но могут быть больше или меньше (см. WrapMode).

number [4]

Вертикальная компонента координаты текстуры. Координаты текстуры обычно находятся в диапазоне [0, 1], но могут быть больше или меньше (см. WrapMode).

number [5] (1)

Компонент красного цвета.

number [6] (1)

Компонент зелёного цвета.

number [7] (1)

Компонент синего цвета.

number [8] (1)

Компонент альфа-канала цвета.

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

Ничего.

См. также

• Mesh
• Mesh:getVertex
• Mesh:getVertexCount
• Mesh:getVertexFormat