Revision as of 15:04, 26 February 2011

Inactive windows become transparent

WARNING ! As for now (02.07.2007), this code does make all your tooltips transparent, I'm working on a solution.

Problem solved (02.07.2007). If you used the old code, please replace by the new.

Please discuss this snippet within the cool window effects - Inactive windows become trans. thread.

Do you know about the cool effects that the composite extension can create on linux ? There are many. I wanted to implement one into my game: make the inactive windows become transparent and only the active one be 100% opaque. (see the links in this sentence for screenshots.) This effect can be interesting if you want your users to concentrate 100% on the active window and the inactive ones aren't important at this moment. But what if the user has to see two windows or more at the same time (and with full opacity) ? We'll see how to handle this.

The theory

There is more then one way to achieve this, but I'll only present the one I chose. CEGUI has something that is called global events. These are events that are fired independently on the widget they apply to. I'll try with an example: sometimes you need to know when a button is clicked, no matter what button it is, you want to know it for EVERY button. This is what global events are for.

We'll subscribe to two global events: "a window gets activated" and "a window gets closed". When a window gets activated, we add it to a stack which we use to keep track of the windows and the order they where activated. We also make the last active window become transparent. When a window gets closed, we remove it from the stack and activate the one that is on the top of the stack now. (that is the window that was active just before the one we just closed.)

We keep the root window away from it, that means we never make the root window transparent, because this would make the tooltips become transparent. You need to have an empty root window that is a container for your other windows.

The praxis (code)

Now let's go ! First, we need to register callback functions to the two global events: <cpp/> CEGUI::GlobalEventSet::getSingleton( ).subscribeEvent( CEGUI::Window::EventNamespace + "/" + CEGUI::Window::EventActivated,

                                                      CEGUI::Event::Subscriber(&onWindowActivated) );

                                                      CEGUI::Event::Subscriber(&onWindowClosed) );

We also need a stack to keep track of the windows. I chose to use the std::list type instead of the std::stack, because we need to be able to either delete all references of one element or to search the stack. So here it is: <cpp/>std::list<CEGUI::Window *> pWinHistory;

Also, don't forget to put your root window just before setting it as the root window: <cpp/>pWinHistory.push_back(pMyRootWindow); CEGUI::System::getSingleton().setGUISheet(pMyRootWindow);

One thing you need to know about the root window is that you need an empty root window, containing one or more child windows that contain all GUI items. Your root window will never become transparent, thus you need an empty "container" root window.

And now we implement our two callback functions. I excessively commented the functions.

onWindowActivated: <cpp/>/// Called everytime a window gets activated. /** This function is called by CEGUI every time that a window gets the focus.

*
*  Currently, we use this function to keep track of the order that windows where
*  active, so when closing a window we can activate the last one, as this isn't
*  done automatically by CEGUI.
*
* \param e The event arguments.
*
* \return Always true.
*
* \author Pompei2
*/

	} catch( CEGUI::Exception& e ) {

return true; }

And onWindowClosed: <cpp/>/// Called everytime a window gets closed. /** This function is called by CEGUI just before a window gets closed.

*
*  Currently, we use this function to activate the previous window
*  when closing this one, as it's not done automatically by CEGUI.
*
* \param e The event arguments.
*
* \return Always true.
*
* \author Pompei2
*/

return true; }

That's all.

One important thing you might not know yet, is that CEGUI DOESN'T activate a window that gets shown. you have to manually activate a window when you create it (and want it to be active, of course).

Extending the effect

• You could also automatically activate a window as soon as it's shown. for this you could subscribe to the "a window gets shown" global event and then just call ea.window->activate( );

Edit: Hmm I tried this one but wasn't able to get it to work. If someone has success, please tell us how you did it in the forums.

• You could try to make the window's transparency degree dependent on its position in the stack. That means the most recent windows get less transparent while the "oldest" windows get very transparent. To do this, just loop trough the stack - that would be a list - and set every window's transparency accordingly. Do this when a window gets active AND when a window gets closed. You would also need to never have the same window twice in the stack, as it would screw your results up.

--Pompei2 06:00, 6 May 2007 (PDT)

you can add more cool effects here.