Настройка ПО для работы с Alternativa3D 8

Материал из AlternativaPlatform Wiki

В этом уроке представлена информация о настройке программного обеспечения для работы с Alternativa3D 8.

Содержание 1 Необходимое ПО 2 Настройка ПО 2.1 Flash Develop 4 2.2 Adobe Flash Builder 4.5 2.3 Intellij IDEA

[править] Необходимое ПО

Для того чтобы работать с движком Alternativa3D 8 вам потребуется:

• Пакет библиотек Flex SDK
  Для работы с движком восьмой версии нам потребуется пакет библиотек Flex SDK не ниже 4.6 версии (ссылка). Скачиваем и распаковываем в удобную для вас папку.
• Flash - проигрыватель
  Компиляция проектов будет проходить в Flash-плеере 11 версии. (ссылка, playerglobal.swc).
• Библиотека Alternativa3D 8
  Движок доступент на сайте AlternativaPlatform.com. Скачиваем и распаковываем в удобную для вас папку.
• Среда разработки
  
  

Что касается сред разработки, то в этом уроке мы познакомимся с настройкой наиболее популярных из них:

• Flash Develop 4.
  
• Adobe Flash Builder 4.6.
• Intellij IDEA 10.5.

Выберите наиболее удобную для вас среду (сравнение IDE). Ознакомимся с их настройкой в следующей главе.

[править] Настройка ПО

[править] Flash Develop 4

1. Во FlashDevelop 4 уже встроен пакет библиотек Flex SDK 4.6, поэтому можно переходить непосредственно к настройке среды.
2. Запустите установленную программу. Перед вами появится стартовое окно:
   
   
   
3. Создадим новый проект. Для этого используем пункты меню Project→New project:
   
   
   
4. Укажите тип проекта, наименование и путь к нему:
   
   
   и создадим его, нажав на кнопку OK.
5. Укажем дополнительные параметры компиляции проекта:
   1. Project→Properties→Compiler Options→Additional Compiler Options.
      
      
      Пропишем сюда следующую строчку:
      

      -swf-version=13 -target-player=11.1 -static-link-runtime-shared-libraries=true

      
      
   2. В Project→Properties→Output→Test Project укажем Open document и введём расположение HTML-окружения

      bin\index.html

6. Проект создан. Подключим библиотеку. Для этого найдём в папке с нашим проектом папку lib. Скопируем туда библиотеку Alternativa3D 8. Она тут же появится в проводнике проекта. Поставим в контекстном меню галочку : "Add to library".
   
   
   
7. Готово! Flash Develop настроен. Проверим, всё ли мы правильно сделали. Переименуем главный файл проекта Main.as в HelloBox.as. Возьмём следующий код и скомпилируем его:

package {
import alternativa.engine3d.controllers.SimpleObjectController;
import alternativa.engine3d.core.Camera3D;
import alternativa.engine3d.core.Object3D;
import alternativa.engine3d.core.Resource;
import alternativa.engine3d.core.View;
import alternativa.engine3d.materials.FillMaterial;
import alternativa.engine3d.primitives.Box;
 
import flash.display.Sprite;
import flash.display.Stage3D;
import flash.events.Event;
 
public class HelloBox extends Sprite {
    private var stage3D:Stage3D;
    private var camera:Camera3D;
    private var rootContainer:Object3D;
    private var controller:SimpleObjectController;
    private var box:Box;
 
    public function HelloBox() {
 
        camera = new Camera3D(0.01, 10000000000);
        camera.x = -50;
        camera.y = -300;
        camera.z = 100;
        controller = new SimpleObjectController(stage, camera, 200);
        controller.lookAtXYZ(0,0,0);
        camera.view = new View(800, 600, false, 0xFFFFFF, 0, 4);
        addChild(camera.view);
 
        rootContainer = new Object3D();
        rootContainer.addChild(camera);
 
        box = new Box();
        box.setMaterialToAllSurfaces(new FillMaterial(0x0));
        rootContainer.addChild(box);
 
        stage3D = stage.stage3Ds[0];
        stage3D.addEventListener(Event.CONTEXT3D_CREATE, init);
        stage3D.requestContext3D();
 
    }
 
    private function init(event:Event):void {
        for each (var resource:Resource in rootContainer.getResources(true)) {
            resource.upload(stage3D.context3D);
        }
        addEventListener(Event.ENTER_FRAME, enterFrameHandler)
    }
 
    private function enterFrameHandler(event:Event):void {
        controller.update();
        camera.render(stage3D);
    }
}
}

Если всё настроено правильно, то перед нами появится чёрный куб.


Используя мышь и клавиатуру мы можем управлять камерой, перемещая её и вращая.

[править] Adobe Flash Builder 4.5

1. Запустите установленную програму. Перед вами появится стартовое окно. Создадим новый проект. Для этого используем пункты меню: File→New→ActionScript Project
2. В появившемся окне укажем базовые параметры проекта (имя, путь к рабочей директории, используемая версия SDK). Назовём проект "HelloBox"
3. Для нормальной работы нам потребуется SDK как минимум версии 4.6. Если это ещё не сделано, то нажмём на ссылку Configure Flex SDKs... Появится окно Preferences. Перейдём по ссылке Installed Flex SDKs и добавим путь к SDK
4. Далее переходим к указанию подключяемых к проекту библиотек. Нажав на кнопку "Add SWC" мы попадём в окно добавления сторонней библиотеки. Воспользуемся этим чтобы указать путь к Alternativa3D 8
5. Нажмём на кнопку Finish. Перед нами пустой проект AS3.
6. Теперь необходимо указать дополнительные свойства компилляции. Вызовем контекстное меню проекта и выберем пункт "Свойства". В появившемся окне выберем раздел ActionScript Compiler. Тут укажем следующие параметры:
   1. Use a specific version → 11.1.0
   2. Additional compiler arguments →

      -swf-version=13

7. Указание свойств HTML-окружения (файл {путь_к_проекту}\html-template\index.template.html). Для включения аппаратного ускорения видео необходимо задать параметр

   params.wmode="direct".

8. Готово! Для того чтобы проверить, всё ли правильно настроено, запустим пример из прошлого пункта. Если всё настроено правильно, то перед нами вновь появится чёрный куб.
   

[править] Intellij IDEA

1. Загрузите пакет библиотек Flex SDK и разархивируйте в удобное для вас место. Перейдите в папку %SDK_PATH%\frameworks\libs\player\ (где %SDK_PATH% - это путь к SDK). Если в ней нет папки 11.0, то создайте её и скопируйте туда файл playerglobal.swc.
2. Запустите установленную программу. Перед вами появится стартовое окно. Создадим новый проект. Для этого используем пункты меню: "File→New project".
3. Далее выбираем пункт Create project from scratch и нажимаем Next
4. Задаём имя проекта, путь к нему и другие параметры:
   
   
   
5. Create source directory
6. Указываем путь к Flex SDK:
   
   
   
   
   
   
   
   
   
7. Дополнительные параметры:
   
   
   Жмём на кнопку Finish и перед нами пустой AS3 проект.
8. Укажем папку src как Source root. Для этого нажмём на ней правой кнопкой мыши и укажем пункты: Mark Directory As→Source root
9. Создадим новый AS3 класс. Для этого опять же нажмём на папке src правой кнопкой мыши и выберем: New→ActionScript Class. Укажем имя нашему модулю: HelloBox
10. Теперь подключим библиотеку Alternativa3D 8. Для этого найдём пункт меню File→Project Structure. Здесь мы видим несколько разделов (Project, Modules, Libraries и т.д.). Нам потребуется:
    • В пункте Project выбрать нащу Flex SDK
    • В пункте Libraries указать путь к библиотеке Alternativa3D 8. Добавим новую ActionScript/Flex библиотеку. Нажмём кнопку "Add SWC Files", укажем директорию, куда мы распаковали библиотеку Alternativa3D 8 и укажем swc файл.
      
      
11. Для запуска необходимо указать параметр Compile with→Flex Compiler Shell (fcsh) в меню File→Settings→Compiler→Flex Compiler
12. Нам осталось проверить правильность настроек, запустив наш пример с чёрным кубом. Чтобы запустить код в IntelliJ IDEA нажмём пункт меню Run→Run. Появится окно выбора настроек. Нажмём HelloBox→Edit...:
    
    
    
    
    
    Должен появится наш любимый чёрный куб.