drawTriangles(), старая ошибка в документации

[Zebestov]

Любой, кто начинает постигать работу метода drawTriangles пытается сложить у себя в голове и без того запутанную на первый взгляд логику его работы. А тут еще эта лажа!

uvtData:Vector.<Number> (default = null) — Вектор нормализованных координат, используемый для наложения текстуры. Каждая координата определяет точку на растровом изображении, используемом для заливки. Для каждой вершины должна быть указана одна координата UV или одна координата UVT. В координатах UV точка (0,0) — это верхняя левая точка, а точка (1,1) — нижняя правая точка растрового изображения.

Если длина этого вектора в два раза превышает длину вектора vertices, то нормализованные координаты используются без перспективной коррекции.

Если длина этого вектора в три раза превышает длину вектора vertices, то третья координата интерпретируется как "t", расстояние от глаза до текстуры в поле зрения). Это помогает средству визуализации правильно применить перспективу при наложении текстур в трехмерной графике.

Выделенные моменты — ошибка составителя.
Правильно так:

Если длина этого вектора равна длине вектора vertices, то нормализованные координаты используются без перспективной коррекции.

Если длина этого вектора в полтора раза (на половину, если хотите) превышает длину вектора vertices, то третья координата интерпретируется как "t", расстояние от глаза до текстуры в поле зрения). Это помогает средству визуализации правильно применить перспективу при наложении текстур в трехмерной графике.

P.S.
И это еще не говоря о том, что "t" вроде бы интерпретируется совсем не как "расстояние от глаза до текстуры", а как уже подготовленная величина d/(d-z), где "d" — расстояние до глаза, а "z" перпендикулярна плоскости экрана и направлена к нам. Но это я уже точно не помню — давно не рисовал треугольники — поэтому пока сереньким =)