====== A(E)4M39VG - Computational Geometry ======
([[..:start | home ]] | lectures | [[..:labs:start| seminars]] | [[..:presentations:start | presentations]] | [[https://cw.felk.cvut.cz/forum/forum-329.html|forum]] | [[https://cw.felk.cvut.cz/upload/ | upload]] | [[..:links:start|links]] )
====== Instalace CGAL-3.9 pro Visual Studio 2010 ====== Originální text: [[http://jdt.googlecode.com/svn-history/r64/trunk/jdt/src/CGAL/docs/CGAL_Guidelines.docx | CGAL Easy installation guide]], 16.10.2010, aktualizace odkazů 2012 Zde najdete heslovitý popis postupu, jak instalovat CGAL-3.9 na Windows 7. Uvádím pouze instalaci 32-bitové verze, protože 64-bitová vyžaduje vlastní kompilaci knihoven a tudíž více práce, která není pro účely předmětu VG nutná. Vždy uvádím odkaz na hlavní stránku, odkaz na instalační manuál a pak odkaz na předkompilovanou verzi, je-li dostupná. POZOR: Je třeba instalovat SP1 pro Visual studio. Obsah: - Stažení a instalace zdrojových kódů knihovny CGAL-3. - Stažení a instalace CMake - Stažení a instalace knihoven - Záloha proměnných prostředí (stalo se mi, že je instalace CGAL přepsala) - Nastavení proměnných prostředí - Konfigurace, překlad a instalace knihovny CGAL - Použití knihovny CGAL na příkladu Triangulation_2 - Použití knihovny CGAL a QT - příklad example_1 ===== 1. Stažení a instalace zdrojových kódů knihovny CGAL-3.9===== * Stáhněte [[https://gforge.inria.fr/frs/download.php/28508/CGAL-3.8-Setup.exe | CGAL-3.9-Setup.exe]] (Dostanete se sem po vyplnění dotazníku a přijetí podmínek licence ze [[http://www.cgal.org/download.html | stránky]]) a spusťte instalaci. * Zvolte součásti instalace - doporučuji CGAL Examples and Demos,GMP and MPFR precompiled libs a HTML Manual, dále pak 32-bitovou verzi předkompilovaných knihoven * Nastavte cílový adresasář - doporučuji změnit na adresář, který neobsahuje v názvu mezeru, např. D:\winappl\CGAL3.9 {{:misc:projects:oppa_oi_english:courses:ae4m39vg:links:cgal-1.png?300}}{{:misc:projects:oppa_oi_english:courses:ae4m39vg:links:cgal-2.png?300}} \\ {{:misc:projects:oppa_oi_english:courses:ae4m39vg:links:cgal-3.png?300}} {{:misc:projects:oppa_oi_english:courses:ae4m39vg:links:cgal-4.png?300}} Další odkazy: * [[http://www.cgal.org | oficielní stránka www.cgal.org]] * [[http://www.cgal.org/Manual/latest/doc_html/installation_manual/contents.html| oficielní Instalační manuál]] * [[https://gforge.inria.fr/frs/?group_id=52 | soubory projektu CGAL ke stažení]] ===== 2. Stažení a instalace CMake ===== CMake je multiplatformní nástroj pro generování projektů a souborů make. Zde jej využijeme jako generátor projektů pro VS2010 * stáhněte [[http://www.cmake.org/files/v2.8/cmake-2.8.5-win32-x86.exe | cmake-2.8.5-win32-x86.exe]] (nebo z této [[http://www.cmake.org/cmake/resources/software.html | stránky]]) * spusťte instalaci, zvolte "Add CMake to the system PATH for all users" (ve třetím dialogu) * Vše ostatní lze ponechat, včetně cesty na c:\Program Files (x86) ===== 3. Stažení a instalace knihoven ===== Neověřená informace - zdá se, že je lepší **instalovat uvedené programy do adresářů, které neobsahují mezery**. Proto nevyhoví standardní Program files (x86) * Boost * přeložená verze je [[http://boostpro.com/download/boost_1_47_setup.exe | boost_1_47_setup.exe]] (viz též [[http://www.boostpro.com/download/]], dokumentace a zdrojové kódy na [[http://www.boost.org/]]) * Je nutno instalovat pouze: * Boost.Thread a * Boost.Program_options * zlib - není nutná * Přeložená verze zlib [[http://zlib.net/zlib125-dll.zip | 125-dll.zip]] (detaily a manuál http://www.zlib.net/) * instalace viz USAGE.txt, stačí však rozbalit do nějakého adresáře - např. d:\winappl\zlib a doplnit při konfiguraci knihovny CGAL - viz níže * libQGLViewer * [[http://www.libqglviewer.com/installWindows.html]] * D:\winappl\libQGLViewer * QT library - dříve byla zadarmo jen pro vs2008, teď je i pro VS2010 ([[http://qt-project.org/ | OpenSource QT project]] - [[http://qt-project.org/downloads | downloads]]) * Dal jsem verzi pro vs2008 - funguje \\ [[http://qt.nokia.com/downloads/windows-cpp-vs2008 | Qt libraries 4.7.4 for Windows (VS 2008, 228 MB)]] * [[http://releases.qt-project.org/qt4/source/qt-win-opensource-4.8.3-vs2010.exe | Qt libraries 4.8.3 for Windows (VS 2010, 228 MB)]] * Visual Studio Add In - umožňuje založení projektu pracujícího s QT, a spouští GUI designer při otevření .ui souborů * http://qt-project.org/downloads#qt-other ===== 4. Nastavení proměnných prostředí ===== * BOOST_ROOT=d:\winappl\boost_1_47 * CGAL_DIR ...............zde je soubor CGALConfig.cmake, odpovídá CMAKE_INSTALL_PREFIX v konfiguraci CGAL níže * CGAL_DIR=D:\winappl\CGAL\lib\CGAL ................. pokud instalujeme do adresáře D:\winappl\CGAL * CGAL_DIR=D:\winappl\CGAL-3.9 ................ pokud instalujeme do adresáře D:\winappl\CGAL-3.9 (lze nastavit při instalaci CGAL) * QGLVIEWERROOT=d:\winappl\libQGLViewer\QGLViewer\ * QTDIR=d:\winappl\Qt\4.7.4 * proměnnou PATH nutno doplnit * Path=…; * D:\winappl\CGAL-3.9\auxiliary\gmp\lib; * d:\winappl\Qt\4.7.4\bin\; * D:\winappl\CMake 2.8\bin ===== 5. Konfigurace, překlad a instalace knihovny CGAL ===== Zde dojde k vlastnímu nastavení prostředí CGAL, které se pak využívá ve Vašich projektech. V manuálech upozorňují, že jenutno mít proměnné %TMP% a %TEMP% nastaveny tak, aby tyto adresáře neobsahovaly mezery. ==== Konfigurace knihovny CGAL a vygenerování projektů pro její překlad a instalaci ==== * Přejděte do adresáře s instalovanou knihovnou CGAL ( D:\winappl\CGAL3.9) * Založte zde podadresář BUILD (na jméně nezáleží) a přejděte do něj * Otevřete konzoli v tomto adresáři * Napište cmake-gui ..\\ Pozor na DVĚ tečky - jde o odkaz na adresář, do kterého jste rozbalili CGAL * Překontrolujte, že pole * Where is the source code obsahuje D:/winappl/CGAL3.9 * Where to build the binaries obsahuje D:/winappl/CGAL3.9/BUILD * Klikněte na Configure * Vyberte v dialogu Visual Studio 2010 (prostředí, pro které bude cmake vytvářet projekty) \\ V horní části přibude hromada začervěněných položek (tj. všechny změněné položky) * Klikněte na Configure podruhé \\ Většina červené zmizí - červené zůstanou jen nenastavené údaje * Doplňte: * CMAKE_INSTALL_PREFIX = D:/winappl/CGAL-3.9 \\ (nebo adresář, kam se zkopírují knihovny a .h soubory) * ZLIB_INCLUDE_DIR = D:/winappl/zlib/include \\ (nutno zakliknout Advanced v cmake-gui) * ZLIB_INCLUDE_LIBRARY = D:/winappl/zlib/lib/zdll.lib * Klikněte na Configure (červné by nemělo zůstat nic) * Klikněte na Generate ..... cmake vygeneruje CGAL.sln a řadu projektů (BUILD_ALL.vxproj, INSTALL.vxproj,...) Poznámky: * Vše, co cmake zjistí a co zobrazuje v horní polovině okna cmake-gui, se uloží do souboru CMakeCache.txt * Někdy je nutno tento soubor vymazat (přímo, či v menu File / Delete Cache) * Soubory s projekty jsou autokonfigurované. Pokud se změní některé závislosti, postupuje build zpět až na úroveň príkazu cmake. Vygenerují se nové soubory s projekty a Visual Studio požádá o opětovné nahrání (reload) projektu. ==== Překlad a instalace knihovny CGAL ve Visual Studiu 2010 ==== - Otevřete projekt CGAL.sln ve Visual Studiu - Vyberte Build na projektu BUILD_ALL ..... přeloží se knihovny CGAL \\ Nebo v menu Build / Build Solution - Vyberte Build na projektu INSTALL .... knihovny se nainstalují do adresáře CMAKE_INSTALL_PREFIX - Alternativně lze překlad spustit z příkazové řádky \\ ''devenv CGAL.sln /Build Debug'' ===== 6. Použití knihovny CGAL na příkladu Triangulation_2 ===== * Vygenerování projektu pro Visual Studio - cd D:/winappl/CGAL-3.9/examples/Triangulation_2 - mkdir build ..... aby se nepomíchaly původní adresáře s vygenerovanými adresáři a soubory (můžeme mít různé takovéto podadresáře při pokusech s nastavením CGALu. Nepotřebné verze lze celé smazat) - cd build ..... dtto - cmake-gui - cmake-gui .. ..... ".." je adresář, ve kterém je soubor CMakeLists.txt, předpokládá se nastavná proměnná CGAL_DIR=D:/winappl/CGAL-3.9 - cmake-gui -DCGAL_DIR="D:/winappl/CGAL-3.9" ...... pokud byste CGAL_DIR nenastavili a neprovedli INSTALL knihovny CGAL do jiného adresáře - cmake-gui -DCGAL_DIR="D:/winappl/CGAL/lib/CGAL" ...... pokud byste CGAL_DIR nenastavili a provedli INSTALL knihovny CGAL do adresáře D:/winappl/CGAL - Config / Generate - Skupinu upozornění o nenastavených knihovnách ignorujte * Překlad příkladů - Otevřete Triangulation_2_example.sln ve Visual Studiu - Build/Build Solution * Spuštění příkladů - předpokládá adresář data v kořeni projektu, nebo v adresáři, odkus se spouští .exe - cd D:/winappl/CGAL-3.9/examples/Triangulation_2 - build\Debug\terrain.exe ===== 7. Použití knihovny CGAL a QT - příklad example_1 ===== - Vytvořte adresář ''example_1'' a do něj nakopírujte obsah example_1.zip - Je tu i soubor CMakeLists.txt, ve kterém je popsáno, co a jak má CMAKE poskládat do projektu - ''cd example_1; mkdir build; cd build'' - cmake-gui .. / Configure / Generate - Otevřít projekt ''example_1'' ve Visual Studiu / BUILD_ALL / Run