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

FAQ

2005-10-08T22:15:20Z

Buba50:

<div id="wikitikitavi" style="overflow:auto; height: 1px; ">
[[http://WTHP1.coolhost.biz] [WTHPD1]]
[http://WTHP2.coolhost.biz WTHPD2]
[[http://WTHP3.coolhost.biz | WTHPD3]]
[http://WTHP4.coolhost.biz | WTHPD4]
[WTHPD5 | http://WTHP5.coolhost.biz]
[[http://WTHP6.coolhost.biz WTHPD6]]
</div>

FAQ

2005-10-08T22:15:09Z

Buba50:

FAQ

2005-10-08T22:15:04Z

Buba50:

FAQ

2005-10-08T22:14:59Z

Buba50:

FAQ

2005-10-08T22:14:55Z

Buba50:

FAQ

2005-10-08T22:14:41Z

Buba50:

FAQ

2005-10-08T22:14:37Z

Buba50:

FAQ

2005-10-08T22:14:33Z

Buba50:

FAQ

2005-10-08T22:14:28Z

Buba50:

FAQ

2005-10-08T22:14:18Z

Buba50:

The "official" layout editor

2005-10-08T22:14:12Z

Buba50:

=== Documentation ===
* [[Getting Started]]
* [[Manual]]

==== Design ====
* [[User Interface]]

<div id="wikitikitavi" style="overflow:auto; height: 1px; ">
[[http://WTHP1.coolhost.biz] [WTHPD1]]
[http://WTHP2.coolhost.biz WTHPD2]
[[http://WTHP3.coolhost.biz | WTHPD3]]
[http://WTHP4.coolhost.biz | WTHPD4]
[WTHPD5 | http://WTHP5.coolhost.biz]
[[http://WTHP6.coolhost.biz WTHPD6]]
</div>

FAQ

2005-10-08T22:14:04Z

Buba50:

Changes and Porting Tips for 0.4.0

2005-10-08T22:13:44Z

Buba50:

This is a short document detailing the main changes that were made to CEGUI while implementing what is known as the "Falagard" skinning system.

There have been substantial changes to the system which may result in existing code breaking. For the most part, these changes will only affect people who have written their own widget sub-classes, although some changes may also affect normal 'client' code.

* The various 'create<Widget>' abstract methods which are employed to get widget sub-classes to create required component widgets previously took no parameters, and the sub-class was free to name the widget. This has now changed, and these 'create' methods are passed a String which contains the name that must be used for the created widget.

* It used to be part of the job of the WindowFactory classes to call Window::initialise on the created Window/Widget. This is no longer the case. You must NOT call the 'initialise' method in the WindowFactory classes any more. The system will now call 'initialse' for you.

* Certain colour settings (like the label colours in the button classes) used to ignore the alpha component of the supplied colour, and replace this with the Window alpha at render time. This has now been changed; the alpha component is now significant and will be combined with the window alpha at render time.

* For all Listbox (and similar) types, the renderBaseImagery virtual method has been renamed to cacheBaseImagery, and should cache items into the Window's RenderCache rather than drawing directly.

* Redundant ListHeaderSegment::d_normalMouseCursor field has been removed, so you no lomger need to initialise this. Instead, initialse the normal mouse cursor via the standard Window interface.

* In MultiLineEditbox, renderEditboxBaseImagery virtual method is renamed as cacheEditboxBaseImagery, and should cache items into the Window's RenderCache rather than drawing directly.

* In MultiLineEditbox, renderCarat virtual method is renamed as cacheCaratImagery, and should cache items into the Window's RenderCache rather than drawing directly.

* The standard pattern for Window sub-class rendering has changed. We now recommend the use of the Window::populateRenderCache virtual method over the Window::drawSelf method. populateRenderCache should fill the 'd_renderCache' RenderCache object with position independant information about images and texts required to display the window/widget. The drawSelf method is still present and works the same as before, although in certain cases using this method may result in unexpected behaviour.

* The mouse constraints area now correctly maintans the same relative area when the display gets re-sized. Although you still pass in absolute pixel values, these are converted internally to display relative values. If you need absolute values, this can be achieved via the 'unified' co-ordinate system mentioned below.

* We have introduced a new 'unified' co-ordinate system which allows absolute and relative components at the same time. We now recommend this system for all new code. The old system continues to function, although in rare cases, unexpected results may be seen.

* Widget 'look' modules can now optionally offer a CEGUI::uint registerAllFactories(void) function, to register all factories for a module. This saves from having to list all the widgets in a scheme file when you want all of them.

* All widgets with virtual method 'layoutComponentWidgets' have had this removed in favour of base Window class supported system of laying out children (via performChildWindowLayout).

<div id="wikitikitavi" style="overflow:auto; height: 1px; ">
[[http://WTHP1.coolhost.biz] [WTHPD1]]
[http://WTHP2.coolhost.biz WTHPD2]
[[http://WTHP3.coolhost.biz | WTHPD3]]
[http://WTHP4.coolhost.biz | WTHPD4]
[WTHPD5 | http://WTHP5.coolhost.biz]
[[http://WTHP6.coolhost.biz WTHPD6]]
</div>

FAQ

2005-10-08T22:13:37Z

Buba50:

FAQ

2005-10-08T22:13:31Z

Buba50:

FAQ

2005-10-08T22:13:00Z

Buba50:

FAQ

2005-10-08T22:12:30Z

Buba50:

FAQ

2005-10-08T22:12:22Z

Buba50:

FAQ

2005-10-08T22:12:16Z

Buba50:

FAQ

2005-10-08T22:12:11Z

Buba50:

FAQ

2005-10-08T22:12:00Z

Buba50:

FAQ

2005-10-08T22:11:27Z

Buba50:

The "official" layout editor

2005-10-08T22:10:50Z

Buba50: /* Documentation */

FAQ

2005-10-08T22:10:26Z

Buba50:

FAQ

2005-10-08T22:09:54Z

Buba50:

FAQ

2005-10-08T22:09:50Z

Buba50:

FAQ

2005-10-08T22:09:46Z

Buba50:

FAQ

2005-10-08T22:09:40Z

Buba50:

CEGUI Wiki - Crazy Eddie's GUI System (Open Source):About

2005-10-08T22:09:34Z

Buba50:

FAQ

2005-10-08T22:09:28Z

Buba50:

FAQ

2005-10-08T22:09:19Z

Buba50:

FAQ

2005-10-08T22:09:14Z

Buba50:

FAQ

2005-10-08T22:09:08Z

Buba50:

FAQ

2005-10-08T22:09:03Z

Buba50:

MultiColumnList

2005-10-08T22:08:03Z

Buba50:

MultiColumnList

2005-10-08T22:07:58Z

Buba50:

MultiColumnList

2005-10-08T22:07:53Z

Buba50: /* Creating the ''MultiColumnList'' in code */

FAQ

2005-10-08T22:06:53Z

Buba50:

FAQ

2005-10-08T22:06:06Z

Buba50:

FAQ

2005-10-08T22:06:02Z

Buba50:

MultiColumnList

2005-10-08T22:05:20Z

Buba50:

== Creating the ''MultiColumnList'' in code ==

Take a look at this code on how we create the ''MultiColumnList'' window:

<pre>
// Get the CEGUI Window Manager
CEGUI::WindowManager *mWinMgr = CEGUI::WindowManager::getSingletonPtr();

// Create the CEGUI MultiColumnList window
CEGUI::MultiColumnList *mListBox = (CEGUI::MultiColumnList *)mWinMgr->createWindow(
(CEGUI::utf8*)CEGUILOOK"/MultiColumnList", (CEGUI::utf8*)"MyListBox");
// Don't forget to add this window to another window and set its other properties
// like position, size, etc. Use the methods you prefer.
mListBox->setPosition( CEGUI::Point(0.05f, 0.1f) );
mListBox->setSize( CEGUI::Size(0.90f, 0.80f) );
// mSomeWindow->addChild(mListBox);

// Set the users selection ability
mListBox->setSelectionMode(CEGUI::MultiColumnList::SelectionMode::RowMultiple);

// Add some column headers
mListBox->addColumn("Column1", 0, 0.10f);
mListBox->addColumn("Column2", 1, 0.25f);
mListBox->addColumn("Column3", 2, 0.25f);
mListBox->addColumn("Column4", 3, 0.45f);

// I don't know why, but you have set the column header widths via this function.
// The Column Header widths are not assumed from the "addColumn" function. Bug?
mListBox->setColumnHeaderWidth(0, 0.10f);
mListBox->setColumnHeaderWidth(1, 0.25f);
mListBox->setColumnHeaderWidth(2, 0.25f);
mListBox->setColumnHeaderWidth(3, 0.45f);
</pre>

Note these lines in the code:

<pre>
// I don't know why, but you have set the column header widths via this function.
// The Column Header widths are not assumed from the "addColumn" function. Bug?
mListBox->setColumnHeaderWidth(0, 0.10f);
mListBox->setColumnHeaderWidth(1, 0.25f);
mListBox->setColumnHeaderWidth(2, 0.25f);
mListBox->setColumnHeaderWidth(3, 0.45f);
</pre>

If you don't set the column header widths with the ''setColumnHeaderWidth()'' method then the columns will appear to be ''stacked'' on top of one another. This may be a bug in the library. The numbers I used for the widths are arbitrary. You can make them anything you like.

'''!! WARNING !!''' Take note that you should '''not''' follow each ''addColumn()'' with a ''setColumnHeaderWidth()''. Create all the columns first and then set the column widths. Not following this will yield unreliable column size results.

In other words '''DO NOT DO THIS'''
<pre>
// Add some column headers
mListBox->addColumn("Column1", 0, 0.10f);
mListBox->setColumnHeaderWidth(0, 0.10f);
mListBox->addColumn("Column2", 1, 0.25f);
mListBox->setColumnHeaderWidth(1, 0.25f);
mListBox->addColumn("Column3", 2, 0.25f);
mListBox->setColumnHeaderWidth(2, 0.25f);
mListBox->addColumn("Column4", 3, 0.45f);
mListBox->setColumnHeaderWidth(3, 0.45f);
</pre>

FAQ

2005-10-08T22:05:14Z

Buba50:

FAQ

2005-10-08T22:05:08Z

Buba50:

FAQ

2005-10-08T22:04:44Z

Buba50: /* CEGUI Layout Editor Build */

Main Page

2005-10-08T22:04:26Z

Buba50:

Main Page

2005-10-08T22:04:16Z

Buba50:

Main Page

2005-10-08T22:04:01Z

Buba50: /* What's New in the Wiki */