Update Cryville.Common.

Assets/Cryville/Common/Unity/UI/AspectRatioLayoutElement.cs

@@ -3,16 +3,27 @@ using UnityEngine.EventSystems;
 using UnityEngine.UI;
 
 namespace Cryville.Common.Unity.UI {
+	/// <summary>
+	/// A <see cref="ILayoutElement" /> that takes the length of one axis to compute the preferred length of the other axis with respect to a aspect ratio.
+	/// </summary>
 	public class AspectRatioLayoutElement : UIBehaviour, ILayoutElement {
 		[SerializeField]
+		[Tooltip("The aspect ratio. Width divided by height.")]
 		private float m_aspectRatio = 1;
+		/// <summary>
+		/// The aspect ratio. Width divided by height.
+		/// </summary>
 		public float AspectRatio {
 			get { return m_aspectRatio; }
 			set { SetProperty(ref m_aspectRatio, value); }
 		}
 
 		[SerializeField]
+		[Tooltip("Whether to compute the length of the y axis.")]
 		private bool m_isVertical = false;
+		/// <summary>
+		/// Whether to compute the length of the y axis.
+		/// </summary>
 		public bool IsVertical {
 			get { return m_isVertical; }
 			set { SetProperty(ref m_isVertical, value); }
@@ -29,26 +40,35 @@ namespace Cryville.Common.Unity.UI {
 			LayoutRebuilder.MarkLayoutForRebuild(transform as RectTransform);
 		}
 
+		/// <inheritdoc />
 		public float minWidth {
 			get {
 				return m_isVertical ? 0 : (transform as RectTransform).rect.height * m_aspectRatio;
 			}
 		}
+		/// <inheritdoc />
 		public float preferredWidth { get { return minWidth; } }
+		/// <inheritdoc />
 		public float flexibleWidth { get { return 0; } }
 
+		/// <inheritdoc />
 		public float minHeight {
 			get {
 				return m_isVertical ? (transform as RectTransform).rect.width / m_aspectRatio : 0;
 			}
 		}
+		/// <inheritdoc />
 		public float preferredHeight { get { return minHeight; } }
+		/// <inheritdoc />
 		public float flexibleHeight { get { return 0; } }
 
+		/// <inheritdoc />
 		public int layoutPriority { get { return 1; } }
 
+		/// <inheritdoc />
 		public void CalculateLayoutInputHorizontal() { }
 
+		/// <inheritdoc />
 		public void CalculateLayoutInputVertical() { }
 
 		protected override void OnDidApplyAnimationProperties() {

Assets/Cryville/Common/Unity/UI/DockAspectRatioLayoutGroup.cs

@@ -1,9 +1,16 @@
 using UnityEngine;
 
 namespace Cryville.Common.Unity.UI {
+	/// <summary>
+	/// A <see cref="DockLayoutGroup" /> that sets the aspect ratio of the docking element.
+	/// </summary>
 	public sealed class DockAspectRatioLayoutGroup : DockLayoutGroup {
 		[SerializeField]
+		[Tooltip("The aspect ratio of the docking element.")]
 		private float m_dockAspectRatio = 1;
+		/// <summary>
+		/// The aspect ratio of the docking element.
+		/// </summary>
 		public float DockAspectRatio {
 			get { return m_dockAspectRatio; }
 			set { base.SetProperty(ref m_dockAspectRatio, value); }

Assets/Cryville/Common/Unity/UI/DockLayoutGroup.cs

@@ -2,30 +2,60 @@
 using UnityEngine.UI;
 
 namespace Cryville.Common.Unity.UI {
+	/// <summary>
+	/// A <see cref="LayoutGroup" /> that docks its first child element to one side.
+	/// </summary>
 	public abstract class DockLayoutGroup : LayoutGroup {
+		/// <summary>
+		/// The dock side.
+		/// </summary>
 		public enum Side {
+			/// <summary>
+			/// Top.
+			/// </summary>
 			Top = 0,
+			/// <summary>
+			/// Right.
+			/// </summary>
 			Right = 1,
+			/// <summary>
+			/// Bottom.
+			/// </summary>
 			Bottom = 2,
+			/// <summary>
+			/// Left.
+			/// </summary>
 			Left = 3,
 		}
 		[SerializeField]
+		[Tooltip("The docking side of the first child element.")]
 		private Side m_side;
+		/// <summary>
+		/// The docking side of the first child element.
+		/// </summary>
 		public Side DockSide {
 			get { return m_side; }
 			set { base.SetProperty(ref m_side, value); }
 		}
 
 		[SerializeField]
+		[Tooltip("The slide index. The children slide along the cross axis.")]
 		private float m_slideIndex;
+		/// <summary>
+		/// The slide index. The children slide along the axis.
+		/// </summary>
 		public float SlideIndex {
 			get { return m_slideIndex; }
 			set { base.SetProperty(ref m_slideIndex, value); }
 		}
 
+		/// <inheritdoc />
 		public sealed override void CalculateLayoutInputHorizontal() { base.CalculateLayoutInputHorizontal(); }
+		/// <inheritdoc />
 		public sealed override void CalculateLayoutInputVertical() { }
+		/// <inheritdoc />
 		public sealed override void SetLayoutHorizontal() { SetChildrenAlongAxis(0); }
+		/// <inheritdoc />
 		public sealed override void SetLayoutVertical() { SetChildrenAlongAxis(1); }
 
 		private float GetSlidePosition(float groupHeight, float dockHeight) {
@@ -68,6 +98,11 @@ namespace Cryville.Common.Unity.UI {
 			}
 		}
 
+		/// <summary>
+		/// Gets the length of the first child element along the axis.
+		/// </summary>
+		/// <param name="groupSize">The size of the layout group.</param>
+		/// <returns></returns>
 		protected abstract float GetDockElementSize(Vector2 groupSize);
 	}
 }

Assets/Cryville/Common/Unity/UI/DockOccupiedRatioLayoutGroup.cs

@@ -1,9 +1,16 @@
 using UnityEngine;
 
 namespace Cryville.Common.Unity.UI {
+	/// <summary>
+	/// A <see cref="DockLayoutGroup" /> that sets the occupied ratio of the docking element.
+	/// </summary>
 	public sealed class DockOccupiedRatioLayoutGroup : DockLayoutGroup {
 		[SerializeField]
+		[Tooltip("The occupied ratio of the docking element.")]
 		private float m_dockOccupiedRatio = 1;
+		/// <summary>
+		/// The occupied ratio of the docking element.
+		/// </summary>
 		public float DockOccupiedRatio {
 			get { return m_dockOccupiedRatio; }
 			set { base.SetProperty(ref m_dockOccupiedRatio, value); }

Assets/Cryville/Common/Unity/UI/GridLayoutSizeFitter.cs

@@ -2,11 +2,17 @@
 using UnityEngine.UI;
 
 namespace Cryville.Common.Unity.UI {
+	/// <summary>
+	/// Fits the size of a <see cref="GridLayoutGroup" /> with its cells.
+	/// </summary>
 	[RequireComponent(typeof(GridLayoutGroup))]
 	public class GridLayoutSizeFitter : MonoBehaviour {
 		RectTransform rectTransform;
 		GridLayoutGroup gridLayoutGroup;
 		Canvas canvas;
+		/// <summary>
+		/// The item count per line.
+		/// </summary>
 		public int GroupItemCount = 3;
 
 #pragma warning disable IDE0051

Assets/Cryville/Common/Unity/UI/ImageSliced3.cs

@@ -10,6 +10,7 @@ namespace Cryville.Common.Unity.UI {
 	[ExecuteInEditMode]
 	public class ImageSliced3 : MaskableGraphic {
 		[SerializeField]
+		[Tooltip("The sliced sprite.")]
 		private Sprite m_sprite;
 		/// <summary>
 		/// The sliced sprite.
@@ -45,6 +46,7 @@ namespace Cryville.Common.Unity.UI {
 			DiagonalRight = 5,
 		}
 		[SerializeField]
+		[Tooltip("The mode how a sliced image is generated when it is too compact.")]
 		private CompactMode m_compact;
 		/// <summary>
 		/// The mode how a sliced image is generated when it is too compact.

Assets/Cryville/Common/Unity/UI/LayoutAspectRatioFitter.cs

@@ -2,9 +2,16 @@
 using UnityEngine.UI;
 
 namespace Cryville.Common.Unity.UI {
+	/// <summary>
+	/// Fits the length of an axis of an element with respect to the children count and the shared aspect ratio.
+	/// </summary>
 	public class LayoutAspectRatioFitter : MonoBehaviour {
 		[SerializeField]
+		[Tooltip("The aspect ratio per element.")]
 		private float m_aspectRatioPerElement = 1;
+		/// <summary>
+		/// The aspect ratio per element.
+		/// </summary>
 		public float AspectRatioPerElement {
 			get { return m_aspectRatioPerElement; }
 			set { m_aspectRatioPerElement = value; }

Assets/Cryville/Common/Unity/UI/ProgressBar.cs

@@ -2,16 +2,27 @@
 using UnityEngine.UI;
 
 namespace Cryville.Common.Unity.UI {
+	/// <summary>
+	/// A non-interactive <see cref="Slider" /> that has an internal tweening behaviour.
+	/// </summary>
 	public class ProgressBar : Slider {
 		[SerializeField][Range(0f, 1f)]
+		[Tooltip("The tweening parameter.")]
 		float m_smooth = 0;
+		/// <summary>
+		/// The tweening parameter.
+		/// </summary>
 		public float Smooth {
 			get { return m_smooth; }
 			set { m_smooth = value; }
 		}
 
 		[SerializeField]
+		[Tooltip("The target value.")]
 		float m_targetValue;
+		/// <summary>
+		/// Gets the current displayed value or sets the target value.
+		/// </summary>
 		public override float value {
 			get { return base.value; }
 			set { m_targetValue = value; }

Assets/Cryville/Common/Unity/UI/ScrollableItemGrid.cs

@@ -3,61 +3,84 @@ using UnityEngine;
 using UnityEngine.UI;
 
 namespace Cryville.Common.Unity.UI {
+	/// <summary>
+	/// A handler for loading an item.
+	/// </summary>
+	/// <param name="index">The zero-based index of the item.</param>
+	/// <param name="gameObject">The game object for the item instantiated from the item template.</param>
+	/// <returns></returns>
+	public delegate bool LoadItemHandler(int index, GameObject gameObject);
+	/// <summary>
+	/// A scrollable grid that dynamically loads its items.
+	/// </summary>
 	public sealed class ScrollableItemGrid : MonoBehaviour {
 		[SerializeField]
+		[Tooltip("The item template.")]
 		private GameObject m_itemTemplate;
+		/// <summary>
+		/// The item template.
+		/// </summary>
 		public GameObject ItemTemplate {
 			get { return m_itemTemplate; }
 			set { m_itemTemplate = value; OnTemplateUpdate(); }
 		}
-		public Func<int, GameObject, bool> LoadItem { private get; set; }
-
-		public enum Corner {
-			UpperLeft  = 0,
-			UpperRight = 1,
-			LowerLeft  = 2,
-			LowerRight = 3,
-		}
-		[SerializeField]
-		private Corner m_startCorner; // TODO
-		public Corner StartCorner {
-			get { return m_startCorner; }
-			set { m_startCorner = value; OnFrameUpdate(); }
-		}
+		/// <summary>
+		/// The handler for loading an item.
+		/// </summary>
+		public LoadItemHandler LoadItem { private get; set; }
 
+		/// <summary>
+		/// Axis.
+		/// </summary>
 		public enum Axis {
-			Horizontal = 0, Vertical = 1,
+			/// <summary>
+			/// Horizontal (x) axis.
+			/// </summary>
+			Horizontal = 0,
+			/// <summary>
+			/// Vertical (y) axis.
+			/// </summary>
+			Vertical = 1,
 		}
 		[SerializeField]
+		[Tooltip("The main axis.")]
 		private Axis m_startAxis;
+		/// <summary>
+		/// The main axis.
+		/// </summary>
 		public Axis StartAxis {
 			get { return m_startAxis; }
 			set { m_startAxis = value; OnFrameUpdate(); }
 		}
 
 		[SerializeField]
-		private Vector2 m_spacing; // TODO
-		public Vector2 Spacing {
-			get { return m_spacing; }
-			set { m_spacing = value; OnFrameUpdate(); }
-		}
-
-		[SerializeField]
+		[Tooltip("The item count.")]
 		private int m_itemCount = 3;
+		/// <summary>
+		/// The item count.
+		/// </summary>
 		public int ItemCount {
 			get { return m_itemCount; }
 			set { m_itemCount = value; OnRefresh(); }
 		}
 
 		[SerializeField]
+		[Tooltip("The item count per line.")]
 		private int m_lineItemCount = 3;
+		/// <summary>
+		/// The item count per line.
+		/// </summary>
 		public int LineItemCount {
 			get { return m_lineItemCount; }
 			set { m_lineItemCount = value; OnFrameUpdate(); }
 		}
 
 		[SerializeField]
+		[Tooltip("The length of the cross axis per line.")]
 		private float m_lineHeight = 100;
+		/// <summary>
+		/// The length of the cross axis per line.
+		/// </summary>
 		public float LineHeight {
 			get { return m_lineHeight; }
 			set { m_lineHeight = value; OnFrameUpdate(); }
@@ -78,6 +101,9 @@ namespace Cryville.Common.Unity.UI {
 				);
 			}
 		}
+		/// <summary>
+		/// The maximum count of visible lines.
+		/// </summary>
 		public int VisibleLines {
 			get {
 				return Mathf.CeilToInt(VisibleSize.y / m_lineHeight) + 1;