OGRE/Środowisko pracy skompilowanej aplikacji

Informacje ogólne

Skompilowany do formy binarnej program korzystającey z systemu Ogre, na przykład gra, wymaga do swej pracy odpowiednio skonfigurowanego środowiska pracy. Próba uruchomienia takiego programu bez właściwie skonfigurowanego środowiska prawdopodobnie zakończy się komunikatem błędu z informacją o braku odpowiednich bibliotek (np. OgreMain.dll).

Zawartość katalogów programu

Pliki konfiguracyjne

W katalogu z programem muszą znaleźć się następujące pliki konfiguracyjne:

• resources.cfg - Plik tekstowy określający ścieżki do materiałów, tekstur, modeli itp.
• plugins.cfg - Plik tekstowy określający biblioteki renderingu, z których ma korzystać OGRE

Biblioteki

W katalogu razem z tym programem, lub w innym katalogu dostępnym na ścieżce plików wykonywalnych muszą się znajdować wszystkie biblioteki dynamicznie wykorzystywane przez program. Są to:

• libOgreMain.so (Linux) lub OgreMain.dll (Windows)
• libz.so (Linux, debian: zlib1g, zlib1g-dev) lub zlib1.dll (Windows)
• libIL.so, libILU.so (Linux, debian: libdevil1, libdevil-dev) lub devil.dll, ilu.dll, ilut.dll (Windows)
• libOgrePlatform.so (Linux) lub OgrePlatform.dll (Windows)
• wszystkie biblioteki zdefiniowane w plugins.cfg

Pliki mediów

W zależności od konfiguracji zapisanej w pliku resource.cfg muszą w odpowiednich podkatalogach pliki mediów czyli pliki zawierające grafikę, czcionki itp. (lub jeśli tak zdefiniowano mogą też być w samym katalogu programu). Ścieżki w resource.cfg mogą być podawane w sposób bezwzględny lub względny w stosunku do katalogu programu. Takimi plikami są (w większości przypadków):

• OgreCore.zip - potrzebny, jeśli masz zamiar używać panelu debugowania OGRE lub profilera. Domyślnie zdefiniowany w resources.cfg
• Pozostałe pliki znajdujące się w podkatalogu media\packs
• Pliki znajdujące się w podkatalogu media\fonts
• Pliki znajdujące się w podkatalogu media\materials
• Pliki znajdujące się w podkatalogu media\models
• Pliki znajdujące się w podkatalogu media\overlays
• Pliki znajdujące się w podkatalogu media\particle
• Pliki znajdujące się w podkatalogu media\gui
• Pliki znajdujące się w podkatalogu media\DeferredShadingMedia

Wykorzystanie systemu CEGUI

W przypadku wykorzystywania systemu CEGUI w naszym programie w pliku plugins.cfg musimy posiadać wpis Plugin=Plugin_CgProgramManager a w katalogu programu musimy posiadać jeszcze następujące pliki:

• libCg.so (Linux np. od nvidii, debian: nvidia-cg-toolkit) lub cg.dll (Windows)
• libCEGUIBase.so (Linux) lub CEGUIBase.dll (Windows)
• libCEGUIOgreRenderer.so (Linux) lub OgreGUIRenderer.dll (Windows)
• libxerces-c.so (Linux, debian: libcegui-mk2-0, libcegui-mk2-dev, libxerces26, libxerces26-dev) lub CEGUITaharezLook.dll, CEGUIWindowsLook.dll, xerces-c_2_5_0.dll (Windows)

Dodatkowe biblioteki

W pracach z Ogre wykorzystuje się także niekiedy:

• OpenEXR: (Linux, debian: libopenexr-dev libopenexr2 )
• ReferenceApp: ReferenceAppLayer.dll (Windows)

Biblioteki Visual C++

Kompilatory Microsoft Visual C++ tworzą binaria do których uruchomienia wymagane są dodatkowe biblioteki dynamiczne. Są to (wybieramy jeden z każdej podanej linii w zależności od wersji kompilatora):

• stlport_vc646.dll lub stlport_vc746.dll (tylko do wersji VC++ 5)
• msvcp60.dll lub msvcp70.dll lub msvcp71.dll lub msvcp80.dll
• msvcrt.dll lub msvcr70.dll lub msvcr71.dll

Biblioteki w wersji testowej (dla debbugingu)

Większość wyżej wymienionych bibliotek posiada swoje wersje przeznaczone do debbugowania tworzonego programu. Nazwy tych bibliotek składają się wówczas z właściwej nazwy, przyrostka '_d' lub 'D' lub 'd' lub '_stldebug' a następnie właściwego rozszerzenia '.dll'. Biblioteki takie posiadają dodatkowy kod umożliwiający obserwowanie wykonywanego kodu. Raczej nie powinny być dołączane do właściwej końcowej dystrybucji programu.