Configuring and Building DREAM.3D on Windows¶

Next, download the source code repositories by following the instructions on the SourceDownload page.

Setup¶

DREAM.3D is built using Visual Studio 2017, either the Free community edition or the Pro paid version. Both versions will give the exact same results. DREAM.3D is compiled as a 64 Bit application.

Using CMake-Gui.exe the developer can configure a build directory for DREAM.3D

Launch CMake-Gui.exe and select the DREAM3D source directory as in figure 1:

Figure 1: Selecting the DREAM3D Source Code Directory

Next set the Binary Directory as in figure 2.

Figure 2: Select the Binary Directory. Note: Do NOT select the same directory.

Next add an entry for the location to the DREAM3D_SDK directory (Figure 4) by clicking the "Add Entry" button (Figure 3.)

Figure 4: Setting the DREAM3D_SDK CMake variable

At this point the CMake-Gui application should look something like the following (Figure 5)

Figure 5: State of CMake-Gui before configuring the project.

Now click the "Confiugre" button. CMake will ask you which generator to use. Please select the version of Visual Studio that you have installed (VS 15 2017 is the current as of FEB 2019). Also not that you want the generator that ends with Win64

Figure 6: Selecting the proper Visual Studio Version.

After selecting the generator CMake will inspect your system for compilers and then locate all of the dependent libraries. After that is complete and assuming no CMake errors the state of the CMake-Gui should look similar to figure 7:

Figure 7: State of CMake-Gui after configuring

Assuming no errors the user can click the Generate button to create the Visual Studio Solution files (DREAM3DProj.sln) which the user can open to compile DREAM.3D.

After opening the DREAM.3D Visual Studio solution file, use the drop down menu to select a Release build (see figure 8)

Figure 8: Visual Studio Release build

and then proceed to build the entire solution (see figure 9)

Figure 9: Visual Studio building DREAM.3D

Packaging¶

If you want to create a redistributable package for your organization then simply select the PACKAGE target to compile (figure 10)

Figure 10: Packaging DREAM.3D for redistribution

At the completion of the PACKAGE phase a ZIPPED archive called DREAM3D-XXXXX.zip will be saved into the Binary directory.