GUI profiles documentation?

#1 I don't believe there is any GUI Profile documentation. I often look in common/gui/profiles.cs to see what the standard Garage Games GUI elements use per type. Then I look through the code.

The main problem is that there is only one GuiControlProfile class, not one per GUI control type. Often, in order to see what a GUI needs, I look through the source code. For example, you'll see in GuiButtonControl::onRender that it uses mProfile->mFillColorHL for depressed butons and mProfile->mFillColor otherwise.

Then, looking through GuiControlProfile::initPersistFields, I see that mFillColorHL is mapped to fillColorHL and mFillColor is mapped to fillColor. (In general, "mXYZ" is mapped to "xYZ", with only font colors differing from this.)

Unfortunately, it's really up to each GUI Control type to define how each variable in the GuiControlProfile is used.

#2 Thank you Willian, nice tip!

Now i understand why many guys create your GUIs using the sceneWindow.

#3 There is an intro to profiles tutorial in the TGB Mini Tutorials section on TDN. ->clicky.

Post back if you have any questions about it.

#4 Thanks Thomas!

#5 I recently prepared this reference to GuiControlProfile. It discusses the class, the default values for the (46!) member fields, and has a relatively complete list of the (>110!) instances of this class bundled with TGB, along with the particular GuiControl classes that use them.

I am presently working on a tool to help people understand what each of the member fields does to the GuiControl they are working with.

#6 Great work, Evan.

#7 Thanks, Thomas!

I have posted the work I refered to in my post of Feb 13: it is the Gui Learning Project, and will be the vehicle for understanding the member fields of GuiControlProfile, as I mentioned.

In the meantime, please have a look at it and give me feedback.