Linux/fr
Cette page détaille les instructions pour compiler RawTherapee dans les systèmes GNU/Linux. Vous trouverez aussi des instructions pour la compilation dans Windows et MacOS.
En cas de doute, Joigniez nous sur IRC ou sur le Forum et demandez à un humain !
Dépendances
Pour compiler RawTherapee votre système nécessite un jeu d'outils et des bibliothèques venues d'autres programmes. Ils sont appelés dépendances, en voici la liste pour la dernière version de RawTherapee.
Package | Version | URL |
---|---|---|
CMake | cmake>=3.5 | https://cmake.org/ |
EXIV2 | exiv2>=0.19 | http://www.exiv2.org/ |
EXPAT | expat>=2.1.0 | https://libexpat.github.io/ |
FFTW3 | fftw>=3.2.2 | http://fftw.org/ |
GCC | gcc>=4.9 | https://gcc.gnu.org/ |
GLIB2 | glib-2.0>=2.24 | https://www.gtk.org/ |
GLIBMM | glibmm-2.4>=2.24 | https://www.gtkmm.org/ |
GTK+ | gtk+-3.16 < 3.24.0 | https://www.gtk.org/ |
GTKMM | gtkmm-3.16 | https://www.gtkmm.org/ |
JPEG | libjpeg>=6b | https://libjpeg-turbo.org/ https://jpegclub.org/ https://www.ijg.org/ |
LCMS2 | lcms>=2.6 | http://www.littlecms.com/ |
LENSFUN | lensfun>=0.2 | http://lensfun.sourceforge.net/ |
LIBCANBERRA | libcanberra>=0.29 | http://0pointer.de/lennart/projects/libcanberra/ (Linux only) |
LIBIPTCDATA | libiptcdata>=1.0.2 | http://libiptcdata.sourceforge.net |
PNG | libpng>=1.2.44 | http://www.libpng.org/ |
librsvg | librsvg>=2.40 | https://github.com/GNOME/librsvg |
SIGC | sigc++-2.0 | https://github.com/libsigcplusplus/libsigcplusplus |
TIFF | libtiff>=4.0.4 | http://libtiff.org/ |
ZLIB | zlib>=1.2.3 | http://www.zlib.net/ |
Pour installer toutes ces dépendances, vous devez ouvrir une console et y coller le code de la section appropriée. Les fragments de code ci-dessous listent les dépendances pour la dernière version de RawTherapee qui exige GTK3. Nous avons laissé tombé le support de GTK2 depuis l'édition "5.0-r1-gtk2" de février 2017. Si vous utilisez une distribution moderne, simplement copier et coller les fragments de code tels qu'ils sont. Si vous êtes sur une vieille distribution sans le support de GTK3, alors reportez vous sur l'article archivé GTK2, puis choisissez et compilez la balise obsolète 5.0-r1-gtk2
.
Arch/Manjaro
Les versions actuelles de Arch et de Manjaro fonctionnent correctement "au sortir de la boite". Reportez vous à l'article GTK2 si vous compilez sur une version antérieure à 17.1.2.
sudo pacman -S --needed bzip2 cmake exiv2 expat fftw glib2 glibmm gtk3 gtkmm3 lcms2 lensfun libcanberra libiptcdata libjpeg-turbo libpng librsvg libsigc++ libtiff zlib
Procéder à la compilation.
CentOS
CentOS 7 possède des paquetages très dépassés et nécessite des étapes supplémentaires pour installer des versions récentes de GCC, git, lensfun et libtiff. Les étapes ci-dessous ont été vérifiées et fonctionnent dans CentOS 7.4.1708, mais vous les utiliserez à votre propre risque.
GCC >=4.9.3:
sudo yum update sudo yum install cmake git sudo yum install centos-release-scl sudo yum install devtoolset-7-gcc* scl enable devtoolset-7 bash source /opt/rh/devtoolset-7/enable
git >=2.7:
sudo yum install http://opensource.wandisco.com/centos/7/git/x86_64/wandisco-git-release-7-2.noarch.rpm
lensfun:
wget http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm sudo rpm -ivh epel-release-latest-7.noarch.rpm
libtiff >=4.0.4:
sudo yum install ninja-build mkdir ~/programs && cd ~/programs wget http://download.osgeo.org/libtiff/tiff-4.0.9.tar.gz tar zxvf tiff-4.0.9.tar.gz mkdir tiff-4.0.9/libtiff-build && cd tiff-4.0.9/libtiff-build cmake -DCMAKE_INSTALL_DOCDIR=/usr/share/doc/libtiff-4.0.9 -DCMAKE_INSTALL_PREFIX=/usr -G Ninja .. ninja-build sudo ninja-build install
Installation des autres dépendances :
sudo yum install curl expat-devel fftw-devel gtk3-devel gtkmm30-devel lcms2-devel lensfun-devel libcanberra-devel libiptcdata-devel libjpeg-turbo-devel libpng-devel librsvg2-devel zlib-devel
Lien symbolique vers libatomic :
sudo ln -s /usr/lib64/libatomic.so.1 /usr/lib64/libatomic.so
Pour procéder à la prochaine étape, la compilation, vous aurez besoin d'éditer le script build-rawtherapee
et ajoutez ces trois lignes dans la section CMake près de la fin du fichier, par exemple après la ligne "-DWITH_BENCHMARK" et avant la ligne "$HOME" :
-DTIFF_INCLUDE_DIR="$HOME/programs/tiff-4.0.9/libtiff" \ -DTIFF_LIBRARY="$HOME/programs/tiff-4.0.9/libtiff-build/libtiff/libtiff.so" -DCMAKE_CXX_FLAGS="-Wno-deprecated -Wno-parentheses" \
Procéder à la compilation.
Debian/Ubuntu/Mint/elementary OS
Les versions actuelles de ces distributions fonctionnent correctement "au sortir de la boite". Reportez vous à l'article GTK2 si vous compilez sur une version d'Ubuntu antérieure à 16.04.
Ubuntu >=16.10, Mint >=18.3, elementary OS >=0.4.1
sudo apt update sudo apt install build-essential cmake curl git libcanberra-gtk3-dev libexiv2-dev libexpat-dev libfftw3-dev libglibmm-2.4-dev libgtk-3-dev libgtkmm-3.0-dev libiptcdata0-dev libjpeg-dev liblcms2-dev libpng-dev librsvg2-dev libsigc++-2.0-dev libtiff5-dev zlib1g-dev
Procéder à la compilation.
Ubuntu 16.04 LTS
sudo apt-get update sudo apt-get install build-essential cmake curl git libbz2-dev libcanberra-gtk3-dev libexiv2-dev libexpat-dev libfftw3-dev libglibmm-2.4-dev libgtk-3-dev libgtkmm-3.0-dev libiptcdata0-dev libjpeg8-dev liblcms2-dev liblensfun-dev libpng12-dev librsvg2-dev libsigc++-2.0-dev libtiff5-dev zlib1g-dev
Procéder à la compilation.
Fedora
Les versions actuelles de Fedora fonctionnent correctement "au sortir de la boite". Reportez vous à l'article GTK2 si vous compilez sur une version antérieure à 22.
sudo dnf install cmake curl expat-devel fftw-devel gcc-c++ git gtk3-devel gtkmm30-devel lcms2-devel lensfun-devel libatomic libcanberra-devel libiptcdata-devel libjpeg-turbo-devel libpng-devel librsvg2-devel libtiff-devel zlib-devel
Procéder à la compilation.
Gentoo/Sabayon
Les utilisateurs de Sabayon doivent pouvoir utiliser les mêmes dépendances que pour Gentoo, mais à la place de sudo emerge -uva
, prendre sudo equo install sys-devel/gcc dev-vcs/git
.
sudo emerge -uva dev-cpp/gtkmm:3.0 dev-libs/expat dev-util/cmake media-gfx/exiv2 media-libs/lcms media-libs/lensfun media-libs/libcanberra media-libs/libiptcdata media-libs/libjpeg-turbo media-libs/libpng gnome-base/librsvg media-libs/tiff net-misc/curl sci-libs/fftw sys-libs/zlib x11-libs/gtk+:3
Procéder à la compilation.
openSUSE
Les versions d'openSUSE supérieures à Leaf 15.0 et Tumbleweed devraient fonctionner sans aucune réserve. Des problèmes sérieux de compilation sont probables avec les versions antérieures. Reportez vous à l'article GTK2 si vous compilez sur une version antérieure à 42.1.
sudo zypper cmake gcc gcc-c++ gtk3-devel gtkmm3-devel liblcms2-devel fftw3-devel libitpcdata-devel librsvg-devel libtiff-devel libjpeg-devel libcanberra-gtk3-devel
Ensuite, lensfun
doit être installé manuellement:
wget https://sourceforge.net/projects/lensfun/files/0.3.2/lensfun-0.3.2.tar.gz tar xvf lensfun-0.3.2.tar.gz cd lensfun-0.3.2.tar.gz mkdir build cd build cmake ../ make sudo make install
Procéder à la compilation.
Compilation
Il existe deux écoles pour compiler RawTherapee : soit utiliser le script Bash automatique qui compile RawTherapee à votre place (recommandé), ou faites le manuellement.
La méthode automatique
Voici la façon recommandée pour compiler RawTherapee car elle est rapide, simple et sûre. Elle s'appuie sur un script Bash qui télécharge le dernier code source de RawTherapee et le compile de façon optimisée pour votre processeur. Les compilations sont prêtes à l'usage. Le script ne vérifie pas la disponibilité des dépendances, lisez donc bien le chapitre Dépendances avant de lancer le script. Les compilations sont autonomes, c'est à dire que vous pouvez faire cohabiter plusieurs versions de RawTherapee en même temps, simplement en renommant les dossiers de compilation afin que la création d'une nouvelle compilation n'écrase pas la précédente, ce qui est le cas par défaut.
Lancer le script sous un compte utilisateur, pas sous root !
Ouvrir un terminal, aller chercher le script, le rendre exécutable et le lancer :
cd ~ wget https://raw.githubusercontent.com/Beep6581/RawTherapee/dev/tools/build-rawtherapee -O build-rawtherapee chmod +x build-rawtherapee ./build-rawtherapee
Si tout va bien, le script se terminera par le message "Pour lancer RawTherapee entrer : ..."
Pour mettre RawTherapee à jour si vous l'avez précédemment compilé avec ce script, simplement exécuter à nouveau le script, c'est tout.
Le script build-rawtherapee
est inclus dans le code source de RawTherapee. Puisque l'exécution du script met le code source à jour, après votre première compilation vous pouvez effacer le script téléchargé manuellement ci-dessus avec wget, et utiliser à la place ~/programs/code-rawtherapee/tools/build-rawtherapee
qui se maintiendra toujours à jour.
Le script compile la branche courante, qui est par défaut dev
où est réalisé la plupart du développement. Pour compiler une branche différente, la récupérer en utilisant les commandes git usuelles avant d'exécuter le script. Pour en savoir plus au sujet des branches de RawTherapee lire ci-dessous le paragraphe Choisir une branche.
Pour plus d'informations, voir ./build-rawtherapee --help
.
Vous avez terminé, RawTherapee est prêt à l'utilisation. Vous pouvez passer le chapitre "La méthode manuelle"
La méthode manuelle
La façon recommandée pour compiler RawTherapee est d'utiliser le script automatique, voir la méthode automatique. Pour apprendre à compiler manuellement, continuez la lecture.
Afin de préserver le bon ordre dans votre répertoire "home" pendant la compilation manuelle de multiples programmes (par ex. en n'utilisant pas le gestionnaire de paquetages de votre distribution) et pour que ce tutoriel de compilation manuelle reste compatible avec le script de compilation automatique, veuillez créer le dossier ~/programs/
qui va contenir dans le dossier ~/programs/code-rawtherapee
, tous les codes sources relatifs à RawTherapee, et dans le dossier ~/programs/rawtherapee
, la compilation. Vous pouvez utiliser la même disposition pour compiler d'autres programmes.
Cloner la source
Premièrement, il faut cloner le dépôt du code source de RawTherapee. Ouvrir une console et exécuter ces commandes :
mkdir -p ~/programs git clone https://github.com/Beep6581/RawTherapee ~/programs/code-rawtherapee cd ~/programs/code-rawtherapee
Choisir une branche
- Les fonctionnalités sont développées sur leur propre branche de fonctionnalité
- Les développements sont effectués dans la branche
dev
. Les branches de fonctionnalité sont fusionnées avec la branchedev
quand elle sont prêtes. La branchedev
est instable. - Les publications sont issues de la branche
releases
.
Essayez la dernière publication si vous souhaitez la version la plus stable. Pour voir toutes les branches disponibles, tapez :
git tag
Choisir la branche dev
ou une autre branche de fonctionnalité si désirez tester le code dernier cri. Pour voir toutes les branches disponibles tapez :
git branch -a
Le "choix" se fait via la commande "git checkout". Pour choisir une publication ou une branche, tapez
git checkout <publication ou branche>
RawTherapee utilise GTK+ pour l'interface utilisateur et exige la version 3.16 ou supérieure. Si votre système ne supporte pas cette version 3.16 ou plus récente, vous devez utiliser la publication 5.0-r1-gtk2
. Notre support de GTK2 a officiellement cessé le 02 février 2017. Reportez vous à l'article archivé GTK2 et mettez votre système à jour.
La compilation d'anciennes versions de RawTherapee échouera sur un système moderne, car les vieilles dépendances seront manquantes.
Compiler RawTherapee
Vous allez maintenant réaliser une compilation de RawTherapee, elle sera construite dans le dossier ~/programs/code-rawtherapee/build/release
, et ensuite vous déplacerez ce dossier dans ~/programs/rawtherapee
CMake
Vous devez avoir connaissance de quelques paramètres de compilation, vous passerez ceux-ci à CMake en utilisant l'option -D
, comme décrit ci-dessous :
- CMAKE_BUILD_TYPE
- Un des suivants :
release
(par defaut),relwithdebinfo
oudebug
. - Cela détermine si la compilation doit favoriser la rapidité d’exécution ou la quantité des commentaires en sortie de déboguage.
- Les compilations "relwithdebinfo" et "debug" vous fournira une trace d'appels bien utile si RawTherapee se plante pendant l'exécution de GDB et vous pourrez nous la soumettre afin que nous puissions résoudre le problème. La compilation "debug" est la plus lente mais génère les informations les plus détaillées. La compilation "relwithdebinfo" est presque aussi rapide qu'une compilation "release" et génère le plus souvent suffisamment d'informations bien que pas aussi détaillées qu'avec la compilation "debug". La compilation "release" ne fournira aucune information mais contient de nombreuses optimisations de la vitesse ce qui en fait un programme qui fonctionne beaucoup plus vite que la version "debug". Pour une utilisation usuelle choisissez une compilation "release" ou "relwithdebinfo". Si vous tombez sur un bug reproductible, alors refaites la compilation avec "debug" et envoyez nous la trace d'appels (ou réparez vous même et envoyez nous le patch !). Nous préférons les traces d'appels des compilations debug plutôt que celles des compilations relwithdebinfo
- Pour réaliser une compilation de type "release", écrire
-DCMAKE_BUILD_TYPE="release"
- Pour réaliser une compilation de type "release", écrire
- USE_OLD_CXX_ABI
ON
orOFF
(par défaut).- Lors de la compilation d'un programme, on doit utiliser les mêmes conventions que celles utilisées par les bibliothèques appelées par ledit programme, sinon, la compilation (création des liens) échouera. En général, on n'a pas besoin de s'en préoccuper, mais nous sommes actuellement à une époque de remplacement progressif de GCC4 par GCC5, chacun utilisant par défaut une convention incompatible avec l'autre, ce qui est la cause du problème. Si les bibliothèques sur votre système ont été compilées avec GC5, elles utilisent probablement un standard appelé C++11. Cela signifie que votre compilation de RawTherapee doit utiliser le même standard, ce qui est le cas par défaut. Cependant, si malgré l'utilisation de GCC5 vos bibliothèques étaient compilées avec l'ancien standard C++03, alors RawTherapee doit être paramétré pour utiliser le même, et pour cela vous devez configurer "USE_OLD_CXX_ABI" sur "ON":
- Pour valider USE_OLD_CXX_ABI, écrire :
-DUSE_OLD_CXX_ABI="ON"
- Pour valider USE_OLD_CXX_ABI, écrire :
- CACHE_NAME_SUFFIX
- Les options CACHE_NAME_SUFFIX définissent le suffixe des noms du répertoire de configuration et du cache qui seront utilisés par la compilation de RawTherapee. : Voir l'article Où sont les fichiers ? pour une explication de ce que sont ces répertoires.
- Pour les versions stables (si vous choisissez la branche "releases") mettre
-DCACHE_NAME_SUFFIX=""
- Pour les compilations de développement (si vous choisissez la branche "dev" ou toute autre branche que "releases") mettre
-DCACHE_NAME_SUFFIX="5-dev"
- PROC_TARGET_NUMBER
- Entre
0
(par défaut) et9
. - L'option PROC_TARGET_NUMBER définit pour quel type de CPU doit se faire l’optimisation.
- Si vous compilez pour vous-même, mettre "2". Cela signifie "natif", donc l'optimisation sera automatiquement pour le CPU détecte et RawTherapee sera aussi rapide que possible sur votre CPU. Il se peut qu'il ne fonctionne pas du tout sur d'autres architectures.
- Si vous compilez pour distribuer (à d'autres personnes), mettre "1". Cela signifie "générique", ainsi seules les optimisations supportées par le plus grand nombre de CPU seront utilisées, la compilation peut donc être téléchargée et utilisée par tout le monde, mais n'aura pas les meilleures optimisations possibles.
- Pour plus d'informations, voir le fichier "ProcessorTargets.cmake" dans le dossier cloné.
- Pour que la compilation utilise l'optimisation "native", écrire :
-DPROC_TARGET_NUMBER="2"
- Pour que la compilation utilise l'optimisation "native", écrire :
- BUILD_BUNDLE
ON
ouOFF
- Il est forcé sur "ON "pour Windows et macOS. Optionnel pour Linux où c'est "OFF" par défaut.
- Si réglé sur "ON", le programme sera compilé dans un répertoire (
DATADIR
), sinon il sera installé selonCMAKE_INSTALL_PREFIX
qui vaut typiquement pour tout le système.
- BUNDLE_BASE_INSTALL_DIR
- Utiliser un chemin absolu.
- Le programme sera compilé dans ce répertoire.
- Par exemple, choisir :
-DBUNDLE_BASE_INSTALL_DIR="$HOME/programs/rawtherapee"
- S'il n'est pas défini,
${CMAKE_BINARY_DIR}/${CMAKE_BUILD_TYPE}
sera utilisé par défaut
- LENSFUNDBDIR
- Non défini par défaut
- L'option
LENSFUNDBDIR
permet de situer la base de données lensfun dans le répertoire spécifié. Elle peut être non définie, absolue ou relative. - Si non définie, alors Lensfun utilise sa propre logique pour trouver la base de donnée. C'est l'option recommandée si Lensfun est déjà installée pour tout le système et que vous souhaitez l'utiliser.
- Vous pouvez choisir un chemin relatif ou absolu pour utiliser une base de données lensfun personnalisée.
- Si vous compilez un lot, le chemin est relatif au répertoire racine du lot, sinon il est relatif au
DATADIR
, c'est-à-dire${CMAKE_INSTALL_PREFIX}/share/rawtherapee
- OPTION_OMP
ON
(par défaut) ouOFF
.- Si validé, compile avec le support de OpenMP, ce qui valide le multithreading et rend RawTherapee plus rapide.
- WITH_LTO
ON
ouOFF
(par défaut).- Si validé, compile avec les optimisations de link-time, ce qui peut rendre RawTherapee un peu plus rapide.
- WITH_PROF
ON
ouOFF
(par défaut).- Pour des fins de débogage. Génère du code supplémentaire pour écrire des informations de profil adaptées au programme d'analyse gprof.
- WITH_SAN
OFF
(défaut) ou l'une des diverses autres options.- Pour des fins de débogage. Permet d'activer divers débogueurs.
- Voir le chapitre Program Instrumentation Options du manuel de GCC davantage d'informations.
- WITH_SYSTEM_KLT
ON
ouOFF
(par défaut).- Si sur ON, compiler en utilisant la bibliothèque du systeme KLT, sinon, utilise le bouquet de fichiers KLT avec RawTherapee.
- Le détecteur de traits Kanade–Lucas–Tomasi (KLT) feature tracker est utilisé par l'outil de Correction automatique de la distortion.
- WITH_BENCHMARK
ON
ouOFF
(par défaut).- Compilation avec les fonctions de synchronisation en service pour mesurer les performances.
Make
Trouvez combien de threads sont supportés par votre CPU. Cela rendra la compilation plus rapide mais n'aura aucun effet sur la vitesse d’exécution de RawTherapee. Pour trouver combien de threads sont supportés par votre CPU, exécutez dans un terminal :
nproc --all
Il retournera un nombre. Utilisez le pour le paramètre --jobs
ci-dessous.
Compile:
cd ~/programs/code-rawtherapee mkdir build cd build cmake \ -DCMAKE_BUILD_TYPE="release" \ -DCACHE_NAME_SUFFIX="5-dev" \ -DPROC_TARGET_NUMBER="2" \ -DBUILD_BUNDLE="ON" \ -DBUNDLE_BASE_INSTALL_DIR="$HOME/programs/rawtherapee" \ -DOPTION_OMP="ON" \ -DWITH_LTO="OFF" \ -DWITH_PROF="OFF" \ -DWITH_SAN="OFF" \ -DWITH_SYSTEM_KLT="OFF" \ .. make --jobs=4 make install
Exécuter RawTherapee
Pour lancer RawTherapee :
~/programs/rawtherapee/rawtherapee
Ou pour lancer la version en ligne de commande :
~/programs/rawtherapee/rawtherapee-cli
Le dépot du code source est dans ~/programs/code-rawtherapee
et le programme compilé est dans ~/programs/rawtherapee
Vous pouvez effacer en toute sécurité ~/programs/code-rawtherapee
si vous le désirez. Le programme compilé continuera de fonctionner, mais vous aurez à refaire toutes les étapes ci-dessus pour réaliser une mise à jour. Il vaut mieux laisser le dépôt intact et vous pourrez ainsi réaliser l'étape suivante dans une semaine ou un mois, lorsque vous désirerez mettre à jour.
Mettre à jour RawTherapee
Chaque fois que vous désirez mettre RawTherapee à jour vers le dernier code disponible, simplement faire ce qui suit :
cd ~/programs/code-rawtherapee git pull
Puis répéter l'étape Make ci-dessus.
Pour la mise à jour, vous pouvez récupérer le dossier build
de la fois précédente pour éviter d'avoir à recompiler des choses qui n'ont pas changé et rendre le processus plus rapide. CMake devrait détecter automatiquement les changements. Cependant, il y a des situations où la compilation échoue si l'on ré-utilise le dossier build
, typiquement cela se produit si l'on passe d'une branche vers une autre très différente. Si cela arrive, simplement effacer le dossier build
puis procéder selon les étapes de la section "Make".