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

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