http://cegui.org/wiki/api.php?action=feedcontributions&feedformat=atom&user=Paul424CEGUI Wiki - Crazy Eddie's GUI System (Open Source) - User contributions [en]2026-04-06T02:19:16ZUser contributionsMediaWiki 1.24.1http://cegui.org/wiki/index.php?title=CEED&diff=5043CEED2013-12-22T18:40:22Z<p>Paul424: </p>
<hr />
<div>The CEGUI unified editor. Includes project management and multi-file/multi-tab editing.<br />
<br />
== Install ==<br />
<br />
CEED from the v0-8 branch (and all snapshots) depend on CEGUI 0.8. Even though it may work with CEGUI "default" it is not tested with it so don't expect any help if you try to make it work that way.<br />
<br />
[http://www.cegui.org.uk/phpBB2/viewtopic.php?f=15&t=5566 Original post at the forums] (very old, don't use!)<br />
<br />
=== Dependencies ===<br />
<br />
You need CMake, Python >= 2.6 (preferably Python 2.7), PyOpenGL, PySide (+ utils/tools), Boost.Python.<br />
<br />
==== Debian Wheezy ====<br />
<br />
PySide is part of Sid at the moment, so you have to add its repository address to your /etc/apt/sources.list<br />
<br />
apt-get install cmake python-opengl pyside-tools boost-python<br />
<br />
==== Arch Linux ====<br />
<br />
You need at least python2, boost, python-opengl, pyside (AUR), pyside-tools (AUR). PySide will bring in several other packages and will probably take a few hours to compile.<br />
<br />
Note: You probably need to add "-DPYTHON_EXECUTABLE=/usr/bin/python2" (without the quotes) to the cmake command line below because Arch Linux defaults to python 3 but the python modules CMake script expects python2.<br />
<br />
Arch Linux has the entire ceed packaged, see the AUR repo and save yourself all this trouble.<br />
<br />
==== Fedora ====<br />
<br />
You need boost-devel, python-devel, python-opengl, python-pyside, pyside-tools<br />
<br />
=== Build CEGUI and PyCEGUI ===<br />
<br />
(Or get it from distribution repo and skip this)<br />
<br />
hg clone https://bitbucket.org/cegui/cegui<br />
hg clone https://bitbucket.org/cegui/ceed<br />
cd ceed<br />
hg update v0-8<br />
cd ../<br />
cd cegui<br />
hg update v0-8<br />
cd ../<br />
mkdir cegui/build<br />
cd cegui/build<br />
cmake -DCEGUI_BUILD_PYTHON_MODULES=ON ../<br />
<br />
<br />
== RENDERERS' MODULES BAD DESIGN TROUBLES ==<br />
<br />
With current version ( 0,5 ) Ogre Rendere won't work , but OpenGL renderer works fine. What is more OpenGL renderer must be enabled with the OpenGL3 one !<br />
<br />
BEFORE CALLING <br />
<br />
cmake -DCEGUI_BUILD_PYTHON_MODULES=ON ../<br />
make -j 4<br />
<br />
start the :<br />
<br />
cmake-gui<br />
<br />
and than in CMAKE tab set ONLY<br />
"CEGUI_BUILD_RENDERER_NULL"<br />
"CEGUI_BUILD_RENDERER_OPENGL"<br />
"CEGUI_BUILD_RENDERER_OPENGL3"<br />
<br />
== Launch ==<br />
<br />
cd ../ceed<br />
cd bin<br />
./runwrapper.sh<br />
./ceed-gui <br />
<br />
or<br />
$ cd ../ceed/bin<br />
$ PYTHONPATH=../../cegui/build/lib:../:$PYTHONPATH python2 ./ceed-gui<br />
<br />
You will see a window like this:<br />
<br />
[[Image:Ceed_main_window.png]]<br />
<br />
=== Troubleshooting ===<br />
* If it fails to import ceed.ui.* then you need to compile UI files, call<br />
[ceed] ./maintenance compile-ui-files<br />
Or alternatively edit ceed/version.py and set CEED_developerMode to True.<br />
* If the data files are missing you need to run the 'maintenance' script like this:<br />
[ceed/bin]$ cd ..<br />
[ceed]$ ./maintenance fetch-datafiles<br />
<br />
== Project ==<br />
<br />
Unlike old editors (CELayoutEditor and CEImagesetEditor), CEED has a notion of a project. Each project has its own combination of resources and runs its own CEGUI version to render your CEGUI resources. This allows you to have more that one scheme loaded at a time.<br />
<br />
To create a new project, you should go to '''File -> New project'''.<br />
<br />
The dialog appears. You should input project name and location of the ".project" file. '''Note''': parent directory of the ".project" file must exist.<br />
<br />
[[Image:Ceed_new_project.png]]<br />
<br />
After you press '''OK''', Project settings window appears.<br />
<br />
=== Project settings ===<br />
<br />
(The window is also accessible from '''Edit -> Project settings''')<br />
<br />
[[Image:Ceed_project_settings.png]]<br />
<br />
CEED can create assets for CEGUI versions: 0.6 to 0.8. 0.7 is the latest stable, so select it.<br />
<br />
Point "Resource directory" to the place where "fonts", "schemes" and the rest directories are located, then press '''Apply'''. It will change the paths below.<br />
<br />
Press '''OK''' and will load your resources. If it fails to, it will show you a warning dialog:<br />
<br />
[[Image:Ceed_new_project_warning.png]]<br />
<br />
In our case, the resource directory does not have "schemes" subdirectory, as noted on the last line. Correct the paths and retry.<br />
<br />
=== Project resources ===<br />
<br />
Currently CEED can only work with imagesets and layouts. Add them to your project by clicking with the right mouse button on '''Project manager''' and selecting '''Add existing file(s)''':<br />
<br />
[[Image:Ceed_project_add_existing.png]]<br />
<br />
Select the necessary imagesets and layouts, and save the project.<br />
<br />
=== Layouts ===<br />
<br />
[[Image:Ceed_layout.png]]<br />
<br />
To create a new widget, drag it from the left bottom panel.<br />
<br />
To edit it, you can either do it visually, or switch to "Code" tab seen below, and edit it manually. There's also "Preview" tab, where you can test your layout in real time.<br />
<br />
=== Imagesets ===<br />
<br />
[[Image:Ceed_imageset.png]]<br />
<br />
To create a new image, press tool bar button second from the right, or click with the right mouse button on the image itself and select '''Create image''':<br />
<br />
[[Image:Ceed_imageset_create_image.png]]<br />
<br />
It creates a 50 x 50 rectangle centered at where mouse cursor is. Move and resize it as you see fit.<br />
<br />
== Settings ==<br />
Go to '''Edit -> Application settings'''.<br />
<br />
[[Image:Ceed_application_settings.png]]<br />
<br />
There are many settings you can tweak. One of the most important might be '''Shortcuts'''. It allows you to assign shortcuts to zoom, image creation, opening a project, and so on.<br />
<br />
== Notes ==<br />
<br />
Currently you may have problems with Imagesets that use TGA, since some versions of Qt may be built without TGA support. CEGUI 0.8 has all imagery as PNG (CEGUI 0.7 used TGA), and we advise you to use PNG instead of TGA.</div>Paul424http://cegui.org/wiki/index.php?title=CEED&diff=5042CEED2013-12-22T14:07:51Z<p>Paul424: /* RENDERERS MODULES BAD DESIGN TROUBLES */</p>
<hr />
<div>The CEGUI unified editor. Includes project management and multi-file/multi-tab editing.<br />
<br />
== Install ==<br />
<br />
CEED from the v0-8 branch (and all snapshots) depend on CEGUI 0.8. Even though it may work with CEGUI "default" it is not tested with it so don't expect any help if you try to make it work that way.<br />
<br />
[http://www.cegui.org.uk/phpBB2/viewtopic.php?f=15&t=5566 Original post at the forums] (very old, don't use!)<br />
<br />
=== Dependencies ===<br />
<br />
You need CMake, Python >= 2.6 (preferably Python 2.7), PyOpenGL, PySide (+ utils/tools), Boost.Python.<br />
<br />
==== Debian Wheezy ====<br />
<br />
PySide is part of Sid at the moment, so you have to add its repository address to your /etc/apt/sources.list<br />
<br />
apt-get install cmake python-opengl pyside-tools boost-python<br />
<br />
==== Arch Linux ====<br />
<br />
You need at least python2, boost, python-opengl, pyside (AUR), pyside-tools (AUR). PySide will bring in several other packages and will probably take a few hours to compile.<br />
<br />
Note: You probably need to add "-DPYTHON_EXECUTABLE=/usr/bin/python2" (without the quotes) to the cmake command line below because Arch Linux defaults to python 3 but the python modules CMake script expects python2.<br />
<br />
Arch Linux has the entire ceed packaged, see the AUR repo and save yourself all this trouble.<br />
<br />
==== Fedora ====<br />
<br />
You need boost-devel, python-devel, python-opengl, python-pyside, pyside-tools<br />
<br />
=== Build CEGUI and PyCEGUI ===<br />
<br />
(Or get it from distribution repo and skip this)<br />
<br />
hg clone https://bitbucket.org/cegui/cegui<br />
hg clone https://bitbucket.org/cegui/ceed<br />
cd ceed<br />
hg update v0-8<br />
cd ../<br />
cd cegui<br />
hg update v0-8<br />
cd ../<br />
mkdir cegui/build<br />
cd cegui/build<br />
cmake -DCEGUI_BUILD_PYTHON_MODULES=ON ../<br />
make -j 4<br />
<br />
== RENDERERS' MODULES BAD DESIGN TROUBLES ==<br />
<br />
With current version ( 0,5 ) Ogre Rendere won't work , but OpenGL renderer works fine. What is more OpenGL renderer must be enabled with the OpenGL3 one !<br />
<br />
BEFORE CALLING <br />
<br />
make<br />
<br />
start the :<br />
<br />
cmake-gui<br />
<br />
and than in CMAKE tab set ONLY<br />
"CEGUI_BUILD_RENDERER_NULL"<br />
"CEGUI_BUILD_RENDERER_OPENGL"<br />
"CEGUI_BUILD_RENDERER_OPENGL3"<br />
<br />
== Launch ==<br />
<br />
cd ../ceed<br />
cd bin<br />
./runwrapper.sh<br />
./ceed-gui <br />
<br />
or<br />
$ cd ../ceed/bin<br />
$ PYTHONPATH=../../cegui/build/lib:../:$PYTHONPATH python2 ./ceed-gui<br />
<br />
You will see a window like this:<br />
<br />
[[Image:Ceed_main_window.png]]<br />
<br />
=== Troubleshooting ===<br />
* If it fails to import ceed.ui.* then you need to compile UI files, call<br />
[ceed] ./maintenance compile-ui-files<br />
Or alternatively edit ceed/version.py and set CEED_developerMode to True.<br />
* If the data files are missing you need to run the 'maintenance' script like this:<br />
[ceed/bin]$ cd ..<br />
[ceed]$ ./maintenance fetch-datafiles<br />
<br />
== Project ==<br />
<br />
Unlike old editors (CELayoutEditor and CEImagesetEditor), CEED has a notion of a project. Each project has its own combination of resources and runs its own CEGUI version to render your CEGUI resources. This allows you to have more that one scheme loaded at a time.<br />
<br />
To create a new project, you should go to '''File -> New project'''.<br />
<br />
The dialog appears. You should input project name and location of the ".project" file. '''Note''': parent directory of the ".project" file must exist.<br />
<br />
[[Image:Ceed_new_project.png]]<br />
<br />
After you press '''OK''', Project settings window appears.<br />
<br />
=== Project settings ===<br />
<br />
(The window is also accessible from '''Edit -> Project settings''')<br />
<br />
[[Image:Ceed_project_settings.png]]<br />
<br />
CEED can create assets for CEGUI versions: 0.6 to 0.8. 0.7 is the latest stable, so select it.<br />
<br />
Point "Resource directory" to the place where "fonts", "schemes" and the rest directories are located, then press '''Apply'''. It will change the paths below.<br />
<br />
Press '''OK''' and will load your resources. If it fails to, it will show you a warning dialog:<br />
<br />
[[Image:Ceed_new_project_warning.png]]<br />
<br />
In our case, the resource directory does not have "schemes" subdirectory, as noted on the last line. Correct the paths and retry.<br />
<br />
=== Project resources ===<br />
<br />
Currently CEED can only work with imagesets and layouts. Add them to your project by clicking with the right mouse button on '''Project manager''' and selecting '''Add existing file(s)''':<br />
<br />
[[Image:Ceed_project_add_existing.png]]<br />
<br />
Select the necessary imagesets and layouts, and save the project.<br />
<br />
=== Layouts ===<br />
<br />
[[Image:Ceed_layout.png]]<br />
<br />
To create a new widget, drag it from the left bottom panel.<br />
<br />
To edit it, you can either do it visually, or switch to "Code" tab seen below, and edit it manually. There's also "Preview" tab, where you can test your layout in real time.<br />
<br />
=== Imagesets ===<br />
<br />
[[Image:Ceed_imageset.png]]<br />
<br />
To create a new image, press tool bar button second from the right, or click with the right mouse button on the image itself and select '''Create image''':<br />
<br />
[[Image:Ceed_imageset_create_image.png]]<br />
<br />
It creates a 50 x 50 rectangle centered at where mouse cursor is. Move and resize it as you see fit.<br />
<br />
== Settings ==<br />
Go to '''Edit -> Application settings'''.<br />
<br />
[[Image:Ceed_application_settings.png]]<br />
<br />
There are many settings you can tweak. One of the most important might be '''Shortcuts'''. It allows you to assign shortcuts to zoom, image creation, opening a project, and so on.<br />
<br />
== Notes ==<br />
<br />
Currently you may have problems with Imagesets that use TGA, since some versions of Qt may be built without TGA support. CEGUI 0.8 has all imagery as PNG (CEGUI 0.7 used TGA), and we advise you to use PNG instead of TGA.</div>Paul424http://cegui.org/wiki/index.php?title=CEED&diff=5041CEED2013-12-22T13:43:39Z<p>Paul424: /* RENDERERS MODULES BAD DESIGN TROUBLES */</p>
<hr />
<div>The CEGUI unified editor. Includes project management and multi-file/multi-tab editing.<br />
<br />
== Install ==<br />
<br />
CEED from the v0-8 branch (and all snapshots) depend on CEGUI 0.8. Even though it may work with CEGUI "default" it is not tested with it so don't expect any help if you try to make it work that way.<br />
<br />
[http://www.cegui.org.uk/phpBB2/viewtopic.php?f=15&t=5566 Original post at the forums] (very old, don't use!)<br />
<br />
=== Dependencies ===<br />
<br />
You need CMake, Python >= 2.6 (preferably Python 2.7), PyOpenGL, PySide (+ utils/tools), Boost.Python.<br />
<br />
==== Debian Wheezy ====<br />
<br />
PySide is part of Sid at the moment, so you have to add its repository address to your /etc/apt/sources.list<br />
<br />
apt-get install cmake python-opengl pyside-tools boost-python<br />
<br />
==== Arch Linux ====<br />
<br />
You need at least python2, boost, python-opengl, pyside (AUR), pyside-tools (AUR). PySide will bring in several other packages and will probably take a few hours to compile.<br />
<br />
Note: You probably need to add "-DPYTHON_EXECUTABLE=/usr/bin/python2" (without the quotes) to the cmake command line below because Arch Linux defaults to python 3 but the python modules CMake script expects python2.<br />
<br />
Arch Linux has the entire ceed packaged, see the AUR repo and save yourself all this trouble.<br />
<br />
==== Fedora ====<br />
<br />
You need boost-devel, python-devel, python-opengl, python-pyside, pyside-tools<br />
<br />
=== Build CEGUI and PyCEGUI ===<br />
<br />
(Or get it from distribution repo and skip this)<br />
<br />
hg clone https://bitbucket.org/cegui/cegui<br />
hg clone https://bitbucket.org/cegui/ceed<br />
cd ceed<br />
hg update v0-8<br />
cd ../<br />
cd cegui<br />
hg update v0-8<br />
cd ../<br />
mkdir cegui/build<br />
cd cegui/build<br />
cmake -DCEGUI_BUILD_PYTHON_MODULES=ON ../<br />
make -j 4<br />
<br />
== RENDERERS MODULES BAD DESIGN TROUBLES ==<br />
<br />
With current version ( 0,5 ) Ogre Rendere won't work , but OpenGL renderer works fine. What is more OpenGL renderer must be enabled with the OpenGL3 one !<br />
<br />
BEFORE CALLING <br />
<br />
make<br />
<br />
start the :<br />
<br />
cmake-gui<br />
<br />
and than in CMAKE tab set ONLY<br />
"CEGUI_BUILD_RENDERER_NULL"<br />
"CEGUI_BUILD_RENDERER_OPENGL"<br />
"CEGUI_BUILD_RENDERER_OPENGL3"<br />
<br />
== Launch ==<br />
<br />
cd ../ceed<br />
cd bin<br />
./runwrapper.sh<br />
./ceed-gui <br />
<br />
or<br />
$ cd ../ceed/bin<br />
$ PYTHONPATH=../../cegui/build/lib:../:$PYTHONPATH python2 ./ceed-gui<br />
<br />
You will see a window like this:<br />
<br />
[[Image:Ceed_main_window.png]]<br />
<br />
=== Troubleshooting ===<br />
* If it fails to import ceed.ui.* then you need to compile UI files, call<br />
[ceed] ./maintenance compile-ui-files<br />
Or alternatively edit ceed/version.py and set CEED_developerMode to True.<br />
* If the data files are missing you need to run the 'maintenance' script like this:<br />
[ceed/bin]$ cd ..<br />
[ceed]$ ./maintenance fetch-datafiles<br />
<br />
== Project ==<br />
<br />
Unlike old editors (CELayoutEditor and CEImagesetEditor), CEED has a notion of a project. Each project has its own combination of resources and runs its own CEGUI version to render your CEGUI resources. This allows you to have more that one scheme loaded at a time.<br />
<br />
To create a new project, you should go to '''File -> New project'''.<br />
<br />
The dialog appears. You should input project name and location of the ".project" file. '''Note''': parent directory of the ".project" file must exist.<br />
<br />
[[Image:Ceed_new_project.png]]<br />
<br />
After you press '''OK''', Project settings window appears.<br />
<br />
=== Project settings ===<br />
<br />
(The window is also accessible from '''Edit -> Project settings''')<br />
<br />
[[Image:Ceed_project_settings.png]]<br />
<br />
CEED can create assets for CEGUI versions: 0.6 to 0.8. 0.7 is the latest stable, so select it.<br />
<br />
Point "Resource directory" to the place where "fonts", "schemes" and the rest directories are located, then press '''Apply'''. It will change the paths below.<br />
<br />
Press '''OK''' and will load your resources. If it fails to, it will show you a warning dialog:<br />
<br />
[[Image:Ceed_new_project_warning.png]]<br />
<br />
In our case, the resource directory does not have "schemes" subdirectory, as noted on the last line. Correct the paths and retry.<br />
<br />
=== Project resources ===<br />
<br />
Currently CEED can only work with imagesets and layouts. Add them to your project by clicking with the right mouse button on '''Project manager''' and selecting '''Add existing file(s)''':<br />
<br />
[[Image:Ceed_project_add_existing.png]]<br />
<br />
Select the necessary imagesets and layouts, and save the project.<br />
<br />
=== Layouts ===<br />
<br />
[[Image:Ceed_layout.png]]<br />
<br />
To create a new widget, drag it from the left bottom panel.<br />
<br />
To edit it, you can either do it visually, or switch to "Code" tab seen below, and edit it manually. There's also "Preview" tab, where you can test your layout in real time.<br />
<br />
=== Imagesets ===<br />
<br />
[[Image:Ceed_imageset.png]]<br />
<br />
To create a new image, press tool bar button second from the right, or click with the right mouse button on the image itself and select '''Create image''':<br />
<br />
[[Image:Ceed_imageset_create_image.png]]<br />
<br />
It creates a 50 x 50 rectangle centered at where mouse cursor is. Move and resize it as you see fit.<br />
<br />
== Settings ==<br />
Go to '''Edit -> Application settings'''.<br />
<br />
[[Image:Ceed_application_settings.png]]<br />
<br />
There are many settings you can tweak. One of the most important might be '''Shortcuts'''. It allows you to assign shortcuts to zoom, image creation, opening a project, and so on.<br />
<br />
== Notes ==<br />
<br />
Currently you may have problems with Imagesets that use TGA, since some versions of Qt may be built without TGA support. CEGUI 0.8 has all imagery as PNG (CEGUI 0.7 used TGA), and we advise you to use PNG instead of TGA.</div>Paul424http://cegui.org/wiki/index.php?title=CEED&diff=5040CEED2013-12-22T13:43:25Z<p>Paul424: /* RENDERERS MODULES BAD DESIGN TROUBLES */</p>
<hr />
<div>The CEGUI unified editor. Includes project management and multi-file/multi-tab editing.<br />
<br />
== Install ==<br />
<br />
CEED from the v0-8 branch (and all snapshots) depend on CEGUI 0.8. Even though it may work with CEGUI "default" it is not tested with it so don't expect any help if you try to make it work that way.<br />
<br />
[http://www.cegui.org.uk/phpBB2/viewtopic.php?f=15&t=5566 Original post at the forums] (very old, don't use!)<br />
<br />
=== Dependencies ===<br />
<br />
You need CMake, Python >= 2.6 (preferably Python 2.7), PyOpenGL, PySide (+ utils/tools), Boost.Python.<br />
<br />
==== Debian Wheezy ====<br />
<br />
PySide is part of Sid at the moment, so you have to add its repository address to your /etc/apt/sources.list<br />
<br />
apt-get install cmake python-opengl pyside-tools boost-python<br />
<br />
==== Arch Linux ====<br />
<br />
You need at least python2, boost, python-opengl, pyside (AUR), pyside-tools (AUR). PySide will bring in several other packages and will probably take a few hours to compile.<br />
<br />
Note: You probably need to add "-DPYTHON_EXECUTABLE=/usr/bin/python2" (without the quotes) to the cmake command line below because Arch Linux defaults to python 3 but the python modules CMake script expects python2.<br />
<br />
Arch Linux has the entire ceed packaged, see the AUR repo and save yourself all this trouble.<br />
<br />
==== Fedora ====<br />
<br />
You need boost-devel, python-devel, python-opengl, python-pyside, pyside-tools<br />
<br />
=== Build CEGUI and PyCEGUI ===<br />
<br />
(Or get it from distribution repo and skip this)<br />
<br />
hg clone https://bitbucket.org/cegui/cegui<br />
hg clone https://bitbucket.org/cegui/ceed<br />
cd ceed<br />
hg update v0-8<br />
cd ../<br />
cd cegui<br />
hg update v0-8<br />
cd ../<br />
mkdir cegui/build<br />
cd cegui/build<br />
cmake -DCEGUI_BUILD_PYTHON_MODULES=ON ../<br />
make -j 4<br />
<br />
== RENDERERS MODULES BAD DESIGN TROUBLES ==<br />
<br />
With current version ( 0,5 ) Ogre Rendere won't work , but OpenGL renderer works fine. What is more OpenGL renderer must be enabled with the OpenGL3 one !<br />
<br />
BEFORE CALLING <br />
<br />
make< <br />
<br />
start the :<br />
<br />
cmake-gui<br />
<br />
and than in CMAKE tab set ONLY<br />
"CEGUI_BUILD_RENDERER_NULL"<br />
"CEGUI_BUILD_RENDERER_OPENGL"<br />
"CEGUI_BUILD_RENDERER_OPENGL3"<br />
<br />
== Launch ==<br />
<br />
cd ../ceed<br />
cd bin<br />
./runwrapper.sh<br />
./ceed-gui <br />
<br />
or<br />
$ cd ../ceed/bin<br />
$ PYTHONPATH=../../cegui/build/lib:../:$PYTHONPATH python2 ./ceed-gui<br />
<br />
You will see a window like this:<br />
<br />
[[Image:Ceed_main_window.png]]<br />
<br />
=== Troubleshooting ===<br />
* If it fails to import ceed.ui.* then you need to compile UI files, call<br />
[ceed] ./maintenance compile-ui-files<br />
Or alternatively edit ceed/version.py and set CEED_developerMode to True.<br />
* If the data files are missing you need to run the 'maintenance' script like this:<br />
[ceed/bin]$ cd ..<br />
[ceed]$ ./maintenance fetch-datafiles<br />
<br />
== Project ==<br />
<br />
Unlike old editors (CELayoutEditor and CEImagesetEditor), CEED has a notion of a project. Each project has its own combination of resources and runs its own CEGUI version to render your CEGUI resources. This allows you to have more that one scheme loaded at a time.<br />
<br />
To create a new project, you should go to '''File -> New project'''.<br />
<br />
The dialog appears. You should input project name and location of the ".project" file. '''Note''': parent directory of the ".project" file must exist.<br />
<br />
[[Image:Ceed_new_project.png]]<br />
<br />
After you press '''OK''', Project settings window appears.<br />
<br />
=== Project settings ===<br />
<br />
(The window is also accessible from '''Edit -> Project settings''')<br />
<br />
[[Image:Ceed_project_settings.png]]<br />
<br />
CEED can create assets for CEGUI versions: 0.6 to 0.8. 0.7 is the latest stable, so select it.<br />
<br />
Point "Resource directory" to the place where "fonts", "schemes" and the rest directories are located, then press '''Apply'''. It will change the paths below.<br />
<br />
Press '''OK''' and will load your resources. If it fails to, it will show you a warning dialog:<br />
<br />
[[Image:Ceed_new_project_warning.png]]<br />
<br />
In our case, the resource directory does not have "schemes" subdirectory, as noted on the last line. Correct the paths and retry.<br />
<br />
=== Project resources ===<br />
<br />
Currently CEED can only work with imagesets and layouts. Add them to your project by clicking with the right mouse button on '''Project manager''' and selecting '''Add existing file(s)''':<br />
<br />
[[Image:Ceed_project_add_existing.png]]<br />
<br />
Select the necessary imagesets and layouts, and save the project.<br />
<br />
=== Layouts ===<br />
<br />
[[Image:Ceed_layout.png]]<br />
<br />
To create a new widget, drag it from the left bottom panel.<br />
<br />
To edit it, you can either do it visually, or switch to "Code" tab seen below, and edit it manually. There's also "Preview" tab, where you can test your layout in real time.<br />
<br />
=== Imagesets ===<br />
<br />
[[Image:Ceed_imageset.png]]<br />
<br />
To create a new image, press tool bar button second from the right, or click with the right mouse button on the image itself and select '''Create image''':<br />
<br />
[[Image:Ceed_imageset_create_image.png]]<br />
<br />
It creates a 50 x 50 rectangle centered at where mouse cursor is. Move and resize it as you see fit.<br />
<br />
== Settings ==<br />
Go to '''Edit -> Application settings'''.<br />
<br />
[[Image:Ceed_application_settings.png]]<br />
<br />
There are many settings you can tweak. One of the most important might be '''Shortcuts'''. It allows you to assign shortcuts to zoom, image creation, opening a project, and so on.<br />
<br />
== Notes ==<br />
<br />
Currently you may have problems with Imagesets that use TGA, since some versions of Qt may be built without TGA support. CEGUI 0.8 has all imagery as PNG (CEGUI 0.7 used TGA), and we advise you to use PNG instead of TGA.</div>Paul424http://cegui.org/wiki/index.php?title=CEED&diff=5039CEED2013-12-22T13:42:54Z<p>Paul424: /* RENDERERS MODULES BAD DESIGN TROUBLES */</p>
<hr />
<div>The CEGUI unified editor. Includes project management and multi-file/multi-tab editing.<br />
<br />
== Install ==<br />
<br />
CEED from the v0-8 branch (and all snapshots) depend on CEGUI 0.8. Even though it may work with CEGUI "default" it is not tested with it so don't expect any help if you try to make it work that way.<br />
<br />
[http://www.cegui.org.uk/phpBB2/viewtopic.php?f=15&t=5566 Original post at the forums] (very old, don't use!)<br />
<br />
=== Dependencies ===<br />
<br />
You need CMake, Python >= 2.6 (preferably Python 2.7), PyOpenGL, PySide (+ utils/tools), Boost.Python.<br />
<br />
==== Debian Wheezy ====<br />
<br />
PySide is part of Sid at the moment, so you have to add its repository address to your /etc/apt/sources.list<br />
<br />
apt-get install cmake python-opengl pyside-tools boost-python<br />
<br />
==== Arch Linux ====<br />
<br />
You need at least python2, boost, python-opengl, pyside (AUR), pyside-tools (AUR). PySide will bring in several other packages and will probably take a few hours to compile.<br />
<br />
Note: You probably need to add "-DPYTHON_EXECUTABLE=/usr/bin/python2" (without the quotes) to the cmake command line below because Arch Linux defaults to python 3 but the python modules CMake script expects python2.<br />
<br />
Arch Linux has the entire ceed packaged, see the AUR repo and save yourself all this trouble.<br />
<br />
==== Fedora ====<br />
<br />
You need boost-devel, python-devel, python-opengl, python-pyside, pyside-tools<br />
<br />
=== Build CEGUI and PyCEGUI ===<br />
<br />
(Or get it from distribution repo and skip this)<br />
<br />
hg clone https://bitbucket.org/cegui/cegui<br />
hg clone https://bitbucket.org/cegui/ceed<br />
cd ceed<br />
hg update v0-8<br />
cd ../<br />
cd cegui<br />
hg update v0-8<br />
cd ../<br />
mkdir cegui/build<br />
cd cegui/build<br />
cmake -DCEGUI_BUILD_PYTHON_MODULES=ON ../<br />
make -j 4<br />
<br />
== RENDERERS MODULES BAD DESIGN TROUBLES ==<br />
<br />
With current version ( 0,5 ) Ogre Rendere won't work , but OpenGL renderer works fine. What is more OpenGL renderer must be enabled with the OpenGL3 one !<br />
<br />
BEFORE CALLING <br />
<br />
make< <br />
<br />
start the :<br />
<br />
cmake-gui<br />
<br />
and than in CMAKE tab set ONLY<br />
CEGUI_BUILD_RENDERER_NULL<br />
CEGUI_BUILD_RENDERER_OPENGL<br />
CEGUI_BUILD_RENDERER_OPENGL3<br />
<br />
== Launch ==<br />
<br />
cd ../ceed<br />
cd bin<br />
./runwrapper.sh<br />
./ceed-gui <br />
<br />
or<br />
$ cd ../ceed/bin<br />
$ PYTHONPATH=../../cegui/build/lib:../:$PYTHONPATH python2 ./ceed-gui<br />
<br />
You will see a window like this:<br />
<br />
[[Image:Ceed_main_window.png]]<br />
<br />
=== Troubleshooting ===<br />
* If it fails to import ceed.ui.* then you need to compile UI files, call<br />
[ceed] ./maintenance compile-ui-files<br />
Or alternatively edit ceed/version.py and set CEED_developerMode to True.<br />
* If the data files are missing you need to run the 'maintenance' script like this:<br />
[ceed/bin]$ cd ..<br />
[ceed]$ ./maintenance fetch-datafiles<br />
<br />
== Project ==<br />
<br />
Unlike old editors (CELayoutEditor and CEImagesetEditor), CEED has a notion of a project. Each project has its own combination of resources and runs its own CEGUI version to render your CEGUI resources. This allows you to have more that one scheme loaded at a time.<br />
<br />
To create a new project, you should go to '''File -> New project'''.<br />
<br />
The dialog appears. You should input project name and location of the ".project" file. '''Note''': parent directory of the ".project" file must exist.<br />
<br />
[[Image:Ceed_new_project.png]]<br />
<br />
After you press '''OK''', Project settings window appears.<br />
<br />
=== Project settings ===<br />
<br />
(The window is also accessible from '''Edit -> Project settings''')<br />
<br />
[[Image:Ceed_project_settings.png]]<br />
<br />
CEED can create assets for CEGUI versions: 0.6 to 0.8. 0.7 is the latest stable, so select it.<br />
<br />
Point "Resource directory" to the place where "fonts", "schemes" and the rest directories are located, then press '''Apply'''. It will change the paths below.<br />
<br />
Press '''OK''' and will load your resources. If it fails to, it will show you a warning dialog:<br />
<br />
[[Image:Ceed_new_project_warning.png]]<br />
<br />
In our case, the resource directory does not have "schemes" subdirectory, as noted on the last line. Correct the paths and retry.<br />
<br />
=== Project resources ===<br />
<br />
Currently CEED can only work with imagesets and layouts. Add them to your project by clicking with the right mouse button on '''Project manager''' and selecting '''Add existing file(s)''':<br />
<br />
[[Image:Ceed_project_add_existing.png]]<br />
<br />
Select the necessary imagesets and layouts, and save the project.<br />
<br />
=== Layouts ===<br />
<br />
[[Image:Ceed_layout.png]]<br />
<br />
To create a new widget, drag it from the left bottom panel.<br />
<br />
To edit it, you can either do it visually, or switch to "Code" tab seen below, and edit it manually. There's also "Preview" tab, where you can test your layout in real time.<br />
<br />
=== Imagesets ===<br />
<br />
[[Image:Ceed_imageset.png]]<br />
<br />
To create a new image, press tool bar button second from the right, or click with the right mouse button on the image itself and select '''Create image''':<br />
<br />
[[Image:Ceed_imageset_create_image.png]]<br />
<br />
It creates a 50 x 50 rectangle centered at where mouse cursor is. Move and resize it as you see fit.<br />
<br />
== Settings ==<br />
Go to '''Edit -> Application settings'''.<br />
<br />
[[Image:Ceed_application_settings.png]]<br />
<br />
There are many settings you can tweak. One of the most important might be '''Shortcuts'''. It allows you to assign shortcuts to zoom, image creation, opening a project, and so on.<br />
<br />
== Notes ==<br />
<br />
Currently you may have problems with Imagesets that use TGA, since some versions of Qt may be built without TGA support. CEGUI 0.8 has all imagery as PNG (CEGUI 0.7 used TGA), and we advise you to use PNG instead of TGA.</div>Paul424http://cegui.org/wiki/index.php?title=CEED&diff=5038CEED2013-12-22T13:42:20Z<p>Paul424: </p>
<hr />
<div>The CEGUI unified editor. Includes project management and multi-file/multi-tab editing.<br />
<br />
== Install ==<br />
<br />
CEED from the v0-8 branch (and all snapshots) depend on CEGUI 0.8. Even though it may work with CEGUI "default" it is not tested with it so don't expect any help if you try to make it work that way.<br />
<br />
[http://www.cegui.org.uk/phpBB2/viewtopic.php?f=15&t=5566 Original post at the forums] (very old, don't use!)<br />
<br />
=== Dependencies ===<br />
<br />
You need CMake, Python >= 2.6 (preferably Python 2.7), PyOpenGL, PySide (+ utils/tools), Boost.Python.<br />
<br />
==== Debian Wheezy ====<br />
<br />
PySide is part of Sid at the moment, so you have to add its repository address to your /etc/apt/sources.list<br />
<br />
apt-get install cmake python-opengl pyside-tools boost-python<br />
<br />
==== Arch Linux ====<br />
<br />
You need at least python2, boost, python-opengl, pyside (AUR), pyside-tools (AUR). PySide will bring in several other packages and will probably take a few hours to compile.<br />
<br />
Note: You probably need to add "-DPYTHON_EXECUTABLE=/usr/bin/python2" (without the quotes) to the cmake command line below because Arch Linux defaults to python 3 but the python modules CMake script expects python2.<br />
<br />
Arch Linux has the entire ceed packaged, see the AUR repo and save yourself all this trouble.<br />
<br />
==== Fedora ====<br />
<br />
You need boost-devel, python-devel, python-opengl, python-pyside, pyside-tools<br />
<br />
=== Build CEGUI and PyCEGUI ===<br />
<br />
(Or get it from distribution repo and skip this)<br />
<br />
hg clone https://bitbucket.org/cegui/cegui<br />
hg clone https://bitbucket.org/cegui/ceed<br />
cd ceed<br />
hg update v0-8<br />
cd ../<br />
cd cegui<br />
hg update v0-8<br />
cd ../<br />
mkdir cegui/build<br />
cd cegui/build<br />
cmake -DCEGUI_BUILD_PYTHON_MODULES=ON ../<br />
make -j 4<br />
<br />
== RENDERERS MODULES BAD DESIGN TROUBLES ==<br />
<br />
With current version ( 0,5 ) Ogre Rendere won't work , but OpenGL renderer works fine. What is more OpenGL renderer must be enabled with the OpenGL3 one !<br />
<br />
BEFORE CALLING >>make<< start the cmake-gui :<br />
<br />
cmake-gui<br />
<br />
and than in CMAKE tab set ONLY<br />
CEGUI_BUILD_RENDERER_NULL<br />
CEGUI_BUILD_RENDERER_OPENGL<br />
CEGUI_BUILD_RENDERER_OPENGL3<br />
<br />
== Launch ==<br />
<br />
cd ../ceed<br />
cd bin<br />
./runwrapper.sh<br />
./ceed-gui <br />
<br />
or<br />
$ cd ../ceed/bin<br />
$ PYTHONPATH=../../cegui/build/lib:../:$PYTHONPATH python2 ./ceed-gui<br />
<br />
You will see a window like this:<br />
<br />
[[Image:Ceed_main_window.png]]<br />
<br />
=== Troubleshooting ===<br />
* If it fails to import ceed.ui.* then you need to compile UI files, call<br />
[ceed] ./maintenance compile-ui-files<br />
Or alternatively edit ceed/version.py and set CEED_developerMode to True.<br />
* If the data files are missing you need to run the 'maintenance' script like this:<br />
[ceed/bin]$ cd ..<br />
[ceed]$ ./maintenance fetch-datafiles<br />
<br />
== Project ==<br />
<br />
Unlike old editors (CELayoutEditor and CEImagesetEditor), CEED has a notion of a project. Each project has its own combination of resources and runs its own CEGUI version to render your CEGUI resources. This allows you to have more that one scheme loaded at a time.<br />
<br />
To create a new project, you should go to '''File -> New project'''.<br />
<br />
The dialog appears. You should input project name and location of the ".project" file. '''Note''': parent directory of the ".project" file must exist.<br />
<br />
[[Image:Ceed_new_project.png]]<br />
<br />
After you press '''OK''', Project settings window appears.<br />
<br />
=== Project settings ===<br />
<br />
(The window is also accessible from '''Edit -> Project settings''')<br />
<br />
[[Image:Ceed_project_settings.png]]<br />
<br />
CEED can create assets for CEGUI versions: 0.6 to 0.8. 0.7 is the latest stable, so select it.<br />
<br />
Point "Resource directory" to the place where "fonts", "schemes" and the rest directories are located, then press '''Apply'''. It will change the paths below.<br />
<br />
Press '''OK''' and will load your resources. If it fails to, it will show you a warning dialog:<br />
<br />
[[Image:Ceed_new_project_warning.png]]<br />
<br />
In our case, the resource directory does not have "schemes" subdirectory, as noted on the last line. Correct the paths and retry.<br />
<br />
=== Project resources ===<br />
<br />
Currently CEED can only work with imagesets and layouts. Add them to your project by clicking with the right mouse button on '''Project manager''' and selecting '''Add existing file(s)''':<br />
<br />
[[Image:Ceed_project_add_existing.png]]<br />
<br />
Select the necessary imagesets and layouts, and save the project.<br />
<br />
=== Layouts ===<br />
<br />
[[Image:Ceed_layout.png]]<br />
<br />
To create a new widget, drag it from the left bottom panel.<br />
<br />
To edit it, you can either do it visually, or switch to "Code" tab seen below, and edit it manually. There's also "Preview" tab, where you can test your layout in real time.<br />
<br />
=== Imagesets ===<br />
<br />
[[Image:Ceed_imageset.png]]<br />
<br />
To create a new image, press tool bar button second from the right, or click with the right mouse button on the image itself and select '''Create image''':<br />
<br />
[[Image:Ceed_imageset_create_image.png]]<br />
<br />
It creates a 50 x 50 rectangle centered at where mouse cursor is. Move and resize it as you see fit.<br />
<br />
== Settings ==<br />
Go to '''Edit -> Application settings'''.<br />
<br />
[[Image:Ceed_application_settings.png]]<br />
<br />
There are many settings you can tweak. One of the most important might be '''Shortcuts'''. It allows you to assign shortcuts to zoom, image creation, opening a project, and so on.<br />
<br />
== Notes ==<br />
<br />
Currently you may have problems with Imagesets that use TGA, since some versions of Qt may be built without TGA support. CEGUI 0.8 has all imagery as PNG (CEGUI 0.7 used TGA), and we advise you to use PNG instead of TGA.</div>Paul424http://cegui.org/wiki/index.php?title=CEED&diff=5037CEED2013-12-22T13:41:14Z<p>Paul424: /* RENDERERS MODULES BAD DESIGN TROUBLES */</p>
<hr />
<div>The CEGUI unified editor. Includes project management and multi-file/multi-tab editing.<br />
<br />
== Install ==<br />
<br />
CEED from the v0-8 branch (and all snapshots) depend on CEGUI 0.8. Even though it may work with CEGUI "default" it is not tested with it so don't expect any help if you try to make it work that way.<br />
<br />
[http://www.cegui.org.uk/phpBB2/viewtopic.php?f=15&t=5566 Original post at the forums] (very old, don't use!)<br />
<br />
=== Dependencies ===<br />
<br />
You need CMake, Python >= 2.6 (preferably Python 2.7), PyOpenGL, PySide (+ utils/tools), Boost.Python.<br />
<br />
==== Debian Wheezy ====<br />
<br />
PySide is part of Sid at the moment, so you have to add its repository address to your /etc/apt/sources.list<br />
<br />
apt-get install cmake python-opengl pyside-tools boost-python<br />
<br />
==== Arch Linux ====<br />
<br />
You need at least python2, boost, python-opengl, pyside (AUR), pyside-tools (AUR). PySide will bring in several other packages and will probably take a few hours to compile.<br />
<br />
Note: You probably need to add "-DPYTHON_EXECUTABLE=/usr/bin/python2" (without the quotes) to the cmake command line below because Arch Linux defaults to python 3 but the python modules CMake script expects python2.<br />
<br />
Arch Linux has the entire ceed packaged, see the AUR repo and save yourself all this trouble.<br />
<br />
==== Fedora ====<br />
<br />
You need boost-devel, python-devel, python-opengl, python-pyside, pyside-tools<br />
<br />
=== Build CEGUI and PyCEGUI ===<br />
<br />
(Or get it from distribution repo and skip this)<br />
<br />
hg clone https://bitbucket.org/cegui/cegui<br />
hg clone https://bitbucket.org/cegui/ceed<br />
cd ceed<br />
hg update v0-8<br />
cd ../<br />
cd cegui<br />
hg update v0-8<br />
cd ../<br />
mkdir cegui/build<br />
cd cegui/build<br />
cmake -DCEGUI_BUILD_PYTHON_MODULES=ON ../<br />
make -j 4<br />
<br />
== RENDERERS MODULES BAD DESIGN TROUBLES ==<br />
<br />
With current version ( 0,5 ) Ogre Rendere won't work , but OpenGL renderer works fine. What is more OpenGL renderer must be enabled with the OpenGL3 one !<br />
<br />
BEFORE CALLING >>make<< start the cmake-gui :<br />
cmake-gui<br />
and than in CMAKE tab set ONLY<br />
CEGUI_BUILD_RENDERER_NULL<br />
CEGUI_BUILD_RENDERER_OPENGL<br />
CEGUI_BUILD_RENDERER_OPENGL3<br />
<br />
== Launch ==<br />
<br />
cd ../ceed<br />
cd bin<br />
./runwrapper.sh<br />
./ceed-gui <br />
<br />
or<br />
$ cd ../ceed/bin<br />
$ PYTHONPATH=../../cegui/build/lib:../:$PYTHONPATH python2 ./ceed-gui<br />
<br />
You will see a window like this:<br />
<br />
[[Image:Ceed_main_window.png]]<br />
<br />
=== Troubleshooting ===<br />
* If it fails to import ceed.ui.* then you need to compile UI files, call<br />
[ceed] ./maintenance compile-ui-files<br />
Or alternatively edit ceed/version.py and set CEED_developerMode to True.<br />
* If the data files are missing you need to run the 'maintenance' script like this:<br />
[ceed/bin]$ cd ..<br />
[ceed]$ ./maintenance fetch-datafiles<br />
<br />
== Project ==<br />
<br />
Unlike old editors (CELayoutEditor and CEImagesetEditor), CEED has a notion of a project. Each project has its own combination of resources and runs its own CEGUI version to render your CEGUI resources. This allows you to have more that one scheme loaded at a time.<br />
<br />
To create a new project, you should go to '''File -> New project'''.<br />
<br />
The dialog appears. You should input project name and location of the ".project" file. '''Note''': parent directory of the ".project" file must exist.<br />
<br />
[[Image:Ceed_new_project.png]]<br />
<br />
After you press '''OK''', Project settings window appears.<br />
<br />
=== Project settings ===<br />
<br />
(The window is also accessible from '''Edit -> Project settings''')<br />
<br />
[[Image:Ceed_project_settings.png]]<br />
<br />
CEED can create assets for CEGUI versions: 0.6 to 0.8. 0.7 is the latest stable, so select it.<br />
<br />
Point "Resource directory" to the place where "fonts", "schemes" and the rest directories are located, then press '''Apply'''. It will change the paths below.<br />
<br />
Press '''OK''' and will load your resources. If it fails to, it will show you a warning dialog:<br />
<br />
[[Image:Ceed_new_project_warning.png]]<br />
<br />
In our case, the resource directory does not have "schemes" subdirectory, as noted on the last line. Correct the paths and retry.<br />
<br />
=== Project resources ===<br />
<br />
Currently CEED can only work with imagesets and layouts. Add them to your project by clicking with the right mouse button on '''Project manager''' and selecting '''Add existing file(s)''':<br />
<br />
[[Image:Ceed_project_add_existing.png]]<br />
<br />
Select the necessary imagesets and layouts, and save the project.<br />
<br />
=== Layouts ===<br />
<br />
[[Image:Ceed_layout.png]]<br />
<br />
To create a new widget, drag it from the left bottom panel.<br />
<br />
To edit it, you can either do it visually, or switch to "Code" tab seen below, and edit it manually. There's also "Preview" tab, where you can test your layout in real time.<br />
<br />
=== Imagesets ===<br />
<br />
[[Image:Ceed_imageset.png]]<br />
<br />
To create a new image, press tool bar button second from the right, or click with the right mouse button on the image itself and select '''Create image''':<br />
<br />
[[Image:Ceed_imageset_create_image.png]]<br />
<br />
It creates a 50 x 50 rectangle centered at where mouse cursor is. Move and resize it as you see fit.<br />
<br />
== Settings ==<br />
Go to '''Edit -> Application settings'''.<br />
<br />
[[Image:Ceed_application_settings.png]]<br />
<br />
There are many settings you can tweak. One of the most important might be '''Shortcuts'''. It allows you to assign shortcuts to zoom, image creation, opening a project, and so on.<br />
<br />
== Notes ==<br />
<br />
Currently you may have problems with Imagesets that use TGA, since some versions of Qt may be built without TGA support. CEGUI 0.8 has all imagery as PNG (CEGUI 0.7 used TGA), and we advise you to use PNG instead of TGA.</div>Paul424http://cegui.org/wiki/index.php?title=CEED&diff=5036CEED2013-12-22T13:40:26Z<p>Paul424: </p>
<hr />
<div>The CEGUI unified editor. Includes project management and multi-file/multi-tab editing.<br />
<br />
== Install ==<br />
<br />
CEED from the v0-8 branch (and all snapshots) depend on CEGUI 0.8. Even though it may work with CEGUI "default" it is not tested with it so don't expect any help if you try to make it work that way.<br />
<br />
[http://www.cegui.org.uk/phpBB2/viewtopic.php?f=15&t=5566 Original post at the forums] (very old, don't use!)<br />
<br />
=== Dependencies ===<br />
<br />
You need CMake, Python >= 2.6 (preferably Python 2.7), PyOpenGL, PySide (+ utils/tools), Boost.Python.<br />
<br />
==== Debian Wheezy ====<br />
<br />
PySide is part of Sid at the moment, so you have to add its repository address to your /etc/apt/sources.list<br />
<br />
apt-get install cmake python-opengl pyside-tools boost-python<br />
<br />
==== Arch Linux ====<br />
<br />
You need at least python2, boost, python-opengl, pyside (AUR), pyside-tools (AUR). PySide will bring in several other packages and will probably take a few hours to compile.<br />
<br />
Note: You probably need to add "-DPYTHON_EXECUTABLE=/usr/bin/python2" (without the quotes) to the cmake command line below because Arch Linux defaults to python 3 but the python modules CMake script expects python2.<br />
<br />
Arch Linux has the entire ceed packaged, see the AUR repo and save yourself all this trouble.<br />
<br />
==== Fedora ====<br />
<br />
You need boost-devel, python-devel, python-opengl, python-pyside, pyside-tools<br />
<br />
=== Build CEGUI and PyCEGUI ===<br />
<br />
(Or get it from distribution repo and skip this)<br />
<br />
hg clone https://bitbucket.org/cegui/cegui<br />
hg clone https://bitbucket.org/cegui/ceed<br />
cd ceed<br />
hg update v0-8<br />
cd ../<br />
cd cegui<br />
hg update v0-8<br />
cd ../<br />
mkdir cegui/build<br />
cd cegui/build<br />
cmake -DCEGUI_BUILD_PYTHON_MODULES=ON ../<br />
make -j 4<br />
<br />
== RENDERERS MODULES BAD DESIGN TROUBLES ==<br />
<br />
With current version ( 0,5 ) Ogre Rendere won't work , but OpenGL renderer works fine. What is more it must be enabled with the OpenGL3 module !!!<br />
BEFORE CALLING >>make<< start the cmake-gui :<br />
cmake-gui<br />
and than in CMAKE tab set ONLY<br />
CEGUI_BUILD_RENDERER_NULL<br />
CEGUI_BUILD_RENDERER_OPENGL<br />
CEGUI_BUILD_RENDERER_OPENGL3<br />
<br />
<br />
== Launch ==<br />
<br />
cd ../ceed<br />
cd bin<br />
./runwrapper.sh<br />
./ceed-gui <br />
<br />
or<br />
$ cd ../ceed/bin<br />
$ PYTHONPATH=../../cegui/build/lib:../:$PYTHONPATH python2 ./ceed-gui<br />
<br />
You will see a window like this:<br />
<br />
[[Image:Ceed_main_window.png]]<br />
<br />
=== Troubleshooting ===<br />
* If it fails to import ceed.ui.* then you need to compile UI files, call<br />
[ceed] ./maintenance compile-ui-files<br />
Or alternatively edit ceed/version.py and set CEED_developerMode to True.<br />
* If the data files are missing you need to run the 'maintenance' script like this:<br />
[ceed/bin]$ cd ..<br />
[ceed]$ ./maintenance fetch-datafiles<br />
<br />
== Project ==<br />
<br />
Unlike old editors (CELayoutEditor and CEImagesetEditor), CEED has a notion of a project. Each project has its own combination of resources and runs its own CEGUI version to render your CEGUI resources. This allows you to have more that one scheme loaded at a time.<br />
<br />
To create a new project, you should go to '''File -> New project'''.<br />
<br />
The dialog appears. You should input project name and location of the ".project" file. '''Note''': parent directory of the ".project" file must exist.<br />
<br />
[[Image:Ceed_new_project.png]]<br />
<br />
After you press '''OK''', Project settings window appears.<br />
<br />
=== Project settings ===<br />
<br />
(The window is also accessible from '''Edit -> Project settings''')<br />
<br />
[[Image:Ceed_project_settings.png]]<br />
<br />
CEED can create assets for CEGUI versions: 0.6 to 0.8. 0.7 is the latest stable, so select it.<br />
<br />
Point "Resource directory" to the place where "fonts", "schemes" and the rest directories are located, then press '''Apply'''. It will change the paths below.<br />
<br />
Press '''OK''' and will load your resources. If it fails to, it will show you a warning dialog:<br />
<br />
[[Image:Ceed_new_project_warning.png]]<br />
<br />
In our case, the resource directory does not have "schemes" subdirectory, as noted on the last line. Correct the paths and retry.<br />
<br />
=== Project resources ===<br />
<br />
Currently CEED can only work with imagesets and layouts. Add them to your project by clicking with the right mouse button on '''Project manager''' and selecting '''Add existing file(s)''':<br />
<br />
[[Image:Ceed_project_add_existing.png]]<br />
<br />
Select the necessary imagesets and layouts, and save the project.<br />
<br />
=== Layouts ===<br />
<br />
[[Image:Ceed_layout.png]]<br />
<br />
To create a new widget, drag it from the left bottom panel.<br />
<br />
To edit it, you can either do it visually, or switch to "Code" tab seen below, and edit it manually. There's also "Preview" tab, where you can test your layout in real time.<br />
<br />
=== Imagesets ===<br />
<br />
[[Image:Ceed_imageset.png]]<br />
<br />
To create a new image, press tool bar button second from the right, or click with the right mouse button on the image itself and select '''Create image''':<br />
<br />
[[Image:Ceed_imageset_create_image.png]]<br />
<br />
It creates a 50 x 50 rectangle centered at where mouse cursor is. Move and resize it as you see fit.<br />
<br />
== Settings ==<br />
Go to '''Edit -> Application settings'''.<br />
<br />
[[Image:Ceed_application_settings.png]]<br />
<br />
There are many settings you can tweak. One of the most important might be '''Shortcuts'''. It allows you to assign shortcuts to zoom, image creation, opening a project, and so on.<br />
<br />
== Notes ==<br />
<br />
Currently you may have problems with Imagesets that use TGA, since some versions of Qt may be built without TGA support. CEGUI 0.8 has all imagery as PNG (CEGUI 0.7 used TGA), and we advise you to use PNG instead of TGA.</div>Paul424http://cegui.org/wiki/index.php?title=CEED&diff=5035CEED2013-12-20T22:08:42Z<p>Paul424: </p>
<hr />
<div>The CEGUI unified editor. Includes project management and multi-file/multi-tab editing.<br />
<br />
== Install ==<br />
<br />
CEED from the v0-8 branch (and all snapshots) depend on CEGUI 0.8. Even though it may work with CEGUI "default" it is not tested with it so don't expect any help if you try to make it work that way.<br />
<br />
[http://www.cegui.org.uk/phpBB2/viewtopic.php?f=15&t=5566 Original post at the forums] (very old, don't use!)<br />
<br />
=== Dependencies ===<br />
<br />
You need CMake, Python >= 2.6 (preferably Python 2.7), PyOpenGL, PySide (+ utils/tools), Boost.Python.<br />
<br />
==== Debian Wheezy ====<br />
<br />
PySide is part of Sid at the moment, so you have to add its repository address to your /etc/apt/sources.list<br />
<br />
apt-get install cmake python-opengl pyside-tools boost-python<br />
<br />
==== Arch Linux ====<br />
<br />
You need at least python2, boost, python-opengl, pyside (AUR), pyside-tools (AUR). PySide will bring in several other packages and will probably take a few hours to compile.<br />
<br />
Note: You probably need to add "-DPYTHON_EXECUTABLE=/usr/bin/python2" (without the quotes) to the cmake command line below because Arch Linux defaults to python 3 but the python modules CMake script expects python2.<br />
<br />
Arch Linux has the entire ceed packaged, see the AUR repo and save yourself all this trouble.<br />
<br />
==== Fedora ====<br />
<br />
You need boost-devel, python-devel, python-opengl, python-pyside, pyside-tools<br />
<br />
=== Build CEGUI and PyCEGUI ===<br />
<br />
(Or get it from distribution repo and skip this)<br />
<br />
hg clone https://bitbucket.org/cegui/cegui<br />
hg clone https://bitbucket.org/cegui/ceed<br />
cd ceed<br />
hg update v0-8<br />
cd ../<br />
cd cegui<br />
hg update v0-8<br />
cd ../<br />
mkdir cegui/build<br />
cd cegui/build<br />
cmake -DCEGUI_BUILD_PYTHON_MODULES=ON ../<br />
make -j 4<br />
<br />
== Launch ==<br />
<br />
cd ../ceed<br />
cd bin<br />
./runwrapper.sh<br />
./ceed-gui <br />
<br />
or<br />
$ cd ../ceed/bin<br />
$ PYTHONPATH=../../cegui/build/lib:../:$PYTHONPATH python2 ./ceed-gui<br />
<br />
You will see a window like this:<br />
<br />
[[Image:Ceed_main_window.png]]<br />
<br />
=== Troubleshooting ===<br />
* If it fails to import ceed.ui.* then you need to compile UI files, call<br />
[ceed] ./maintenance compile-ui-files<br />
Or alternatively edit ceed/version.py and set CEED_developerMode to True.<br />
* If the data files are missing you need to run the 'maintenance' script like this:<br />
[ceed/bin]$ cd ..<br />
[ceed]$ ./maintenance fetch-datafiles<br />
<br />
== Project ==<br />
<br />
Unlike old editors (CELayoutEditor and CEImagesetEditor), CEED has a notion of a project. Each project has its own combination of resources and runs its own CEGUI version to render your CEGUI resources. This allows you to have more that one scheme loaded at a time.<br />
<br />
To create a new project, you should go to '''File -> New project'''.<br />
<br />
The dialog appears. You should input project name and location of the ".project" file. '''Note''': parent directory of the ".project" file must exist.<br />
<br />
[[Image:Ceed_new_project.png]]<br />
<br />
After you press '''OK''', Project settings window appears.<br />
<br />
=== Project settings ===<br />
<br />
(The window is also accessible from '''Edit -> Project settings''')<br />
<br />
[[Image:Ceed_project_settings.png]]<br />
<br />
CEED can create assets for CEGUI versions: 0.6 to 0.8. 0.7 is the latest stable, so select it.<br />
<br />
Point "Resource directory" to the place where "fonts", "schemes" and the rest directories are located, then press '''Apply'''. It will change the paths below.<br />
<br />
Press '''OK''' and will load your resources. If it fails to, it will show you a warning dialog:<br />
<br />
[[Image:Ceed_new_project_warning.png]]<br />
<br />
In our case, the resource directory does not have "schemes" subdirectory, as noted on the last line. Correct the paths and retry.<br />
<br />
=== Project resources ===<br />
<br />
Currently CEED can only work with imagesets and layouts. Add them to your project by clicking with the right mouse button on '''Project manager''' and selecting '''Add existing file(s)''':<br />
<br />
[[Image:Ceed_project_add_existing.png]]<br />
<br />
Select the necessary imagesets and layouts, and save the project.<br />
<br />
=== Layouts ===<br />
<br />
[[Image:Ceed_layout.png]]<br />
<br />
To create a new widget, drag it from the left bottom panel.<br />
<br />
To edit it, you can either do it visually, or switch to "Code" tab seen below, and edit it manually. There's also "Preview" tab, where you can test your layout in real time.<br />
<br />
=== Imagesets ===<br />
<br />
[[Image:Ceed_imageset.png]]<br />
<br />
To create a new image, press tool bar button second from the right, or click with the right mouse button on the image itself and select '''Create image''':<br />
<br />
[[Image:Ceed_imageset_create_image.png]]<br />
<br />
It creates a 50 x 50 rectangle centered at where mouse cursor is. Move and resize it as you see fit.<br />
<br />
== Settings ==<br />
Go to '''Edit -> Application settings'''.<br />
<br />
[[Image:Ceed_application_settings.png]]<br />
<br />
There are many settings you can tweak. One of the most important might be '''Shortcuts'''. It allows you to assign shortcuts to zoom, image creation, opening a project, and so on.<br />
<br />
== Notes ==<br />
<br />
Currently you may have problems with Imagesets that use TGA, since some versions of Qt may be built without TGA support. CEGUI 0.8 has all imagery as PNG (CEGUI 0.7 used TGA), and we advise you to use PNG instead of TGA.</div>Paul424http://cegui.org/wiki/index.php?title=CEED&diff=5034CEED2013-12-20T22:02:07Z<p>Paul424: </p>
<hr />
<div>The CEGUI unified editor. Includes project management and multi-file/multi-tab editing.<br />
<br />
== Install ==<br />
<br />
CEED from the v0-8 branch (and all snapshots) depend on CEGUI 0.8. Even though it may work with CEGUI "default" it is not tested with it so don't expect any help if you try to make it work that way.<br />
<br />
[http://www.cegui.org.uk/phpBB2/viewtopic.php?f=15&t=5566 Original post at the forums] (very old, don't use!)<br />
<br />
=== Dependencies ===<br />
<br />
You need CMake, Python >= 2.6 (preferably Python 2.7), PyOpenGL, PySide (+ utils/tools), Boost.Python.<br />
<br />
==== Debian Wheezy ====<br />
<br />
PySide is part of Sid at the moment, so you have to add its repository address to your /etc/apt/sources.list<br />
<br />
apt-get install cmake python-opengl pyside-tools boost-python<br />
<br />
==== Arch Linux ====<br />
<br />
You need at least python2, boost, python-opengl, pyside (AUR), pyside-tools (AUR). PySide will bring in several other packages and will probably take a few hours to compile.<br />
<br />
Note: You probably need to add "-DPYTHON_EXECUTABLE=/usr/bin/python2" (without the quotes) to the cmake command line below because Arch Linux defaults to python 3 but the python modules CMake script expects python2.<br />
<br />
Arch Linux has the entire ceed packaged, see the AUR repo and save yourself all this trouble.<br />
<br />
==== Fedora ====<br />
<br />
You need boost-devel, python-devel, python-opengl, python-pyside, pyside-tools<br />
<br />
=== Build CEGUI and PyCEGUI ===<br />
<br />
(Or get it from distribution repo and skip this)<br />
<br />
hg clone https://bitbucket.org/cegui/cegui<br />
hg clone https://bitbucket.org/cegui/ceed<br />
cd ceed<br />
hg update v0-8<br />
cd ../<br />
mkdir cegui/build<br />
cd cegui/build<br />
cmake -DCEGUI_BUILD_PYTHON_MODULES=ON ../<br />
make -j 4<br />
<br />
== Launch ==<br />
<br />
cd ../ceed<br />
cd bin<br />
./runwrapper.sh<br />
./ceed-gui <br />
<br />
or<br />
$ cd ../ceed/bin<br />
$ PYTHONPATH=../../cegui/build/lib:../:$PYTHONPATH python2 ./ceed-gui<br />
<br />
You will see a window like this:<br />
<br />
[[Image:Ceed_main_window.png]]<br />
<br />
=== Troubleshooting ===<br />
* If it fails to import ceed.ui.* then you need to compile UI files, call<br />
[ceed] ./maintenance compile-ui-files<br />
Or alternatively edit ceed/version.py and set CEED_developerMode to True.<br />
* If the data files are missing you need to run the 'maintenance' script like this:<br />
[ceed/bin]$ cd ..<br />
[ceed]$ ./maintenance fetch-datafiles<br />
<br />
== Project ==<br />
<br />
Unlike old editors (CELayoutEditor and CEImagesetEditor), CEED has a notion of a project. Each project has its own combination of resources and runs its own CEGUI version to render your CEGUI resources. This allows you to have more that one scheme loaded at a time.<br />
<br />
To create a new project, you should go to '''File -> New project'''.<br />
<br />
The dialog appears. You should input project name and location of the ".project" file. '''Note''': parent directory of the ".project" file must exist.<br />
<br />
[[Image:Ceed_new_project.png]]<br />
<br />
After you press '''OK''', Project settings window appears.<br />
<br />
=== Project settings ===<br />
<br />
(The window is also accessible from '''Edit -> Project settings''')<br />
<br />
[[Image:Ceed_project_settings.png]]<br />
<br />
CEED can create assets for CEGUI versions: 0.6 to 0.8. 0.7 is the latest stable, so select it.<br />
<br />
Point "Resource directory" to the place where "fonts", "schemes" and the rest directories are located, then press '''Apply'''. It will change the paths below.<br />
<br />
Press '''OK''' and will load your resources. If it fails to, it will show you a warning dialog:<br />
<br />
[[Image:Ceed_new_project_warning.png]]<br />
<br />
In our case, the resource directory does not have "schemes" subdirectory, as noted on the last line. Correct the paths and retry.<br />
<br />
=== Project resources ===<br />
<br />
Currently CEED can only work with imagesets and layouts. Add them to your project by clicking with the right mouse button on '''Project manager''' and selecting '''Add existing file(s)''':<br />
<br />
[[Image:Ceed_project_add_existing.png]]<br />
<br />
Select the necessary imagesets and layouts, and save the project.<br />
<br />
=== Layouts ===<br />
<br />
[[Image:Ceed_layout.png]]<br />
<br />
To create a new widget, drag it from the left bottom panel.<br />
<br />
To edit it, you can either do it visually, or switch to "Code" tab seen below, and edit it manually. There's also "Preview" tab, where you can test your layout in real time.<br />
<br />
=== Imagesets ===<br />
<br />
[[Image:Ceed_imageset.png]]<br />
<br />
To create a new image, press tool bar button second from the right, or click with the right mouse button on the image itself and select '''Create image''':<br />
<br />
[[Image:Ceed_imageset_create_image.png]]<br />
<br />
It creates a 50 x 50 rectangle centered at where mouse cursor is. Move and resize it as you see fit.<br />
<br />
== Settings ==<br />
Go to '''Edit -> Application settings'''.<br />
<br />
[[Image:Ceed_application_settings.png]]<br />
<br />
There are many settings you can tweak. One of the most important might be '''Shortcuts'''. It allows you to assign shortcuts to zoom, image creation, opening a project, and so on.<br />
<br />
== Notes ==<br />
<br />
Currently you may have problems with Imagesets that use TGA, since some versions of Qt may be built without TGA support. CEGUI 0.8 has all imagery as PNG (CEGUI 0.7 used TGA), and we advise you to use PNG instead of TGA.</div>Paul424http://cegui.org/wiki/index.php?title=Porting_tips_and_changes_from_0.7.X_to_0.8.X&diff=5026Porting tips and changes from 0.7.X to 0.8.X2013-12-18T12:38:40Z<p>Paul424: </p>
<hr />
<div>{{VersionBadge|0.7}}<br />
<br />
{{Section|1=Introduction|2=<br />
The 0.8.x branch has already seen releases. Please see the sourceforge page for tarball downloads.<br />
}}<br />
{{Section|1=Major renames/API changes|2=<br />
* CEGUI::Window was renamed to CEGUI::Widget as Widget is the coined term for that, WindowManager renamed to WidgetManager, etc... (not in mercurial yet!)<br />
* The stock/standard window renderer set (now widget renderer set) FalagardWRBase was renamed to StandardWRSet to avoid confusion with core [[Falagard]] facilities (not in mercurial yet!)<br />
* Windows now don't have absolute names! Every window's name only has to be unique in it's parent window. Therefore WindowManager::getSingleton().getWindow no longer made sense and was removed. If root's name was "Root" and your the window name was "Root/Stuff/After/Root/Name", you can emulate its behaviour with root->getChild("Stuff/After/Root/Name"). It's recommended to migrate to a more encapsulated model.<br />
* CEGUI::GUIContext class has been created that is responsible for injecting input and event handling, setting the default font, setting the root window, setting a default tooltip object and type, and manipulating the mouse cursor.<br />
* CEGUI::GUIContext needs time impulses injected separately! You should also inject time pulses into CEGUI::System. This API "wart" may disappear in future versions.<br />
* CEGUI::MouseCursor is no longer a singleton, and can be accessed and manipulated from CEGUI::GUIContext.<br />
}}<br />
{{Section|1=General|2=<br />
* All XML attributes must now be in lowercase, e.g. <WidgetLook Name="TaharezLook/FrameWindow"> must be <WidgetLook name="TaharezLook/FrameWindow"><br />
* PropertyHelper has been turned into a template class, instead of PropertyHelper::uintToString you do PropertyHelper<uint>::toString, instead of PropertyHelper::stringToUint you do PropertyHelper<uint>::fromString<br />
* All instances of the word caret that were incorrectly spelt 'carat' have been corrected. This affects all APIs, properties, events and datafiles.<br />
* Window::EventWindowUpdated renamed to Window::EventUpdated and the associated string is changed from "WindowUpdate" to "Updated"<br />
* ListHeader::SegmentNameSuffix changed type from character array to CEGUI::String<br />
* EventMouseEnters renamed to EventMouseEntersSurface (old name removed)<br />
* EventMouseLeaves renamed to EventMouseLeavesSurface (old name removed)<br />
* BiDiVisualMapping renamed to BidiVisualMapping. Also renamed the files, so CEGUIBiDiVisualMapping.h is now CEGUIBidiVisualMapping.h<br />
* class colour renamed to Colour, as a side effect the "colour" interpolator is now "Colour" interpolator, this breaks animation definitions!<br />
* Point typedef removed, please use Vector2 instead<br />
* Many event string values changed to match the C++ name (but without the Event prefix). A list of which strings changed value will appear here soon.<br />
* Window::setRestoreCapture renamed to Window::setRestoreOldCapture<br />
* CEGUI now supports custom memory allocation, see [[Memory Allocation]] to check if this concerns you or not.<br />
* Window::addChildWindow renamed to Window::addChild, Window::removeChildWindow renamed to Window::removeChild, several other methods (mostly in layout containers) changed from *ChildWindow* to *Child*<br />
* CEGUI::String can now be just a typedef or a class, depending on String configuration (CEGUI can now use std::string as CEGUI::String for apps not requiring unicode)<br />
* Window::getChild_impl method completely removed, it was only used by Window::getParentPixelSize, shouldn't be hard to replace<br />
* Vector2, Vector3, Size and Rect are now templated, you should use Vector2<float> (or just Vector2<> as a shortcut since float is the default type) instead of Vector2, UVector2 class was removed, UVector2 is now just a typedef to Vector2<UDim>. Same with Vector3, Size and Rect.<br />
* Texture::saveToMemory is renamed Texture::blitToMemory.<br />
* Renderer and Texture interfaces changed in order to support named textures.<br />
* Window::isDisabled(localOnly) is now split into Window::isDisabled (= old isDisabled(true) and Window::isEffectiveDisabled (= old isDisabled(false))<br />
* Window::isVisible(localOnly) is now split into Window::isVisible (= old isDisabled(true) and Window::isEffectiveVisible (= old isVisible(false))<br />
* WindowManager::loadWindowLayout is renamed to WindowManager::loadLayoutFromFile<br />
* NamedXMLResourceManager::create is renamed to NamedXMLResourceManager::createFromFile (Ex. CEGUI::SchemeManager::createFromFile)<br />
* Property from Window called "ZOrderChangeEnabled" renamed to "ZOrderingEnabled"<br />
* Property from Window called "MouseButtonDownAutoRepeat" renamed to "MouseAutoRepeatEnabled"<br />
* Property from Window called "CustomTooltipType" renamed to "TooltipType"<br />
* Property from Window called "Tooltip" renamed to "TooltipText"<br />
* Property from Window called "RiseOnClick" renamed to "RiseOnClickEnabled"<br />
* Property from Window called "UnifiedAreaRect" renamed to "Area", "UnifiedSize" renamed to "Size", etc...<br />
* CEGUI::DefaultLogger no longer throws const char* but a real exception in setLogFilename - http://www.cegui.org.uk/mantis/view.php?id=443<br />
* CEGUI now has inbuilt copy, cut, paste support, if you used a custom solution, you might want to check CEGUI::Clipboard and System::inject{Copy,Cut,Paste}Request<br />
* CEGUI::ProgressBar::getStep renamed to getStepSize for consistency with setStepSize<br />
* CEGUI::WidgetLookManager::parseLookNFeelSpecification is now called parseLookNFeelSpecificationFromFile, variants for loading from string and raw data container have been added<br />
* XRotation, YRotation, ZRotation properties merged into the new Rotation property, which is a Quaternion.<br />
}}<br />
{{Section|1=Image and ImageManager|2=<br />
* Image::draw renamed to Image::render<br />
* Image class is now an abstract interface. BasicImage implementation is provided, and used for internally created Image objects.<br />
* Imageset class is removed. It remains a CEGUI format that allows to conveniently define multiple images on one texture but the data is no longer stored in any class. When Imageset is loaded, the ImageManager creates a new BasicImage for each of the images in the imageset. Only the images themselves will remain after imageset is loaded. You now use the new ImageManager to access defined images.<br />
* ImagesetManager class is removed. You now use the new ImageManager.<br />
* Images belonging to a certain imageset can be accessed like so: "ImageSetName/ImageName" (ex. "AlfiskoSkin/MouseArrow").<br />
}}<br />
{{Section|1=GUIContext|2=<br />
A lot of API has been moved from CEGUI::System to CEGUI::GUIContext. CEGUI now allows you to create multiple independent GUI contexts with their own input injection.<br />
<br />
As a rule of thumb, whenever you see "There is no CEGUI::System::some_foobar_method* method", you can replace the call with CEGUI::System::getSingleton().getDefaultGUIContext().some_foobar_method*()<br />
<br />
WindowManager::getSingleton().getWindow() was removed. You can emulate its behaviour with root->getChild("Stuff/After/Root/Name").<br />
To get Root Window you can call GUIContext::getRootWindow();<br />
<br />
SIDE NOTE: The chain call of methods CEGUI::System::getSingleton().getDefaultGUIContext() should be called as rarely as possible, instead one should keep it's result in appropriate variable.<br />
<br />
}}<br />
{{Section|1=PyCEGUI|2=<br />
* EventSet.subscribeEvent now has a different, more pythonic syntax, any python callable (bound member function, free function, lambda, functor, ...) is allowed (EventSet.subscribeEvent("EventName", instance, "someMethodInIt") is now EventSet.subscribeEvent("EventName", instance.someMethodInIt)<br />
}}<br />
[[Category:Manuals]]</div>Paul424http://cegui.org/wiki/index.php?title=Porting_tips_and_changes_from_0.7.X_to_0.8.X&diff=5025Porting tips and changes from 0.7.X to 0.8.X2013-12-18T12:36:13Z<p>Paul424: </p>
<hr />
<div>{{VersionBadge|0.7}}<br />
<br />
{{Section|1=Introduction|2=<br />
The 0.8.x branch has already seen releases. Please see the sourceforge page for tarball downloads.<br />
}}<br />
{{Section|1=Major renames/API changes|2=<br />
* CEGUI::Window was renamed to CEGUI::Widget as Widget is the coined term for that, WindowManager renamed to WidgetManager, etc... (not in mercurial yet!)<br />
* The stock/standard window renderer set (now widget renderer set) FalagardWRBase was renamed to StandardWRSet to avoid confusion with core [[Falagard]] facilities (not in mercurial yet!)<br />
* Windows now don't have absolute names! Every window's name only has to be unique in it's parent window. Therefore WindowManager::getSingleton().getWindow no longer made sense and was removed. If root's name was "Root" and your the window name was "Root/Stuff/After/Root/Name", you can emulate its behaviour with root->getChild("Stuff/After/Root/Name"). It's recommended to migrate to a more encapsulated model.<br />
* CEGUI::GUIContext class has been created that is responsible for injecting input and event handling, setting the default font, setting the root window, setting a default tooltip object and type, and manipulating the mouse cursor.<br />
* CEGUI::GUIContext needs time impulses injected separately! You should also inject time pulses into CEGUI::System. This API "wart" may disappear in future versions.<br />
* CEGUI::MouseCursor is no longer a singleton, and can be accessed and manipulated from CEGUI::GUIContext.<br />
}}<br />
{{Section|1=General|2=<br />
* All XML attributes must now be in lowercase, e.g. <WidgetLook Name="TaharezLook/FrameWindow"> must be <WidgetLook name="TaharezLook/FrameWindow"><br />
* Image::draw renamed to Image::render<br />
* PropertyHelper has been turned into a template class, instead of PropertyHelper::uintToString you do PropertyHelper<uint>::toString, instead of PropertyHelper::stringToUint you do PropertyHelper<uint>::fromString<br />
* All instances of the word caret that were incorrectly spelt 'carat' have been corrected. This affects all APIs, properties, events and datafiles.<br />
* Window::EventWindowUpdated renamed to Window::EventUpdated and the associated string is changed from "WindowUpdate" to "Updated"<br />
* ListHeader::SegmentNameSuffix changed type from character array to CEGUI::String<br />
* EventMouseEnters renamed to EventMouseEntersSurface (old name removed)<br />
* EventMouseLeaves renamed to EventMouseLeavesSurface (old name removed)<br />
* BiDiVisualMapping renamed to BidiVisualMapping. Also renamed the files, so CEGUIBiDiVisualMapping.h is now CEGUIBidiVisualMapping.h<br />
* class colour renamed to Colour, as a side effect the "colour" interpolator is now "Colour" interpolator, this breaks animation definitions!<br />
* Point typedef removed, please use Vector2 instead<br />
* Many event string values changed to match the C++ name (but without the Event prefix). A list of which strings changed value will appear here soon.<br />
* Window::setRestoreCapture renamed to Window::setRestoreOldCapture<br />
* CEGUI now supports custom memory allocation, see [[Memory Allocation]] to check if this concerns you or not.<br />
* Window::addChildWindow renamed to Window::addChild, Window::removeChildWindow renamed to Window::removeChild, several other methods (mostly in layout containers) changed from *ChildWindow* to *Child*<br />
* CEGUI::String can now be just a typedef or a class, depending on String configuration (CEGUI can now use std::string as CEGUI::String for apps not requiring unicode)<br />
* Window::getChild_impl method completely removed, it was only used by Window::getParentPixelSize, shouldn't be hard to replace<br />
* Vector2, Vector3, Size and Rect are now templated, you should use Vector2<float> (or just Vector2<> as a shortcut since float is the default type) instead of Vector2, UVector2 class was removed, UVector2 is now just a typedef to Vector2<UDim>. Same with Vector3, Size and Rect.<br />
* Texture::saveToMemory is renamed Texture::blitToMemory.<br />
* Renderer and Texture interfaces changed in order to support named textures.<br />
* Window::isDisabled(localOnly) is now split into Window::isDisabled (= old isDisabled(true) and Window::isEffectiveDisabled (= old isDisabled(false))<br />
* Window::isVisible(localOnly) is now split into Window::isVisible (= old isDisabled(true) and Window::isEffectiveVisible (= old isVisible(false))<br />
* WindowManager::loadWindowLayout is renamed to WindowManager::loadLayoutFromFile<br />
* NamedXMLResourceManager::create is renamed to NamedXMLResourceManager::createFromFile (Ex. CEGUI::SchemeManager::createFromFile)<br />
* Property from Window called "ZOrderChangeEnabled" renamed to "ZOrderingEnabled"<br />
* Property from Window called "MouseButtonDownAutoRepeat" renamed to "MouseAutoRepeatEnabled"<br />
* Property from Window called "CustomTooltipType" renamed to "TooltipType"<br />
* Property from Window called "Tooltip" renamed to "TooltipText"<br />
* Property from Window called "RiseOnClick" renamed to "RiseOnClickEnabled"<br />
* Property from Window called "UnifiedAreaRect" renamed to "Area", "UnifiedSize" renamed to "Size", etc...<br />
* CEGUI::DefaultLogger no longer throws const char* but a real exception in setLogFilename - http://www.cegui.org.uk/mantis/view.php?id=443<br />
* CEGUI now has inbuilt copy, cut, paste support, if you used a custom solution, you might want to check CEGUI::Clipboard and System::inject{Copy,Cut,Paste}Request<br />
* CEGUI::ProgressBar::getStep renamed to getStepSize for consistency with setStepSize<br />
* CEGUI::WidgetLookManager::parseLookNFeelSpecification is now called parseLookNFeelSpecificationFromFile, variants for loading from string and raw data container have been added<br />
* XRotation, YRotation, ZRotation properties merged into the new Rotation property, which is a Quaternion.<br />
}}<br />
{{Section|1=Image and ImageManager|2=<br />
* Image class is now an abstract interface. BasicImage implementation is provided, and used for internally created Image objects.<br />
* Imageset class is removed. It remains a CEGUI format that allows to conveniently define multiple images on one texture but the data is no longer stored in any class. When Imageset is loaded, the ImageManager creates a new BasicImage for each of the images in the imageset. Only the images themselves will remain after imageset is loaded. You now use the new ImageManager to access defined images.<br />
* ImagesetManager class is removed. You now use the new ImageManager.<br />
* Images belonging to a certain imageset can be accessed like so: "ImageSetName/ImageName" (ex. "AlfiskoSkin/MouseArrow").<br />
}}<br />
{{Section|1=GUIContext|2=<br />
A lot of API has been moved from CEGUI::System to CEGUI::GUIContext. CEGUI now allows you to create multiple independent GUI contexts with their own input injection.<br />
<br />
As a rule of thumb, whenever you see "There is no CEGUI::System::some_foobar_method* method", you can replace the call with CEGUI::System::getSingleton().getDefaultGUIContext().some_foobar_method*()<br />
<br />
WindowManager::getSingleton().getWindow() was removed. You can emulate its behaviour with root->getChild("Stuff/After/Root/Name").<br />
To get Root Window you can call GUIContext::getRootWindow();<br />
<br />
SIDE NOTE: The chain call of methods CEGUI::System::getSingleton().getDefaultGUIContext() should be called as rarely as possible, instead one should keep it's result in appropriate variable.<br />
<br />
}}<br />
{{Section|1=PyCEGUI|2=<br />
* EventSet.subscribeEvent now has a different, more pythonic syntax, any python callable (bound member function, free function, lambda, functor, ...) is allowed (EventSet.subscribeEvent("EventName", instance, "someMethodInIt") is now EventSet.subscribeEvent("EventName", instance.someMethodInIt)<br />
}}<br />
[[Category:Manuals]]</div>Paul424http://cegui.org/wiki/index.php?title=Porting_tips_and_changes_from_0.7.X_to_0.8.X&diff=5024Porting tips and changes from 0.7.X to 0.8.X2013-12-18T12:30:43Z<p>Paul424: </p>
<hr />
<div>{{VersionBadge|0.7}}<br />
<br />
{{Section|1=Introduction|2=<br />
The 0.8.x branch has already seen releases. Please see the sourceforge page for tarball downloads.<br />
}}<br />
{{Section|1=Major renames/API changes|2=<br />
* CEGUI::Window was renamed to CEGUI::Widget as Widget is the coined term for that, WindowManager renamed to WidgetManager, etc... (not in mercurial yet!)<br />
* The stock/standard window renderer set (now widget renderer set) FalagardWRBase was renamed to StandardWRSet to avoid confusion with core [[Falagard]] facilities (not in mercurial yet!)<br />
* Image class is now an abstract interface. BasicImage implementation is provided, and used for internally created Image objects.<br />
* Imageset class is removed. It remains a CEGUI format that allows to conveniently define multiple images on one texture but the data is no longer stored in any class. When Imageset is loaded, the ImageManager creates a new BasicImage for each of the images in the imageset. Only the images themselves will remain after imageset is loaded. You now use the new ImageManager to access defined images.<br />
* ImagesetManager class is removed. You now use the new ImageManager.<br />
* Images belonging to a certain imageset can be accessed like so: "ImageSetName/ImageName" (ex. "AlfiskoSkin/MouseArrow").<br />
* Windows now don't have absolute names! Every window's name only has to be unique in it's parent window. Therefore WindowManager::getSingleton().getWindow no longer made sense and was removed. If root's name was "Root" and your the window name was "Root/Stuff/After/Root/Name", you can emulate its behaviour with root->getChild("Stuff/After/Root/Name"). It's recommended to migrate to a more encapsulated model.<br />
* CEGUI::GUIContext class has been created that is responsible for injecting input and event handling, setting the default font, setting the root window, setting a default tooltip object and type, and manipulating the mouse cursor.<br />
* CEGUI::GUIContext needs time impulses injected separately! You should also inject time pulses into CEGUI::System. This API "wart" may disappear in future versions.<br />
* CEGUI::MouseCursor is no longer a singleton, and can be accessed and manipulated from CEGUI::GUIContext.<br />
}}<br />
{{Section|1=General|2=<br />
* All XML attributes must now be in lowercase, e.g. <WidgetLook Name="TaharezLook/FrameWindow"> must be <WidgetLook name="TaharezLook/FrameWindow"><br />
* Image::draw renamed to Image::render<br />
* PropertyHelper has been turned into a template class, instead of PropertyHelper::uintToString you do PropertyHelper<uint>::toString, instead of PropertyHelper::stringToUint you do PropertyHelper<uint>::fromString<br />
* All instances of the word caret that were incorrectly spelt 'carat' have been corrected. This affects all APIs, properties, events and datafiles.<br />
* Window::EventWindowUpdated renamed to Window::EventUpdated and the associated string is changed from "WindowUpdate" to "Updated"<br />
* ListHeader::SegmentNameSuffix changed type from character array to CEGUI::String<br />
* EventMouseEnters renamed to EventMouseEntersSurface (old name removed)<br />
* EventMouseLeaves renamed to EventMouseLeavesSurface (old name removed)<br />
* BiDiVisualMapping renamed to BidiVisualMapping. Also renamed the files, so CEGUIBiDiVisualMapping.h is now CEGUIBidiVisualMapping.h<br />
* class colour renamed to Colour, as a side effect the "colour" interpolator is now "Colour" interpolator, this breaks animation definitions!<br />
* Point typedef removed, please use Vector2 instead<br />
* Many event string values changed to match the C++ name (but without the Event prefix). A list of which strings changed value will appear here soon.<br />
* Window::setRestoreCapture renamed to Window::setRestoreOldCapture<br />
* CEGUI now supports custom memory allocation, see [[Memory Allocation]] to check if this concerns you or not.<br />
* Window::addChildWindow renamed to Window::addChild, Window::removeChildWindow renamed to Window::removeChild, several other methods (mostly in layout containers) changed from *ChildWindow* to *Child*<br />
* CEGUI::String can now be just a typedef or a class, depending on String configuration (CEGUI can now use std::string as CEGUI::String for apps not requiring unicode)<br />
* Window::getChild_impl method completely removed, it was only used by Window::getParentPixelSize, shouldn't be hard to replace<br />
* Vector2, Vector3, Size and Rect are now templated, you should use Vector2<float> (or just Vector2<> as a shortcut since float is the default type) instead of Vector2, UVector2 class was removed, UVector2 is now just a typedef to Vector2<UDim>. Same with Vector3, Size and Rect.<br />
* Texture::saveToMemory is renamed Texture::blitToMemory.<br />
* Renderer and Texture interfaces changed in order to support named textures.<br />
* Window::isDisabled(localOnly) is now split into Window::isDisabled (= old isDisabled(true) and Window::isEffectiveDisabled (= old isDisabled(false))<br />
* Window::isVisible(localOnly) is now split into Window::isVisible (= old isDisabled(true) and Window::isEffectiveVisible (= old isVisible(false))<br />
* WindowManager::loadWindowLayout is renamed to WindowManager::loadLayoutFromFile<br />
* NamedXMLResourceManager::create is renamed to NamedXMLResourceManager::createFromFile (Ex. CEGUI::SchemeManager::createFromFile)<br />
* Property from Window called "ZOrderChangeEnabled" renamed to "ZOrderingEnabled"<br />
* Property from Window called "MouseButtonDownAutoRepeat" renamed to "MouseAutoRepeatEnabled"<br />
* Property from Window called "CustomTooltipType" renamed to "TooltipType"<br />
* Property from Window called "Tooltip" renamed to "TooltipText"<br />
* Property from Window called "RiseOnClick" renamed to "RiseOnClickEnabled"<br />
* Property from Window called "UnifiedAreaRect" renamed to "Area", "UnifiedSize" renamed to "Size", etc...<br />
* CEGUI::DefaultLogger no longer throws const char* but a real exception in setLogFilename - http://www.cegui.org.uk/mantis/view.php?id=443<br />
* CEGUI now has inbuilt copy, cut, paste support, if you used a custom solution, you might want to check CEGUI::Clipboard and System::inject{Copy,Cut,Paste}Request<br />
* CEGUI::ProgressBar::getStep renamed to getStepSize for consistency with setStepSize<br />
* CEGUI::WidgetLookManager::parseLookNFeelSpecification is now called parseLookNFeelSpecificationFromFile, variants for loading from string and raw data container have been added<br />
* XRotation, YRotation, ZRotation properties merged into the new Rotation property, which is a Quaternion.<br />
}}<br />
{{Section|1=GUIContext|2=<br />
A lot of API has been moved from CEGUI::System to CEGUI::GUIContext. CEGUI now allows you to create multiple independent GUI contexts with their own input injection.<br />
<br />
As a rule of thumb, whenever you see "There is no CEGUI::System::some_foobar_method* method", you can replace the call with CEGUI::System::getSingleton().getDefaultGUIContext().some_foobar_method*()<br />
<br />
WindowManager::getSingleton().getWindow() was removed. You can emulate its behaviour with root->getChild("Stuff/After/Root/Name").<br />
To get Root Window you can call GUIContext::getRootWindow();<br />
<br />
SIDE NOTE: The chain call of methods CEGUI::System::getSingleton().getDefaultGUIContext() should be called as rarely as possible, instead one should keep it's result in appropriate variable.<br />
<br />
}}<br />
{{Section|1=PyCEGUI|2=<br />
* EventSet.subscribeEvent now has a different, more pythonic syntax, any python callable (bound member function, free function, lambda, functor, ...) is allowed (EventSet.subscribeEvent("EventName", instance, "someMethodInIt") is now EventSet.subscribeEvent("EventName", instance.someMethodInIt)<br />
}}<br />
[[Category:Manuals]]</div>Paul424http://cegui.org/wiki/index.php?title=Talk:Porting_tips_and_changes_from_0.7.X_to_0.8.X&diff=5023Talk:Porting tips and changes from 0.7.X to 0.8.X2013-12-17T12:34:01Z<p>Paul424: </p>
<hr />
<div>Image & create (const String &type, const String &name)<br />
Create an instance of Image subclass registered for identifier type using the name name. <br />
<br />
<br />
This is the most crypytic API change regarding the Image / ImageManager class <br />
<br />
What types are there avalaible by default ?<br />
paul424</div>Paul424http://cegui.org/wiki/index.php?title=Talk:Porting_tips_and_changes_from_0.7.X_to_0.8.X&diff=5022Talk:Porting tips and changes from 0.7.X to 0.8.X2013-12-17T12:33:42Z<p>Paul424: Created page with "Image & create (const String &type, const String &name) Create an instance of Image subclass registered for identifier type using the name name. This is the most crypyti..."</p>
<hr />
<div>Image & create (const String &type, const String &name)<br />
Create an instance of Image subclass registered for identifier type using the name name. <br />
<br />
<br />
This is the most crypytic API change regarding the Image / ImageManager class <br />
<br />
What types are there avalaible by default ?</div>Paul424