mirror of
https://bitbucket.org/mfeemster/fractorium.git
synced 2025-01-21 13:10:04 -05:00
Update BuildGuideQtCreator.md
This commit is contained in:
Matt Feemster
parent
3533ea2002
commit
db447d2075
@ -1,14 +1,29 @@
|
||||
#Building Guide for Fractorium Using MSVC2013 and Qt Creator (64 bit)
|
||||
##Requirements
|
||||
#Build Guide for Fractorium Using MSVC2013 or Qt Creator (64 bit)
|
||||
##Tools
|
||||
|
||||
###git
|
||||
|
||||
Install [git](https://git-scm.com/downloads).
|
||||
|
||||
###Visual Studio
|
||||
|
||||
Install [Microsoft Visual Studio 2013 or later](https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx), then install the latest updates.
|
||||
|
||||
Install Qt for Windows 64-bit (VS 2013) 5.4 or later (http://www.qt.io/download/).
|
||||
###Qt
|
||||
|
||||
##Get this project
|
||||
Open up the Visual Studio x64 Native Tools Command Prompt
|
||||
Install Qt for Windows 64-bit (VS 2013) 5.5.x (http://www.qt.io/download/).
|
||||
|
||||
Add system environment variable named `QTPATH` and point it to the location of the Qt binaries folder. On a default install, this will be something like:
|
||||
|
||||
`C:\Qt\Qt5.5.1\5.5\msvc2013_64\bin`
|
||||
|
||||
###Wix
|
||||
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.
|
||||
|
||||
##Obtaining source
|
||||
|
||||
###This project
|
||||
Open up the Visual Studio x64 Native Tools Command Prompt.
|
||||
|
||||
Create a new folder in your development area named fractorium:
|
||||
|
||||
@ -18,12 +33,12 @@ Create a new folder in your development area named fractorium:
|
||||
|
||||
`git clone https://github.com/mfeemster/fractorium.git`
|
||||
|
||||
##Prerequisites
|
||||
###Prerequisites
|
||||
There are six prerequisite dependencies. Two of them must be downloaded manually:
|
||||
|
||||
[libjpeg](http://www.ijg.org/)
|
||||
|
||||
[tbb](https://www.threadingbuildingblocks.org/download) (get the open source download)
|
||||
[tbb](https://www.threadingbuildingblocks.org/download) (Intel provides executable only releases in addition to open source releases. You must get the open source release)
|
||||
|
||||
Extract them into the folder you created such that they are arranged like so:
|
||||
|
||||
@ -43,7 +58,7 @@ Go into the fractorium folder and run this script which will get the rest of the
|
||||
This will download and build `glm libpng libxml zlib`. You will have a folder structure like this:
|
||||
|
||||
```
|
||||
[YOUR ROOT FOLDER]
|
||||
[fractorium]
|
||||
│
|
||||
├─glm
|
||||
├─libjpeg
|
||||
@ -63,7 +78,9 @@ This will download and build `glm libpng libxml zlib`. You will have a folder st
|
||||
├─zlib.lib
|
||||
```
|
||||
|
||||
##Begin build with Qt Creator:
|
||||
##Building with Qt Creator or Visual Studio
|
||||
|
||||
###Begin build with Qt Creator:
|
||||
Open the Qt Project `fractorium/main.pro` using Qt Creator with the default config of *Desktop Qt [version] MSVC2013 64bit*
|
||||
Select *shadow build* in *Edit build configuration* for both *Debug* and *Release*
|
||||
|
||||
@ -71,11 +88,28 @@ Switch to *Release* configuration for all projects and build main.pro.
|
||||
|
||||
The outputs will be placed in `fractorium/Bin/release` several minutes later if no error occurs.
|
||||
|
||||
##Begin build with Visual Studio:
|
||||
###Begin build with Visual Studio:
|
||||
|
||||
####Visual Studio Qt Addon
|
||||
|
||||
Install the [Visual Studio Qt Addon](http://www.qt.io/download/).
|
||||
|
||||
Run Visual Studio and verify there is a menu item named Qt5. Click on it and click Qt Options.
|
||||
|
||||
Add a new Qt version to the list with the exact name of "Qt 5.5", and set its path to be one level higher than `$QTPATH`, which will be something like:
|
||||
|
||||
`C:\Qt\Qt5.5.1\5.5\msvc2013_64`
|
||||
|
||||
The name "Qt 5.5" 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.
|
||||
|
||||
Set the default version to the newly created Qt version and click Ok.
|
||||
|
||||
Open the file Fractorium.sln under Builds/MSVC/2013
|
||||
|
||||
Set the configuration to release, and build all.
|
||||
|
||||
###Outputs
|
||||
|
||||
The outputs will be the same as with Qt Creator and will be placed in:
|
||||
|
||||
`fractorium/Bin/x64/Release`
|
||||
@ -83,6 +117,7 @@ The outputs will be the same as with Qt Creator and will be placed in:
|
||||
Regardless of the IDE chosen, the output folder will have these contents:
|
||||
|
||||
```
|
||||
dark.qss
|
||||
Ember.dll
|
||||
Ember.exp
|
||||
Ember.lib
|
||||
@ -92,7 +127,10 @@ EmberCL.exp
|
||||
EmberCL.lib
|
||||
embergenome.exe
|
||||
emberrender.exe
|
||||
flam3-palettes.xml
|
||||
fractorium.exe
|
||||
libxml2.dll
|
||||
tbb.dll
|
||||
```
|
||||
|
||||
Double click fractorium.exe to run it, and use the command line to run the others.
|
||||
@ -104,10 +142,6 @@ 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\bin\Qt5Widgets.dll
|
||||
Qt5.5.1\5.5\msvc2013_64\plugins\platforms\qwindows.dll (put in folder "platforms")
|
||||
Deps\libxml2.dll
|
||||
Deps\tbb.dll
|
||||
fractorium\Data\dark.qss
|
||||
fractorium\Data\flam3-palettes.xml
|
||||
```
|
||||
|
||||
To run on a computer without Visual Studio 2013, these files also need to be in the folder:
|
||||
@ -118,31 +152,33 @@ 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)*
|
||||
or you can install [Visual C++ Redistributable Packages for Visual Studio 2013 (64 bit)](https://www.microsoft.com/en-us/download/details.aspx?id=40784)
|
||||
|
||||
##Final file structure for distribution
|
||||
|
||||
```
|
||||
[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)
|
||||
│
|
||||
├─ 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
|
||||
│
|
||||
├─qwindows.dll
|
||||
```
|
||||
|
||||
Loading…
Reference in New Issue
Block a user