{"id":527,"date":"2016-03-10T02:26:30","date_gmt":"2016-03-10T02:26:30","guid":{"rendered":"http:\/\/fractorium.com\/?page_id=527"},"modified":"2025-03-25T16:48:34","modified_gmt":"2025-03-25T16:48:34","slug":"building-on-windows","status":"publish","type":"page","link":"http:\/\/fractorium.com\/?page_id=527","title":{"rendered":"Building on Windows"},"content":{"rendered":"

This is the guide for building on Windows using either Visual Studio 2022 or Qt Creator<\/p>\n

Tools<\/h3>
\n

git<\/h4>\n

Install\u00a0git<\/a>.<\/p>\n

Visual Studio<\/h4>\n

Install Microsoft Visual Studio 2022 or later<\/a>, then install the latest updates.<\/p>\n

Qt<\/h4>\n

Install Qt for Windows 64-bit<\/a><\/p>\n

Add system environment variable named QTPATH<\/code> and point it to the location of the Qt folder. On a default install, this will be something like:<\/p>\n

C:\\Qt\\6.5.1\\msvc2019_64<\/pre>\n
Wix<\/h4>\n
To build the installer, you must have Wix installed. If you are unconcerned with it, you can skip this step and just dismiss the warning that shows when opening the solution later. It’s recommended you ignore the installer since official builds are provided on this page.<\/p>\n
CMake<\/h4>\n
Download<\/a> and be sure to check the option to add it to the system path.<\/p>\n<\/div>\n
Obtaining source<\/h3>
\n
This project<\/h4>\n
Open up the Visual Studio x64 Native Tools Command Prompt.<\/p>\n
Create a new folder in your development area named fractorium:<\/p>\n
mkdir fractorium<\/pre>\n
cd fractorium<\/pre>\n
git clone https:\/\/mfeemster@bitbucket.org\/mfeemster\/fractorium.git<\/pre>\n
Prerequisites<\/h4>\n
There are six prerequisite dependencies. One of them must be downloaded manually:<\/p>\n
Download the libjpeg zip file here<\/a>.<\/p>\n
Extract it into the folder you created such that they are arranged like so:<\/p>\n
[fractorium]\n \u2502\n \u251c\u2500libjpeg\n<\/pre>\n
Go into the fractorium folder and run this script which will get the rest of the prerequisites from git and build them:<\/p>\n
cd fractorium<\/pre>\n
makedeps.bat<\/pre>\n
This will download and build<\/p>\n
glm libopenexr libpng libxml zlib<\/pre>\n
You will have a folder structure like this:<\/p>\n
[fractorium]\n\u2502\n\u251c\u2500[glm]\n\u251c\u2500[libjpeg]\n\u251c\u2500[libpng]\n\u251c\u2500[libxml2]\n\u251c\u2500[openexr]\n\u2514\u2500[fractorium]\n--\u2502\n--\u2514\u2500[Deps]\n----\u2502\n----\u251c\u2500Iex-3_1.dll\n----\u251c\u2500IlmThread-3_1.dll\n----\u251c\u2500IMath-3_1.dll\n----\u251c\u2500libxml2.dll\n----\u251c\u2500OpenEXR-3_1.dll\n----\u251c\u2500Iex-3_1.lib\n----\u251c\u2500IlmThread-3_1.lib\n----\u251c\u2500Imath-3_1.lib\n----\u251c\u2500libjpeg.lib\n----\u251c\u2500libpng.lib\n----\u251c\u2500libxml2.lib\n----\u251c\u2500OpenEXR-3_1.lib\n----\u251c\u2500OpenEXRCore-3_1.lib\n----\u251c\u2500OpenEXRUtil-3_1.lib\n----\u251c\u2500zlib.lib<\/pre>\n<\/div>\n
Building with Qt Creator or Visual Studio<\/h3>
\n
Begin build with Qt Creator<\/h4>\n
Open the Qt Project fractorium\/main.pro<\/code> using Qt Creator with the default configuration of Desktop Qt [version] MSVC[VS version] 64bit<\/code>.<\/p>\n
Make sure Shadow build<\/code> in Edit build configuration<\/code> for both Debug<\/code> and Release<\/code> is unchecked.<\/p>\n
Switch to the Release<\/code> configuration.<\/p>\n
Under Build Steps<\/code>, add an additional argument of install<\/code> to the make<\/code> command to force all dependencies to be copied to the output folder. The final make command should look like:<\/p>\n
jom.exe install in \/path\/to\/fractorium<\/pre>\n
Ensure all projects are in the Release<\/code> configuration and build main.pro<\/code>.<\/p>\n
The outputs will be placed in fractorium\/Bin\/release<\/code> several minutes later if no errors occur.<\/p>\n
Begin build with Visual Studio<\/h4>\n
Visual Studio Qt Addon<\/h5>\n
Install the Visual Studio Qt Addon<\/a>.<\/p>\n
Run Visual Studio and verify there is a menu item named Qt6<\/code>. Click on it and click Qt Options<\/code>.<\/p>\n
Add a new Qt version to the list with the exact name of \"Qt6\"<\/code>, and set its path to the same as $QTPATH<\/code>, which will be something like:<\/p>\n
C:\\Qt\\6.5.1\\msvc2019_64<\/pre>\n
The name \"Qt6\"<\/code> must match exactly and this step must be completed before the Fractorium solution is opened. If not, the Qt add-in will completely ruin all solution and project files that use Qt.<\/p>\n
Set the default version to the newly created Qt version and click Ok<\/code>.<\/p>\n
Open the file Fractorium.sln<\/code> under Builds\/MSVC\/[VS version]<\/code><\/p>\n
Set the configuration to Release<\/code>, and build all.<\/p>\n
The outputs will be placed in fractorium\/Bin\/x64\/Release<\/code> several minutes later if no errors occur.<\/p>\n<\/div>\n
Outputs<\/h3>
\n
The outputs will be the same whether Visual Studio or Qt Creator was used, however their locations will be different.<\/p>\n
Qt Creator will place its outputs in:<\/p>\n
fractorium\/Bin\/Release<\/pre>\n
and Visual Studio will place its outputs in:<\/p>\n
fractorium\/Bin\/x64\/Release<\/pre>\n
The output contents will be:<\/p>\n
Amphibole_Supergroup.ugr\nApatite_Supergroup.ugr\nboxtail_pack_02.gradient\nboxtail_pack_03_triangle.gradient\nboxtail_pack_04_mineshack.gradient\nconcrt140.dll\ndark_windows.qss\nEmber.dll\nEmberAnimate.exe\nEmberCL.dll\nEmberGenome.exe\nEmberRender.exe\nfardareismai_pack_01_variety_number_128.gradient\nfardareismai_pack_02_b_sides.gradient\nfardareismai_pack_03_old_and_new.gradient\nfardareismai_pack_04_hoard.gradient\nFeldspar_Group.ugr\nflam3-palettes.xml\nfractaldesire_pack_01.gradient\nFractorium.exe\nIex-3_1.dll\nIlmThread-3_1.dll\nImath-3_1.dll\nlibxml2.dll\nlightdark.qss\nMica_Group.ugr\nmsvcp140.dll\nOpenEXR-3_1.dll\nQt6Core.dll\nQt6Gui.dll\nQt6OpenGL.dll\nQt6OpenGLWidgets.dll\nQt6Widgets.dll\nQuartz_Varieties.ugr\nrce_ordinary_pack_01_colornation.gradient\ntatasz_pack_01.gradient\ntatasz_pack_02_colder.gradient\ntatasz_pack_02_dark.gradient\ntatasz_pack_02_warmer.gradient\ntatasz_pack_03.gradient\ntatasz_pack_04.gradient\ntatasz_pack_05.gradient\ntatasz_pack_06.gradient\ntatasz_pack_07.gradient\nuranium.qss\nuser-palettes.xml\nvccorlib140.dll\nvcruntime140.dll\nvcruntime140_1.dll\nimageformats\\qjpeg.dll\nplatforms\\qwindows.dll<\/pre>\n
Double click fractorium.exe<\/code> to run it, and use the command line to run the others.<\/p>\n
To run on a computer without Visual Studio 2022, these files also need to be in the folder:<\/p>\n
C:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\Common7\\IDE\\msvcp140.dll\nC:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\Common7\\IDE\\vcruntime140.dll\nC:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\Common7\\IDE\\vcruntime140_1.dll\nC:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\Common7\\IDE\\vccorlib140.dll\nC:\\Program Files\\Microsoft Visual Studio\\2022\\Community\\Common7\\IDE\\concrt140.dll<\/pre>\n
or you can install Visual C++ Redistributable Packages for Visual Studio<\/a><\/p>\n<\/div>\n
Final file structure for distribution<\/h3>
\n
[YOUR FOLDER]\n\u2502\n\u251c\u2500Amphibole_Supergroup.ugr\n\u251c\u2500Apatite_Supergroup.ugr\n\u251c\u2500boxtail_pack_02.gradient\n\u251c\u2500boxtail_pack_03_triangle.gradient\n\u251c\u2500boxtail_pack_04_mineshack.gradient\n\u251c\u2500dark_windows.qss\n\u251c\u2500Ember.dll\n\u251c\u2500EmberAnimate.exe\n\u251c\u2500EmberCL.dll\n\u251c\u2500EmberGenome.exe\n\u251c\u2500EmberRender.exe\n\u251c\u2500fardareismai_pack_01_variety_number_128.gradient\n\u251c\u2500fardareismai_pack_02_b_sides.gradient\n\u251c\u2500fardareismai_pack_03_old_and_new.gradient\n\u251c\u2500fardareismai_pack_04_hoard.gradient\n\u251c\u2500Feldspar_Group.ugr\n\u251c\u2500flam3-palettes.xml\n\u251c\u2500fractaldesire_pack_01.gradient\n\u251c\u2500Fractorium.exe\n\u251c\u2500Iex-3_1.dll\n\u251c\u2500IlmThread-3_1.dll\n\u251c\u2500Imath-3_1.dll\n\u251c\u2500libxml2.dll\n\u251c\u2500lightdark.qss\n\u251c\u2500Mica_Group.ugr\n\u251c\u2500OpenEXR-3_1.dll\n\u251c\u2500Qt6Core.dll\n\u251c\u2500Qt6Gui.dll\n\u251c\u2500Qt6OpenGL.dll\n\u251c\u2500Qt6OpenGLWidgets.dll\n\u251c\u2500Qt6Widgets.dll\n\u251c\u2500Quartz_Varieties.ugr\n\u251c\u2500rce_ordinary_pack_01_colornation.gradient\n\u251c\u2500tatasz_pack_01.gradient\n\u251c\u2500tatasz_pack_02_colder.gradient\n\u251c\u2500tatasz_pack_02_dark.gradient\n\u251c\u2500tatasz_pack_02_warmer.gradient\n\u251c\u2500tatasz_pack_03.gradient\n\u251c\u2500tatasz_pack_04.gradient\n\u251c\u2500tatasz_pack_05.gradient\n\u251c\u2500tatasz_pack_06.gradient\n\u251c\u2500tatasz_pack_07.gradient\n\u251c\u2500uranium.qss\n\u251c\u2500user-palettes.xml\n\u251c\u2500msvcp140.dll (optional)\n\u251c\u2500vcruntime140.dll (optional)\n\u251c\u2500vcruntime140_1.dll (optional)\n\u251c\u2500vccorlib140.dll (optional)\n\u251c\u2500concrt140.dll (optional)\n\u2502\n\u2514\u2500[imageformats]\n--|\n--\u251c\u2500qjpeg.dll\n--\u2514\u2500[platforms]\n----\u2502\n----\u251c\u2500qwindows.dll\n<\/span><\/div><\/pre>\n","protected":false},"excerpt":{"rendered":"
This is the guide for building on Windows using either Visual Studio 2022 or Qt Creator<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":63,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-527","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/pages\/527","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"http:\/\/fractorium.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=527"}],"version-history":[{"count":62,"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/pages\/527\/revisions"}],"predecessor-version":[{"id":2490,"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/pages\/527\/revisions\/2490"}],"up":[{"embeddable":true,"href":"http:\/\/fractorium.com\/index.php?rest_route=\/wp\/v2\/pages\/63"}],"wp:attachment":[{"href":"http:\/\/fractorium.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=527"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}