1 MyPaint - drawing program with dynamic brushes for graphic tablets
3 The license is described in the file LICENSE.
4 Documentation can be found within the program and on the homepage:
6 A list of contributors can be found in the about dialog.
17 # scons prefix=/usr/local install
21 # scons prefix=/usr/local install --clean
23 Install (for packagers):
25 $ scons prefix=/usr --install-sandbox=path/to/sandbox
28 Required: pygtk, python, swig, gtk, numpy, pycairo(>=1.4), libpng
30 Debian users can fetch these dependencies by running:
32 # apt-get install g++ python-dev libglib2.0-dev python-numpy \
33 swig scons gettext libpng12-dev
35 Recommended: a pressure sensitive input device (graphic tablet)
38 Take care to update the icon theme cache for your $prefix if you're
39 installing mypaint to a location which has one of these files already. If
40 you install new icons, any existing icon cache must be updated too,
41 otherwise MyPaint won't be able to find its icons even if it looks in the
42 right place. For example for an install into /usr (which has one on most
43 systems), you should run
45 $ gtk-update-icon-cache /usr/share/icons/hicolor
46 $ chmod a+r /usr/share/icons/hicolor/icon-theme.cache
48 after installation to ensure that the cache is up to date. Scons won't
49 do this for you because the cache file is optional.
54 NOTE: This is still very experimental.
55 If you'd much rather simply have a semi-recent pre-build version of MyPaint for Windows,
56 downloads should be available on the website.
58 NOTE: This page might contain more up to date instructions:
59 http://opensourcepack.blogspot.com/2009/08/building-mypaint-in-windows.html
61 To build on a Windows platform there are a handful of things you need to setup before building.
62 As the very first step you should make sure you have the following things installed correctly on your system:
67 Python 2.5 (or possibly above)
79 Numeric ( This is the predecessor to Numpy, and dependency might depend on your choice of other libs - you might actually not need it )
81 When everything is installed you will most likely have to set the following Environmet Variables under Windows.
82 These will naturally need to reflect the way you installed the above mentioned tools and libs.
83 The variables and example values are given here:
85 PATH = "C:\MinGW\bin;C:\GTK\bin;C:\swig;C:\Python25;C:\Python25\Scripts;"
86 PYTHONPATH = "C:\Python25\Lib\site-packages"
87 PKG_CONFIG_PATH = "C:\Python25\Lib\pkgconfig"
89 ( The following is handy for debugging purpose, but should only be use when needed - NOT required ! )
92 Along the line you will most likely also have to make the missing ".pc" files for pkg-config.
93 These should be put in one of the locations specified in PKG_CONFIG_PATH.
94 Here you should have the following files:
102 If they do not exist and are not found elsewhere in PKG_CONFIG_PATH, you have to write them yourself.
103 These files are rather simple, containing only a few lines.
104 If you're not able to create these yourself by trial'n'error, try Google some info on the format.
106 Fortunately once everything is set up building should be a smooth process.
107 Open the Command Prompt and simply follow these two steps:
109 "cd \mypaint-trunk\" To go the dir containing the downloaded source code.
110 "scons" Start up SCons and have it read the SConstruct script.
111 This is the where 'mypaint.dll' and 'mypaint.exe' (hopefully) are build.
113 Now the remaining problem is to boil it all down to a reasonable clean set of files.
114 At this stage you will have to experiment a lot - and again utilize your trial'n'error skills.
115 Some of the files you'll most likely need to find are:
117 ( in no particular order )
119 libglib-2.0-0.dll, libgobject-2.0-0.dll, libpangowin32-1.0-0.dll,
120 libgmodule-2.0-0.dll, libgdk_pixbuf-2.0-0.dll, libgthread-2.0-0.dll,
121 libcairo-2.dll, libpangocairo-1.0-0.dll, libgdk-win32-2.0-0.dll,
122 libatk-1.0-0.dll, libgio-2.0-0.dll, libgtk-win32-2.0-0.dll
123 libpng12-0.dll, libpango-1.0-0.dll,
125 zlib1.dll, jpeg62.dll, libtiff3.dll,
128 python25.dll, MSVCR71.dll, w9xpopen.exe,
130 numpy.core.umath.pyd, numpy.lib._compiled_base.pyd,
131 numpy.core.multiarray.pyd, numpy.core.scalarmath.pyd,
132 numpy.fft.fftpack_lite.pyd, numpy.core._sort.pyd,
133 numpy.random.mtrand.pyd, numpy.linalg.lapack_lite.pyd,
135 gtk._gtk.pyd, gobject._gobject.pyd, cairo._cairo.pyd
137 This stage is just insanity for you perfectinists out there. Noone will mind if you skip this step.
138 Likely MyPaint will run just fine, finding these files elsewhere on your system.
139 BUT! if it turns out it doesn't or if you need to run MyPaint on other systems than the one you build it on,
140 you'll still have to have these files in the directory you keep 'mypaint.exe'.
144 PS: If you give up along the way there should be semi-recent builds available on the website.
145 PPS: Much in line with all the shared libs metioned above,
146 the exe file is build to import two files 'python25.zip' and 'site-packages.zip'.
147 These files were ment to hold any addictional python scripts needed.
148 Examine the files from the recent Windows builds on the website for reference.