Synfig Studio :: Documentation - User contributions [en]

User:Milleja46

2011-01-26T15:57:37Z

Milleja46: Created page with 'Synfig wiki editor and hopeful soon developer. Some knowledge in c++, and working to develop it a bit with this software.'

Synfig wiki editor and hopeful soon developer. Some knowledge in c++, and working to develop it a bit with this software.

Dev talk:Mingw installation

2011-01-26T15:56:37Z

Milleja46: /* GTK and git stuff */

Without cairomm installed from the gtkmm package, I saw this error:

$ pkg-config --cflags gtkmm-2.4
Package cairomm-1.0 was not found in the pkg-config search path.
Perhaps you should add the directory containing `cairomm-1.0.pc'
to the PKG_CONFIG_PATH environment variable
Package 'cairomm-1.0', required by 'gdkmm', not found

so I added cairomm to the list of elements from gtkmm which are needed.
== GTK and git stuff ==
Ok gtk should be downloaded from the direct gtk.org website not the work around pages listed. Git can be accessed and gotten with tortoise and it's required components for the git version to work. Other than that i've almost got it updated.
--[[User:Milleja46|Milleja46]] 15:56, 26 January 2011 (UTC)

Dev talk:Mingw installation

2011-01-26T15:56:14Z

Milleja46:

Dev:Mingw installation

2011-01-25T12:10:41Z

Milleja46: /* GTK+ */

Dev:Mingw installation

2011-01-25T02:12:10Z

Milleja46:

Dev:Mingw installation

2011-01-25T02:08:01Z

Milleja46:

Dev:Mingw installation

2011-01-25T02:04:37Z

Milleja46:

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page! As the information is checked to be fully functional we will post it to this page. As that is verified the old information shown here will be deleted since you are not what so ever to get it working using the below information since the developers of mingw have discontinued and removed that version and setup of that way completely. For now refer to this page: http://www.mingw.org/wiki/Getting_Started
First - download [http://www.mingw.org/ MinGW] installer. You may get version mingw-get-inst-20101030.exe or higher but with the current setup of mingw this is best way to install it.

* [http://sourceforge.net/projects/mingw/files/Automated%20MinGW%20Installer/mingw-get-inst/mingw-get-inst-20101030/mingw-get-inst-20101030.exe/download Download mingw get-inst]

Run mingw-get-inst-20101030.exe(or what version you get). When the installer asks which packages to install, select:

* MinGW base tools
* g++ Compiler
* g77 Compiler
* MinGW Make
* MSYS(both you will still have to go back and install later but this will be explained when the time comes)

Note: you really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

===MSYS===
This is installed when you install mingw if you selected, if you feel so nesscary to install it open a mingw shell and run <code>mingw-get install msys-base</code> but this command might just be uncesscary

===cygpath emulation(yet to fully check on this component)===
As far as I read, Cygwin only supports paths like /C/somedir/somefile. MinGW can use native windows paths also. Cygwin has a special tool for this (and some another features). MinGW has not. But several Synfig configure scripts require this tool so it will be better to make it. Just save the following text as <code>C:\msys\1.0\bin\cygpath</code>:

<pre>#!/bin/sh
# A simple cygpath replacement

until [ -z "$1" ]
do
if [ "${1:0:1}" != "-" ]; then
echo $1 | sed -e 's/\\/\//g' -e 's/^$[a-zA-Z]$:/\/\1/g'
fi
shift
done</pre>

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
===[http://subversion.tigris.org Subversion]===

Source code is now in GIT

Synfig source is stored in a subversion repository. You will need the svn client to get it. Also the svn client is required by the Synfig build scripts, to receive the revision number of the source.
You can download the Windows subversion package from this page:

* http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91

When I wrote this the latest version was 1.4.3:

* http://subversion.tigris.org/files/documents/15/36797/svn-1.4.3-setup.exe (3.58 Mb)

But it is best to get the newest available version.

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.
When I wrote this the latest version was 2.27:

* http://downloads.sourceforge.net/nsis/nsis-2.42-setup.exe (1.4 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

==MinGW(Old and unusable will be replaced as the new information is tested and added to the page)==
First - download [http://www.mingw.org/ MinGW] installer. You may get version 5.1.3 or higher (recommended).

* https://sourceforge.net/projects/mingw/files/Automated%20MinGW%20Installer/MinGW-5.1.4.exe/download

Run MinGW-5.1.4.exe. Select "Download and install". Choose "Candidate" package, because "Current" is too old. When the installer asks which packages to install, select:

* MinGW base tools
* g++ Compiler
* g77 Compiler
* MinGW Make

Note: you really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

(instructions updated from version 5.1.3 to 5.1.4, but untested. please update the wiki if anything is broken with 5.1.4)

===MSYS===
Now download and install MSYS - a shell and tools kit.

* http://downloads.sourceforge.net/mingw/MSYS-1.0.10.exe (2.7 Mb)

Run MSYS-1.0.10.exe, confirm default installation path <code>C:\msys\1.0</code>. Wait until installation completes. Then the installer opens a console and asks some questions.

:<code>'''This is a post install process that will try to normalize between'''<br />'''your MinGW install if any as well as your previous MSYS installs'''<br />'''if any. I don't have any traps as aborts will not hurt anything.'''<br />'''Do you wish to continue with the post install? [yn ]'''</code>

Answer "<code>'''y'''</code>" here.

:<code>'''Do you have MinGW installed? [yn ]'''</code>

Answer "<code>'''y'''</code>" here.

:<code>'''Please answer following the in the form of c:/foo/bar.'''<br />'''Where is your MinGW installation?'''<br /></code>

Answer "<code>'''c:/mingw'''</code>".

The installer script prints some text and finally writes:

:<code>'''Oh joy, you do not have c:/mingw/bin/make.exe. Keep it that way.'''</code>

It's OK. The first phase of installation is completed. Press any key.

===MSYS Developer Toolkit===
Download MSYS Developer Toolkit, which contain such required tools as [http://www.gnu.org/software/autoconf/ autoconf], [http://www.gnu.org/software/automake/ automake], [http://www.gnu.org/software/libtool/ libtool], [http://www.cpan.org/ perl], pkg-tools, etc. Unfortunately, many tools included in MSYS DTK is too old and we need update it manually later.

* http://downloads.sourceforge.net/mingw/msysDTK-1.0.1.exe (9.8 Mb)

Run msysDTK-1.0.1.exe. Confirm your MSYS installation path <code>C:\msys\1.0</code>. Nothing more. Installation will continue without any additional questions.

===bash===
The current bash version is not enough for Synfig building and neither is the new 2.05b version. It contains an error and you need to:

# Download 3.1 snapshot: * http://downloads.sourceforge.net/mingw/bash-3.1-MSYS-1.0.11-snapshot.tar.bz2 (538.2 Kb)
# Make sure that all msys sessions are closed,
# then just decompress bash-3.1 directory from archive into <code>C:\msys\1.0</code>.

Also, you might want to edit <code>'''C:\msys\1.0\msys.bat'''</code> file. If so, do the following:
{| class="wikitable" style="text-align:center"
|-
! Look into the string which contain !! Find !! Replace
|-
! <code>'''MINGW32BGCOLOR='''</code>
| <code>'''{Any Color}'''</code> || <code>'''Black'''</code>
|-
! <code>'''MINGW32FGCOLOR='''</code>
| <code>'''{Any Color}'''</code> || <code>'''White'''</code>
|-
! <code>'''start rxvt -backspacekey'''</code>
| <code>'''-fn Courier-12'''</code> || <code>'''-fn Courier-16'''</code>
|}

===[http://www.gnu.org/software/autoconf/ autoconf]===
As written before, some tool are too old for Synfig build. For example, since revision 547 synfig required autoconf and automake, included in MSYS DTK are not acceptible. And we need replace them by new version.

# Download new autoconf from: http://downloads.sourceforge.net/mingw/msys-autoconf-2.59.tar.bz2 (394.7 Kb)
# Decompress content of archive to <code>'''C:\msys\1.0'''</code> directory.

===[http://www.gnu.org/software/automake/ automake]===
# Download new automake from: http://downloads.sourceforge.net/mingw/msys-automake-1.8.2.tar.bz2 (304 Kb)
# Decompress content of archive to <code>'''C:\msys\1.0'''</code> directory.

===[http://www.gnu.org/software/libtool/ libtool]===
In Synfig Core bootstrap file we can find that libtool prior to version 1.4.2 has an error in libltdl but msys has only 1.4e. I think - will be better to update it instead of patching.

# Download libtool 1.5 from: http://downloads.sourceforge.net/mingw/msys-libtool-1.5.tar.bz2 (411.3 Kb)
# Decompress content of archive to <code>'''C:\msys\1.0'''</code> directory.

=== [http://www.gnu.org/software/gettext Gettext] ===
Starting from SVN 1143, Synfig offers support for internationalization (languages translations). For this, Gettext is needed.

# You'll need [http://www.cygwin.com/ Cygwin] project's [http://cygwin.com/packages/gettext-devel/ gettext-devel] package: http://ftp.yz.yamagata-u.ac.jp/pub/cygwin/release/gettext/gettext-devel/
# Unpack the archive so that everything is under <code>'''/usr/local'''</code> instead of <code>'''/usr'''</code>.

'''Note:''' Any binaries that are not from the MinGW project (''or not built specially for MSYS'') cannot be placed in the <code>'''/msys/1.0/bin'''</code> (<code>'''/bin'''</code> and <code>'''/usr/bin'''</code> inside MSYS) directory. You then need to:
# hack the <code>'''/usr/local/bin/autopoint'''</code> script so that prefix is defined as <code>'''/usr/local'''</code> instead of <code>'''/usr'''</code>.
# '''Warning!''' Ugly hack follows
:: Autopoint expects to find an <code>'''archive.tar.gz'''</code> in <code>'''usr/share'''</code>, so copy gettext (found on <code>'''usr/share/'''</code> on the archive) file structure to <code>'''/usr/share'''</code> also.

'''Update:''' If you insist a MSYS-compatible gettext-devel, try: http://downloads.sourceforge.net/mingw/gettext-devel-0.16.1-MSYS-1.0.11-1.tar.bz2
* As of this post, <code>'''gettext-devel-0.16.1-MSYS'''</code> is being tested for problem-free Synfig compile.

'''Note:''' If you reload the GTK+ devel environment, make sure that you rename the autopoint script and gettext so that they don't conflict with the ones in msys. GTK\bin tends to show up first in the path, and those versions get picked by default.

===[http://www.mktemp.org/ mktemp]===
Synfig requires mktemp for building, but for some unknown reason this tool is not installed by default in MinGW.

# Download the MinGW implementation of this tool from: http://downloads.sourceforge.net/mingw/mktemp-1.5-MSYS.tar.bz2 (4 Kb)
# Decompress mktemp.exe from this archive to <code>'''C:\msys\1.0\bin'''</code> directory.

===[http://darwinsys.com/file/ file]===
libtool requires the "file" tool to check filetypes of libraries.

# So we need to download it: http://downloads.sourceforge.net/mingw/file-4.16-MSYS-1.0.11-snapshot.tar.bz2 (236.2 Kb)
# Decompress content of directory file-4.16 from the archive to <code>'''C:\msys\1.0'''</code>.

===cygpath emulation===
As far as I read, Cygwin only supports paths like /C/somedir/somefile. MinGW can use native windows paths also. Cygwin has a special tool for this (and some another features). MinGW has not. But several Synfig configure scripts require this tool so it will be better to make it. Just save the following text as <code>C:\msys\1.0\bin\cygpath</code>:

<pre>#!/bin/sh
# A simple cygpath replacement

until [ -z "$1" ]
do
if [ "${1:0:1}" != "-" ]; then
echo $1 | sed -e 's/\\/\//g' -e 's/^$[a-zA-Z]$:/\/\1/g'
fi
shift
done</pre>

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
===[http://subversion.tigris.org Subversion]===

Source code is now in GIT

Synfig source is stored in a subversion repository. You will need the svn client to get it. Also the svn client is required by the Synfig build scripts, to receive the revision number of the source.
You can download the Windows subversion package from this page:

* http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91

When I wrote this the latest version was 1.4.3:

* http://subversion.tigris.org/files/documents/15/36797/svn-1.4.3-setup.exe (3.58 Mb)

But it is best to get the newest available version.

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.
When I wrote this the latest version was 2.27:

* http://downloads.sourceforge.net/nsis/nsis-2.42-setup.exe (1.4 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw

Dev:Building on Windows

2011-01-25T01:31:25Z

Milleja46: /* Files */

{{Category|Building}}

==Directories==
If you didn't already install Mingw, {{l|Mingw installation|this page}} will guide you through the process.

If you didn't already start an msys session, do so now. Just double click the MSYS shortcut or run <code>'''C:\mingw\msys\1.0\msys.bat'''</code>. An msys session will be opened, creating your profile directory at <code>'''C:\mingw\msys\1.0\home\<windows login>'''</code>. As you can see, MinGW uses your windows login as the user name in its fake UNIX environment. Be careful, I've not checked whether it works with non latin-character account names.

Now, use explorer or your favorite file manager and go to <code>'''C:\mingw\msys\1.0\home\<windows login>'''</code>. Create a directory there for all Synfig operations. For example, let it be <code>'''synfig'''</code>. Go into this directory.

Ok, now you are at <code>'''C:\msys\1.0\home\<windows login>\synfig'''</code>. Create four directories here:
* <code>'''_filez'''</code>, for patches (and maybe later, additional files).
* <code>'''_src'''</code>, for program sources.
* <code>'''build'''</code>, for building programs.
* <code>'''temp'''</code>, for local installation programs and libraries, which are required for building synfig. (For example: ETL, synfig (core for studio), OpenEXR, etc...)

Of course, you can choose your own name for all the directories and choose their locations. All you need then is to set a new path in the configuration file. But for now we choose the easy way.

==Files==
Save this configuration file as <code>C:\mingw\msys\1.0\home\<windows login>\synfig\synbuild.conf</code>:

<code><pre><nowiki>
# Synfig for Win32 build configuration script.
############################################################################
# 1. Files and Directories

# Uncompressed Synfig svn snapshots and another package sources
SYN_SOURCE_DIR=`dirname ~/.`"/synfig/_src"

# Directory additional files (patches f.e.)
SYN_FILEZ_DIR=`dirname ~/.`"/synfig/_filez"

# Temporary installations (ETL headers, synfig binaries for icon and image making)
SYN_TEMP_INSTALL=`dirname ~/.`"/synfig/temp"

# Build directory
SYN_BUILD_DIR=`dirname ~/.`"/synfig/build"

# OpenEXR source package
SYN_ILMBASE_VERSION="1.0.1"
SYN_ILMBASE_SRC="${SYN_SOURCE_DIR}/ilmbase-${SYN_ILMBASE_VERSION}.tar.gz"
SYN_OPENEXR_VERSION="1.6.1"
SYN_OPENEXR_SRC="${SYN_SOURCE_DIR}/openexr-${SYN_OPENEXR_VERSION}.tar.gz"

#############################################################################
# 2. External tools

# Path to ImageMagick directory.
SYN_IMAGEMAGICK_PATH="/C/Program Files/ImageMagick"

# Path to Subversion bin directory.
SYN_SUBVERSION_PATH="/C/Program Files/Subversion/bin"

# Path to NSIS directory with makensis.exe file.
SYN_NSIS_PATH="/C/Program Files/NSIS"

#############################################################################
# 3. Build setup

# Build host
MINGW_HOST="mingw32"

# Make debug build of Synfig Core
SYN_CORE_DEBUG_BUILD="no"

# Make debug build of Synfig Studio
SYN_STUDIO_DEBUG_BUILD="no"
#WITH_FMOD="yes"

#############################################################################
# 4. Patches (you can place here any additional patches)

# ETL patches
ETL_PATCHES=$(cat <<:END_ETL:
:END_ETL:)

# Synfig Core patches
SYNCORE_PATCHES=$(cat <<:END_SYNCORE:
:END_SYNCORE:)

# Sunfig Studio patches
SYNSTUDIO_PATCHES=$(cat <<:END_SYNSTUDIO:
:END_SYNSTUDIO:)

# OpenEXR ILMBase patches

ILMBASE_PATCHES=$(cat <<:END_ILMBASE:
ilmbase-1.0.1-makefile.patch
ilmbase-1.0.1-pkgconfig.patch
:END_ILMBASE:)

# OpenEXR patches
#openexr-1.4.0-pkgconfig.patch
#openexr-1.4.0-mingw32.patch
OPENEXR_PATCHES=$(cat <<:END_OPENEXR:
:END_OPENEXR:)

#############################################################################
# 5. Autoconfiguration

if [ "$GTK_BASEPATH" ]; then
CPPFLAGS="-I${GTK_BASEPATH}/include $CPPFLAGS"
fi

if [ "$SYN_IMAGEMAGICK_PATH" ]; then
PATH="${SYN_IMAGEMAGICK_PATH}:${PATH}"
fi

if [ "$SYN_SUBVERSION_PATH" ]; then
PATH="${SYN_SUBVERSION_PATH}:${PATH}"
fi

if [ "$SYN_NSIS_PATH" ]; then
PATH="${SYN_NSIS_PATH}:${PATH}"
fi

if [ -d "${SYN_TEMP_INSTALL}/ETL" ]; then
PATH="${SYN_TEMP_INSTALL}/ETL/bin:${PATH}"
PKG_CONFIG_PATH="${SYN_TEMP_INSTALL}/ETL/lib/pkgconfig:${PKG_CONFIG_PATH}"
fi

if [ -d "${SYN_TEMP_INSTALL}/synfig-devel" ]; then
PATH="${SYN_TEMP_INSTALL}/synfig-devel/bin:${PATH}"
PKG_CONFIG_PATH="${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig:${PKG_CONFIG_PATH}"
fi

if [ -d "${SYN_TEMP_INSTALL}/openexr" ]; then
PATH="${SYN_TEMP_INSTALL}/openexr/bin:${PATH}"
PKG_CONFIG_PATH="${SYN_TEMP_INSTALL}/openexr/lib/pkgconfig:${PKG_CONFIG_PATH}"
fi

CPPFLAGS="-DSINGLE_THREADED $CPPFLAGS"

export PATH
export PKG_CONFIG_PATH
export CPPFLAGS
</nowiki></pre></code>

Save OpenEXR build script as <code>C:\mingw\msys\1.0\home\<windows login>\synfig\make_openexr.sh</code>:
<code><pre><nowiki>
#!/bin/sh

echo "Making OpenEXR..."
# Including configuration
if [ -r "./synbuild.conf" ]; then
. ./synbuild.conf
else
echo "No config file for synfig build (./synbuild.conf) found."
exit 1
fi

CURRENT_DIR=`pwd`

echo "Cleanup directories"
rm -rf ${SYN_BUILD_DIR}/ilmbase-${SYN_ILMBASE_VERSION}
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_TEMP_INSTALL}/ilmbase
[ $? -eq 0 ] || exit 1

rm -rf ${SYN_BUILD_DIR}/openexr-${SYN_OPENEXR_VERSION}
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_TEMP_INSTALL}/openexr
[ $? -eq 0 ] || exit 1

echo "Preparing sources"
echo PATH is $PATH
echo tar -xzf ${SYN_ILMBASE_SRC} -C ${SYN_BUILD_DIR}
tar -xzf ${SYN_ILMBASE_SRC} -C ${SYN_BUILD_DIR}
[ $? -eq 0 ] || exit 1
echo tar -xzf ${SYN_OPENEXR_SRC} -C ${SYN_BUILD_DIR}
tar -xzf ${SYN_OPENEXR_SRC} -C ${SYN_BUILD_DIR}
[ $? -eq 0 ] || exit 1

echo "Applying patches for ILMBase... "
cd ${SYN_BUILD_DIR}/ilmbase-${SYN_ILMBASE_VERSION}
[ $? -eq 0 ] || exit 1
for SFILE in ${ILMBASE_PATCHES[@]}
do
patch -p1 <${SYN_FILEZ_DIR}/${SFILE}
[ $? -eq 0 ] || exit 1
done

echo "Configuring ILMbase"
[ $? -eq 0 ] || exit 1
./configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=${SYN_TEMP_INSTALL}/openexr \
--disable-static --disable-threading --disable-posix-sem
[ $? -eq 0 ] || exit 1

echo "Making"
make
[ $? -eq 0 ] || exit 1
make install
[ $? -eq 0 ] || exit 1
echo "ILMBase Done"

echo "Applying patches for OpenEXR... "
cd ${SYN_BUILD_DIR}/openexr-${SYN_OPENEXR_VERSION}
[ $? -eq 0 ] || exit 1
for SFILE in ${OPENEXR_PATCHES[@]}
do
patch -p1 <${SYN_FILEZ_DIR}/${SFILE}
[ $? -eq 0 ] || exit 1
done

# Now the temp/openexr dir exists, we can add it to paths
if [ -d "${SYN_TEMP_INSTALL}/openexr" ]; then
PATH="${SYN_TEMP_INSTALL}/openexr/bin:${PATH}"
PKG_CONFIG_PATH="${SYN_TEMP_INSTALL}/openexr/lib/pkgconfig:${PKG_CONFIG_PATH}"
fi

export PATH
export PKG_CONFIG_PATH

echo "Configuring OpenEXR"
[ $? -eq 0 ] || exit 1
./configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=${SYN_TEMP_INSTALL}/openexr \
--disable-static --disable-threading --disable-posix-sem --disable-ilmbasetest
[ $? -eq 0 ] || exit 1

echo "separately build b44ExpLogTable as the openexr script doesn't work under msys"
cd ${SYN_BUILD_DIR}/openexr-${SYN_OPENEXR_VERSION}/IlmImf
[ $? -eq 0 ] || exit 1
mingw32-g++ --verbose -g -O2 -I${SYN_TEMP_INSTALL}/openexr/include/OpenEXR -L${SYN_TEMP_INSTALL}/openexr/lib b44ExpLogTable.cpp -lHalf -o b44ExpLogTable
[ $? -eq 0 ] || exit 1
cd ..
[ $? -eq 0 ] || exit 1

echo "Making"
make
[ $? -eq 0 ] || exit 1
make install
[ $? -eq 0 ] || exit 1
cd ${CURRENT_DIR}
[ $? -eq 0 ] || exit 1
# rm -rf ${SYN_BUILD_DIR}/openexr-${SYN_OPENEXR_VERSION}
# [ $? -eq 0 ] || exit 1

echo "Done: OpenEXR"
</nowiki></pre></code>

Save ETL build script as <code>C:\mingw\msys\1.0\home\<windows login>\synfig\make_etl.sh</code>:
<code><pre><nowiki>
#!/bin/sh

echo "Making ETL..."
# Including configuration
if [ -r "./synbuild.conf" ]; then
. ./synbuild.conf
else
echo "No config file for synfig build (./synbuild.conf) found."
exit 1
fi

CURRENT_DIR=`pwd`

echo "Cleanup directories"
rm -rf ${SYN_BUILD_DIR}/ETL
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_TEMP_INSTALL}/ETL
[ $? -eq 0 ] || exit 1

echo "Preparing sources"
mkdir ${SYN_BUILD_DIR}/ETL
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/ETL/* ${SYN_BUILD_DIR}/ETL/
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/ETL/.svn ${SYN_BUILD_DIR}/ETL/
[ $? -eq 0 ] || exit 1

echo "Applying patches..."
cd ${SYN_BUILD_DIR}/ETL
[ $? -eq 0 ] || exit 1
for SFILE in ${ETL_PATCHES[@]}
do
patch -p1 <${SYN_FILEZ_DIR}/${SFILE}
[ $? -eq 0 ] || exit 1
done

echo "Configuring"
autoreconf -if
[ $? -eq 0 ] || exit 1
./configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=${SYN_TEMP_INSTALL}/ETL
[ $? -eq 0 ] || exit 1

echo "Making"
make install
[ $? -eq 0 ] || exit 1
cd ${CURRENT_DIR}
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_BUILD_DIR}/ETL
[ $? -eq 0 ] || exit 1

echo "Done: ETL"
</nowiki></pre></code>

Save Synfig Core build script as <code>C:\mingw\msys\1.0\home\<windows login>\synfig\make_core.sh</code>:
<code><pre><nowiki>
#!/bin/sh

echo "Making Synfig-Core..."
# Including configuration
if [ -r "./synbuild.conf" ]; then
. ./synbuild.conf
else
echo "No config file for synfig build (./synbuild.conf) found."
exit 1
fi

CURRENT_DIR=`pwd`

echo "Cleanup directories"
rm -rf ${SYN_BUILD_DIR}/synfig-core
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_TEMP_INSTALL}/synfig-devel
[ $? -eq 0 ] || exit 1

echo "Preparing sources"
mkdir ${SYN_BUILD_DIR}/synfig-core
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/synfig-core/* ${SYN_BUILD_DIR}/synfig-core/
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/synfig-core/.svn ${SYN_BUILD_DIR}/synfig-core/
[ $? -eq 0 ] || exit 1

echo "Applying patches..."
cd ${SYN_BUILD_DIR}/synfig-core
[ $? -eq 0 ] || exit 1
for SFILE in ${SYNCORE_PATCHES[@]}
do
patch -p1 <${SYN_FILEZ_DIR}/${SFILE}
[ $? -eq 0 ] || exit 1
done

echo "Configuring"
libtoolize --ltdl --copy -f
autoreconf -if
[ $? -eq 0 ] || exit 1
mkdir win32build
[ $? -eq 0 ] || exit 1
cd win32build
[ $? -eq 0 ] || exit 1
if [ "$SYN_CORE_DEBUG_BUILD" == "yes" ]; then
../configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=C:/PROGRA~1/Synfig --disable-optimization --enable-debug
[ $? -eq 0 ] || exit 1
else
../configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=C:/PROGRA~1/Synfig --enable-optimization=1 --disable-debug
[ $? -eq 0 ] || exit 1
fi

echo "Making"
# libtool hack patch [begin]
patch -p2 <${SYN_FILEZ_DIR}/synfig-core-hack-libtool.patch
[ $? -eq 0 ] || exit 1
# libtool hack patch [end]
make package
[ $? -eq 0 ] || exit 1
mv ./synfig-*.exe ${CURRENT_DIR}/
[ $? -eq 0 ] || exit 1

make clean
[ $? -eq 0 ] || exit 1
# auto build hack installation [begin]
make install prefix=${SYN_TEMP_INSTALL}/synfig-devel
[ $? -eq 0 ] || exit 1
# auto build hack installation [end]
cd ${CURRENT_DIR}

# auto build hack patch [begin]
echo "Postprocessing"
SYN_SED_PATH=`echo ${SYN_TEMP_INSTALL}/synfig-devel | sed -e 's/\//\\\\\//g'`
[ $? -eq 0 ] || exit 1
mv ${SYN_TEMP_INSTALL}/synfig-devel/bin/synfig-config ${SYN_TEMP_INSTALL}/synfig-devel/bin/synfig-config.tmp
[ $? -eq 0 ] || exit 1
sed -e "s/C:\/PROGRA~1\\/Synfig/${SYN_SED_PATH}/g" \
${SYN_TEMP_INSTALL}/synfig-devel/bin/synfig-config.tmp >${SYN_TEMP_INSTALL}/synfig-devel/bin/synfig-config
[ $? -eq 0 ] || exit 1
rm -f ${SYN_TEMP_INSTALL}/synfig-devel/bin/synfig-config.tmp
[ $? -eq 0 ] || exit 1
mv ${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig/synfig.pc ${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig/synfig.pc.tmp
[ $? -eq 0 ] || exit 1
sed -e "s/C:\/PROGRA~1\\/Synfig/${SYN_SED_PATH}/g" \
${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig/synfig.pc.tmp >${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig/synfig.pc
[ $? -eq 0 ] || exit 1
rm -f ${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig/synfig.pc.tmp
[ $? -eq 0 ] || exit 1
# auto build hack patch [end]

rm -rf ${SYN_BUILD_DIR}/synfig-core

echo "Done: synfig-core"
</nowiki></pre></code>

Save Synfig Studio build script as <code>C:\msys\1.0\home\<windows login>\synfig\make_studio.sh</code>:
<code><pre><nowiki>
#!/bin/sh

echo "Making Synfig-Studio..."
# Including configuration
if [ -r "./synbuild.conf" ]; then
. ./synbuild.conf
else
echo "No config file for synfig build (./synbuild.conf) found."
exit 1
fi

CURRENT_DIR=`pwd`

echo "Cleanup directories"
rm -rf ${SYN_BUILD_DIR}/synfig-studio
[ $? -eq 0 ] || exit 1

echo "Preparing sources"
mkdir ${SYN_BUILD_DIR}/synfig-studio
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/synfig-studio/* ${SYN_BUILD_DIR}/synfig-studio/
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/synfig-studio/.svn ${SYN_BUILD_DIR}/synfig-studio/
[ $? -eq 0 ] || exit 1

echo "Applying patches..."
cd ${SYN_BUILD_DIR}/synfig-studio
[ $? -eq 0 ] || exit 1
for SFILE in ${SYNSTUDIO_PATCHES[@]}
do
patch -p1 <${SYN_FILEZ_DIR}/${SFILE}
[ $? -eq 0 ] || exit 1
done

echo "Configuring"
autoreconf -if
[ $? -eq 0 ] || exit 1
mkdir win32build
[ $? -eq 0 ] || exit 1
cd win32build
[ $? -eq 0 ] || exit 1
if [ "$SYN_STUDIO_DEBUG_BUILD" == "yes" ]; then
../configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=C:/PROGRA~1/Synfig --disable-optimization --enable-debug
[ $? -eq 0 ] || exit 1
else
../configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=C:/PROGRA~1/Synfig --enable-optimization=1 --disable-debug
[ $? -eq 0 ] || exit 1
fi

echo "Making"
make package
[ $? -eq 0 ] || exit 1

mv ./synfigstudio-*.exe ${CURRENT_DIR}/
[ $? -eq 0 ] || exit 1
cd ${CURRENT_DIR}
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_BUILD_DIR}/synfig-studio
[ $? -eq 0 ] || exit 1

echo "Done: synfig-studio"
</nowiki></pre></code>

===_src directory===
Go to the <code>C:\msys\1.0\home\<windows login>\synfig\_src</code> directory. Get the latest sources of Synfig from its repository.

:: <code>'''$ svn co <nowiki>https://synfig.svn.sourceforge.net/svnroot/synfig/ETL/trunk/ </nowiki> ETL'''</code><br />
:: <code>'''$ svn co <nowiki>https://synfig.svn.sourceforge.net/svnroot/synfig/synfig-core/trunk/ </nowiki> synfig-core'''</code><br />
:: <code>'''$ svn co <nowiki>https://synfig.svn.sourceforge.net/svnroot/synfig/synfig-studio/trunk/ </nowiki> synfig-studio'''</code><br />

'''Note:''' The commands have a space between the URL address and the third paramater, it's easy to miss it. There should be three, space separated, paramaters in total after the "'''svn'''" command.

Download the current stable [http://www.openexr.com/ OpenEXR] version from:

* http://download.savannah.gnu.org/releases-noredirect/openexr/ilmbase-1.0.1.tar.gz (452 KB)
* http://download.savannah.gnu.org/releases-noredirect/openexr/openexr-1.6.1.tar.gz (13 MB)

Finally, you must have three directories (ETL, synfig-core and synfig-studio) and the ilmbase-1.0.1.tar.gz & openexr-1.6.1.tar.gz files in your <code>'''_src'''</code> directory.

The scripts also create <code>C:\msys\1.0\home\<windows login>\synfig\_filez\config-cache</code>. To avoid the delay due to configuration autodetection keep this file until your build environment changes (i.e. you change some file related to MingW/msys, not Synfig).

===_filez directory===
Save the following text as <code>'''C:\msys\1.0\home\<windows login>\synfig\_filez\synfig-core-hack-libtool.patch'''</code>:
<code><pre><nowiki>
diff -Nuar synfig-core.orig/win32build/libtool synfig-core/win32build/libtool
--- synfig-core.orig/win32build/libtool Wed Feb 7 21:52:34 2007
+++ synfig-core/win32build/libtool Wed Feb 7 21:57:12 2007
@@ -2805,7 +2805,7 @@
fi
elif test "$build_libtool_libs" = yes; then
# Not a shared library
- if test "$deplibs_check_method" != pass_all; then
+ if test "$deplibs_check_method" != pass_all && test "$old_library" != "libltdl.a"; then
# We're trying link a shared library against a static one
# but the system doesn't support it.

</nowiki></pre></code>

Then save the following as <code>'''C:\msys\1.0\home\<windows login>\synfig\_filez\ilmbase-1.0.1-makefile.patch'''</code>:
<code><pre><nowiki>
diff -Nuar ilmbase-1.0.1.orig/IlmThread/Makefile.in ilmbase-1.0.1/IlmThread/Makefile.in
--- ilmbase-1.0.1.orig/IlmThread/Makefile.in Tue Oct 9 14:28:29 2007
+++ ilmbase-1.0.1/IlmThread/Makefile.in Sat Aug 16 18:35:08 2008
@@ -64,7 +64,8 @@
am_libIlmThread_la_OBJECTS = IlmThreadPool.lo IlmThread.lo \
IlmThreadSemaphore.lo IlmThreadMutex.lo IlmThreadPosix.lo \
IlmThreadSemaphorePosix.lo IlmThreadSemaphorePosixCompat.lo \
- IlmThreadMutexPosix.lo
+ IlmThreadMutexPosix.lo IlmThreadWin32.lo IlmThreadSemaphoreWin32.lo \
+ IlmThreadMutexWin32.lo
libIlmThread_la_OBJECTS = $(am_libIlmThread_la_OBJECTS)
DEFAULT_INCLUDES = -I. -I$(srcdir) -I$(top_builddir)/config
depcomp = $(SHELL) $(top_srcdir)/depcomp
</nowiki></pre></code>

Finally save the following as <code>'''C:\msys\1.0\home\<windows login>\synfig\_filez\ilmbase-1.0.1-pkgconfig.patch'''</code>:
<code><pre><nowiki>
diff -Nuar ilmbase-1.0.1.orig/IlmBase.pc.in ilmbase-1.0.1/IlmBase.pc.in
--- ilmbase-1.0.1.orig/IlmBase.pc.in Wed Dec 13 14:55:53 2006
+++ ilmbase-1.0.1/IlmBase.pc.in Sat Aug 16 21:06:27 2008
@@ -7,5 +7,5 @@
Name: IlmBase
Description: Base math and exception libraries
Version: @ILMBASE_VERSION@
-Libs: -L${libdir} -lImath -lHalf -lIex -lIlmThread @PTHREAD_LIBS@
-Cflags: @PTHREAD_CFLAGS@ -I${OpenEXR_includedir}
+Libs: -L${libdir} -lImath -lHalf -lIex -lIlmThread
+Cflags: -I@includedir@ -I${OpenEXR_includedir}
</nowiki></pre></code>

<s>Last but not least, prior to SVN 2055, the Windows installer files need patching - http://patches.synfig.org/r/3/</s> -- ''(it's been done)''.

(Acknowledgment to the writer of http://qtpfsgui.wiki.sourceforge.net/Compiling+on+Windows for the tip on the b44ExpLogTable file in OpenEXR)

==Configuration==
This section describes the parameters of <code>synbuild.conf</code> file.

===Files and Directories===
As you can see in this section you can define the path and name of the special directories (with sources, patches and temporary directories). If you install the build scripts as written above, there is nothing to change.

Also this section contains the path and version of the OpenEXR source files.

===External tools===
In this section you need to define the path to the executable files of the three auxiliary packages: ImageMagick, Subversion and NSIS. ImageMagick and Subversion binaries are located using the PATH environment variable, but their paths are added to the end of the path list and so we can get name collisions. For example, the ImageMagick "convert" tool has the same name as the "convert" tool from Borland Delphi Explorer, which may have been installed before ImageMagick.

===Build setup===
'''MINGW_HOST''' - host parameter of "configure" script. Do not change it.

'''SYN_CORE_DEBUG_BUILD''' - if "yes", Synfig Core will be made with debug info.

'''SYN_STUDIO_DEBUG_BUILD''' - if "yes", Synfig Studio will be made with debug info.

===Patches===
In this section you can find a number of patch definition blocks, looking like this:

<table style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em;"><tr><td>
<pre># ETL patches
ETL_PATCHES=$(cat <<:END_ETL:
:END_ETL:)</pre></td></tr></table>

For example, if you place any filenames of patches between '':END_ETL:'' blocks, it will be applied before the configuration of ETL. Patch files need to be stored in the <code>_filez</code> directory.

This section is useful if you want to test your own patches before sending them to the Synfig developers.

===Autoconfiguration===
This section contatins code which sets up the required environment variables and (by default) there is no need to change anything.

==Build Order==
Note: If you want build synfig without slowing down other tasks running on the same machine while the build takes place, open a single msys session, then open "Task Manager", search for the ''sh.exe'' process and set its priority to "Below normal".

Note: Running an on-access antivirus scanner can dramatically decrease compilation speed.

===OpenEXR===
This package needs to be built only once. A rebuild is only required if you get a new version or want to apply a new patch to it or you update the compiler and it is incompatible with the previous binaries.

In your msys console go to the <code>C:\msys\1.0\home\<windows login>\synfig</code> directory by typing:

<blockquote><nowiki>$ cd ~/synfig</nowiki></blockquote>

Then type:

<blockquote><nowiki>$ ./make_openexr.sh</nowiki></blockquote>

Wait for the "Done: OpenEXR" message.

===ETL===
Rebuild it when you get a new version of Synfig.

In your msys console go to the <code>C:\msys\1.0\home\<windows login>\synfig</code> directory by typing:

<blockquote><nowiki>$ cd ~/synfig</nowiki></blockquote>

Then type:

<blockquote><nowiki>$ ./make_etl.sh</nowiki></blockquote>

Wait for the "Done: ETL" message.

===Synfig Core===
Rebuild it when you get a new version of Synfig.

In your msys console go to the <code>C:\msys\1.0\home\<windows login>\synfig</code> directory by typing:

<blockquote><nowiki>$ cd ~/synfig</nowiki></blockquote>

Then type:

<blockquote><nowiki>$ ./make_core.sh</nowiki></blockquote>

Wait for the "Done: synfig-core" message. It can take a long time. The Synfig Core installer will be moved into the current directory.

===Synfig Studio===
Rebuild it when you get a new version of Synfig.

In your msys console go to the <code>C:\msys\1.0\home\<windows login>\synfig</code> directory by typing:

<blockquote><nowiki>$ cd ~/synfig</nowiki></blockquote>

Then type:

<blockquote><nowiki>$ ./make_studio.sh</nowiki></blockquote>

Wait for the "Done: synfig-studio" message. It can take a long time. The Synfig Studio installer will be moved into the current directory.

==Additional tools==
These tools are not required to build Synfig, but they can help in the debugging process.

P.S. Post this later. ;-)

(Atrus - keen to hear what you recommend for debug. Also any debug processes you go through to fix the bugs. There's several bugs (mainly preview rendering) that I see under the current builds of Windows that are not under Linux or the old 0.61.05 for Windows - Pxegeek 2/7/07)

{{Category|Windows}}

Dev:Building on Windows

2011-01-25T01:28:46Z

Milleja46: /* Directories */

{{Category|Building}}

==Directories==
If you didn't already install Mingw, {{l|Mingw installation|this page}} will guide you through the process.

If you didn't already start an msys session, do so now. Just double click the MSYS shortcut or run <code>'''C:\mingw\msys\1.0\msys.bat'''</code>. An msys session will be opened, creating your profile directory at <code>'''C:\mingw\msys\1.0\home\<windows login>'''</code>. As you can see, MinGW uses your windows login as the user name in its fake UNIX environment. Be careful, I've not checked whether it works with non latin-character account names.

Now, use explorer or your favorite file manager and go to <code>'''C:\mingw\msys\1.0\home\<windows login>'''</code>. Create a directory there for all Synfig operations. For example, let it be <code>'''synfig'''</code>. Go into this directory.

Ok, now you are at <code>'''C:\msys\1.0\home\<windows login>\synfig'''</code>. Create four directories here:
* <code>'''_filez'''</code>, for patches (and maybe later, additional files).
* <code>'''_src'''</code>, for program sources.
* <code>'''build'''</code>, for building programs.
* <code>'''temp'''</code>, for local installation programs and libraries, which are required for building synfig. (For example: ETL, synfig (core for studio), OpenEXR, etc...)

Of course, you can choose your own name for all the directories and choose their locations. All you need then is to set a new path in the configuration file. But for now we choose the easy way.

==Files==
Save this configuration file as <code>C:\msys\1.0\home\<windows login>\synfig\synbuild.conf</code>:

<code><pre><nowiki>
# Synfig for Win32 build configuration script.
############################################################################
# 1. Files and Directories

# Uncompressed Synfig svn snapshots and another package sources
SYN_SOURCE_DIR=`dirname ~/.`"/synfig/_src"

# Directory additional files (patches f.e.)
SYN_FILEZ_DIR=`dirname ~/.`"/synfig/_filez"

# Temporary installations (ETL headers, synfig binaries for icon and image making)
SYN_TEMP_INSTALL=`dirname ~/.`"/synfig/temp"

# Build directory
SYN_BUILD_DIR=`dirname ~/.`"/synfig/build"

# OpenEXR source package
SYN_ILMBASE_VERSION="1.0.1"
SYN_ILMBASE_SRC="${SYN_SOURCE_DIR}/ilmbase-${SYN_ILMBASE_VERSION}.tar.gz"
SYN_OPENEXR_VERSION="1.6.1"
SYN_OPENEXR_SRC="${SYN_SOURCE_DIR}/openexr-${SYN_OPENEXR_VERSION}.tar.gz"

#############################################################################
# 2. External tools

# Path to ImageMagick directory.
SYN_IMAGEMAGICK_PATH="/C/Program Files/ImageMagick"

# Path to Subversion bin directory.
SYN_SUBVERSION_PATH="/C/Program Files/Subversion/bin"

# Path to NSIS directory with makensis.exe file.
SYN_NSIS_PATH="/C/Program Files/NSIS"

#############################################################################
# 3. Build setup

# Build host
MINGW_HOST="mingw32"

# Make debug build of Synfig Core
SYN_CORE_DEBUG_BUILD="no"

# Make debug build of Synfig Studio
SYN_STUDIO_DEBUG_BUILD="no"
#WITH_FMOD="yes"

#############################################################################
# 4. Patches (you can place here any additional patches)

# ETL patches
ETL_PATCHES=$(cat <<:END_ETL:
:END_ETL:)

# Synfig Core patches
SYNCORE_PATCHES=$(cat <<:END_SYNCORE:
:END_SYNCORE:)

# Sunfig Studio patches
SYNSTUDIO_PATCHES=$(cat <<:END_SYNSTUDIO:
:END_SYNSTUDIO:)

# OpenEXR ILMBase patches

ILMBASE_PATCHES=$(cat <<:END_ILMBASE:
ilmbase-1.0.1-makefile.patch
ilmbase-1.0.1-pkgconfig.patch
:END_ILMBASE:)

# OpenEXR patches
#openexr-1.4.0-pkgconfig.patch
#openexr-1.4.0-mingw32.patch
OPENEXR_PATCHES=$(cat <<:END_OPENEXR:
:END_OPENEXR:)

#############################################################################
# 5. Autoconfiguration

if [ "$GTK_BASEPATH" ]; then
CPPFLAGS="-I${GTK_BASEPATH}/include $CPPFLAGS"
fi

if [ "$SYN_IMAGEMAGICK_PATH" ]; then
PATH="${SYN_IMAGEMAGICK_PATH}:${PATH}"
fi

if [ "$SYN_SUBVERSION_PATH" ]; then
PATH="${SYN_SUBVERSION_PATH}:${PATH}"
fi

if [ "$SYN_NSIS_PATH" ]; then
PATH="${SYN_NSIS_PATH}:${PATH}"
fi

if [ -d "${SYN_TEMP_INSTALL}/ETL" ]; then
PATH="${SYN_TEMP_INSTALL}/ETL/bin:${PATH}"
PKG_CONFIG_PATH="${SYN_TEMP_INSTALL}/ETL/lib/pkgconfig:${PKG_CONFIG_PATH}"
fi

if [ -d "${SYN_TEMP_INSTALL}/synfig-devel" ]; then
PATH="${SYN_TEMP_INSTALL}/synfig-devel/bin:${PATH}"
PKG_CONFIG_PATH="${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig:${PKG_CONFIG_PATH}"
fi

if [ -d "${SYN_TEMP_INSTALL}/openexr" ]; then
PATH="${SYN_TEMP_INSTALL}/openexr/bin:${PATH}"
PKG_CONFIG_PATH="${SYN_TEMP_INSTALL}/openexr/lib/pkgconfig:${PKG_CONFIG_PATH}"
fi

CPPFLAGS="-DSINGLE_THREADED $CPPFLAGS"

export PATH
export PKG_CONFIG_PATH
export CPPFLAGS
</nowiki></pre></code>

Save OpenEXR build script as <code>C:\msys\1.0\home\<windows login>\synfig\make_openexr.sh</code>:
<code><pre><nowiki>
#!/bin/sh

echo "Making OpenEXR..."
# Including configuration
if [ -r "./synbuild.conf" ]; then
. ./synbuild.conf
else
echo "No config file for synfig build (./synbuild.conf) found."
exit 1
fi

CURRENT_DIR=`pwd`

echo "Cleanup directories"
rm -rf ${SYN_BUILD_DIR}/ilmbase-${SYN_ILMBASE_VERSION}
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_TEMP_INSTALL}/ilmbase
[ $? -eq 0 ] || exit 1

rm -rf ${SYN_BUILD_DIR}/openexr-${SYN_OPENEXR_VERSION}
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_TEMP_INSTALL}/openexr
[ $? -eq 0 ] || exit 1

echo "Preparing sources"
echo PATH is $PATH
echo tar -xzf ${SYN_ILMBASE_SRC} -C ${SYN_BUILD_DIR}
tar -xzf ${SYN_ILMBASE_SRC} -C ${SYN_BUILD_DIR}
[ $? -eq 0 ] || exit 1
echo tar -xzf ${SYN_OPENEXR_SRC} -C ${SYN_BUILD_DIR}
tar -xzf ${SYN_OPENEXR_SRC} -C ${SYN_BUILD_DIR}
[ $? -eq 0 ] || exit 1

echo "Applying patches for ILMBase... "
cd ${SYN_BUILD_DIR}/ilmbase-${SYN_ILMBASE_VERSION}
[ $? -eq 0 ] || exit 1
for SFILE in ${ILMBASE_PATCHES[@]}
do
patch -p1 <${SYN_FILEZ_DIR}/${SFILE}
[ $? -eq 0 ] || exit 1
done

echo "Configuring ILMbase"
[ $? -eq 0 ] || exit 1
./configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=${SYN_TEMP_INSTALL}/openexr \
--disable-static --disable-threading --disable-posix-sem
[ $? -eq 0 ] || exit 1

echo "Making"
make
[ $? -eq 0 ] || exit 1
make install
[ $? -eq 0 ] || exit 1
echo "ILMBase Done"

echo "Applying patches for OpenEXR... "
cd ${SYN_BUILD_DIR}/openexr-${SYN_OPENEXR_VERSION}
[ $? -eq 0 ] || exit 1
for SFILE in ${OPENEXR_PATCHES[@]}
do
patch -p1 <${SYN_FILEZ_DIR}/${SFILE}
[ $? -eq 0 ] || exit 1
done

# Now the temp/openexr dir exists, we can add it to paths
if [ -d "${SYN_TEMP_INSTALL}/openexr" ]; then
PATH="${SYN_TEMP_INSTALL}/openexr/bin:${PATH}"
PKG_CONFIG_PATH="${SYN_TEMP_INSTALL}/openexr/lib/pkgconfig:${PKG_CONFIG_PATH}"
fi

export PATH
export PKG_CONFIG_PATH

echo "Configuring OpenEXR"
[ $? -eq 0 ] || exit 1
./configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=${SYN_TEMP_INSTALL}/openexr \
--disable-static --disable-threading --disable-posix-sem --disable-ilmbasetest
[ $? -eq 0 ] || exit 1

echo "separately build b44ExpLogTable as the openexr script doesn't work under msys"
cd ${SYN_BUILD_DIR}/openexr-${SYN_OPENEXR_VERSION}/IlmImf
[ $? -eq 0 ] || exit 1
mingw32-g++ --verbose -g -O2 -I${SYN_TEMP_INSTALL}/openexr/include/OpenEXR -L${SYN_TEMP_INSTALL}/openexr/lib b44ExpLogTable.cpp -lHalf -o b44ExpLogTable
[ $? -eq 0 ] || exit 1
cd ..
[ $? -eq 0 ] || exit 1

echo "Making"
make
[ $? -eq 0 ] || exit 1
make install
[ $? -eq 0 ] || exit 1
cd ${CURRENT_DIR}
[ $? -eq 0 ] || exit 1
# rm -rf ${SYN_BUILD_DIR}/openexr-${SYN_OPENEXR_VERSION}
# [ $? -eq 0 ] || exit 1

echo "Done: OpenEXR"
</nowiki></pre></code>

Save ETL build script as <code>C:\msys\1.0\home\<windows login>\synfig\make_etl.sh</code>:
<code><pre><nowiki>
#!/bin/sh

echo "Making ETL..."
# Including configuration
if [ -r "./synbuild.conf" ]; then
. ./synbuild.conf
else
echo "No config file for synfig build (./synbuild.conf) found."
exit 1
fi

CURRENT_DIR=`pwd`

echo "Cleanup directories"
rm -rf ${SYN_BUILD_DIR}/ETL
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_TEMP_INSTALL}/ETL
[ $? -eq 0 ] || exit 1

echo "Preparing sources"
mkdir ${SYN_BUILD_DIR}/ETL
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/ETL/* ${SYN_BUILD_DIR}/ETL/
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/ETL/.svn ${SYN_BUILD_DIR}/ETL/
[ $? -eq 0 ] || exit 1

echo "Applying patches..."
cd ${SYN_BUILD_DIR}/ETL
[ $? -eq 0 ] || exit 1
for SFILE in ${ETL_PATCHES[@]}
do
patch -p1 <${SYN_FILEZ_DIR}/${SFILE}
[ $? -eq 0 ] || exit 1
done

echo "Configuring"
autoreconf -if
[ $? -eq 0 ] || exit 1
./configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=${SYN_TEMP_INSTALL}/ETL
[ $? -eq 0 ] || exit 1

echo "Making"
make install
[ $? -eq 0 ] || exit 1
cd ${CURRENT_DIR}
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_BUILD_DIR}/ETL
[ $? -eq 0 ] || exit 1

echo "Done: ETL"
</nowiki></pre></code>

Save Synfig Core build script as <code>C:\msys\1.0\home\<windows login>\synfig\make_core.sh</code>:
<code><pre><nowiki>
#!/bin/sh

echo "Making Synfig-Core..."
# Including configuration
if [ -r "./synbuild.conf" ]; then
. ./synbuild.conf
else
echo "No config file for synfig build (./synbuild.conf) found."
exit 1
fi

CURRENT_DIR=`pwd`

echo "Cleanup directories"
rm -rf ${SYN_BUILD_DIR}/synfig-core
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_TEMP_INSTALL}/synfig-devel
[ $? -eq 0 ] || exit 1

echo "Preparing sources"
mkdir ${SYN_BUILD_DIR}/synfig-core
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/synfig-core/* ${SYN_BUILD_DIR}/synfig-core/
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/synfig-core/.svn ${SYN_BUILD_DIR}/synfig-core/
[ $? -eq 0 ] || exit 1

echo "Applying patches..."
cd ${SYN_BUILD_DIR}/synfig-core
[ $? -eq 0 ] || exit 1
for SFILE in ${SYNCORE_PATCHES[@]}
do
patch -p1 <${SYN_FILEZ_DIR}/${SFILE}
[ $? -eq 0 ] || exit 1
done

echo "Configuring"
libtoolize --ltdl --copy -f
autoreconf -if
[ $? -eq 0 ] || exit 1
mkdir win32build
[ $? -eq 0 ] || exit 1
cd win32build
[ $? -eq 0 ] || exit 1
if [ "$SYN_CORE_DEBUG_BUILD" == "yes" ]; then
../configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=C:/PROGRA~1/Synfig --disable-optimization --enable-debug
[ $? -eq 0 ] || exit 1
else
../configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=C:/PROGRA~1/Synfig --enable-optimization=1 --disable-debug
[ $? -eq 0 ] || exit 1
fi

echo "Making"
# libtool hack patch [begin]
patch -p2 <${SYN_FILEZ_DIR}/synfig-core-hack-libtool.patch
[ $? -eq 0 ] || exit 1
# libtool hack patch [end]
make package
[ $? -eq 0 ] || exit 1
mv ./synfig-*.exe ${CURRENT_DIR}/
[ $? -eq 0 ] || exit 1

make clean
[ $? -eq 0 ] || exit 1
# auto build hack installation [begin]
make install prefix=${SYN_TEMP_INSTALL}/synfig-devel
[ $? -eq 0 ] || exit 1
# auto build hack installation [end]
cd ${CURRENT_DIR}

# auto build hack patch [begin]
echo "Postprocessing"
SYN_SED_PATH=`echo ${SYN_TEMP_INSTALL}/synfig-devel | sed -e 's/\//\\\\\//g'`
[ $? -eq 0 ] || exit 1
mv ${SYN_TEMP_INSTALL}/synfig-devel/bin/synfig-config ${SYN_TEMP_INSTALL}/synfig-devel/bin/synfig-config.tmp
[ $? -eq 0 ] || exit 1
sed -e "s/C:\/PROGRA~1\\/Synfig/${SYN_SED_PATH}/g" \
${SYN_TEMP_INSTALL}/synfig-devel/bin/synfig-config.tmp >${SYN_TEMP_INSTALL}/synfig-devel/bin/synfig-config
[ $? -eq 0 ] || exit 1
rm -f ${SYN_TEMP_INSTALL}/synfig-devel/bin/synfig-config.tmp
[ $? -eq 0 ] || exit 1
mv ${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig/synfig.pc ${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig/synfig.pc.tmp
[ $? -eq 0 ] || exit 1
sed -e "s/C:\/PROGRA~1\\/Synfig/${SYN_SED_PATH}/g" \
${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig/synfig.pc.tmp >${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig/synfig.pc
[ $? -eq 0 ] || exit 1
rm -f ${SYN_TEMP_INSTALL}/synfig-devel/lib/pkgconfig/synfig.pc.tmp
[ $? -eq 0 ] || exit 1
# auto build hack patch [end]

rm -rf ${SYN_BUILD_DIR}/synfig-core

echo "Done: synfig-core"
</nowiki></pre></code>

Save Synfig Studio build script as <code>C:\msys\1.0\home\<windows login>\synfig\make_studio.sh</code>:
<code><pre><nowiki>
#!/bin/sh

echo "Making Synfig-Studio..."
# Including configuration
if [ -r "./synbuild.conf" ]; then
. ./synbuild.conf
else
echo "No config file for synfig build (./synbuild.conf) found."
exit 1
fi

CURRENT_DIR=`pwd`

echo "Cleanup directories"
rm -rf ${SYN_BUILD_DIR}/synfig-studio
[ $? -eq 0 ] || exit 1

echo "Preparing sources"
mkdir ${SYN_BUILD_DIR}/synfig-studio
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/synfig-studio/* ${SYN_BUILD_DIR}/synfig-studio/
[ $? -eq 0 ] || exit 1
cp -R ${SYN_SOURCE_DIR}/synfig-studio/.svn ${SYN_BUILD_DIR}/synfig-studio/
[ $? -eq 0 ] || exit 1

echo "Applying patches..."
cd ${SYN_BUILD_DIR}/synfig-studio
[ $? -eq 0 ] || exit 1
for SFILE in ${SYNSTUDIO_PATCHES[@]}
do
patch -p1 <${SYN_FILEZ_DIR}/${SFILE}
[ $? -eq 0 ] || exit 1
done

echo "Configuring"
autoreconf -if
[ $? -eq 0 ] || exit 1
mkdir win32build
[ $? -eq 0 ] || exit 1
cd win32build
[ $? -eq 0 ] || exit 1
if [ "$SYN_STUDIO_DEBUG_BUILD" == "yes" ]; then
../configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=C:/PROGRA~1/Synfig --disable-optimization --enable-debug
[ $? -eq 0 ] || exit 1
else
../configure --host=${MINGW_HOST} --cache-file=${SYN_FILEZ_DIR}/config-cache --prefix=C:/PROGRA~1/Synfig --enable-optimization=1 --disable-debug
[ $? -eq 0 ] || exit 1
fi

echo "Making"
make package
[ $? -eq 0 ] || exit 1

mv ./synfigstudio-*.exe ${CURRENT_DIR}/
[ $? -eq 0 ] || exit 1
cd ${CURRENT_DIR}
[ $? -eq 0 ] || exit 1
rm -rf ${SYN_BUILD_DIR}/synfig-studio
[ $? -eq 0 ] || exit 1

echo "Done: synfig-studio"
</nowiki></pre></code>

===_src directory===
Go to the <code>C:\msys\1.0\home\<windows login>\synfig\_src</code> directory. Get the latest sources of Synfig from its repository.

:: <code>'''$ svn co <nowiki>https://synfig.svn.sourceforge.net/svnroot/synfig/ETL/trunk/ </nowiki> ETL'''</code><br />
:: <code>'''$ svn co <nowiki>https://synfig.svn.sourceforge.net/svnroot/synfig/synfig-core/trunk/ </nowiki> synfig-core'''</code><br />
:: <code>'''$ svn co <nowiki>https://synfig.svn.sourceforge.net/svnroot/synfig/synfig-studio/trunk/ </nowiki> synfig-studio'''</code><br />

'''Note:''' The commands have a space between the URL address and the third paramater, it's easy to miss it. There should be three, space separated, paramaters in total after the "'''svn'''" command.

Download the current stable [http://www.openexr.com/ OpenEXR] version from:

* http://download.savannah.gnu.org/releases-noredirect/openexr/ilmbase-1.0.1.tar.gz (452 KB)
* http://download.savannah.gnu.org/releases-noredirect/openexr/openexr-1.6.1.tar.gz (13 MB)

Finally, you must have three directories (ETL, synfig-core and synfig-studio) and the ilmbase-1.0.1.tar.gz & openexr-1.6.1.tar.gz files in your <code>'''_src'''</code> directory.

The scripts also create <code>C:\msys\1.0\home\<windows login>\synfig\_filez\config-cache</code>. To avoid the delay due to configuration autodetection keep this file until your build environment changes (i.e. you change some file related to MingW/msys, not Synfig).

===_filez directory===
Save the following text as <code>'''C:\msys\1.0\home\<windows login>\synfig\_filez\synfig-core-hack-libtool.patch'''</code>:
<code><pre><nowiki>
diff -Nuar synfig-core.orig/win32build/libtool synfig-core/win32build/libtool
--- synfig-core.orig/win32build/libtool Wed Feb 7 21:52:34 2007
+++ synfig-core/win32build/libtool Wed Feb 7 21:57:12 2007
@@ -2805,7 +2805,7 @@
fi
elif test "$build_libtool_libs" = yes; then
# Not a shared library
- if test "$deplibs_check_method" != pass_all; then
+ if test "$deplibs_check_method" != pass_all && test "$old_library" != "libltdl.a"; then
# We're trying link a shared library against a static one
# but the system doesn't support it.

</nowiki></pre></code>

Then save the following as <code>'''C:\msys\1.0\home\<windows login>\synfig\_filez\ilmbase-1.0.1-makefile.patch'''</code>:
<code><pre><nowiki>
diff -Nuar ilmbase-1.0.1.orig/IlmThread/Makefile.in ilmbase-1.0.1/IlmThread/Makefile.in
--- ilmbase-1.0.1.orig/IlmThread/Makefile.in Tue Oct 9 14:28:29 2007
+++ ilmbase-1.0.1/IlmThread/Makefile.in Sat Aug 16 18:35:08 2008
@@ -64,7 +64,8 @@
am_libIlmThread_la_OBJECTS = IlmThreadPool.lo IlmThread.lo \
IlmThreadSemaphore.lo IlmThreadMutex.lo IlmThreadPosix.lo \
IlmThreadSemaphorePosix.lo IlmThreadSemaphorePosixCompat.lo \
- IlmThreadMutexPosix.lo
+ IlmThreadMutexPosix.lo IlmThreadWin32.lo IlmThreadSemaphoreWin32.lo \
+ IlmThreadMutexWin32.lo
libIlmThread_la_OBJECTS = $(am_libIlmThread_la_OBJECTS)
DEFAULT_INCLUDES = -I. -I$(srcdir) -I$(top_builddir)/config
depcomp = $(SHELL) $(top_srcdir)/depcomp
</nowiki></pre></code>

Finally save the following as <code>'''C:\msys\1.0\home\<windows login>\synfig\_filez\ilmbase-1.0.1-pkgconfig.patch'''</code>:
<code><pre><nowiki>
diff -Nuar ilmbase-1.0.1.orig/IlmBase.pc.in ilmbase-1.0.1/IlmBase.pc.in
--- ilmbase-1.0.1.orig/IlmBase.pc.in Wed Dec 13 14:55:53 2006
+++ ilmbase-1.0.1/IlmBase.pc.in Sat Aug 16 21:06:27 2008
@@ -7,5 +7,5 @@
Name: IlmBase
Description: Base math and exception libraries
Version: @ILMBASE_VERSION@
-Libs: -L${libdir} -lImath -lHalf -lIex -lIlmThread @PTHREAD_LIBS@
-Cflags: @PTHREAD_CFLAGS@ -I${OpenEXR_includedir}
+Libs: -L${libdir} -lImath -lHalf -lIex -lIlmThread
+Cflags: -I@includedir@ -I${OpenEXR_includedir}
</nowiki></pre></code>

<s>Last but not least, prior to SVN 2055, the Windows installer files need patching - http://patches.synfig.org/r/3/</s> -- ''(it's been done)''.

(Acknowledgment to the writer of http://qtpfsgui.wiki.sourceforge.net/Compiling+on+Windows for the tip on the b44ExpLogTable file in OpenEXR)

==Configuration==
This section describes the parameters of <code>synbuild.conf</code> file.

===Files and Directories===
As you can see in this section you can define the path and name of the special directories (with sources, patches and temporary directories). If you install the build scripts as written above, there is nothing to change.

Also this section contains the path and version of the OpenEXR source files.

===External tools===
In this section you need to define the path to the executable files of the three auxiliary packages: ImageMagick, Subversion and NSIS. ImageMagick and Subversion binaries are located using the PATH environment variable, but their paths are added to the end of the path list and so we can get name collisions. For example, the ImageMagick "convert" tool has the same name as the "convert" tool from Borland Delphi Explorer, which may have been installed before ImageMagick.

===Build setup===
'''MINGW_HOST''' - host parameter of "configure" script. Do not change it.

'''SYN_CORE_DEBUG_BUILD''' - if "yes", Synfig Core will be made with debug info.

'''SYN_STUDIO_DEBUG_BUILD''' - if "yes", Synfig Studio will be made with debug info.

===Patches===
In this section you can find a number of patch definition blocks, looking like this:

<table style="padding: 1em; border: 1px dashed #2f6fab; color: Black; background-color: #f9f9f9; line-height: 1.1em;"><tr><td>
<pre># ETL patches
ETL_PATCHES=$(cat <<:END_ETL:
:END_ETL:)</pre></td></tr></table>

For example, if you place any filenames of patches between '':END_ETL:'' blocks, it will be applied before the configuration of ETL. Patch files need to be stored in the <code>_filez</code> directory.

This section is useful if you want to test your own patches before sending them to the Synfig developers.

===Autoconfiguration===
This section contatins code which sets up the required environment variables and (by default) there is no need to change anything.

==Build Order==
Note: If you want build synfig without slowing down other tasks running on the same machine while the build takes place, open a single msys session, then open "Task Manager", search for the ''sh.exe'' process and set its priority to "Below normal".

Note: Running an on-access antivirus scanner can dramatically decrease compilation speed.

===OpenEXR===
This package needs to be built only once. A rebuild is only required if you get a new version or want to apply a new patch to it or you update the compiler and it is incompatible with the previous binaries.

In your msys console go to the <code>C:\msys\1.0\home\<windows login>\synfig</code> directory by typing:

<blockquote><nowiki>$ cd ~/synfig</nowiki></blockquote>

Then type:

<blockquote><nowiki>$ ./make_openexr.sh</nowiki></blockquote>

Wait for the "Done: OpenEXR" message.

===ETL===
Rebuild it when you get a new version of Synfig.

In your msys console go to the <code>C:\msys\1.0\home\<windows login>\synfig</code> directory by typing:

<blockquote><nowiki>$ cd ~/synfig</nowiki></blockquote>

Then type:

<blockquote><nowiki>$ ./make_etl.sh</nowiki></blockquote>

Wait for the "Done: ETL" message.

===Synfig Core===
Rebuild it when you get a new version of Synfig.

In your msys console go to the <code>C:\msys\1.0\home\<windows login>\synfig</code> directory by typing:

<blockquote><nowiki>$ cd ~/synfig</nowiki></blockquote>

Then type:

<blockquote><nowiki>$ ./make_core.sh</nowiki></blockquote>

Wait for the "Done: synfig-core" message. It can take a long time. The Synfig Core installer will be moved into the current directory.

===Synfig Studio===
Rebuild it when you get a new version of Synfig.

In your msys console go to the <code>C:\msys\1.0\home\<windows login>\synfig</code> directory by typing:

<blockquote><nowiki>$ cd ~/synfig</nowiki></blockquote>

Then type:

<blockquote><nowiki>$ ./make_studio.sh</nowiki></blockquote>

Wait for the "Done: synfig-studio" message. It can take a long time. The Synfig Studio installer will be moved into the current directory.

==Additional tools==
These tools are not required to build Synfig, but they can help in the debugging process.

P.S. Post this later. ;-)

(Atrus - keen to hear what you recommend for debug. Also any debug processes you go through to fix the bugs. There's several bugs (mainly preview rendering) that I see under the current builds of Windows that are not under Linux or the old 0.61.05 for Windows - Pxegeek 2/7/07)

{{Category|Windows}}

Dev:Mingw installation

2011-01-24T21:10:59Z

Milleja46: /* Updated Mingw */

Dev:Mingw installation

2011-01-24T21:07:47Z

Milleja46: /* MinGW */

{{Category|Building}}
{{Category|Windows}}

==Updated Mingw==
Welcome to the updated mingw page! As the
==MinGW(Old and unusable will be replaced as the new information is tested and added to the page)==
First - download [http://www.mingw.org/ MinGW] installer. You may get version 5.1.3 or higher (recommended).

* https://sourceforge.net/projects/mingw/files/Automated%20MinGW%20Installer/MinGW-5.1.4.exe/download

Run MinGW-5.1.4.exe. Select "Download and install". Choose "Candidate" package, because "Current" is too old. When the installer asks which packages to install, select:

* MinGW base tools
* g++ Compiler
* g77 Compiler
* MinGW Make

Note: you really do need to install Fortran; even though Synfig does not require it, it is required by the autoconf configuration scripts. These are the minimal required package versions which are needed to successfully build win32 synfig (version numbers from the 5.1.3 package):

* mingw-runtime-3.12.tar.gz (429.7 Kb)
* w32api-3.9.tar.gz (1.6 Mb)
* binutils-2.17.50-20060824-1.tar.gz (8.9 Mb)
* gcc-core-3.4.5-20060117-1.tar.gz (3.3 Mb)
* gcc-g++-3.4.5-20060117-1.tar.gz (4.5 Mb)
* gcc-g77-3.4.5-20060117-1.tar.gz (2.0 Mb)
* mingw32-make-3.81-2.tar.gz (95 Kb)

Confirm default installation path <code>C:\MinGW</code>. If you install MinGW into another directory, synfig compilation may fail.

(instructions updated from version 5.1.3 to 5.1.4, but untested. please update the wiki if anything is broken with 5.1.4)

===MSYS===
Now download and install MSYS - a shell and tools kit.

* http://downloads.sourceforge.net/mingw/MSYS-1.0.10.exe (2.7 Mb)

Run MSYS-1.0.10.exe, confirm default installation path <code>C:\msys\1.0</code>. Wait until installation completes. Then the installer opens a console and asks some questions.

:<code>'''This is a post install process that will try to normalize between'''<br />'''your MinGW install if any as well as your previous MSYS installs'''<br />'''if any. I don't have any traps as aborts will not hurt anything.'''<br />'''Do you wish to continue with the post install? [yn ]'''</code>

Answer "<code>'''y'''</code>" here.

:<code>'''Do you have MinGW installed? [yn ]'''</code>

Answer "<code>'''y'''</code>" here.

:<code>'''Please answer following the in the form of c:/foo/bar.'''<br />'''Where is your MinGW installation?'''<br /></code>

Answer "<code>'''c:/mingw'''</code>".

The installer script prints some text and finally writes:

:<code>'''Oh joy, you do not have c:/mingw/bin/make.exe. Keep it that way.'''</code>

It's OK. The first phase of installation is completed. Press any key.

===MSYS Developer Toolkit===
Download MSYS Developer Toolkit, which contain such required tools as [http://www.gnu.org/software/autoconf/ autoconf], [http://www.gnu.org/software/automake/ automake], [http://www.gnu.org/software/libtool/ libtool], [http://www.cpan.org/ perl], pkg-tools, etc. Unfortunately, many tools included in MSYS DTK is too old and we need update it manually later.

* http://downloads.sourceforge.net/mingw/msysDTK-1.0.1.exe (9.8 Mb)

Run msysDTK-1.0.1.exe. Confirm your MSYS installation path <code>C:\msys\1.0</code>. Nothing more. Installation will continue without any additional questions.

===bash===
The current bash version is not enough for Synfig building and neither is the new 2.05b version. It contains an error and you need to:

# Download 3.1 snapshot: * http://downloads.sourceforge.net/mingw/bash-3.1-MSYS-1.0.11-snapshot.tar.bz2 (538.2 Kb)
# Make sure that all msys sessions are closed,
# then just decompress bash-3.1 directory from archive into <code>C:\msys\1.0</code>.

Also, you might want to edit <code>'''C:\msys\1.0\msys.bat'''</code> file. If so, do the following:
{| class="wikitable" style="text-align:center"
|-
! Look into the string which contain !! Find !! Replace
|-
! <code>'''MINGW32BGCOLOR='''</code>
| <code>'''{Any Color}'''</code> || <code>'''Black'''</code>
|-
! <code>'''MINGW32FGCOLOR='''</code>
| <code>'''{Any Color}'''</code> || <code>'''White'''</code>
|-
! <code>'''start rxvt -backspacekey'''</code>
| <code>'''-fn Courier-12'''</code> || <code>'''-fn Courier-16'''</code>
|}

===[http://www.gnu.org/software/autoconf/ autoconf]===
As written before, some tool are too old for Synfig build. For example, since revision 547 synfig required autoconf and automake, included in MSYS DTK are not acceptible. And we need replace them by new version.

# Download new autoconf from: http://downloads.sourceforge.net/mingw/msys-autoconf-2.59.tar.bz2 (394.7 Kb)
# Decompress content of archive to <code>'''C:\msys\1.0'''</code> directory.

===[http://www.gnu.org/software/automake/ automake]===
# Download new automake from: http://downloads.sourceforge.net/mingw/msys-automake-1.8.2.tar.bz2 (304 Kb)
# Decompress content of archive to <code>'''C:\msys\1.0'''</code> directory.

===[http://www.gnu.org/software/libtool/ libtool]===
In Synfig Core bootstrap file we can find that libtool prior to version 1.4.2 has an error in libltdl but msys has only 1.4e. I think - will be better to update it instead of patching.

# Download libtool 1.5 from: http://downloads.sourceforge.net/mingw/msys-libtool-1.5.tar.bz2 (411.3 Kb)
# Decompress content of archive to <code>'''C:\msys\1.0'''</code> directory.

=== [http://www.gnu.org/software/gettext Gettext] ===
Starting from SVN 1143, Synfig offers support for internationalization (languages translations). For this, Gettext is needed.

# You'll need [http://www.cygwin.com/ Cygwin] project's [http://cygwin.com/packages/gettext-devel/ gettext-devel] package: http://ftp.yz.yamagata-u.ac.jp/pub/cygwin/release/gettext/gettext-devel/
# Unpack the archive so that everything is under <code>'''/usr/local'''</code> instead of <code>'''/usr'''</code>.

'''Note:''' Any binaries that are not from the MinGW project (''or not built specially for MSYS'') cannot be placed in the <code>'''/msys/1.0/bin'''</code> (<code>'''/bin'''</code> and <code>'''/usr/bin'''</code> inside MSYS) directory. You then need to:
# hack the <code>'''/usr/local/bin/autopoint'''</code> script so that prefix is defined as <code>'''/usr/local'''</code> instead of <code>'''/usr'''</code>.
# '''Warning!''' Ugly hack follows
:: Autopoint expects to find an <code>'''archive.tar.gz'''</code> in <code>'''usr/share'''</code>, so copy gettext (found on <code>'''usr/share/'''</code> on the archive) file structure to <code>'''/usr/share'''</code> also.

'''Update:''' If you insist a MSYS-compatible gettext-devel, try: http://downloads.sourceforge.net/mingw/gettext-devel-0.16.1-MSYS-1.0.11-1.tar.bz2
* As of this post, <code>'''gettext-devel-0.16.1-MSYS'''</code> is being tested for problem-free Synfig compile.

'''Note:''' If you reload the GTK+ devel environment, make sure that you rename the autopoint script and gettext so that they don't conflict with the ones in msys. GTK\bin tends to show up first in the path, and those versions get picked by default.

===[http://www.mktemp.org/ mktemp]===
Synfig requires mktemp for building, but for some unknown reason this tool is not installed by default in MinGW.

# Download the MinGW implementation of this tool from: http://downloads.sourceforge.net/mingw/mktemp-1.5-MSYS.tar.bz2 (4 Kb)
# Decompress mktemp.exe from this archive to <code>'''C:\msys\1.0\bin'''</code> directory.

===[http://darwinsys.com/file/ file]===
libtool requires the "file" tool to check filetypes of libraries.

# So we need to download it: http://downloads.sourceforge.net/mingw/file-4.16-MSYS-1.0.11-snapshot.tar.bz2 (236.2 Kb)
# Decompress content of directory file-4.16 from the archive to <code>'''C:\msys\1.0'''</code>.

===cygpath emulation===
As far as I read, Cygwin only supports paths like /C/somedir/somefile. MinGW can use native windows paths also. Cygwin has a special tool for this (and some another features). MinGW has not. But several Synfig configure scripts require this tool so it will be better to make it. Just save the following text as <code>C:\msys\1.0\bin\cygpath</code>:

<pre>#!/bin/sh
# A simple cygpath replacement

until [ -z "$1" ]
do
if [ "${1:0:1}" != "-" ]; then
echo $1 | sed -e 's/\\/\//g' -e 's/^$[a-zA-Z]$:/\/\1/g'
fi
shift
done</pre>

===[http://www.winterdrache.de/freeware/png2ico/index.html png2ico]===
Early version of Synfig used [http://www.kernel.org/pub/software/graphics/pngtoico/ pngtoico] tool to produce icons from png files. Unfortunately this tool is broken now. You can see this for youeself by installing the official build of Synfig Studio 0.61.05. The latest versions of Synfig using another tool: png2ico. This tool is not perfect, but it works.

# Download it from: http://www.winterdrache.de/freeware/png2ico/data/png2ico-win-2002-12-08.zip (89.9 Kb)
# And decompress png2ico.exe file to <code>'''C:\msys\1.0\bin'''</code> directory.

==Non MinGW packages==
===[http://subversion.tigris.org Subversion]===

Source code is now in GIT

Synfig source is stored in a subversion repository. You will need the svn client to get it. Also the svn client is required by the Synfig build scripts, to receive the revision number of the source.
You can download the Windows subversion package from this page:

* http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91

When I wrote this the latest version was 1.4.3:

* http://subversion.tigris.org/files/documents/15/36797/svn-1.4.3-setup.exe (3.58 Mb)

But it is best to get the newest available version.

===[http://sourceforge.net/projects/nsis/ NSIS]===
NSIS is the Nullsoft Scriptable Install System, a free and open source installer for WinAmp, a popular windows music player.
When I wrote this the latest version was 2.27:

* http://downloads.sourceforge.net/nsis/nsis-2.42-setup.exe (1.4 Mb)

You can use this or any newer version.

===[http://www.imagemagick.org ImageMagick]===
When I wrote this the latest version was 6.3.4-10:

* http://www.imagemagick.org/download/binaries/ImageMagick-6.4.8-3-Q16-windows-dll.exe (11 MB)

'''Note:''' The ''updated'' file has not been tested yet -- try here instead http://www.imagemagick.org/download/www/binary-releases.html#windows

ImageMagick is required to build Studio, also Core has an ImageMagick render target.

==Gtk+/Gtkmm==
===[http://www.gtk.org/ GTK+]===
Go to [http://gladewin32.sourceforge.net/modules/news/ this page] and download the latest GTK+ devel package for windows:

* http://gladewin32.sourceforge.net/modules/wfdownloads/visit.php?lid=110 (12 MB)

^^ These links are broken :( Pixelgeek is researching alternate solutions

Though it's not yet tested, you can try either:
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-2.exe (16.7 MB)
* http://downloads.sourceforge.net/gladewin32/gtk-dev-2.12.9-win32-1.exe (13,313 KB)

You need only install the following components:

* Gtk+ Runtime (required)
* Register Environment Variables
* Devel header/libraries

Confirm registration for environment: ''MSYS (C:\msys\1.0)''.

Install GTK+ to <code>C:\GTK</code>.

===[http://www.gtkmm.org/ GTKmm]===
Go to [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ this page] and download the latest GTKmm devel package for Windows:

* http://ftp.gnome.org/pub/gnome/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.8-1.exe (16.1 MB)

If you opted for '''gtk-dev-2.12.9-win32-2.exe''' or '''gtk-dev-2.12.9-win32-1.exe''' pick this instead.
* ftp://ftp.gnome.org/pub/GNOME/binaries/win32/gtkmm/2.10/gtkmm-win32-devel-2.10.11-1.exe (16.3 MB)

You need only install the following components (footnote 1):

* libsigc++
* cairomm
* glibmm
* gtkmm
* libxml++

(1) if you're using gtkmm-win32-devel-2.16.0-4.exe, then pangomm is a required component.

For each selected component you may keep only

* Runtime
* Development

subcategories. Install GTKmm to <code>'''C:\GTK'''</code>.

===Collision Resolution===
If you have several Gtk-applications (f.e. InkScape), you can receive a strange errors, like "''the procedure entry point XML_SetDoctypeDeclHandler could not be located in the dynamic link library xmlparse.dll''". Thats mean you have an old version of this library in windows system32 directory, installed by another program. Just search and rename/delete this old library and all will work perfectly again.

===Troubleshooting===
Test whether MSYS can find MinGW by running:

$ gcc --version

If it replies command not found, MSYS can't see MinGW. In that case, you will need to edit the text file C:\msys\1.0\etc\fstab so that it includes the line:

c:/MinGW /mingw