Castor3D utilise CMake pour générer les fichiers de projets.
Vous devez donc lancer CMake pour générer les fichiers de projet pour la solution que vous préférez.
La documenation de CastorUtils et Castor3D peut être générée via Doxygen.

Les compilateurs testés sont les suivants :

• Visual Studio 2019
• gcc 8.0

Projets

Projets Principaux

• CastorUtils: Dépend de zlib.
• Castor3D: Dépend de CastorUtils, Ahes et ShaderWriter.
• GuiCommon: Dépend de Castor3D et wxWidgets (depuis la version 2.9.5, actuellement la version 3.1).
• CastorViewer: Dépend de GuiCommon et wxWidgets.

Plugins

Importers

• ASSIMP: Dépend de Castor3D et Assimp.
• PLY: Dépend de Castor3D.
• OBJ: Dépend de Castor3D.

Dividers

• Loop: Dépend de Castor3D.
• Phong: Dépend de Castor3D.
• PN-Triangles: Dépend de Castor3D.

PostEffects

• Bloom: Dépend de Castor3D.
• FilmGrain: Dépend de Castor3D.
• GrayScale: Dépend de Castor3D.
• LightStreaks: Dépend de Castor3D.
• FXAA: Dépend de Castor3D.
• SMAA: Dépend de Castor3D.
• Linear Motion Blur: Dépend de Castor3D.

Generators

• DiamondSquareTerrain: Dépend de Castor3D.

Generic

• CastorGUI: Dépend de Castor3D.

ToneMappings

• LinearToneMapping: Dépend de Castor3D.
• HaarmPieterDuikerToneMapping: Dépend de Castor3D.
• HejlBurgessDawsonToneMapping: Dépend de Castor3D.
• ReinhardToneMapping: Dépend de Castor3D.
• Uncharted2ToneMapping: Dépend de Castor3D.

Projets de test

• CastorTest: Bibliothèque de base pour les tests, dépend de CastorUtils.
• CastorUtilsTest: Vous permet de lancer des tests unitaires et de performances pour CastorUtils, dépend de CastorUtils et CastorTest.
• Castor3DTest: Vous permet de lancer les tests unitaires de Castor3D, dépend de Castor3D et CastorTest.

Outils

• Aria: Dépend de CastorUtils, Boost, sqlite et wxWidgets.
• CastorMeshConverter: Dépend de Castor3D et wxWidgets.
• CastorMeshUpgrader: Dépend de Castor3D et wxWidgets.
• ImgConverter: Dépend de wxWidgets.
• CastorTestLauncher: Dépend de Castor3D.
• DiffImage: Dépend de CastorUtils.

Options

Sur GNU/Linux le dossier par défaut d'installation est /usr/local.
Vous pouvez changer ce dossier en modifiant la valeur CMAKE_INSTALL_PREFIX.
Les applications d'exemple, d'outils et de tests sont installées dans install_dir/bin/
Les bibliothèques principales (CastorUtils and Castor3D) sont installées dans install_dir/lib/ sur GNU/Linux, et dans install_dir/bin/ sur Windows.
Les plug-ins sont installés dans install_dir/lib/Castor3D/
La génération est configurable dans CMake, via les options suivantes :

• PROJECTS_BINARIES_OUTPUT_DIR
  Utilisé pour définir le dossier de base des binaires finaux.
  Dans ce dossier, les sous-dossiers bin, lib et share sont créés, et les binaires sont placés dans les sous-dossiers appropriés.
  Certains fichiers seront aussi copiés dans le sous-dossier share (les traductions, par exemple).
  Sur Windows, les DLL externes seront copiées dans le dossier bin, si elles sont trouvées.
  
• PROJECTS_USE_PRECOMPILED_HEADERS
  Utilisé pour activer/désactiver l'utilisation des Precompiled Headers lors de la compilation.
  
• PROJECTS_USE_PRETTY_PRINTING
  Si cette option est activée, et si A-Style est trouvé, de nouveaux projets de test seront créés, permettant de lancer A-Style sur les sources associés à ces projets.
  
• CASTOR_BUILD_CASTOR3D
  Cette option particulière vous permet de désactiver le build de Castor3D, et de tout projet en dépendant, résultant en la génération de CastorUtils et CastorUtilsTest uniquement.
  
• CASTOR_BUILD_PLUGINS
  Une autre option particulière, permettant de désactiver la génération des plugins.
  
• CASTOR_BUILDGRP_DIVIDER
  Active la génération des plugins de type Divider.
  
• CASTOR_BUILDGRP_GENERATOR
  Active la génération des plugins de type Generator.
  
• CASTOR_BUILDGRP_GENERIC
  Active la génération des plugins de type Generic.
  
• CASTOR_BUILDGRP_IMPORTER
  Active la génération des plugins de type Importer.
  
• CASTOR_BUILDGRP_INTEROP
  Active la génération des bindings avec d'autres langages.
  
• CASTOR_BUILDGRP_PARTICLES
  Active la génération des plugins de type Particle.
  
• CASTOR_BUILDGRP_POSTFX
  Active la génération des plugins de type PostEffect.
  
• CASTOR_BUILDGRP_SAMPLE
  Active la génération des applications d'exemple.
  
• CASTOR_BUILDGRP_SETUP
  Active la génération des projets de setup.
  
• CASTOR_BUILDGRP_TEST
  Active la génération des applications de test.
  
• CASTOR_BUILDGRP_TONEMAPS
  Active la génération des plugins de type ToneMapping.
  (Le plugin LinearToneMapping sera tout de même généré, étant celui utilisé par défaut).
  
• CASTOR_BUILDGRP_TOOL
  Active la génération des applications utilitaires.
  
• CASTOR_BUILD_DIVIDER_(NAME)
  Active la génération du plugin Divider (NAME).
  
• CASTOR_BUILD_GENERATOR_(NAME)
  Active la génération du plugin Generator (NAME).
  
• CASTOR_BUILD_GENERIC_(NAME)
  Active la génération du plugin Generic (NAME).
  
• CASTOR_BUILD_IMPORTER_(NAME)
  Active la génération du plugin Importer (NAME).
  
• CASTOR_BUILD_INTEROP_(NAME)
  Active la génération du binding (NAME).
  
• CASTOR_BUILD_POSTFX_(NAME)
  Active la génération du plugin PostEffect (NAME).
  
• CASTOR_BUILD_SAMPLE_(NAME)
  Active la génération de l'application d'exemple (NAME).
  
• CASTOR_BUILD_TONEMAP_(NAME)
  Active la génération du plugin ToneMap (NAME).
  
• CASTOR_BUILD_TEST_(NAME)
  Active la génération de l'application de test (NAME).