Класс 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) для индексов текстурных координат.

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