====== 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