Unified Positions and Sizes System - Revision history

Kulik at 21:36, 26 February 2011

2011-02-26T21:36:44Z

Kulik: moved Use the Unified Positions and Sizes System to Unified Positions and Sizes System

2011-02-26T21:36:23Z

moved Use the Unified Positions and Sizes System to Unified Positions and Sizes System

Kulik: moved HOWTO: Use the Unified Positions and Sizes System to Use the Unified Positions and Sizes System: Not a How To (IMO)

2011-02-26T21:36:09Z

moved HOWTO: Use the Unified Positions and Sizes System to Use the Unified Positions and Sizes System: Not a How To (IMO)

Capek: Robot: Cosmetic changes

2011-02-26T15:13:09Z

Robot: Cosmetic changes

Kulik at 12:11, 26 February 2011

2011-02-26T12:11:16Z

Makofierce at 09:43, 7 January 2011

2011-01-07T09:43:34Z

Kulik: testing multiple badges

2010-10-02T20:26:14Z

testing multiple badges

lindquist at 08:58, 4 January 2006

2006-01-04T08:58:58Z

Ayudo at 08:08, 7 December 2005

2005-12-07T08:08:08Z

Ayudo at 07:58, 7 December 2005

2005-12-07T07:58:43Z

New page

'''note: This system/page only applies to CEGUI >= 0.4.0'''

The system is explained the easiest way by examples:

<Property Name="UnifiedPosition" Value="{{0.1,10},{1.0,-30}}" />

X-position: 10% of the width of the parent window + 10 pixel
Y-position: 30 pixel above the bottom of the parent window

<Property Name="UnifiedSize" Value="{{0.6,5},{0.3,20}}" />

Width: 60% of the width of the parent window + 5 pixel
Height: 30% of the height of the parent window + 20 pixel

I hope you got the idea.

← Older revision		Revision as of 21:36, 26 February 2011
Line 82:		Line 82:
	Height: 80% of the height of the parent window.		Height: 80% of the height of the parent window.

−	[[Category:~~Uncategorised~~]]	+	[[Category:Manuals]]

@@ Line 1: / Line 1: @@
-{{VersionBadge|0.4}} {{VersionBadge|0.5}} {{VersionBadge|0.6}} {{VersionBadge|0.7}} [[category: Uncategorised]]
+{{VersionBadge|0.4}} {{VersionBadge|0.5}} {{VersionBadge|0.6}} {{VersionBadge|0.7}}
-−
 '''note: This page only applies to CEGUI >= 0.4.0'''
@@ Line 6: / Line 5: @@
 There are three different forms in unified metrics:
-*UDim - a single dimension.
+* UDim - a single dimension.
-*UVector2 - a two dimensional UDim vector
+* UVector2 - a two dimensional UDim vector
-*URect - four UDims describing a rectangle by its left, top, right and bottom edges.
+* URect - four UDims describing a rectangle by its left, top, right and bottom edges.
 The property system in CEGUI uses a special syntax for unified dimensions.
@@ Line 18: / Line 17: @@
 The properties that take a single UDim like the ones used above are:
-*UnifiedXPosition
+* UnifiedXPosition
-*UnifiedYPosition
+* UnifiedYPosition
-*UnifiedWidth
+* UnifiedWidth
-*UnifiedHeight
+* UnifiedHeight
 == UVector2 ==
@@ Line 30: / Line 29: @@
 The properties that take UVector2 values are:
-*UnifiedPosition
+* UnifiedPosition
-*UnifiedSize
+* UnifiedSize
-*UnifiedMinSize
+* UnifiedMinSize
-*UnifiedMaxSize
+* UnifiedMaxSize
 == URect ==
@@ Line 44: / Line 43: @@
 The x and y position are simple absolute-only dims with a value of 10 pixels. The right and bottom edges are 100% relative components with a offset of -10 which will make it "move back" 10 pixels relative to the parent's right and bottom edges.
-== XML examples==
+== XML examples ==
 <pre>
@@ Line 82: / Line 81: @@
 Height: 80% of the height of the parent window.

← Older revision		Revision as of 12:11, 26 February 2011
Line 1:		Line 1:
−	{{VersionBadge\|0.4}} {{VersionBadge\|0.5}} {{VersionBadge\|0.6}} {{VersionBadge\|0.7}}	+	{{VersionBadge\|0.4}} {{VersionBadge\|0.5}} {{VersionBadge\|0.6}} {{VersionBadge\|0.7}} [[category: Uncategorised]]

	'''note: This page only applies to CEGUI >= 0.4.0'''		'''note: This page only applies to CEGUI >= 0.4.0'''

@@ Line 26: / Line 26: @@
 The UVector2 is used for position and size if you want avoid specifying each single dimension seperately (x,y,w,h).
 <pre>{{''x-scale'',''x-offset''},{''y-scale'',''y-offset''}}   fx:   {{1,0},{1,0}}</pre>
-Besides the extra {..} around its two UDims it's very similar. Let's say we use the example above as value for the ''UnifiedSize'' property of a window, we would get a window that had exactly the same size as its parent.
+Besides the extra {..} around its two UDims, it's very similar. Let's say we use the example above as value for the ''UnifiedSize'' property of a window, we would get a window that had exactly the same size as its parent.
 <pre>{{1,0},{0,100}}</pre> would yield a window width the same width as its parent but an absolute height of 100 pixels.
@@ Line 39: / Line 39: @@
 As there is alot of parameters I'll write ''ls'' instead of ''left-scale'', ''to'' instead of ''top-offset'' etc.
 <pre>{{ls,lo},{ts,to},{rs,ro},{bs,bo}}   fx:   {{0,0},{0,0},{1,0},{1,0}}</pre>
-The example above is the default rectangle for a DefaultWindow type window. It will cover the entire area of it's parent window.
+The example above is the default rectangle for a DefaultWindow type window. It will cover the entire area of its parent window.
 There is only one property that takes a URect. ''UnifiedAreaRect''.
 The fact that we are specifying edges instead of size, can be useful. For example if we want a window to cover its entire parent, but leave a 10 pixel border a value like this could be used: <pre>{{0,10},{0,10},{1,-10},{1,-10}}</pre>

← Older revision		Revision as of 20:26, 2 October 2010
Line 1:		Line 1:
		+	{{VersionBadge\|0.4}} {{VersionBadge\|0.5}} {{VersionBadge\|0.6}} {{VersionBadge\|0.7}}
		+
	'''note: This page only applies to CEGUI >= 0.4.0'''		'''note: This page only applies to CEGUI >= 0.4.0'''

← Older revision	Revision as of 21:36, 26 February 2011
(No difference)

@@ Line 1: / Line 1: @@
 '''note: This page only applies to CEGUI >= 0.4.0'''
-The system is explained the easiest way by examples:
+The unified metrics system in CEGUI 0.4.0 and up, allows you to have both a relative and absolute component of a coordinate / dimension. This gives you alot more flexibility in how you layout your windows. For example you can use relative metrics for the height and absolute metrics for the width. Or simply mix and match.
 <pre>
@@ Line 19: / Line 60: @@
 Height: 30% of the height of the parent window + 20 pixel

@@ Line 1: / Line 1: @@
-'''note: This system/page only applies to CEGUI >= 0.4.0'''
+'''note: This page only applies to CEGUI >= 0.4.0'''
 The system is explained the easiest way by examples:
 <Property Name="UnifiedPosition" Value="{{0.1,10},{1.0,-30}}" />
 X-position: 10% of the width of the parent window + 10 pixel
 Y-position: 30 pixel above the bottom of the parent window
 <Property Name="UnifiedSize" Value="{{0.6,5},{0.3,20}}" />
 Width: 60% of the width of the parent window + 5 pixel
 Height: 30% of the height of the parent window + 20 pixel