CEED /

Filename Size Date modified Message
bin
build
ceed
data
doc
445 B
Added author aliases for 'hg churn'
296 B
Added *.md to hgeol
535 B
Fixed problems in ceed-mic when dealing with onlyPOT, added basic integration tests for it
713 B
Added tag v0-8-0 for changeset 03853182a1e3
1.4 KB
MOD: Adding my name to the authors file
32.1 KB
ADD: AUTHORS and LICENSE files
4.2 KB
Added a note about sample datafiles into README.md
1.6 KB
Added appdata support, the appdata file is installed with setup.py
181 B
Added a desktop file and it's getting installed by the install script
3.1 KB
Renamed icons to sensible names and added them to the install script
409 B
Added script that generates API reference using epydoc
8.2 KB
Include runwrapper.sh in the source tarball
875 B
Check for dependencies in the static analysis script
6.7 KB
Added helpful format lists to ceed-migrate, improved docs, changed the CLI of it
2.6 KB
Fixed the run_tests script to use $TEMPDIR instead of /tmp
3.8 KB
Don't require pysideuic in setup.py unless DEVELOPER_MODE is enabled

CEGUI Unified Editor

User Manual

CEED comes with a beautifully formatted PDF explaining many of its functions. Please, read it! Seriously, please read the manual. It comes as a PDF in the release tarballs, you can also build it yourself if you have LyX - see the doc folder.

Alternatively visit http://static.cegui.org.uk/docs/ and select the appropriate CEED version.

Other Resources

Contributing

We are happiest with clean pull requests containing conscise commits with proper commit messages. We also accept plain patches but making it easier for us to just accept your contribution with one click greatly speeds up the review process.

  • Join the #cegui and #cegui-devel channels on irc.freenode.net

Quick Start Guide

Dependencies

  1. Python 2.7+ (but not Python 3)

    If you have 32bit CEGUI you have to use 32bit Python, the arch has to match! It is recommended to use the same toolchain to build PyCEGUI that your Python was built with, on Windows with Python 2.7 this will most likely be MSVC 2008.

  2. CEGUI 0.8.x with PyCEGUI
  3. Qt 4.7+ with PySide
  4. PyOpenGL

Requirements

You need an OpenGL capable GPU with FBO support. CEED will run without that but layout editing will exhibit artifacts.

CEED was tested on Linux, MacOS X, Windows and FreeBSD. It may or may not run on other systems.

Starting CEED

system-wide install (Linux or MacOS X)

# as root
python setup.py install

Then you can start CEED using

ceed-gui

You can also use the other tools called ceed-migrate and ceed-mic.

local developer setup (without installation) on Linux, BSD, OS X, etc...

Go to "bin" and start runwrapper.sh. It will spawn a shell with PYTHONPATH defined so that "ceed" is found properly.

cd ceed/bin
# runwrapper creates the necessary environment
./runwrapper.sh
# start CEED
./ceed-gui
# you can also use debugging tools - pdb, gdb, cgdb, valgrind - in the environment

See the script's contents for more details.

local developer setup (without installation) on Windows

The only difference is that you need to start runwrapper.bat and the script will start ceed-gui automatically. This is the preferred choice on Windows because the terminal emulators are horrible.

sample datafiles

CEED comes with a few project files to get you started. See data/samples/StockDatafiles_$version.project. If you are using CEED from a repository instead of a source tarball, you need to fetch datafiles from the CEGUI repository. Use ./maintenance fetch-datafiles to do that.

Troubleshooting

Can't import ceed.ui.something

You haven't got the .ui files compiled. Compile them with ./maintenance compile-ui-files or switch to developer mode (see ceed/version.py)

Released CEED versions come with compiled UI files but these are not committed to the repository. Either use a released tarball or compile UI files as instructed above.

If you are developing CEED you probably don't want to manually compile UI files all the time, switch to the developer mode in ceed/version.py and it will be done automatically every time CEED starts.

Module ceed not found

Unless you have installed ceed system-wide, you have to set several environment variables so that everything is found correctly.

Please see the section Starting CEED above.

CEED vs CEGUI Editor vs CEGUI Unified Editor

Yes, there is some confusion regarding the names. CEGUI has had many editors in the past and we sort of ran out of ideas. CEED stands for CEguiEDitor. It's very often also called "CEGUI Unified Editor" because it has features previously only available in multiple editor applications.