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