modify Qt projects for building with Qt Creator (windows)

add build guide using Qt Creator and MSVC2013
2025-07-01 05:46:06 -04:00 · 2016-01-04 21:45:40 +08:00
parent fd084d2ce8
commit 02261e6e76
6 changed files with 335 additions and 52 deletions
--- a/Data/BuildGuideQtCreator.md
+++ b/Data/BuildGuideQtCreator.md
@ -0,0 +1,224 @@
+#Building Guide for Fractorium Using MSVC2013 and Qt Creator (64 bit)
+##Requirements
+
+You need to have MSVC2013 compiler and  Qt for Windows 64-bit (VS 2013) like Qt 5.5.1 (http://download.qt.io/official_releases/qt/5.5/5.5.1/qt-opensource-windows-x86-msvc2013_64-5.5.1.exe)
+
+##Prerequisites
+Download Prerequisites ( /glm /libjpeg /libpng /libxml2 /tbb /zlib ) according to [mfeemster's wiki](https://github.com/mfeemster/fractorium/wiki/Building).  
+Extract them in the parallel folder of `fractorium` named `External`  
+You can refer to the [folder structure](#folder-structure) below  
+Open your `Visual Studio Tools Command Prompt (amd64 2013)` and do the followings in folders below:  
+
+######\External\libjpeg (jpegsr9a.zip)
+-   run in prompt  
+
+    ```
+    SET Include=%Include%;"C:\Program Files (x86)\Microsoft SDKs\Windows\v7.1A\Include"
+    ```
+    
+    (to include WIN32.mak)  
+    (I use `SET Include=%Include%;"B:\MSVC2013\Windows Kits\v7.1A\Include"`)
+    
+    ```
+    nmake /f makefile.vc  setup-v10
+    nmake nodebug=1 /f makefile.vc clean all
+    ```
+    
+    copy `libjpeg.lib` in `External\libjpeg` to `External\libs`
+
+
+###### \External\zlib (zlib128.zip)
+- run in prompt
+
+    ```
+    nmake -f win32/Makefile.msc clean all
+    ```
+    
+    copy `zlib.lib` in `External\zlib` to `External\libs`
+
+###### \External\libxml2 (libxml2-2.9.3.zip)
+- cd to `External\libxml2\win32`
+
+    ```
+    cscript configure.js compiler=msvc iconv=no zlib=yes include=..\..\zlib lib=..\..\zlib
+    nmake /f Makefile.msvc clean all
+    ```
+
+    copy `libxml2.lib` in `External\libxml2\win32\bin.msvc` to `External\libs`
+
+###### \External\libpng (lpng1620.zip)
+- First, copy `zlib.lib` `zlib.h` and `zconf.h` to `External\libpng\zlib` (create this folder if no exsiting)
+
+    ```
+    nmake -f  scripts\makefile.vcwin32 clean all
+    ```
+    
+    copy `libpng.lib` in `External\libpng` to `External\libs`
+
+###### \External\glm (glm-0.9.6.3.zip)
+- noting to do, make sure you extract it correctly.
+
+###### \External\tbb (tbb44_20151115oss_win_0.zip)
+- copy `External\tbb\lib\intel64\vc12\tbb_debug.lib` and `External\tbb\lib\intel64\vc12\tbb.lib` to `External\libs`
+
+##Collect libs and includes
+###### \External\libs
+- copy `GlU32.Lib` `WS2_32.Lib` `OpenGL32.Lib` under `MSVC2013\Windows Kits\8.1\Lib\winv6.3\um\x64`
+    to this folder (`\External\libs`)  
+    install CUDA toolkit and copy `CUDA\v7.5\lib\x64\OpenCL.lib` to this folder (`\External\libs`)
+
+- Now you should already have these files in the folder:
+
+    ```
+    GlU32.Lib
+    libjpeg.lib
+    libpng.lib
+    libxml2.lib
+    OpenCL.lib
+    OpenGL32.Lib
+    tbb.lib
+    tbb_debug.lib
+    WS2_32.Lib
+    zlib.lib
+    ```
+
+###### \fractorium\Builds\lib
+- copy anything(they are `*.h`) under `CUDA\v7.5\include\CL`
+     to this folder `\fractorium\Builds\include\vendor\CL` (overwrite)
+
+**All Done!**  
+<a id="folder-structure"></a>
+
+You shuold have folder structure like this:
+
+```
+[YOUR ROOT FOLDER]
+│  
+├─External
+│  ├─glm
+│  │  ├─glm
+│  │  ...
+│  ├─libjpeg
+│  ├─libpng
+│  │  ├─scripts
+│  │  ├─zlib
+│  │  ...
+│  ├─libs
+│  │      GlU32.Lib
+│  │      libjpeg.lib
+│  │      libpng.lib
+│  │      libxml2.lib
+│  │      OpenCL.lib
+│  │      OpenGL32.Lib
+│  │      tbb.lib
+│  │      tbb_debug.lib
+│  │      WS2_32.Lib
+│  │      zlib.lib
+│  │      
+│  ├─libxml2
+│  │  ├─include
+│  │  │  └─libxml
+│  │  ...
+│  ├─tbb
+│  │  ├─include
+│  │  │  ├─serial
+│  │  │  │  └─tbb
+│  │  │  └─tbb
+│  │  │      ├─compat
+│  │  │      ├─internal
+│  │  │      └─machine
+│  │  ├─lib
+│  │  │   ├─ia32
+│  │  │   │ 
+│  │  │   └─intel64
+│  │  │      ├─vc10
+│  │  │      ├─vc12
+│  │  ...     ...
+│  └─zlib
+│      ├─win32
+│      ...
+└─fractorium
+    ├─archive
+    ├─Builds
+    │  ├─lib
+    │  ├─QtCreator
+    │  ...
+    ├─Data
+    │  
+    ├─debian
+    │  
+    └─Source
+```
+
+##Begin to build
+Open Qt Project `fractorium/main.pro` using Qt Creator with config like *Desktop Qt 5.5.1 MSVC2013 OpenGL 64bit*  
+**DO TURN OFF** "shadow build option" in "Edit build configuration" for both `Debug` and `Release`
+
+Switch to `Release` configuration and Build!  
+
+You can find outputs `under fractorium\Bin\release` several minutes later if no error occurs.
+
+```
+Ember.dll
+Ember.exp
+Ember.lib
+emberanimate.exe
+EmberCL.dll
+EmberCL.exp
+EmberCL.lib
+embergenome.exe
+emberrender.exe
+fractorium.exe
+```
+
+To run it, put exes and dlls above and these files together in one folder
+```
+Qt5.5.1\5.5\msvc2013_64\bin\Qt5OpenGL.dll
+Qt5.5.1\5.5\msvc2013_64\bin\Qt5Widgets.dll
+Qt5.5.1\5.5\msvc2013_64\bin\Qt5Core.dll
+Qt5.5.1\5.5\msvc2013_64\bin\Qt5Gui.dll
+Qt5.5.1\5.5\msvc2013_64\plugins\platforms\qwindows.dll  (put in folder "platforms")
+External\libxml2\win32\bin.msvc\libxml2.dll
+External\tbb\bin\intel64\vc12\tbb.dll
+fractorium\Data\dark.qss
+fractorium\Data\flam3-palettes.xml
+```
+
+To run on another computer, maybe these files are needed to be shipped with:
+
+```
+MSVC2013\VC\redist\x64\Microsoft.VC120.CRT\msvcp120.dll
+MSVC2013\VC\redist\x64\Microsoft.VC120.CRT\msvcr120.dll
+MSVC2013\VC\redist\x64\Microsoft.VC120.CRT\vccorlib120.dll
+```
+
+or you can install *Visual C++ Redistributable Packages for Visual Studio 2013 (64 bit)*
+
+####Output file structure
+
+```
+[YOUR FOLDER]
+│  dark.qss
+│  Ember.dll
+│  emberanimate.exe
+│  EmberCL.dll
+│  embergenome.exe
+│  emberrender.exe
+│  flam3-palettes.xml
+│  fractorium.exe
+│  libxml2.dll
+│  Qt5Core.dll
+│  Qt5Gui.dll
+│  Qt5OpenGL.dll
+│  Qt5Widgets.dll
+│  tbb.dll
+│ 
+│  vccorlib120.dll   (optional)
+│  msvcp120.dll      (optional)
+│  msvcr120.dll      (optional)
+│  
+└─platforms
+        qwindows.dll
+```
+
+####Have Fun!