Hlavní navigace

Open Inventor: Jak nainstalovat a používat

Jan Pečiva

V tomto článku se dozvíme, jak nainstalovat knihovnu Coin, což je knihovna kompatibilní s Open Inventor API. Vyřešíme také množství otázek, které se mohou během používání vyskytnout.

Minule jsme si ukázali jednoduchý příklad v Open Inventoru. Mnohé možná mrzelo, že si nemohou vše hned vyzkoušet. Nicméně instalace nemusí být vždy úplně triviální – problémy na Windows, Linuxu etc. Množství informací, které by se při instalaci mohly hodit, nakonec vydaly za celý článek. Takže je zde. Pokud se časem objeví nějaký nový problém, který by bylo vhodné doplnit do tohoto článku, bude tak učiněno.

Text je pro snadnější orientaci organizován stylem otázek a odpovědí. Pokud zde, i přes snahu autora o kompletnost, odpověď nenaleznete, zeptejte se v diskusi pod článkem.

Seznam témat ohledně instalace:

Obecné otázky:

Specifické problémy při používání na Windows:

Co je potřeba nainstalovat?

V prvé řadě to bude Inventor API kompatibilní knihovna Coin, poté následuje několik podpůrných knihoven. Souhrn je v tabulce:

Tabulka č. 475
název popis
Coin vlastní knihovna poskytující Open Inventor API
simage knihovna pro načítání textur z různých grafických formátů
SoQt
(Linux)
okenní rozhraní pro aplikace založené na knihovně Qt
SoWin
(Win32)
okenní rozhraní pro Windows aplikace
knihovna Qt
(Linux)
okenní knihovna Qt, budeme potřebovat development verzi

Na vysvětlenou: SoQt a Qt budeme používat na Linuxu a SoWin na Windows. Qt je k dispozici všude, kde máme KDE. My jako vývojáři si navíc musíme nainstalovat development verzi. Na Windows si vystačíme se SoWin.

Pro informace „přímo od zdroje“ o prvních čtyřech knihovnách z naší tabulky bych odkázal na www.coin3d.or­g/Coin/about.php, kde dole mezi developer linky vybereme „Download Binaries“ nebo „Getting the Source“. Binárky, jak vidíme, jsou zde pro Windows a z Linuxů bohužel pouze pro Debian. Požadovaná verze Coin pro náš tutoriál je alespoň 2.0.0. Alternativní řešení, které je sice složitější, ale má i své výhody, je zkompilovat si vše ze zdrojáků. Qt knihovnu stáhnete jako balíček například ze stránek vaší linuxové distribuce či z instalačního Linux CD.

Podporované platformy a kompilátory

Podporovaných platforem je velmi mnoho. Z těch nejznámějších: Windows, Linux, Mac od Apple a obrovské množství Unixů. My se soustředíme pouze na popis Linuxu a Windows.

Na Linuxu budeme používat klasické gcc, na Windows je prošlapaná cesta zatím pouze pro Microsoft Visual C++, nejlépe verzi 6, pro kterou existují i binárky. Údajně snad někdo používá i gcc a prostředí cygwin, (kdyby to někdo testoval, dejte mi prosím vědět výsledek). A pro všechny uživatele Borlandu horká novinka: V uplynulých dnech se objevila zpráva, že se to někomu podařilo zkompilovat i v C++ Builderu. Možná se tedy v krátké době dočkáme oficiální podpory.

Jak vše nainstalovat v Linuxu?

Na Linuxu asi nejčastěji půjdeme cestou vlastní kompilace. Zdrojáky si stáhneme z CVS dle návodu nebo jako snapshots. Věci, které potřebujeme, jsou: Coin verze 2 a novější, simage, SoQt. Navíc, SoQt knihovna využívá Qt knihovnu, proto budeme potřebovat i Qt 3 development verzi. Jediné upozornění: Možná si v snapshots či v CVS všimnete, že jsou tam dvě verze: Coin-2 a Coin. Coin-2 je stabilní verze na rozdíl od Coin, což je vývojová větev. Proto ani z CVS ani ze snapshotů bychom Coin verze neměli stahovat, vždy pouze stabilní Coin-2. Buildování se provádí naprosto standardní cestou. Celý postup je uveden na www.coin3d.or­g/Coin/buildin­g.php. Pokud narazíte na „nevyřešitelný“ problém, odkazuji na diskusi pod článkem.

Ještě jedna věc týkající se kompilace SoQt: Okenní knihovna Qt je obyčejně již nainstalovaná, neboť ji využívají KDE. My však budeme potřebovat navíc developement verzi: libqt3-devel, alespoň tak se to jmenuje v Mandrake 9.1. Po její instalaci před příkazem configure provedeme pouze export QTDIR=/usr/lib/qt3, popřípadě jiné místo, kam se libqt3-devel nainstalovala.

Jak na instalaci ve Windows?

V prvé řadě potřebujeme Visual C++, nejlépe verzi 6, ale i 5 a 7 (.NET) jsou použitelné. Poštěstí-li se, budou během několika dní k dispozici i makefiles pro Borland C++ Builder.

Pro začátek doporučuji použít samorozbalující se balíčky, se kterými je instalace mnohem jednodušší, než kdybychom si vše chtěli zkompilovat ze zdrojáků sami. Balíčky se rozbalí do námi zvoleného adresáře. Instalujeme pouze Coin, simage a SoWin. Pro každý z nich zadáme vždy ten samý adresář pro instalaci (např. c:\Coin3D). Balíčky obsahují binárky pouze pro Visual C++ verze 6. Pro verzi 5 a 7 (.NET) bude potřeba asi vše překompilovat. Údajně je v balíčku i projektový soubor Visual C++, takže by to snad mělo jít jednoduše. Alternativní cesta je skrz Visual C++ kompilátor a Cygwin prostředí, kde kompilace probíhá klasickým unixovým stylem: ./configure a make install. Kdyby se náhodou objevila tvrdá povaha a dala si to velké množství práce s rozjetím kompilace v Mingw nebo v čemkoliv jiném, dejte mi určitě vědět. Ještě připomínám, že po instalaci je potřeba nastavit cesty ve Visual C++ v Tools → Options → záložka Directories, kde musíme nastavit cesty pro include a library files, aby vedly do odpovídajících adresářů, kam jsme nainstalovali Coin. A jako poslední věc je potřeba přidat podadresář bin Coinu do proměnné PATH, aby systém našel potřebné DLL knihovny. To lze provést například přidáním řádku PATH=%PATH%;c:\Co­in3D\bin do autoexec.bat nebo v mých WinXP jsem to provedl v Tento počítač → Vlastnosti → Upřesnit → Proměnné prostředí, kde jsem přidal do PATH požadovanou cestu.

Kde vzít dokumentaci k Open Inventoru?

Nejjednodušší je používat on-line dokumentaci. Pro off-line prohlížení je nejsnadnější na Windows instalovat Coin z instalačních balíčků, které již dokumentaci obsahují. Na Linuxu je potřeba nainstalovat doxigen a vhodný je i GraphViz pro generování diagramů dědičnosti tříd. Při configure přidáme parametr –enable-html a během kompilace se nám pak vygeneruje i celá dokumentace. Pokud nechcete jít touto cestou, spakoval jsem dokumentaci ze svého disku a můžete si ji stáhnout.

Další užitečné linky

Co dělají ta pragma ve Windows příkladech?

Windows záludnosti se nám představují hned na počátcích souborů z našich příkladů (pouze ve Windows verzi):

   #pragma warning(disable:4275)
   #pragma warning(disable:4251)
   #pragma comment(linker, "/entry:\"mainCRTStartup\"")

Pragma jsou příkazy pro kompilátor, které ovlivňují jeho funkci. Většinou jsou kompilátorově specifické. Proto pokud dané pragma kompilátor nezná, jednoduše ho ignoruje a maximálně vypíše varovnou hlášku. V našem případě první dvě pragma zakazují varovná hlášení (warnings) MSVC při kompilaci h-souborů knihovny Coin. Po prozkoumání toho, co ty hlášky znamenají, myslím, že chyba je určitě na straně Microsoftu. Třetí pragma odstraňuje main/WinMain schizofrenii, kterou před mnoha lety zavedl Microsoft. Toto pragma řekne linkeru, aby přesto, že linkuje Windows aplikaci, ji slinkoval s funkcí main, nikoliv s WinMain. Především první dvě pragma jsou velmi otravná, neboť by bylo třeba je uvádět v každém souboru, který includuje inventorské hlavičkové soubory. Já to řeším svým souborem config.h, který includuji v každém souboru, kde includuji inventorské hlavičkové soubory. Navíc do config.h mohu dávat různá nastavení projektu.

Jak ve Visual C++ založit nový projekt pro Open Inventor?

Projekt zakládáme v podstatě stejně jako jakýkoliv jiný projekt. V nově vytvořeném projektu je však potřeba nastavit několik věcí, aby vše správně fungovalo.

V menu File zvolíme New a na stránce projects vybereme Win32 application, zvolíme project name (např. HelloCone) a umístění projektu na disku. Klikneme na OK a na následující stránce zvolíme empty project. Pak vytvoříme nový C++ soubor, např. v menu File → New, stránka Files vybereme C++ Source File a jako název souboru zvolíme např. HelloCone. Do tohoto souboru napíšeme nebo vkopírujeme náš kód. Před vlastní kompilací musíme provést ještě některá nastavení projektu. V menu zvolíme Project → Settings a na záložce C/C++ připíšeme do Preprocessor definitions COIN_DLL a SOWIN_DLL (hodnoty v tomto poli jsou odděleny čárkami). Tato nastavení řeknou kompilátoru, že má knihovnu Coin a SoWin přilinkovat k aplikaci jako DLL knihovny. Toto nastavení už možná od čerstvě vydané verze Coin 2.1.0 není potřeba díky autodetekci, která byla nedávno dodělána. Zkuste. Pokud detekce nebude fungovat, kompilátor hlásí chybu. Poté se přepneme na záložku Link a v poli Object/library modules, kromě toho, že většinou můžeme skoro všechny uvedené knihovny smazat (snad kromě kernel32.lib user32.lib gdi32.lib), přidáme coin2d.lib a sowin1d.lib. Klikneme na OK a stiskem F7 můžeme provést kompilaci. Pokud kompilace proběhla správně, můžeme tlačítkem F5 spustit naši aplikaci.

Závěr

Tímto končí náš návod na instalaci. Přeju, ať se vše podaří a vyhnou se vám pokud možno všechny problémy. Příště navážeme na náš první příklad HelloCone, který byl sice jednoduchý, ale výsledná aplikace poněkud nudná – mohli jsme si tak maximálně měnit velikost okna. To příště napravíme v dostatečné míře.

Našli jste v článku chybu?

28. 8. 2003 10:38

PCJohn (neregistrovaný)

:-) Asi melo byt do uvodu pripsano:

"Clanek obsahuje slova Windows a Microsoft.
Pokud myslite, ze tato slova skodi svetu, zdravi nebo pocitacum,
okamzite opustte tyto stranky." ;-)

P.S. Samozrejme, ze pouzivam "opravdove" operacni systemy. Snad je budou jednou pouzivat vsichni.







24. 8. 2003 22:52

lzap (neregistrovaný)

na clanekna linuxovem serveru, nebo ne?

Jaky mate na toto nazor? ;-)



Podnikatel.cz: Přehledná titulka, průvodci, responzivita

Přehledná titulka, průvodci, responzivita

Podnikatel.cz: K EET. Štamgast už peníze na stole nenechá

K EET. Štamgast už peníze na stole nenechá

Lupa.cz: Kdo pochopí vtip, může jít do ČT vyvíjet weby

Kdo pochopí vtip, může jít do ČT vyvíjet weby

120na80.cz: 5 nejčastějších mýtů o kondomech

5 nejčastějších mýtů o kondomech

Měšec.cz: Sleva na dítě a manželku pro OSVČ je zpět. Ale..

Sleva na dítě a manželku pro OSVČ je zpět. Ale..

Vitalia.cz: Proč vás každý zubař posílá na dentální hygienu

Proč vás každý zubař posílá na dentální hygienu

Měšec.cz: Jak vymáhat výživné zadarmo?

Jak vymáhat výživné zadarmo?

Vitalia.cz: Pamlsková vyhláška bude platit jen na základkách

Pamlsková vyhláška bude platit jen na základkách

Vitalia.cz: Potvrzeno: Pobyt v lese je skvělý na imunitu

Potvrzeno: Pobyt v lese je skvělý na imunitu

Lupa.cz: Insolvenční řízení kvůli cookies? Vítejte v ČR

Insolvenční řízení kvůli cookies? Vítejte v ČR

Podnikatel.cz: Chaos u EET pokračuje. Jsou tu další návrhy

Chaos u EET pokračuje. Jsou tu další návrhy

Lupa.cz: Proč firmy málo chrání data? Chovají se logicky

Proč firmy málo chrání data? Chovají se logicky

Vitalia.cz: Když přijdete o oko, přijdete na rok o řidičák

Když přijdete o oko, přijdete na rok o řidičák

Podnikatel.cz: Chtějte údaje k dani z nemovitostí do mailu

Chtějte údaje k dani z nemovitostí do mailu

Měšec.cz: U levneELEKTRO.cz už reklamaci nevyřídíte

U levneELEKTRO.cz už reklamaci nevyřídíte

DigiZone.cz: Rádio Šlágr má licenci pro digi vysílání

Rádio Šlágr má licenci pro digi vysílání

120na80.cz: Pánové, pečujte o svoje přirození a prostatu

Pánové, pečujte o svoje přirození a prostatu

Vitalia.cz: Jmenuje se Janina a žije bez cukru

Jmenuje se Janina a žije bez cukru

Měšec.cz: mBank cenzuruje, zrušila mFórum

mBank cenzuruje, zrušila mFórum

Měšec.cz: Air Bank zruší TOP3 garanci a zdražuje kurzy

Air Bank zruší TOP3 garanci a zdražuje kurzy