Originální text: 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:

1. Stažení a instalace zdrojových kódů knihovny CGAL-3.
2. Stažení a instalace CMake
3. Stažení a instalace knihoven
4. Záloha proměnných prostředí (stalo se mi, že je instalace CGAL přepsala)
5. Nastavení proměnných prostředí
6. Konfigurace, překlad a instalace knihovny CGAL
7. Použití knihovny CGAL na příkladu Triangulation_2
8. Použití knihovny CGAL a QT - příklad example_1

• Stáhněte CGAL-3.9-Setup.exe (Dostanete se sem po vyplnění dotazníku a přijetí podmínek licence ze 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

Další odkazy:

• oficielní stránka www.cgal.org
• oficielní Instalační manuál
• soubory projektu CGAL ke stažení

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 cmake-2.8.5-win32-x86.exe (nebo z této 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)

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 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 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 ( OpenSource QT project - downloads)
  • Dal jsem verzi pro vs2008 - funguje
    Qt libraries 4.7.4 for Windows (VS 2008, 228 MB)
  • 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

• 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

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.

• 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.

1. Otevřete projekt CGAL.sln ve Visual Studiu
2. Vyberte Build na projektu BUILD_ALL ….. přeloží se knihovny CGAL
   Nebo v menu Build / Build Solution
3. Vyberte Build na projektu INSTALL …. knihovny se nainstalují do adresáře CMAKE_INSTALL_PREFIX
4. Alternativně lze překlad spustit z příkazové řádky
   devenv CGAL.sln /Build Debug

• Vygenerování projektu pro Visual Studio
  1. cd D:/winappl/CGAL-3.9/examples/Triangulation_2
  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)
  3. cd build ….. dtto
  4. cmake-gui
     1. 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
     2. cmake-gui -DCGAL_DIR=“D:/winappl/CGAL-3.9” …… pokud byste CGAL_DIR nenastavili a neprovedli INSTALL knihovny CGAL do jiného adresáře
     3. 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
  5. Config / Generate
  6. Skupinu upozornění o nenastavených knihovnách ignorujte
• Překlad příkladů
  1. Otevřete Triangulation_2_example.sln ve Visual Studiu
  2. 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
  1. cd D:/winappl/CGAL-3.9/examples/Triangulation_2
  2. build\Debug\terrain.exe

1. Vytvořte adresář example_1 a do něj nakopírujte obsah example_1.zip
2. Je tu i soubor CMakeLists.txt, ve kterém je popsáno, co a jak má CMAKE poskládat do projektu
3. cd example_1; mkdir build; cd build
4. cmake-gui .. / Configure / Generate
5. Otevřít projekt example_1 ve Visual Studiu / BUILD_ALL / Run