CEGUI Wiki - Crazy Eddie's GUI System (Open Source) - User contributions [en]

Build PyCEGUI from source for Linux

2012-01-07T20:10:52Z

Morgul: Fixed incorrect patch

{{VersionBadge|0.7}} {{VersionAtLeast|0.7.4}}
= Ubuntu Flavors =
Version shipped in repositories is 0.6.0 (as of 7th July 2011) so if we want 0.7.x we need to build it from source.

== Ubuntu 11.04 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libglut3-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
First, we move the contents of site-packages to dist-packages.
sudo mv /usr/local/lib/python2.6/site-packages/* /usr/local/lib/python2.6/dist-packages/
Now, we remove site-packages, and symlink it to dist-packages
sudo rmdir /usr/local/lib/python2.6/site-packages
sudo ln -s /usr/local/lib/python2.6/dist-packages/ /usr/local/lib/python2.6/site-packages
* Build CEGUI with python support
./configure && make && sudo make install && sudo ldconfig
* ''Note: On some Ubuntu systems it seems that CEGUI's configure system does not correctly detect the Python headers. To solve this, do the following:''
export CXXFLAGS=-I/usr/include/python2.7
./configure && make && sudo make install && sudo ldconfig
== Ubuntu 11.10 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev libtool autoconf</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
First, we move the contents of site-packages to dist-packages.
sudo mv /usr/local/lib/python2.7/site-packages/* /usr/local/lib/python2.7/dist-packages/
Now, we remove site-packages, and symlink it to dist-packages
sudo rmdir /usr/local/lib/python2.7/site-packages
sudo ln -s /usr/local/lib/python2.7/dist-packages/ /usr/local/lib/python2.7/site-packages

* Patch CEGUI:
There are two patched required to make CEGUI 0.7.5 compile correctly with python support, on 11.10. They are:

'''ptrdiff_t.patch'''
<code>
--- cegui/include/CEGUIString.h 2011-05-11 13:36:22.091872287 -0500
+++ cegui/include/CEGUIString.h.new 2011-05-11 13:38:04.387704592 -0500
@@ -34,6 +34,7 @@
#include <string>
#include <string.h>
#include <stdexcept>
+#include <cstddef>

// Start of CEGUI namespace section
namespace CEGUI
</code>

'''python27.patch'''
<code>
--- acinclude.m4 2011-02-18 14:31:36.736126680 -0600
+++ src/CEGUI-0.7.5/acinclude.m4 2011-02-18 14:47:26.379459922 -0600
@@ -1394,7 +1394,7 @@
AC_DEFUN([AX_PYTHON],
[AC_MSG_CHECKING(for python build information)
AC_MSG_RESULT([])
-for python in python2.6 python2.5 python2.4 python2.3 python2.2 python2.1 python; do
+for python in python2.7 python2.6 python2.5 python2.4 python2.3 python2.2 python2.1 python2 python; do
AC_CHECK_PROGS(PYTHON_BIN, [$python])
ax_python_bin=$PYTHON_BIN
if test x$ax_python_bin != x; then
</code>

Copy the contents of the code blocks above, and paste them into files of the correct name (ptrdiff_t.patch and python27.patch respectively). Then apply the patched like so:
$ patch -p0 < ptrdiff_t.patch
$ patch -p0 < python27.patch
* Regenerate configure:
$ ./bootstrap
* Build CEGUI with python support
./configure --disable-external-tinyxml && make && sudo make install && sudo ldconfig
''Note: The tinyXML shipping with Ubuntu 11.10 is too new, and doesn't compile, hence we disable it.''

= Still not working? =
You can try running your program with:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" python <file.py>

'''Note for Panda3D users'''
You can run your program at the same way, using:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" ppython <file.py>

[[Category:HowTo]]

Build PyCEGUI from source for Linux

2012-01-07T20:09:37Z

Morgul: /* Ubuntu 11.10 */

{{VersionBadge|0.7}} {{VersionAtLeast|0.7.4}}
= Ubuntu Flavors =
Version shipped in repositories is 0.6.0 (as of 7th July 2011) so if we want 0.7.x we need to build it from source.

== Ubuntu 11.04 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libglut3-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
First, we move the contents of site-packages to dist-packages.
sudo mv /usr/local/lib/python2.6/site-packages/* /usr/local/lib/python2.6/dist-packages/
Now, we remove site-packages, and symlink it to dist-packages
sudo rmdir /usr/local/lib/python2.6/site-packages
sudo ln -s /usr/local/lib/python2.6/dist-packages/ /usr/local/lib/python2.6/site-packages
* Build CEGUI with python support
./configure && make && sudo make install && sudo ldconfig
* ''Note: On some Ubuntu systems it seems that CEGUI's configure system does not correctly detect the Python headers. To solve this, do the following:''
export CXXFLAGS=-I/usr/include/python2.7
./configure && make && sudo make install && sudo ldconfig
== Ubuntu 11.10 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev libtool autoconf</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
First, we move the contents of site-packages to dist-packages.
sudo mv /usr/local/lib/python2.7/site-packages/* /usr/local/lib/python2.7/dist-packages/
Now, we remove site-packages, and symlink it to dist-packages
sudo rmdir /usr/local/lib/python2.7/site-packages
sudo ln -s /usr/local/lib/python2.7/dist-packages/ /usr/local/lib/python2.7/site-packages

* Patch CEGUI:
There are two patched required to make CEGUI 0.7.5 compile correctly with python support, on 11.10. They are:

'''ptrdiff_t.patch'''
<code>
--- cegui/include/CEGUIString.h 2011-05-11 13:36:22.091872287 -0500
+++ cegui/include/CEGUIString.h.new 2011-05-11 13:38:04.387704592 -0500
@@ -34,6 +34,7 @@
#include <string>
#include <string.h>
#include <stdexcept>
+#include <cstddef>

// Start of CEGUI namespace section
namespace CEGUI
</code>

'''python27.patch'''
<code>
--- cegui/include/CEGUIString.h 2011-05-11 13:36:22.091872287 -0500
+++ cegui/include/CEGUIString.h.new 2011-05-11 13:38:04.387704592 -0500
@@ -34,6 +34,7 @@
#include <string>
#include <string.h>
#include <stdexcept>
+#include <cstddef>

// Start of CEGUI namespace section
namespace CEGUI
</code>

Copy the contents of the code blocks above, and paste them into files of the correct name (ptrdiff_t.patch and python27.patch respectively). Then apply the patched like so:
$ patch -p0 < ptrdiff_t.patch
$ patch -p0 < python27.patch
* Regenerate configure:
$ ./bootstrap
* Build CEGUI with python support
./configure --disable-external-tinyxml && make && sudo make install && sudo ldconfig
''Note: The tinyXML shipping with Ubuntu 11.10 is too new, and doesn't compile, hence we disable it.''

= Still not working? =
You can try running your program with:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" python <file.py>

'''Note for Panda3D users'''
You can run your program at the same way, using:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" ppython <file.py>

[[Category:HowTo]]

Build PyCEGUI from source for Linux

2012-01-07T02:24:57Z

Morgul: Changes the dist-packages hack to be safer, in case the user has files installed in site-packages. Then, just to be even more paranoid, we still only use rmdir, in case the mv failed.

{{VersionBadge|0.7}} {{VersionAtLeast|0.7.4}}
= Ubuntu Flavors =
Version shipped in repositories is 0.6.0 (as of 7th July 2011) so if we want 0.7.x we need to build it from source.

== Ubuntu 11.04 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libglut3-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
First, we move the contents of site-packages to dist-packages.
sudo mv /usr/local/lib/python2.6/site-packages/* /usr/local/lib/python2.6/dist-packages/
Now, we remove site-packages, and symlink it to dist-packages
sudo rmdir /usr/local/lib/python2.6/site-packages
sudo ln -s /usr/local/lib/python2.6/dist-packages/ /usr/local/lib/python2.6/site-packages
* Build CEGUI with python support
./configure && make && sudo make install && sudo ldconfig
* ''Note: On some Ubuntu systems it seems that CEGUI's configure system does not correctly detect the Python headers. To solve this, do the following:''
export CXXFLAGS=-I/usr/include/python2.7
./configure && make && sudo make install && sudo ldconfig
== Ubuntu 11.10 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev libtool autoconf</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
First, we move the contents of site-packages to dist-packages.
sudo mv /usr/local/lib/python2.7/site-packages/* /usr/local/lib/python2.7/dist-packages/
Now, we remove site-packages, and symlink it to dist-packages
sudo rmdir /usr/local/lib/python2.7/site-packages
sudo ln -s /usr/local/lib/python2.7/dist-packages/ /usr/local/lib/python2.7/site-packages

* Patch CEGUI:
There are two patched required to make CEGUI 0.7.5 compile correctly with python support, on 11.10. They are:

'''ptrdif_t.patch'''
<code>
--- cegui/include/CEGUIString.h 2011-05-11 13:36:22.091872287 -0500
+++ cegui/include/CEGUIString.h.new 2011-05-11 13:38:04.387704592 -0500
@@ -34,6 +34,7 @@
#include <string>
#include <string.h>
#include <stdexcept>
+#include <cstddef>

// Start of CEGUI namespace section
namespace CEGUI
</code>

'''python27.patch'''
<code>
--- cegui/include/CEGUIString.h 2011-05-11 13:36:22.091872287 -0500
+++ cegui/include/CEGUIString.h.new 2011-05-11 13:38:04.387704592 -0500
@@ -34,6 +34,7 @@
#include <string>
#include <string.h>
#include <stdexcept>
+#include <cstddef>

// Start of CEGUI namespace section
namespace CEGUI
</code>

Copy the contents of the code blocks above, and paste them into files of the correct name (ptrdiff_t.patch and python27.patch respectively). Then apply the patched like so:
$ patch -p0 < ptrdiff_t.patch
$ patch -p0 < python27.patch
* Regenerate configure:
$ ./bootstrap
* Build CEGUI with python support
./configure --disable-external-tinyxml && make && sudo make install && sudo ldconfig
''Note: The tinyXML shipping with Ubuntu 11.10 is too new, and doesn't compile, hence we disable it.''

= Still not working? =
You can try running your program with:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" python <file.py>

'''Note for Panda3D users'''
You can run your program at the same way, using:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" ppython <file.py>

[[Category:HowTo]]

Talk:Build PyCEGUI from source for Linux

2012-01-07T02:10:34Z

Morgul:

== Thoughts ==
A good topic, one close to my heart.

I am curious, though; in this snippet:

<code>
sudo rmdir /usr/local/lib/python2.6/site-packages
sudo ln -s /usr/local/lib/python2.6/dist-packages/ /usr/local/lib/python2.6/site-packages
</code>

* If 'site-packages' is not empty, that command will fail; an 'rm -r' would be necessary, but in that case it means the directory might have valuable contents.
* Which leads to my next question: is deleting that directory a good idea? Could it cause future problems with some other arbitrary piece of software?
- [[User:Crond|Crond]] 11:30, 10 July 2011 (UTC)

There should be a note about this, I agree. See, here's the problem: Ubuntu installs python in a non-standard location; dist-packages. Ubuntu's python doesn't add site-packages to the python path. This hack, provided there's no valuable contents in site-packages, is perfectly safe. (I've run into the problem, and used this solution, in a lot of installs. It even works across upgrades.)

Basically, the crux of all of this is that contents of site-packages needs to be copied over to dist-packages first, and then those steps can be performed. I'll make a note on the page.

- [[User:Morgul|Morgul]] 02:10, 06 Jan 2012 (UTC)

Build PyCEGUI from source for Linux

2012-01-06T19:56:34Z

Morgul: /* Ubuntu 11.10 */

{{VersionBadge|0.7}} {{VersionAtLeast|0.7.4}}
= Ubuntu Flavors =
Version shipped in repositories is 0.6.0 (as of 7th July 2011) so if we want 0.7.x we need to build it from source.

== Ubuntu 11.04 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libglut3-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
sudo rmdir /usr/local/lib/python2.6/site-packages
sudo ln -s /usr/local/lib/python2.6/dist-packages/ /usr/local/lib/python2.6/site-packages
* Build CEGUI with python support
./configure && make && sudo make install && sudo ldconfig
* ''Note: On some Ubuntu systems it seems that CEGUI's configure system does not correctly detect the Python headers. To solve this, do the following:''
export CXXFLAGS=-I/usr/include/python2.7
./configure && make && sudo make install && sudo ldconfig
== Ubuntu 11.10 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev libtool autoconf</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
sudo rmdir /usr/local/lib/python2.7/site-packages
sudo ln -s /usr/local/lib/python2.7/dist-packages/ /usr/local/lib/python2.7/site-packages

* Patch CEGUI:
There are two patched required to make CEGUI 0.7.5 compile correctly with python support, on 11.10. They are:

'''ptrdif_t.patch'''
<code>
--- cegui/include/CEGUIString.h 2011-05-11 13:36:22.091872287 -0500
+++ cegui/include/CEGUIString.h.new 2011-05-11 13:38:04.387704592 -0500
@@ -34,6 +34,7 @@
#include <string>
#include <string.h>
#include <stdexcept>
+#include <cstddef>

// Start of CEGUI namespace section
namespace CEGUI
</code>

'''python27.patch'''
<code>
--- cegui/include/CEGUIString.h 2011-05-11 13:36:22.091872287 -0500
+++ cegui/include/CEGUIString.h.new 2011-05-11 13:38:04.387704592 -0500
@@ -34,6 +34,7 @@
#include <string>
#include <string.h>
#include <stdexcept>
+#include <cstddef>

// Start of CEGUI namespace section
namespace CEGUI
</code>

Copy the contents of the code blocks above, and paste them into files of the correct name (ptrdiff_t.patch and python27.patch respectively). Then apply the patched like so:
$ patch -p0 < ptrdiff_t.patch
$ patch -p0 < python27.patch
* Regenerate configure:
$ ./bootstrap
* Build CEGUI with python support
./configure --disable-external-tinyxml && make && sudo make install && sudo ldconfig
''Note: The tinyXML shipping with Ubuntu 11.10 is too new, and doesn't compile, hence we disable it.''

= Still not working? =
You can try running your program with:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" python <file.py>

'''Note for Panda3D users'''
You can run your program at the same way, using:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" ppython <file.py>

[[Category:HowTo]]

Build PyCEGUI from source for Linux

2012-01-06T18:37:51Z

Morgul: Fixed formatting.

{{VersionBadge|0.7}} {{VersionAtLeast|0.7.4}}
= Ubuntu Flavors =
Version shipped in repositories is 0.6.0 (as of 7th July 2011) so if we want 0.7.x we need to build it from source.

== Ubuntu 11.04 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libglut3-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
sudo rmdir /usr/local/lib/python2.6/site-packages
sudo ln -s /usr/local/lib/python2.6/dist-packages/ /usr/local/lib/python2.6/site-packages
* Build CEGUI with python support
./configure && make && sudo make install && sudo ldconfig
* ''Note: On some Ubuntu systems it seems that CEGUI's configure system does not correctly detect the Python headers. To solve this, do the following:''
export CXXFLAGS=-I/usr/include/python2.7
./configure && make && sudo make install && sudo ldconfig
== Ubuntu 11.10 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev libtool autoconf</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
sudo rmdir /usr/local/lib/python2.7/site-packages
sudo ln -s /usr/local/lib/python2.7/dist-packages/ /usr/local/lib/python2.7/site-packages

* Patch CEGUI:
There are two patched required to make CEGUI 0.7.5 compile correctly with python support, on 11.10. They are:

'''ptrdif_t.patch'''
<code>
--- cegui/include/CEGUIString.h 2011-05-11 13:36:22.091872287 -0500
+++ cegui/include/CEGUIString.h.new 2011-05-11 13:38:04.387704592 -0500
@@ -34,6 +34,7 @@
#include <string>
#include <string.h>
#include <stdexcept>
+#include <cstddef>

// Start of CEGUI namespace section
namespace CEGUI
</code>

'''python27.patch'''
<code>
--- cegui/include/CEGUIString.h 2011-05-11 13:36:22.091872287 -0500
+++ cegui/include/CEGUIString.h.new 2011-05-11 13:38:04.387704592 -0500
@@ -34,6 +34,7 @@
#include <string>
#include <string.h>
#include <stdexcept>
+#include <cstddef>

// Start of CEGUI namespace section
namespace CEGUI
</code>

Copy the contents of the code blocks above, and paste them into files of the correct name (ptrdiff_t.patch and python27.patch respectively). Then apply the patched like so:
$ patch -p0 < ptrdiff_t.patch
$ patch -p0 < python27.patch
* Regenerate configure:
$ ./bootstrap
* Build CEGUI with python support
./configure && make && sudo make install && sudo ldconfig

= Still not working? =
You can try running your program with:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" python <file.py>

'''Note for Panda3D users'''
You can run your program at the same way, using:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" ppython <file.py>

[[Category:HowTo]]

Build PyCEGUI from source for Linux

2012-01-06T18:36:47Z

Morgul: Updated instructions for ubuntu 11.10, including required patches, and python 2.7 support.

{{VersionBadge|0.7}} {{VersionAtLeast|0.7.4}}
= Ubuntu Flavors =
Version shipped in repositories is 0.6.0 (as of 7th July 2011) so if we want 0.7.x we need to build it from source.

== Ubuntu 11.04 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libglut3-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
sudo rmdir /usr/local/lib/python2.6/site-packages
sudo ln -s /usr/local/lib/python2.6/dist-packages/ /usr/local/lib/python2.6/site-packages
* Build CEGUI with python support
./configure && make && sudo make install && sudo ldconfig
* ''Note: On some Ubuntu systems it seems that CEGUI's configure system does not correctly detect the Python headers. To solve this, do the following:''
export CXXFLAGS=-I/usr/include/python2.7
./configure && make && sudo make install && sudo ldconfig
== Ubuntu 11.10 ==
* Install dependency packages: <code>sudo apt-get install build-essential pkg-config python-dev libfreetype6-dev libpcre3-dev libboost-python-dev libpng-dev libmng-dev libjpeg-dev libfreeimage-dev libtool autoconf</code>
* Obtain a copy of CEGUI [http://prdownloads.sourceforge.net/crayzedsgui/CEGUI-0.7.5.tar.gz?download here]
* Extract to a folder
* Before we build, we have to symlink the site-packages directory correctly, so it installs to the correct place.
sudo rmdir /usr/local/lib/python2.7/site-packages
sudo ln -s /usr/local/lib/python2.7/dist-packages/ /usr/local/lib/python2.7/site-packages

* Patch CEGUI:
There are two patched required to make CEGUI 0.7.5 compile correctly with python support, on 11.10. They are:
'''ptrdif_t.patch'''
<code>
--- cegui/include/CEGUIString.h 2011-05-11 13:36:22.091872287 -0500
+++ cegui/include/CEGUIString.h.new 2011-05-11 13:38:04.387704592 -0500
@@ -34,6 +34,7 @@
#include <string>
#include <string.h>
#include <stdexcept>
+#include <cstddef>

// Start of CEGUI namespace section
namespace CEGUI
</code>

'''python27.patch'''
<code>
--- cegui/include/CEGUIString.h 2011-05-11 13:36:22.091872287 -0500
+++ cegui/include/CEGUIString.h.new 2011-05-11 13:38:04.387704592 -0500
@@ -34,6 +34,7 @@
#include <string>
#include <string.h>
#include <stdexcept>
+#include <cstddef>

// Start of CEGUI namespace section
namespace CEGUI
</code>

Copy the contents of the code blocks above, and paste them into files of the correct name (ptrdiff_t.patch and python27.patch respectively). Then apply the patched like so:
$ patch -p0 < ptrdiff_t.patch
$ patch -p0 < python27.patch
* Regenerate configure:
$ ./bootstrap
* Build CEGUI with python support
./configure && make && sudo make install && sudo ldconfig

= Still not working? =
You can try running your program with:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" python <file.py>

'''Note for Panda3D users'''
You can run your program at the same way, using:
PYTHONPATH="/usr/local/lib/python2.6/site-packages:$PYTHONPATH" ppython <file.py>

[[Category:HowTo]]

Obtaining the library source from Subversion

2006-05-17T22:13:23Z

Morgul: Updated for latest SVN changes

All the code for CrazyEddie's GUI System (and the layout editor) is kept in a revision control system known as [[Subversion]](SVN). This is a tool that allows us to easily track changes to the code (who did what, and when), to maintain multiple different versions (branches) for the code, and, where necessary, undo, revert, or merge code changes.

Generally speaking, each stable release series has a seperate branch, and any changes made on those branches are largely bug-fixes and non-breaking (where possible) changes. The main 'trunk' code is where the latest and greatest code can be found, although this version of the code is generally to be considered as unstable / testing code. On the whole, we maintain two branches at once; whichever is the latest 'stable' branch, and the main trunk code. When a new release is made, previous release branches are generally considered obsolete (this will continue at least until we reach version 1.0.0 - at this stage we may consider maintaining support for multiple released versions).

It is possible to browse the SVN repository online by visiting http://svn.sourceforge.net/viewcvs.cgi/crayzedsgui/cegui_mk2/

= Getting the Code =
To obtain the code you use the Subversion client command 'svn', and the command is to get the trunk code is simply:

svn co <nowiki>https://svn.sourceforge.net/svnroot/crayzedsgui/cegui_mk2/trunk</nowiki> cegui_mk2-trunk

This will 'checkout' the code from SVN, and place it in the directory 'cegui_mk2-trunk'

If you want to obtain the latest code in from one of the stable branches, then the command you should issue is:

svn co <nowiki>https://svn.sourceforge.net/svnroot/crayzedsgui/cegui_mk2/branches/v0-4</nowiki> cegui_mk2-0-4

This will get you the latest code from the stable 'v0-4' branch (release series 0.4.x), and place it in the directory 'cegui_mk2-0-4'

---

With the [http://tortoisesvn.tigris.org/ Tortoise SVN Client], right-click within a directory and select "SVN Checkout..." from the popup menu. Specify the "URL of repository" as: <pre>https://svn.sourceforge.net/svnroot/crayzedsgui/cegui_mk2/trunk</pre>

= Compiling =
Now that you have the code, you probably want to compile it ;)

The first thing to do is to run bootstrap, which will run automake, autoconf, and various other tools to initialise the build environment and create the main configure script.

./bootstrap

Now you should be on familiar territorty. To configure the build, run configure:

./configure

There are various things you can change about the way the system is built, to get information about these options, pass the --help option to configure like so:

./configure --help

Once configure has run successfully, you need to run make as usual:

make

And finall, install as root:

su <and enter password ;) >
make install

[[User:CrazyEddie|CrazyEddie]] 11:13, 3 April 2006 (PDT)

FAQ

2005-09-09T21:25:06Z

Morgul: /* Build Questions */ - Cleaned up the bulk of the instructions.

== General Questions ==
=== What is CEGUI? ===
CEGUI is ''Crazy Eddie's Gui System''; a cross platform Gui/widget library for use in games and other multi-media projects where use of standard operating system Gui libraries is either not possible, or is very difficult.

=== How is CEGUI licensed? ===
CEGUI is licensed under the LGPL (Lesser/Library General Public License). For details of this license, please visit the following web-site: http://www.gnu.org/copyleft/lesser.html.

=== How much does CEGUI cost? ===
Nothing. The use of CEGUI is totally free within the bounds of the LGPL license as described above.

=== I am developing a commercial, closed-source product. Since CEGUI is licensed under LGPL, this means that can't I use the library, right? ===
No, that's not right. So long as you link dynamically to CEGUI and associated libraries, then you do not have to release any of your own source or .o/.obj files, though do carefully check the LGPL, and the licenses for the third party libraries for full details of what is and is not permissible.

=== I am not happy with the LGPL license, do you offer alternative licensing? ===
No. Alternative licensing is not available, nor is it planned.

=== Does CEGUI rely upon any third party libraries? If so what are they? ===
CEGUI currently depends upon the following external libraries:

* FreeType2
* Xerces-C++ (optional, built-in TinyXML parser is provided)

You will also require a supported rendering system, and some form of input library.
=== Where can I get these third party libraries? ===

* FreeType2: http://www.freetype.org/
* Xerces-C++: http://xml.apache.org/xerces-c/

=== Do I have to compile the third part libraries myself? ===
It depends. Under Linux and similar systems, you will need to perform your own compilation. For Microsoft® Windows® users, we have supplied packages containing binary versions of the libraries for a selection of popular compiler configurations.

=== You mentioned something about "supported rendering systems", what's that all about and which systems are supported? ===
CEGUI can be used with various rendering systems. There are currently CEGUI renderer modules for Microsoft® DirectX® 8.1 and 9, OpenGL, the Ogre engine, and the Irrlicht engine.

=== There is no renderer module for my rendering engine or API of choice, will other rendering system be supported? ===
It is likely that, over time, CEGUI will add support for other APIs and engines. Having said this, it is fairly simple to write your own renderer module for CEGUI, so you might consider taking that option if you do not want to wait.

=== And what about input libraries? ===
CEGUI requires you to ''inject'' inputs into it, these inputs can come from any source that you choose. All you need to do is pass mouse movements, mouse button up and down events, and keyboard inputs to CEGUI.

=== Why doesn't CEGUI collect its own inputs? Why do I need to inject the inputs myself? ===
CEGUI does not collect its own input so that the system can remain as flexible as possible. We didn't want to tie people down to one system or input library.

=== I have seen mention of a Lua scripting module, how can I get this? ===
'''TODO'''

=== I can't find many of the things you talk about in my crayzedsgui code, what's wrong? ===
You probably have one of the older Mk-1 alpha releases. Get the newer Mk-2 releases instead, the archive files for these generally have names with cegui_mk2 in them.

=== Why are there two versions of the system? ===
The Mk-1 version was a Windows®/DirectX® only library and was really a dry run for what became the Mk-2 system. There was only ever 'alpha' versions of the Mk-1 code, so it was never anywhere near finished.

=== Are the Mk-1 and Mk-2 systems interface compatible? ===
No. The interfaces of the two systems are totally different, although many of the general concepts have remained the same.

=== The Mk-1 system is so much more lightweight than the Mk-2 system. Can I still use the Mk-1 code? Is the Mk-1 code still being developed and supported? ===
Short Answer: Not really.

Long Answer: There were too many weak areas within the Mk-1 system and development on this version has ceased completely. There is no longer any support for the Mk-1 version; in general it would be better for everyone if they migrated to the Mk-2 version of the system.

=== I am having major troubles integrating CEGUI with my project, will you do it for me? ===
No. The CEGUI developers have enough to do without writing users projects for them.

=== I have (or think I have) found a bug. How should I proceed? ===
If you are certain that it's a bug and not, for example, a misunderstanding of what is happening, then the bug should be reported via the project bug tracking system. However, before submitting a bug to the tracker, it is asked that you first do a quick search to see if the bug has already been reported. If you are unsure whether something is a bug or not, then it may be discussed on the web site forums prior to submitting a bug report to the project bug tracker.

=== I notice that feature/widget 'X' is missing. Will this be added to CEGUI? ===
Requests for new features and/or widgets are welcomed. You can discuss such things on the web site forums and then submit a feature request to the project feature request tracking system. Although it is asked that you first search to ensure that the feature has not already been requested; if the feature has already been requested feel free to add a note to the tracker item stating your support for the feature request. Note that no promises are made with regards to which features will and will not be added, or how long such things will take, but all requests will be seriously considered.

=== How can I get involved with CEGUI development? ===
The best way to become involved is to visit the web site forums, state what your intentions are (to help in avoiding duplicated effort), and then start submitting some patches to the project patch tracking system.

=== Is there managed code / Microsoft .Net support for the CEGUI library? ===
Yes, there is ''ceguisharp'' at http://realmforgewiki.castlegobs.nl/index.php/CEGUI This is a C# port of the library which uses the excellent Axiom rendering engine.

=== This FAQ doesn't answer my question, what should I do now? ===
Feel free to post your question on the web site forums, somebody will gladly answer your question and/or offer further advice.

== Build Questions ==

(A work in Progress)

=== Building CEGUI ===
# General Requirements
# Dependency installs

=== Building from CVS ===
''(The following instructions are for unix systems)''

==== Configuring CEGUI ====
First, we need to generate the configure script, as well as a few other files.
In the cegui_mk2 directory, run:
$ sh ./bootstrap
Now, it's time to actually run configure:
$ ./configure

==== Building CEGUI ====
With all this one, we can now build CEGUI.
Type:
$ make
Once that's finished, we can install it!
Type:
$ make install

Tada!

=== CEGUI Layout Editor Build ===
# Dependency installs (for versions > 0.4.0)
Install wxWidgets
# Building

== Usage Questions ==
=== What is the correct way to subscribe for an event? ===
Event notification is a vital aspect of GUI programming. CEGUI handles those using subscribers.
In order to subscribe a window for an event, you have to call the method 'Window::subscribeEvent', passing the function
to be called when the specified event occurs, and the instance on which the method is called.

class MyButtonHandler
{
private:
PushButton* mButton;

public:
MyButtonHandler::MyButtonHandler(PushButton* btn) : mButton(btn)
{
btn->subscribeEvent(PushButton::EventClicked, Event::Subscriber(MyButtonHandler::ButtonClicked,this));
}

MyButtonHandler::ButtonClicked()
{
//This function gets called when the button is clicked
std::cout << "Button clicked" << std::endl;
}

The 'subscribeEvent' method returns an Event::Connection, which can be used later to unsubscribe for a registered event with
the 'disconnect' method.

Event::Connection myCon = btn->subscribeEvent(...);

...

myCon->disconnect();

In order to totally remove the event itself, you have to call the 'removeEvent' function:
all the connections to the specified event will be disconnected.
There's also an Event::ScopedConnection, which can be used to auto-unsubscribe when the event goes out of scope.

Similar way for the scripted events, which can be subscribed with the 'subscribeScriptedEvent' method.
In addition, you can do it in XML, using this syntax:

<Event Name="Clicked" Function="luabtn_clicked" />

=== How can I make the ListBox highlight the selected item? ===
In order to highlight selected items you need to set selection brush image and the selection colours of that item. The selection image is modulated by the colours you set. Note, that the alpha component needs to be smaller than 1.0, for the content of the selected item to be seen.
// set selection highlight to a half transparent blue to red gradient.
colour blue(0.0, 0.0, 1.0, 0.5);
colour red(1.0, 0.0, 0.0, 0.5);
myListBoxItem->setSelectionColours(blue, blue, red, red);
// this default image is a simple white rectangle
myListBoxItem->setSelectionBrushImage("TaharezLook", "ListboxSelectionBrush");

=== How can I remove the border of a StaticImage? ===
Either put the following property into the window definition:
<Property Name="FrameEnabled" Value="false" />
Or set it by code:
myStaticImage->setFrameEnabled(false);

=== How can I set the background of a StaticImage? ===
The first thing you need in order to do this is an Imageset that defines the Image that you wish to use. When wanting to use an image file for this as you suggest, you basically have an imageset defined like this:
<?xml version="1.0" ?>
<Imageset Name="BackdropImageset" Imagefile="backdrop.tga" NativeHorzRes="1024" NativeVertRes="768" AutoScaled="true">
<Image Name="Backdrop" XPos="0" YPos="0" Width="1024" Height="768" />
</Imageset>

What this does is define an Imageset using the backdrop.tga. A single image "Backdrop" is defined that starts at location (0,0) and is 1024 x 768 in size. You should be careful in that the source image file should have dimensions that are powers of two - this is because the image is loaded as a texture, and may be stretched if the powers-of-two requirement is not observed.<br>
Once you have your imageset defined, you can load it either by adding a reference to it in whichever scheme you are loading, or manually using the ImagesetManager:
CEGUI::ImagesetManager::getSingleton().createImageset("myImageset.imagset");
Once the thing is loaded, you set the image into the StaticImage like so:
myStaticImage->setImage("BackdropImageset", "Backdrop");
Notice that the names we specify here are the ones that were originally specified in the imageset XML file.<br>

=== What properties are available for use in XML layouts, and what format do I use for the value strings? ===
Each widget has its properties placed within an appropriately named C++ namespace, so all you need to do is look up the appropriate namespace within the [http://www.cegui.org.uk/api_reference/namespaces.html namespaces section of the API reference].

Also, remember that properties are inherited. So for example, when looking up properties for a PushButton, also check the properties for ButtonBase and Window too - since these properties are also available to you.

=== I can't see the items I've added to my Combobox, how do I get the list to show when I press the button? ===

The height you specify for the combobox widget includes the height of the drop down list; it's not just for the 'Editbox' portion of the widget (the height of which is usually automatically determined based upon the font). Ensure that when specifying the height for your combobox, you have provided sufficient space for the list to appear.