Windows/fr

Ce guide documente la méthode de compilation de RawTherapee en versions 32 bits et 64 bits pour Windows en utilisant le runtime MinGW-w64. Commencez par installer et mettre à jour MSYS2 à l'aide des instructions sur le site Web MSYS2. Puis, exécuter les commandes suivantes en utilisant soit "MinGW-w64 Win32 Shell" pour compiler une version 32 bits ou "MinGW-w64 Win64 Shell" pour compiler une version 64 bits.

RawTherapee peut se compiler en utilisant les versions GTK+ 2 ou 3. Avec GTK2 utiliser la branche gtk2; avec GTK3 la branche dev. La dernière version de RawTherapee à supporter GTK2 est 5.0-r1-gtk2 publiée le 02-02-2017. Utiliser la branche dev pour le dernier code, il exige GTK+ >=3.16.

Installation des outils et des bibliothèques

Premièrement, installer quelques outils divers :

$ pacman -S tar gzip nano make diffutils intltool git

Puis installer les outils de développement nécessaires :

# win32
$ pacman -S mingw-w64-i686-gcc mingw-w64-i686-gdb mingw-w64-i686-make mingw-w64-i686-pkg-config mingw-w64-i686-cmake
# win64
$ pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-gdb mingw-w64-x86_64-make mingw-w64-x86_64-pkg-config mingw-w64-x86_64-cmake

et les bibliothèques requises :

# win32
$ pacman -S mingw-w64-i686-gtkmm mingw-w64-i686-gtkmm3 mingw-w64-i686-lcms2 mingw-w64-i686-fftw
# win64
$ pacman -S mingw-w64-x86_64-gtkmm mingw-w64-x86_64-gtkmm3 mingw-w64-x86_64-lcms2 mingw-w64-x86_64-fftw

Télécharger et compiler libiptcdata

La bibliothèque libiptcdata n'est plus fournie par MSYS2, cependant, elle est téléchargeable et configurable en utilisant :

$ curl -LO http://downloads.sourceforge.net/project/libiptcdata/libiptcdata/1.0.4/libiptcdata-1.0.4.tar.gz
$ tar xzf libiptcdata-1.0.4.tar.gz
$ cd libiptcdata-1.0.4

# win32
$ ./configure --prefix=/mingw32
# win64
$ ./configure --prefix=/mingw64

Ensuite Makefile doit être ouvert avec un éditeur de texte pour retirer iptc et docs des listes nommées docs et DIST_SUBDIRS, sinon, la compilation ou l'installation échouera.

$ nano Makefile

# Remplacer
DIST_SUBDIRS = m4 libiptcdata po iptc docs win python
# par
DIST_SUBDIRS = m4 libiptcdata po win python

# et remplacer
SUBDIRS = m4 libiptcdata po iptc docs win $(MAYBE_PYTHONLIB)
# par
SUBDIRS = m4 libiptcdata po win $(MAYBE_PYTHONLIB)

Enfin, compiler et installer la bibliothèque :

$ make
$ make install
$ cd

Télécharger et installer Clearlooks

Si vous compilez RawTherapee en utilisant GTK2, alors vous avez besoin du moteur de thème Clearlooks, Vous n'en n'avez pas besoin si vous utilisez GTK3.

Téléchargement et compilation :

$ curl -LO http://sources.archlinux.org/other/gtk-engines/gtk-engines-2.21.0.tar.gz
$ tar xzf gtk-engines-2.21.0.tar.gz
$ cd gtk-engines-2.21.0

# win32
$ ./configure --prefix=/mingw32 --disable-all --enable-clearlooks
# win64
$ ./configure --prefix=/mingw64 --disable-all --enable-clearlooks

$ make
$ make install
$ cd

Cloner et compiler RawTherapee

Cloner le dépôt Git de RawTherapee. Le processus de compilation va échouer s'il existe un espace dans le chemin de votre répertoire build. Par exemple si votre nom d'utilisateur sous Windows est "Zank Frappa" alors le nom du chemin sera C:\Users\Zank Frappa\ et si vous clonez RawTherapee dedans alors la compilation échouera. Clonez dans un répertoire dont ni lui-même ni ses répertoires parents n'ont d'espace dans leur nom, par exemple C:\code\repo-rt

$ git clone http://github.com/Beep6581/RawTherapee.git /c/code/repo-rt
$ cd /c/code/repo-rt

RawTherapee peut se compiler en utilisant les versions GTK+ 2 ou 3. Avec GTK2 utiliser la branche gtk2; avec GTK3 la branche dev. La dernière version de RawTherapee à supporter GTK2 est 5.0-r1-gtk2 publiée le 02-02-2017. Utiliser la branche dev pour le dernier code, il exige GTK+ >=3.16. Lors du clonage du dépôt, vous allez automatiquement vous retrouver dans la branche dev. Pour basculer manuellement dans la branche dev, faites ceci :

$ git checkout dev

Créer une répertoire séparé pour la compilation :

$ mkdir build
$ cd build

Notez que si vous changez de branche, alors vous devez effacer et re-créer le répertoire build afin que la compilation parte depuis le début dans un répertoire vide, sinon la compilation risque d'échouer. Cependant si vous faites une simple mise à jour sans changer de branche, alors vous n'avez pas besoin de démarrer dans un répertoire build vide, vous pouvez utiliser celui qui existe et la compilation sera plus rapide car tout n'a pas besoin d'être re-compilé.

Exécuter CMake et Make :

$ cmake -G "MSYS Makefiles" -DCMAKE_BUILD_TYPE="release" -DPROC_TARGET_NUMBER="2" -DCACHE_NAME_SUFFIX="5-dev" ..
$ make install

Référez vous à l'article Linux pour avoir une explication des diverses options passées à CMake et Make, y compris quel "BUILD_TYPE" utiliser.

Si vous réalisez une compilation pour Windows XP 32 bits et utilisez le "BUILD_TYPE" release ou relwithdebinfo, vous aurez besoin d'ajouter le drapeau de compilation -mstackrealign avant les deux derniers points .. de la commande CMake ci-dessus :

-DCMAKE_C_FLAGS="-mstackrealign" -DCMAKE_CXX_FLAGS="-mstackrealign"

Copier RawTherapee et les DLL requises

RawTherapee peut maintenant être démarré depuis la ligne de commande de MSYS2 :

# pour les compilations debug
$ cd debug
# pour les compilations release
$ cd release
# pour les compilations relwithdebinfo
$ cd relwithdebinfo
$ ./rawtherapee.exe

Le gestionnaire de fichiers peut être utilisé pour copier le contenu de c:\code\repo-rt\build\<debug|release|relwithdebinfo> avec les DLL nécessaires de <MSYS2>\<mingw32|mingw64>\bin dans un répertoire d'installation de RawTherapee, où <MSYS2> est le répertoire d'installation de MSYS2.

Voici une liste (peut-être incomplète) des DLL requises :

libatk-1.0-0.dll
libatkmm-1.6-1.dll
libsz-1.dll
libcairo-2.dll
libcairo-gobject-2.dll
libcairomm-1.0-1.dll
libcroco-0.6-3.dll
libepoxy-0.dll
libexpat-1.dll
libffi-6.dll
libfftw3f-3.dll
libfontconfig-1.dll
libfreetype-6.dll
libgcc_s_seh-1.dll
libgdk_pixbuf-2.0-0.dll
libgdk-3-0.dll
libgdkmm-3.0-1.dll
libgio-2.0-0.dll
libgiomm-2.4-1.dll
libglib-2.0-0.dll
libglibmm-2.4-1.dll
libgmodule-2.0-0.dll
libgobject-2.0-0.dll
libgomp-1.dll
libgraphite2.dll
libgtk-3-0.dll
libgtkmm-3.0-1.dll
libharfbuzz-0.dll
libiconv-2.dll
libintl-8.dll
libjpeg-8.dll
liblcms2-2.dll
liblzma-5.dll
libpango-1.0-0.dll
libpangocairo-1.0-0.dll
libpangoft2-1.0-0.dll
libpangomm-1.4-1.dll
libpangowin32-1.0-0.dll
libpcre-1.dll
libpixman-1-0.dll
libpng16-16.dll
librsvg-2-2.dll
libsigc-2.0-0.dll
libstdc++-6.dll
libtiff-5.dll
libwinpthread-1.dll
libxml2-2.dll
zlib1.dll

Les fichiers suivants doivent aussi être copiés :

<prefix>\bin\gspawn-<win32|win64>-helper.exe -> .
<prefix>\bin\gspawn-<win32|win64>-helper-console.exe -> .

<prefix>\lib\gtk-2.0\include -> .
<prefix>\lib\gtk-2.0\modules -> .
<prefix>\lib\gtk-2.0\2.10.0\engines -> .

<prefix>\lib\gdk-pixbuf-2.0 -> .\lib\gdk-pixbuf-2.0

<prefix>\share\glib-2.0\schemas\gschemas.compiled -> .\share\glib-2.0\schemas

où <prefix> est <MSYS2>\<mingw32|mingw64> de ci-dessus et . est le répertoire d'installation.

Création d'un paquetage distribuable

Si vous avez l'intention de distribuer des paquetages de RawTherapee pour la plateforme Windows, vous devez tout d'abord vous assurer que RawTherapee sera compilé avec pour cible le processeur "générique". Pour cela, indiquer -DPROC_TARGET_NUMBER="1" dans la commande CMake.

Pendant la compilation, un script nommé WindowsInnoSetup.iss est créé dans le répertoire d'installation de RawTherapee. Ce script est utilisé par Inno Setup [1], un programme qui est utilisé pour générer des installateurs pour les programmes Windows. Il est conseillé de télécharger la version Unicode [2] pour éviter les problèmes avec certaines langues. L'actuel script WindowsInnoSetup.iss est conçu pour la branche gtk2. Si vous désirez créer un paquetage pour une compilation GTK3 (brannche dev ou releases), vous aurez besoin d'éditer le script et de remplacer la ligne :

Source: "{#MyBuildBasePath}\lib\*"; DestDir: "{app}\lib\"; Flags: ignoreversion recursesubdirs createallsubdirs

par

Source: "{#MyBuildBasePath}\share\*"; DestDir: "{app}\share\"; Flags: ignoreversion recursesubdirs createallsubdirs

ainsi les icônes et les schémas seront copiés dans le paquetage.

Pour aider les utilisateurs à écrire de bons rapports de bogues, les mainteneurs de paquetages sont encouragés à produire des compilations qui contiennent à la fois un exécutable "release" et un "debug", et de les rassembler avec l'exécutable GDB debugger. En d'autres termes,

avec l'exécutable du debugger gdb. Les binaires Windows du debugger (gdb.exe) peuvent être téléchargés depuis ici dans les versions 32 et 64 bits. Le binaire gdb.exe doit être copié dans le répertoire d'installation de Rawtherapee et, en cas d'utilisation de Inno Setup pour générer le paquetage, le script WindowsInnoSetup.iss doit être édité en ajoutant la ligne suivante auprès de la ligne 121 du script :

Source: "{#MyBuildBasePath}\gdb.exe"; DestDir: "{app}"; Flags: ignoreversion

Notez que GDB est un programme publié sous la licence GNU GPL, son code source se trouve à http://www.gnu.org/software/gdb/.

Maintenant que tout est configuré, pour créer le paquetage, cliquer droit sur le script WindowsInnoSetup.iss et choisir Compile dans le menu contextuel. Il générera automatiquement l'installateur et le placera dans le répertoire parent. Pour rendre votre nouveau paquetage compatible avec l'"uploader" du Site Web officiel de Rawtherapee, créez une archive zip dans laquelle vous placez ensemble l'installer nouvellement créé et les AboutThisBuild.txt correspondants qui doivent se trouver à la même place. Nommer l'archive zip résultante selon cet exemple : RawTherapee_<WinXP|WinVista>_<32|64>_branch_buildtype_version.zip (par exemple, Rawtherapee_WinVista_64_gtk3_Release_4.2.730.zip).