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" перпендикулярна плоскости экрана и направлена к нам. Но это я уже точно не помню — давно не рисовал треугольники — поэтому пока сереньким =)

[alatar]

Лучше в блоги перенеси, а то тут потеряется.

[samana]

Zebestov Спасибо! Я действительно не понимал, что за "в два" и "в три раза".

[alatar]

В английской версии тоже самое. Может они сначала поланировали использовать для вертексов поинты? Ну или надо просто убрать слово "вектор" и перевести vertices на русский. Тогда все встанет на свои места.

Если длина этого вектора в два раза превышает количество вершин...

[Zebestov]

alatar, перенес в блоги, спасибо за подсказку )

[-De-]

Неплохо бы про t ещё уточнить. А то на это несоответствие я и внимания не обратил когда-то, ну есть и есть, а как t самому считать - интересно.