Осваиваем Papervision3D. Часть III. Примеры

Продолжаем вгрызаться в Papervision 3D.
Для тестирования я выбрал пример "Panorama" из папки "examples". Кстати, попутно еще раз убедился в пользе SVN: скопировав папку с примером в рабочий каталог, я скопировал находящуюся в ней папку ".svn" - теперь в любое время, я могу выбором из контекстного меню проводника легко обновить файлы прямо с сервера SVN-репозитория. Чертовски удобно - пора ставить SVN-сервер!

Создаю во FlashDevelop проект типа "Flash IDE Project". В свойствах проекта, в "Classpaths" указываю путь к классам Papervision3D "...\as3\trunk\src". Это нам нужно для того, чтобы работала проверка ошибок, подстановка и другие удобства. Как только классы подцепились, в панели "Task Panel" FlashDevelop появился список задач TODO, что говорит о незавершенности и бурном развитии проекта.
Теперь надо указать путь к классам во Flash IDE. В Getting Started FAQ нам советуют установить путь в свойствах среды: "Edit -> Preferences -> Actionscript -> Actionscript 3.0 settings -> Classpath". Пожалуй не буду обобщать и укажу путь для моего конкретного FLA файла в "Publish settings -> Actionscript Settings -> Classpath". Кстати, там уже есть путь к классам, но только относительный, а раз мы скопировали в другую папку, то, конечно, неправильный.
Запускаем проект - всё компилируется без ошибок, запускается панорама - мы внутри куба, на стенах которого надписи. Попробуем что-нибудь изменить. Например, мне не нравится качество отображения надписей. Всё из-за того, что текстуры маленькие и качество сцены установлено в LOW. Увеличиваем размер одной из текстурок - например, та что "BOTTOM". Хе, на размер 3000 выскочило исключение. Ладно, поставим 2000. Забавно натягивает.
Заметил хитрый ход: изменение качества сцены сильно не меняет картины, однако, ресурсов процессора потребляется заметно меньше.
Продолжаем смотреть примеры. В общих чертах - создается сцена, создается камера, создаются материалы для объектов, создаются объекты и добавляются в сцену, выставляются параметры и по ENTER_FRAME осуществляется управление сценой и ее перерисовка.

Примеров вполне достаточно, чтобы разобраться и начать применять Papervision3D в своих проектах. Чем мы активно и займемся в ближайшее время.

Осваиваем Papervision3D. Часть II. Установка

Следуем Getting Started FAQ -> Getting started walkthrough.
Качаем и устанавливаем SVN-клиент. Об этом подробно изложено здесь: "Установка SVN-клиента TortoiseSVN". Тут же описан процесс скачивания SVN-репозитория.
В итоге, мы имеем каталог с классами Papervision3D.

Порыв интернет, нашел следующую информацию по серверу Subversion:
Здесь пишут, что:
"Большинство людей создают папку trunk для поддержки "основной линии" разработки, папку branches для копий ветвей, и папку tags для копий меток. Если хранилище содержит только один проект, тогда часто создают их как папки верхнего уровня."
Здесь пишут, что:
"Структура проекта может быть произвольной, но общепринято создавать три основных каталога: branches – для веток, tags – для тегов проекта и trunk – непосредственную рабочую область для коммитов".
На Wikipedia можно почитать про Subversion в общих чертах.

Кстати, попался на глаза блог Установка и настройка Subversion. Нам это еще пригодится.

Итак, базовая структура репозитория создается из директорий trunk, tags, и branches.

На сколько я понял, структура SVN Papervision3D следующая:

• as2 - С ней всё ясно: "\as2\trunk\" содержит классы финальной версии для AS2, ее документацию и примеры.
• as3 - Здесь в "\as3\trunk\" лежит финальная версия для AS3. В "\as3\tags\", очевидно, предыдущая версия.
• branches - Здесь разрабатываемые/тестируемые/альфа/бета версии. По всей видимости, нас интересует "\branches\GreatWhite\" - та что Papervision3D 2.0 GreatWhite.

Не исключено, что структура репозитория может измениться.

Продолжаем изучать полученные материалы. Пока не будем лезть в последнюю версию и поработаем с той, что лежит в "trunk" - "Beta 1.7" (я узнал это, открыв и просмотрев файл "Papervision3D.as").

Смотрим примеры.

Осваиваем Papervision3D. Часть I. Обзор ресурсов

Итак, свершилось. Добрались, наконец, до Papervision3D.

Для начала порыскаем по сайту. Посмотрим, для начала, последние проекты с использованием этой технологии и вдохновимся.
Первый, интересный для нас раздел - Downloads. Судя по датам, всё, что здесь размещено уже старовато - последняя версия 1.5, дата последнего апдейта - Jul 25. Хотя, в новостях уже можно видеть декабрьский анонс Papervision3D 2.0 Alpha - Great White. Судя по отзывам, пока ни у кого не возникло существенных проблем использования последних версий. Только восторги и благодарности. Что ж, значит нам туда дорога.
Дальше, поглядим-ка, что тут на форуме. Активность здесь неслабая.
Раздел "Getting Started" - это что нам и надо. Смотрим Documentation. Как и следовало ожидать, скупо документированный ASDoc. Что радует, на первый взгляд - структура прозрачна, а количество пакетов и классов вполне обозримо.
Ссылка Cheatsheet открываться не захотела.
Tutorials и Getting Started FAQ, собственно,ведут на Wiki, где нам и предстоит остановиться в дальнейшем.
Еще один интересный раздел - "Recommended tools". Здесь нам рекомендуют пользоваться FlashDevelop (что мы, собственно и делаем), Fuse Kit - пока непонятно зачем (движок анимационных эффектов на AS2, а 3-я версия этого продукта, по всей видимости, пока готовится), Xray - утилита для просмотра снэпшота текущего состояния flash-приложения. Мда, по-видимому это просто партнерские ссылки.

Ладно, идем смотреть Wiki.
В разделе Getting Started FAQ для нас наиболее интересна информация "Getting started walkthrough" - подробное описание скачивания и установки Papervision3D. Этот процесс мы рассмотрим во второй части изысканий.
Разделы FAQ, Tutorials и Examples оставим для 3-й части.
Ссылки из "Content creation" посвящены созданию 3D-контента. Здесь без 3D-специалиста мне не обойтись, т.к. сам я имею отдаленное представление о 3D-моделировании - пусть этим занимаются другие. Подсуну ему вот эту ссылочку: COLLADA, чтоб у него было чем экспортить для меня модели.
Ссылки "Showcase" дают мало полезного - старые демки, сайты c SWF по 20Mb и т.п.

Итак, пора приступать к установке и тестированию Papervision3D.