fractorium/Data/BuildGuideLinux.md
Person 1dfbd4eff2 --User changes
-Add new preset dimensions to the right click menu of the width and height fields in the editor.
-Change QSS stylesheets to properly handle tabs.
-Make tabs rectangular by default. For some reason, they had always been triangular.

--Bug fixes
 -Incremental rendering times in the editor were wrong.

--Code changes
 -Migrate to Qt6. There is probably more work to be done here.
-Migrate to VS2022.
-Migrate to Wix 4 installer.
-Change installer to install to program files for all users.
-Fix many VS2022 code analysis warnings.
-No longer use byte typedef, because std::byte is now a type. Revert all back to unsigned char.
-Upgrade OpenCL headers to version 3.0 and keep locally now rather than trying to look for system files.
-No longer link to Nvidia or AMD specific OpenCL libraries. Use the generic installer located at OCL_ROOT too.
-Add the ability to change OpenCL grid dimensions. This was attempted for investigating possible performance improvments, but made no difference.

This has not been verified on Linux or Mac yet.
2023-04-25 17:59:54 -06:00

2.0 KiB

Build Guide for Linux

The following has been tested on Ubuntu 17.10 (artful).

Make sure the package lists are up-to-date:

sudo apt-get update
sudo apt-get upgrade

Install git and clone the repository:

sudo apt-get install git
git clone --depth=1 https://mfeemster@bitbucket.org/mfeemster/fractorium.git

Install the dependencies.

sudo apt-get install g++ libc6-dev libgl1-mesa-dev libgl-dev libglm-dev libjpeg-dev libpng-dev libqt5opengl5-dev libtbb-dev libxml2-dev ocl-icd-libopencl1 ocl-icd-opencl-dev opencl-headers qt5-default qt5-qmake qtbase5-dev libopenexr22 libopenexr-dev

Install the OpenCL drivers and opencl support for your hardware.

For AMD get their drivers from their site, build and install the .deb package.

For Nvidia:

sudo apt-get install nvidia-modprobe nvidia-prime nvidia-384 nvidia-384-dev 

Optionally you can install the Nvidia-specific nvidia-libopencl1-384 package, but keep in mind that this will remove the generic ones (ocl-icd-opencl-dev and ocl-icd-libopencl1).

If you have both Qt 4 and 5 installed, select Qt 5 before compilation:

export QT_SELECT=qt5

Compile the binaries, they will be created in the Bin/release folder.

cd fractorium
qmake main.pro -r -spec linux-g++-64 CONFIG+="release native"
make

Or open main.pro in Qt Creator and build all.

sudo make install will install the files directly. sudo make uninstall is also available.

You can also compile a .deb package to install locally. A few more tools will be necessary:

sudo apt-get install bzr bzr-builddeb dh-make debhelper

Tell bzr about yourself:

bzr whoami "The Person <the.person@email.com>"

A helper script is available, use package-linux.sh in the project root. It will create ~/PPA/fractorium-VERSION as a work folder, by default it builds a signed source package.

For local use you probably want an unsigned binary package:

cd fractorium
./package-linux.sh --binary-only --unsigned