(Solved) Formatting Tags reference

[mboeni]

Hi all

Can anyone point me towards a formatting tags reference or tutorial? Haven't found much myself yet

Cheers,
Michael

[IR3uL]

What do you mean with formatting tags?

[mboeni]

CEGUI offers text formatting. Check out this thread:
http://www.cegui.org.uk/phpBB2/viewtopic.php?f=10&t=4855&start=0

I just have not found a reference or tut for it

[IR3uL]

The thread you pointed explains how to use it (a tutorial? =D). As for reference, maybe this helps http://www.cegui.org.uk/docs/current/classCEGUI_1_1BasicRenderedStringParser.html

I know is not much but a list of properties is a start. You can have a look at CEGUIBasicRenderedStringParser.h/cpp too. I made a few quick tests and it seems simple to use.

Also, if you have time, you can arrange a wiki article about this

[mboeni]

The "how" is not really an issue I'm more into the '"what's possible". The class reference is certainly a start, thanks!
And yes, if i find enough info I can create a wiki article

[IR3uL]

Check this video

It's a bit outdated (+1 year i think) but it's a nice demo of the string formatting caps. Some trial & error should do the rest.

Have fun!

[mboeni]

Hi mate!

As promised, I have written a tutorial about tags

Here you go:

http://www.cegui.org.uk/wiki/index.php/Formatting_Tags_in_CEGUI

Enjoy! Feedback welcome!

Cheers,
Michael

[Kulik]

Nicely written! You seem to have some doc writing skills This is what CEGUI lacks IMO. It has docs aimed at advanced developers but no beginner material taking people step by step over concepts.

[mboeni]

Thanks Thats why I wrote it. Im still a (bloody) CEGUI newbie but I'm catching on And its definitely not my last tutorial.

[IR3uL]

Yay! nice work man!

[Jamarr]

Looks good so far. This should definitely help people understand how to use these tags. I briefly skimmed over it and noticed a few things:

• You use colour and color - stick to colour since that is what CEGUI uses
• You do not "need to have" font files; fonts can be created dynamically in code via the CEGUI::FontManager - using the .font files is good for a beginner tutorial, but don't make them sound like a requirement; perhaps change "Font formatting is a bit more involved as you need to have the actual fonts and the ‘font’ XML files defined for each style." > "Font formatting is a bit more involved. The simple approach is to define fonts in ‘font’ XML files for each style."
• Your first example of embedding an image seems to be missing an apostrophe: [image=set:<imageset> image:<image>']
• Under Image Size, the second sentence starts "The sized" s/b "The sizes"
• Under Vertical Alignment, the word Tag is capitalized when it does not need to be
• embed the defined window...into you string > into the string

Filling in those screenshots will be a nice touch; I wonder if embedding the YouTube video would be useful?

[mboeni]

You use colour and color - stick to colour since that is what CEGUI uses

--> Done

You do not "need to have" font files; fonts can be created dynamically in code via the CEGUI::FontManager - using the .font files is good for a beginner tutorial, but don't make them sound like a requirement; perhaps change "Font formatting is a bit more involved as you need to have the actual fonts and the ‘font’ XML files defined for each style." > "Font formatting is a bit more involved. The simple approach is to define fonts in ‘font’ XML files for each style."

--> Feel free to add this to the tutorial.

Your first example of embedding an image seems to be missing an apostrophe: [image=set:<imageset> image:<image>']

--> Done

Under Image Size, the second sentence starts "The sized" s/b "The sizes"

--> Done

Code: Select all

Under Vertical Alignment, the word Tag is capitalized when it does not need to be

--> Done

embed the defined window...into you string > into the string

--> Done

[CrazyEddie]

Thanks for your efforts here; I like it

CE