Axiom/Środowisko projektowe

Struktura katalogów

Budując i uruchomiając aplikację opartą na AXIOM musimy zagwarantować, że kompilator i pliki wykonywalne będą mogły znaleźć wszystkie zależności, czyli pliki jakie potrzebują.

Podczas kompilacji będziemy potrzebować:

• klas i jądra programu w postaci plików *.cs
• biblioteki referencyjnej Axiom Axiom.dll

Natomiast skompilowany program będzie potrzebował w tym samym katalogu w którym został utworzony:

• pozostałych bibliotek dll jak to opisano w rozdziale Środowisko pracy skompilowanej aplikacji
• pliku EngineConfig.xml, w którym gdy używasz takich mechanizmów znajdowania zasobów, jaki jest w ExampleApplication.cs określa się ścieżki do tekstur, siatek i skryptów
• dodatkowych plików mediów (*.zip, *.png, *.particle, *.mesh itp.) w katalogach opisanych w pliku EngineConfig.xml.

W pliku .xml powinny być ustawione właściwe ścieżki. Jeśli tak nie jest, Axiom może nie uruchomić się i zgłosić bład do pliku logu. Najłatwiej skonfigurować wszystko poprzez skopiowanie konfiguracji z przykładów z AXIOM, jednak ponieważ używają one względnej ścieżki mogą pojawiają się problemy, jeśli program nie znajduje się w tej samej względnej lokacji. Jeśli przenosisz swoją aplikację gdzie indziej będziesz musiał także przestawić ścieżki odpowiednio gdzie indziej.

Typowy rozkład katalogów wygląda następująco:

AXIOM_HOME
       ├───bin                  
       │     ├───debug          (binaria tworzone w wersji do debuggowania)
       │     └───release        (binaria tworzone do właściwej wersji)
       ├───Media                (pliki mediów, czcionki, modele, siatki 3D, grafika itp)
       │     ├───Archives      
       │     ├───BrowserImages  
       │     ├───Fonts        
       │     ├───GpuPrograms  
       │     ├───Icons         
       │     ├───Materials     
       │     ├───Meshes        
       │     ├───Overlays     
       │     ├───Skeletons     
       │     └───Textures      
       └───Projects             (katalog przykładów)

Microsoft Visual C# 2008 Express

1. Uruchom VC# i utwórz nowy projekt 'Console Application'.
2. Wpisz nazwę swojego projektu.
3. Po utworzeniu upewnij się że masz otwary plik 'Program.cs'.
4. Zamień jego całą zawartość na podaną w rozdziale "Zalążek programu AXIOM" ("Zalążek programu w środowisku programistycznym").
5. Dodaj nowy obiekt ("new item" prawym klawiszem myszy na nazwie projektu) typu Class i nazwij go "ExampleApplication.cs".
6. Zamień jego całą zawartość na podaną w rozdziale "Zalążek programu AXIOM" ("Klasa ExampleApplication").
7. Zapisz projekt.
8. W utworzony katalog "debug" (i ewentualnie "relase") wkopiuj całą zawartość tak samo nazwanych katalogów z dystrybucji Axiom.
9. Pliki ICSharpCode.SharpZipLib.dll i Tao.DevIl.dll ustaw na read-only.
10. Wyedytuj i wprowadź właściwe ścieżki do pliku EngineConfig.xml.
11. Uruchom ponownie środowisko VS i otwórz zapisany projekt.
12. Dodaj referencję do pliku Axiom.dll.
13. Zapisz ponownie projekt.