Page 1 of 1

(Solved) Formatting Tags reference

Posted: Wed Sep 15, 2010 15:38
by mboeni
Hi all

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

Cheers,
Michael

Re: Formatting Tags reference

Posted: Wed Sep 15, 2010 15:40
by IR3uL
What do you mean with formatting tags?

Re: Formatting Tags reference

Posted: Wed Sep 15, 2010 15:47
by 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 :)

Re: Formatting Tags reference

Posted: Wed Sep 15, 2010 16:38
by 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 ;)

Re: Formatting Tags reference

Posted: Wed Sep 15, 2010 17:12
by 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 ;)

Re: Formatting Tags reference

Posted: Wed Sep 15, 2010 17:25
by 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! :D

Re: Formatting Tags reference

Posted: Fri Sep 24, 2010 13:56
by 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

Re: Formatting Tags reference

Posted: Fri Sep 24, 2010 14:03
by 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.

Re: Formatting Tags reference

Posted: Fri Sep 24, 2010 14:09
by 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.

Re: Formatting Tags reference

Posted: Fri Sep 24, 2010 15:54
by IR3uL
Yay! nice work man!

Re: (Solved) Formatting Tags reference

Posted: Fri Sep 24, 2010 16:49
by 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?

Re: (Solved) Formatting Tags reference

Posted: Fri Sep 24, 2010 17:24
by 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

Re: (Solved) Formatting Tags reference

Posted: Mon Sep 27, 2010 13:06
by CrazyEddie
Thanks for your efforts here; I like it :D

CE