Класс TriangleMesh

public class TriangleMesh extends Mesh

Определяет 3D сетку треугольников, которая состоит из связанного с ней VertexFormat и набора отдельных массивов компонент вершин, таких как точки, нормали, координаты текстуры, и массив граней, определяющий отдельные треугольники сетки.

Обратите внимание, что термин «точка», используемый в именах методов и описаниях методов, на самом деле относится к 3D точке (x, y, z) в пространстве, представляющей положение одной вершины. Термин «точки» (множественное число) используется для обозначения наборов 3D точек для нескольких вершин. Аналогично, термин «нормаль» используется для обозначения 3D вектора (nx, ny, nz) в пространстве, представляющего направление одной вершины. Термин «нормали» (множественное число) используется для обозначения наборов 3D векторов для нескольких вершин. Термин «texCoord» используется для обозначения одной пары 2D координат текстуры (u, v) для одной вершины, а термин «texCoords» (множественное число) используется для обозначения наборов координат текстуры для нескольких вершин. Наконец, термин «грань» используется для обозначения 3 наборов перекрывающихся точек, нормалей (необязательно, в зависимости от связанного VertexFormat) и координат текстуры, которые вместе представляют геометрическую топологию одного треугольника, в то время как термин «грани» (множественное число) используется для обозначения наборов треугольников (каждый из которых представляется гранью).

Например, грани с VertexFormat.POINT_TEXCOORD, которые представляют один текстурированный прямоугольник, используя 2 треугольника, имеют следующий порядок данных: [

p0, t0, p1, t1, p3, t3, // Первый треугольник текстурированного прямоугольника

p1, t1, p2, t2, p3, t3 // Второй треугольник текстурированного прямоугольника

]

в то время как грани с VertexFormat.POINT_NORMAL_TEXCOORD, которые представляют один текстурированный прямоугольник, используя 2 треугольника, имеют следующий порядок данных: [

p0, n0, t0, p1, n1, t1, p3, n3, t3, // Первый треугольник текстурированного прямоугольника

p1, n1, t1, p2, n2, t2, p3, n3, t3 // Второй треугольник текстурированного прямоугольника

]

где p0, p1, p2 и p3 являются индексами в массиве точек, n0, n1, n2 и n3 являются индексами в массиве нормалей, а t0, t1, t2 и t3 являются индексами в массиве texCoords.

У треугольника есть передняя и задняя грань. Порядок обхода вершин треугольника определяет, какая сторона является передней гранью. JavaFX выбирает против часовой стрелки (или правило правой руки) порядок обхода как переднюю грань. По умолчанию отображается только передняя грань треугольника. См. CullFace для получения дополнительной информации.

Длина points, normals и texCoords должны быть соответственно кратными 3, 3 и 2. Длина faces должна быть кратной 6, если она VertexFormat.POINT_TEXCOORD, иначе она должна быть кратной 9, если она VertexFormat.POINT_NORMAL_TEXCOORD. Значения в массиве граней должны находиться в пределах диапазона количества вершин в массиве точек (0 до points.length / 3 - 1) для индексов точек, в пределах диапазона количества вершин в массиве нормалей (0 до normals.length / 3 - 1) для индексов нормалей и в пределах диапазона количества вершин в массиве texCoords (0 до texCoords.length / 2 - 1) для индексов координат текстуры.

Предупреждение будет записано в логгер, и сетка не будет отображаться (и будет иметь пустую границу), если длина любого из массивов не является допустимой или если какое-либо из значений в массиве граней выходит за пределы диапазона.