ASTex

ASTex is an open-source library for texture analysis and synthesis. The term “texture” must be understood as in computer graphics. The purpose of this library is to support collaborative coding and to allow for comparison with recently published algorithms.

Installation

Dependencies:

To compile and use ASTex, you need the following libraries:

• ITK 4.10
• zlib
• openexr for saving/loading images in floating point format.

You need some classic development tools (minimal supported version)

• git
• cmake 3.0
• a recent C++ compiler
  • g++ 4.9
  • clang 3.3
  • Visual Studio C++ 2015

Linux

Install the following packages:

• libinsighttoolkit4-dev (version >=4.10)
• libpng-dev
• libopenexr-dev

Mac OS/X

The most simple way to install dependencies is to use the homebrew package system. Then you can install the dependencies:

• brew install insighttoolkit
• brew install openexr
• brew install libpng

Windows

Softwares:

• VisualStudio C++ (2015 min)
• CMake (3.0 min),
• jom (already installed if you have QtCreator) for multi-threaded compilation of dependencies

Sources to download:

• get sources of zlib
• get sources of OpenEXR (use github, archive on OpenEXR.com has bugs)
• get sources of InsightToolKit

Compile dependencies

• use furnished compilation scripts:
  • make a local copy of folder script_windows to avoid pushing your modifications on git server
  • edit your installvars.bat (check path for exec, src and installation)
  • WARNING due to a limitation in Visual-Studio, source and build (of itk) directory path should not be too long (50 char) !
  • double click on install_static_debug.bat for compil/install of zlib/openexr/itk and creation of ASTex solution in static debug mode
  • or/and double click on install_static_release.bat for compil/install of zlib/openexr/itk and creation of ASTex solution in static release mode
  • or/and double click on install_dynamic_debug.bat for compil/install of zlib/openexr/itk and creation of ASTex solution in dynamic debug mode
  • or/adn double click on install_dynamic_release.bat for compil/install of zlib/openexr/itk and creation of ASTex solution in dynamic release mode
  • you can reset the ASTex solutions with the reset_static_astex_solu.bat and reset_dynamic_astex_solu.bat scripts
  • after you can customize your build with cmake-gui (using the right build directory)
• WARNINNG: if you want to install dynamic and static do not forget to changethe INSTALL_REL & INSTALL_DBG vars in installvars.bat
• solutions are in folder build-astex-xxx-release / build-astex-xxx-debug
• all installed libs (including ASTex) are in the same folder:
  • to install ASTex just just generate the INSTALL target
  • installed-Release for release
  • installed-Debug for debug

Data

IMPORTANT

Some tests, tutorials and algorithms read in some example images and write image results out. In order to keep the original Data directory of ASTex clean we use a copy whose path can be chosen at cmake configuration time.

You should copy the content of the Data/ directory to the chosen path manually for this to work (see the ASTEX_TEMPO_PATH cmake variable).

Compilation

on Linux & Mac

Use CMake as usual:

• Create a build directory at the same level as ASTex/ (ASTex-build/ or ASTex-buildDebug/ for example)
• Go inside your build directory and type "cmake ../ASTex"
• Alternatively, use the cmake GUI or let (a recent) Qtcreator do the job !

on Windows + VisualStudio

• The build directory has been created by install script
• Use the script reset_astex_solu in your copy of script_windows in case of trouble
• Use CMake-gui to customize the build
• Launch Visual Studio and load the ASTex solution which has been generated in the build directory

CMake Options

There are some original options/values that can be set at the cmake stage:

• ASTEX_ALGO_xxx choose to build the different implemented algorithms.
• ASTEX_BUILD_xxx choose to build bench/tuto/test
• ASTEX_PERSO_xxx set to ON if you wish to build each directory added in ASTex/ containing a CMakeLists.txt. Note: just relaunch cmake after adding a directory.
• ASTEX_TEMPO_PATH path of directory used to store images for test and tutorial scripts (copy ASTex/Data into it)
• ASTEX_USE_CPP14 set this to ON if VXL complains that you are using a C++ standard version older than the one used to compile the ASTex library.