README

   1 MyPaint - drawing program with dynamic brushes for graphic tablets
   2
   3 Linux:
   4
   5         Compile and run:
   6         scons && ./mypaint
   7     There is currently no "make install" replacement.
   8
   9         Required: pygtk, python, swig, gtk, numpy, [maybe also scipy]
  10         Recommended: a pressure sensitive input device (graphic tablet)
  11
  12         Debian users need: python-gtk2-dev python-dev python-numpy swig
  13
  14
  15 Windows:
  16
  17         NOTE: This is still very experimental.
  18         If you'd much rather simply have a semi-recent pre-build version of MyPaint for Windows,
  19         downloads should be available on the website.
  20
  21         To build on a Windows platform there are a handful of things you need to setup before building.
  22         As the very first step you should make sure you have the following things installed correctly on your system:
  23
  24                 Tools:
  25                         SCons
  26                         MinGW (or the like)
  27                         Python 2.5 (or possibly above)
  28                         SWIG
  29                         pkg-config
  30
  31                 Libs:
  32                         GTK+
  33                         (And for Python:)
  34                         PyGTK
  35                         PyGObject
  36                         PyCairo
  37                         PIL
  38                         Numpy
  39                         Numeric ( This is the predecessor to Numpy, and dependency might depend on your choice of other libs - you might actually not need it )
  40
  41         When everything is installed you will most likely have to set the following Environmet Variables under Windows.
  42         These will naturally need to reflect the way you installed the above mentioned tools and libs.
  43         The variables and example values are given here:
  44
  45                 PATH                                            =       "C:\MinGW\bin;C:\GTK\bin;C:\swig;C:\Python25;C:\Python25\Scripts;"
  46                 PYTHONPATH                      =       "C:\Python25\Lib\site-packages"
  47                 PKG_CONFIG_PATH =       "C:\Python25\Lib\pkgconfig"
  48
  49                 ( The following is handy for debugging purpose, but should only be use when needed - NOT required ! )
  50                 PYTHONVERBOSE           =       "1"
  51
  52         Along the line you will most likely also have to make the missing ".pc" files for pkg-config.
  53         These should be put in one of the locations specified in PKG_CONFIG_PATH.
  54         Here you should have the following files:
  55
  56                 numpy.pc
  57                 pycairo.pc
  58                 pygobject-2.0.pc
  59                 pygtk-2.0.pc
  60                 python25.pc
  61
  62         If they do not exist and are not found elsewhere in PKG_CONFIG_PATH, you have to write them yourself.
  63         These files are rather simple, containing only a few lines.
  64         If you're not able to create these yourself by trial'n'error, try Google some info on the format.
  65
  66         Fortunately once everything is set up building should be a smooth process.
  67         Open the Command Prompt and simply follow these two steps:
  68
  69                 "cd \mypaint-trunk\"            To go the dir containing the downloaded source code.
  70                 "scons"                                                                 Start up SCons and have it read the SConstruct script.
  71                                                                                                                 This is the where 'mypaint.dll' and 'mypaint.exe' (hopefully) are build.
  72
  73         Now the remaining problem is to boil it all down to a reasonable clean set of files.
  74         At this stage you will have to experiment a lot - and again utilize your trial'n'error skills.
  75         Some of the files you'll most likely need to find are:
  76
  77                 ( in no particular order )
  78
  79                 libglib-2.0-0.dll,              libgobject-2.0-0.dll,                   libpangowin32-1.0-0.dll,
  80                 libgmodule-2.0-0.dll,   libgdk_pixbuf-2.0-0.dll,        libgthread-2.0-0.dll,
  81                 libcairo-2.dll,                         libpangocairo-1.0-0.dll,        libgdk-win32-2.0-0.dll,
  82                 libatk-1.0-0.dll,                       libgio-2.0-0.dll,                                       libgtk-win32-2.0-0.dll
  83                 libpng12-0.dll,                         libpango-1.0-0.dll,
  84
  85                 zlib1.dll,      jpeg62.dll,             libtiff3.dll,
  86                 tk84.dll,               tcl84.dll,
  87
  88                 python25.dll,           MSVCR71.dll,    w9xpopen.exe,
  89
  90                 numpy.core.umath.pyd,                           numpy.lib._compiled_base.pyd,
  91                 numpy.core.multiarray.pyd,      numpy.core.scalarmath.pyd,
  92                 numpy.fft.fftpack_lite.pyd,     numpy.core._sort.pyd,
  93                 numpy.random.mtrand.pyd,                numpy.linalg.lapack_lite.pyd,
  94
  95                 gtk._gtk.pyd,           gobject._gobject.pyd,           cairo._cairo.pyd
  96
  97         This stage is just insanity for you perfectinists out there. Noone will mind if you skip this step.
  98         Likely MyPaint will run just fine, finding these files elsewhere on your system.
  99         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,
 100         you'll still have to have these files in the directory you keep 'mypaint.exe'.
 101
 102         Good luck !
 103
 104         PS: If you give up along the way there should be semi-recent builds available on the website.
 105         PPS: Much in line with all the shared libs metioned above,
 106                 the exe file is build to import two files 'python25.zip' and 'site-packages.zip'.
 107                 These files were ment to hold any addictional python scripts needed.
 108                 Examine the files from the recent Windows builds on the website for reference.
 109
 110 Project homepage:
 111 http://mypaint.intilinux.com/
 112 http://gna.org/projects/mypaint/
 113
 114 The license for this program is in the file COPYING.