home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 November / CPNL0711.ISO / communic / email / Evolution-2.8.2-2.msi / Data1.cab / gtkmm_win32_runtime_2.10.7_1 / gtkmm_win32.txt next >
Text File  |  2006-10-01  |  6KB  |  160 lines
  1.  
  2.  
  3.         Gtkmm on the Win32 platform
  4.         ***************************
  5.  
  6.  
  7. Content
  8. -------
  9.  
  10.     1. Building gtkmm on Win32
  11.         1.1 Mingw
  12.         1.2 MS Visual Studio 2005
  13.     2. Using the binaries and building your gtkmm application
  14.         2.1 Mingw
  15.         2.2 MS Visual Studio 2005
  16.     3. Gtkmm methods and signals not available on win32
  17.     4. Gtkmm examples and demos on win32
  18.  
  19.  
  20. 1. Building gtkmm on Win32
  21.    ========================
  22.  
  23. Currently, both the mingw (native win32) gcc compiler and MS Visual
  24. Studio 2005 are supported. gtkmm can be built with mingw32-gcc using
  25. the gnu autotools (automake, autoconf, libtool). As explicitly
  26. stated in the gtk+ for win32 distribution (http://www.gimp.org/win32/),
  27. the gcc compiler provided by the cygwin distribution should not be
  28. used to build gtk+/gtkmm libraries and/or applications (see the
  29. README.win32 that comes with the gtk+ DLLs). This MIGHT cause
  30. conflicts between the cygwin and msvcrt runtime environments.
  31.  
  32. 1.1. Mingw
  33.      -----
  34.  
  35. The mingw distribution which has been tested with this release is the
  36. following :
  37.  
  38. * MinGW-4.1 as the base distribution.
  39.  
  40. The bare mingw distribution does not provide the necessary tools (sh, perl, m4
  41. , autoconf, automake, ..) to run the provided configure script "as is". One 
  42. (currently non supported) solution is to use mingw in conjunction with msys,
  43. which is readily available on the mingw website (http://www.mingw.org/).
  44.  
  45. The preferred method is to combine the cygwin distribution (for the unix tools
  46. that were mentioned above) with mingw by making sure that the mingw
  47. tools (gcc, ld, dlltool, ..) are called first.
  48.  
  49. First, make sure that you have working distribution of the native port
  50. of both libsigc++-2.0.x and gtk+-2.0 on win32 (see
  51. http://www.gimp.org/win32). If you can't compile a simple gtk+ example
  52. using gcc and `pkg-config --cflags --libs`, you should not even think
  53. about trying to compile gtkmm, let alone using precompiled libgtkmm
  54. DLLs to port your gtkmm application !
  55.  
  56. The configure script can then be called using (as an example) the
  57. following options
  58.  
  59. ./configure --prefix=/target --build=i386-pc-mingw32 --disable-static
  60.  
  61. then
  62.  
  63. make
  64. make check
  65. make install
  66.  
  67. 1.2. MS Visual Studio 2005
  68.      ---------------------
  69.  
  70. Open the gtkmm.sln solution file in the MSVC_Net2003 directory. In
  71. the Tools/Options panel, add the appropriate GTK+, glibmm include and lib
  72. directories to the Projects and Solutions/VC++ directories. Build the
  73. solution. 
  74.  
  75. Important NOTE : to circumvent the C++ compiler bug described in this
  76. bugzilla entry (http://bugzilla.gnome.org/show_bug.cgi?id=158040), it
  77. is necessary to add '/vd2' to the list of compiler options when
  78. building and/or using gtkmm with Visual Studio 2005. 
  79.  
  80. gtkmm-2.10 will probably not work correctly with Visual Studio 7.1 or
  81. below because of the aforementioned bug.
  82.  
  83. 2. Using the binaries and building your gtkmm application
  84. =============================================================
  85.  
  86.  
  87. 2.1. Mingw
  88.      -----
  89.  
  90. To build your gtkmm application, it is recommended to either use mingw
  91. combined with cygwin (http://www.cygwin.com) or msys
  92. (http://www.mingw.org). If you use mingw/cygwin, make sure that the
  93. directory that contains the mingw executables is first in your PATH
  94. (by checking with g++ -v). Then
  95.  
  96. 1. Add the directories with the gtkmm, gtk+ DLLs and the gtk+
  97. executables (especially the one containing pkg-config.exe) to your
  98. path. If you have selected the corresponding option in the Gtkmm
  99. installer, both the gtkmm and gtk+ runtime will already be in your
  100. PATH. Make sure pkg-config is available by typing 'pkg-config --version'
  101.  
  102. 2. Set the PKG_CONFIG_PATH environment variable to point to the various
  103. lib/pkgconfig directories. Look for files with the .pc extension in
  104. the gtk+ and gtkmm developer packages. It's basically the same syntax
  105. as on linux but the directory are separated by semicolons.
  106.  
  107. 3. Check the gtkmm distribution by typing 'pkg-config --modversion
  108. --cflags --libs gtkmm-2.4'. You should get something like
  109.  
  110. 2.10.1
  111. -IC:/target/include/gtkmm-2.4
  112. -IC:/target/lib/gtkmm-2.4/include 
  113. -IC:/target/include/glibmm-2.4 
  114. -IC:/target/lib/glibmm-2.4/include 
  115. -IC:/target/include/gdkmm-2.4
  116. -IC:/target/lib/gdkmm-2.4/include 
  117. -IC:/target/include/pangomm-1.4 
  118. -IC:/target/include/atkmm-1.6 
  119. -IC:/target/include/sigc++-2.0 
  120. -IC:/target/lib/sigc++-2.0/include 
  121. -IC:/GTK/include/gtk-2.0 
  122. -IC:/GTK/include/glib-2.0 
  123. -IC:/GTK/lib/glib-2.0/include 
  124. -IC:/GTK/lib/gtk-2.0/include 
  125. -IC:/GTK/include/pango-1.0 
  126. -IC:/GTK/include/atk-1.0
  127. -LC:/target/lib 
  128. -LC:/GTK/lib 
  129. -lgtkmm-2.4 -lgdkmm-2.4 -latkmm-1.6 -lgtk-win32-2.0 
  130. -lpangomm-1.4 -lglibmm-2.4 -lsigc-2.0 -lgdk-win32-2.0 
  131. -latk-1.0 -lgdk_pixbuf-2.0 -lpangowin32-1.0 -lgdi32 
  132. -lpango-1.0 -lgobject-2.0 -lgmodule-2.0 -lglib-2.0 -lintl -liconv
  133.  
  134. Of course, the target directories will reflect your local installation
  135. tree.
  136.  
  137. 4. Compile your program with
  138.  
  139. g++ `pkg-config --cflags gtkmm-2.4` my_programs.cc -o my_program 
  140. `pkg-config --libs gtkmm-2.4`
  141.  
  142. Alternatively, you can adapt the above compiler and linker flags to
  143. your directory structure...
  144.  
  145. 2.2. MS Visual Studio 2005
  146.      --------------------- 
  147.  
  148. To build a gtkmm project with MS Visual Studio 2005 or Visual C++ 2005, simply create a new project and add the MSVC/gtkmm-2.4d.vsprops or MSVC/gtkmm-2.4.vsprops project sheets to the project for a Debug and Release target, respectively. See the MSDN documentation for more information on how to use project sheets. Add source and header files to the project, set the name of the executable to be created in the project properties, and build  the solution/project.  
  149.  
  150. 3. Gtkmm methods and signals not available on win32
  151. ===================================================
  152.  
  153. All gtkmm methods and signals are available on win32.
  154.  
  155. 4. Gtkmm examples and demos on win32
  156. ====================================
  157.  
  158. All demos and examples compile/run on win32
  159.  
  160.