using System; using System.Linq; using Microsoft.Xna.Framework; using Microsoft.Xna.Framework.Graphics; using MLEM.Extensions; using MLEM.Font; using MLEM.Formatting; using MLEM.Formatting.Codes; using MLEM.Graphics; using MLEM.Misc; using MLEM.Ui.Style; namespace MLEM.Ui.Elements { /// /// A paragraph element for use inside of a . /// A paragraph is an element that contains text. /// A paragraph's text can be formatted using the ui system's . /// public class Paragraph : Element { /// /// The font that this paragraph draws text with. /// To set its bold and italic font, use and . /// public StyleProp RegularFont { get => this.regularFont; set { this.regularFont = value; this.SetTextDirty(); } } /// /// The tokenized version of the /// public TokenizedString TokenizedText { get { this.CheckTextChange(); this.TokenizeIfNecessary(); return this.tokenizedText; } } /// /// The color that the text will be rendered with /// public StyleProp TextColor; /// /// The scale that the text will be rendered with. /// To add a multiplier rather than changing the scale directly, use . /// public StyleProp TextScale { get => this.textScale; set { this.textScale = value; this.SetTextDirty(); } } /// /// A multiplier that will be applied to . /// To change the text scale itself, use . /// public float TextScaleMultiplier { get => this.textScaleMultiplier; set { if (this.textScaleMultiplier != value) { this.textScaleMultiplier = value; this.SetTextDirty(); } } } /// /// The text to render inside of this paragraph. /// Use if the text changes frequently. /// public string Text { get { this.CheckTextChange(); return this.displayedText; } set { this.explicitlySetText = value; this.CheckTextChange(); } } /// /// If this paragraph should automatically adjust its width based on the width of the text within it /// public bool AutoAdjustWidth { get => this.autoAdjustWidth; set { if (this.autoAdjustWidth != value) { this.autoAdjustWidth = value; this.SetAreaDirty(); } } } /// /// Whether this paragraph should be truncated instead of split if the displayed 's width exceeds the provided width. /// When the string is truncated, the is added to its end. /// public bool TruncateIfLong { get => this.truncateIfLong; set { if (this.truncateIfLong != value) { this.truncateIfLong = value; this.SetAlignSplitDirty(); } } } /// /// The ellipsis characters to use if is enabled and the string is truncated. /// If this is set to an empty string, no ellipsis will be attached to the truncated string. /// public string Ellipsis { get => this.ellipsis; set { if (this.ellipsis != value) { this.ellipsis = value; this.SetAlignSplitDirty(); } } } /// /// An event that gets called when this paragraph's is queried. /// Use this event for setting this paragraph's text if it changes frequently. /// public TextCallback GetTextCallback; /// /// The action that is executed if objects inside of this paragraph are pressed. /// By default, is executed. /// public Action LinkAction; /// /// The that this paragraph's text should be rendered with /// public StyleProp Alignment { get => this.alignment; set { this.alignment = value; this.SetTextDirty(); } } /// /// The inclusive index in this paragraph's to start drawing at. /// This value is passed to . /// public int? DrawStartIndex; /// /// The exclusive index in this paragraph's to stop drawing at. /// This value is passed to . /// public int? DrawEndIndex; /// public override bool IsHidden => base.IsHidden || string.IsNullOrWhiteSpace(this.Text); private string displayedText; private string explicitlySetText; private StyleProp alignment; private StyleProp regularFont; private StyleProp textScale; private TokenizedString tokenizedText; private float? lastAlignSplitWidth; private float? lastAlignSplitScale; private string ellipsis = "..."; private bool truncateIfLong; private float textScaleMultiplier = 1; private bool autoAdjustWidth; /// /// Creates a new paragraph with the given settings. /// /// The paragraph's anchor /// The paragraph's width. Note that its height is automatically calculated. /// The paragraph's text /// The paragraph's text alignment. /// Whether the paragraph's width should automatically be calculated based on the text within it. public Paragraph(Anchor anchor, float width, TextCallback textCallback, TextAlignment alignment, bool autoAdjustWidth = false) : this(anchor, width, textCallback, autoAdjustWidth) { this.Alignment = alignment; } /// /// Creates a new paragraph with the given settings. /// /// The paragraph's anchor /// The paragraph's width. Note that its height is automatically calculated. /// The paragraph's text /// The paragraph's text alignment. /// Whether the paragraph's width should automatically be calculated based on the text within it. public Paragraph(Anchor anchor, float width, string text, TextAlignment alignment, bool autoAdjustWidth = false) : this(anchor, width, text, autoAdjustWidth) { this.Alignment = alignment; } /// /// Creates a new paragraph with the given settings. /// /// The paragraph's anchor /// The paragraph's width. Note that its height is automatically calculated. /// The paragraph's text /// Whether the paragraph's width should automatically be calculated based on the text within it. public Paragraph(Anchor anchor, float width, TextCallback textCallback, bool autoAdjustWidth = false) : this(anchor, width, string.Empty, autoAdjustWidth) { this.GetTextCallback = textCallback; } /// /// Creates a new paragraph with the given settings. /// /// The paragraph's anchor /// The paragraph's width. Note that its height is automatically calculated. /// The paragraph's text /// Whether the paragraph's width should automatically be calculated based on the text within it. public Paragraph(Anchor anchor, float width, string text, bool autoAdjustWidth = false) : base(anchor, new Vector2(width, 0)) { this.Text = text; this.AutoAdjustWidth = autoAdjustWidth; this.CanBeSelected = false; this.CanBeMoused = false; } /// public override void SetAreaAndUpdateChildren(RectangleF area) { base.SetAreaAndUpdateChildren(area); // in case an outside source sets our area, we still want to display our text correctly this.AlignAndSplitIfNecessary(area.Size); } /// protected override Vector2 CalcActualSize(RectangleF parentArea) { var size = base.CalcActualSize(parentArea); this.CheckTextChange(); this.TokenizeIfNecessary(); this.AlignAndSplitIfNecessary(size); var textSize = this.tokenizedText.GetArea(Vector2.Zero, this.TextScale * this.TextScaleMultiplier * this.Scale).Size; // if we auto-adjust our width, then we would also split the same way with our adjusted width, so cache that if (this.AutoAdjustWidth) this.lastAlignSplitWidth = textSize.X; return new Vector2(this.AutoAdjustWidth ? textSize.X + this.ScaledPadding.Width : size.X, textSize.Y + this.ScaledPadding.Height); } /// public override void Update(GameTime time) { this.TokenizedText?.Update(time); base.Update(time); } /// public override void Draw(GameTime time, SpriteBatch batch, float alpha, SpriteBatchContext context) { var pos = this.DisplayArea.Location + new Vector2(this.GetAlignmentOffset(), 0); var sc = this.TextScale * this.TextScaleMultiplier * this.Scale; var color = this.TextColor.OrDefault(Color.White) * alpha; this.TokenizedText.Draw(time, batch, pos, this.RegularFont, color, sc, 0, 0, Vector2.Zero, SpriteEffects.None, this.DrawStartIndex, this.DrawEndIndex); base.Draw(time, batch, alpha, context); } /// protected override void InitStyle(UiStyle style) { base.InitStyle(style); this.RegularFont = this.RegularFont.OrStyle(style.Font ?? throw new NotSupportedException("Paragraphs cannot use ui styles that don't have a font. Please supply a custom font by setting UiStyle.Font.")); this.TextScale = this.TextScale.OrStyle(style.TextScale); this.TextColor = this.TextColor.OrStyle(style.TextColor); this.Alignment = this.Alignment.OrStyle(style.TextAlignment); } private void SetTextDirty() { this.tokenizedText = null; // only set our area dirty if our size changed as a result of this action if (!this.AreaDirty && (this.System == null || !this.CalcActualSize(this.ParentArea).Equals(this.DisplayArea.Size, Element.Epsilon))) this.SetAreaDirty(); } private void CheckTextChange() { var newText = this.GetTextCallback?.Invoke(this) ?? this.explicitlySetText; if (this.displayedText == newText) return; var emptyChanged = string.IsNullOrWhiteSpace(this.displayedText) != string.IsNullOrWhiteSpace(newText); this.displayedText = newText; if (emptyChanged) this.SetAreaDirty(); this.SetTextDirty(); } private float GetAlignmentOffset() { switch (this.Alignment.Value) { case TextAlignment.Center: return this.DisplayArea.Width / 2; case TextAlignment.Right: return this.DisplayArea.Width; } return 0; } private void TokenizeIfNecessary() { if (this.tokenizedText != null) return; // tokenize the text this.tokenizedText = this.System.TextFormatter.Tokenize(this.RegularFont, this.Text, this.Alignment); this.SetAlignSplitDirty(); // add links to the paragraph this.RemoveChildren(c => c is Link); foreach (var link in this.tokenizedText.Tokens.Where(t => t.AppliedCodes.Any(c => c is LinkCode))) this.AddChild(new Link(Anchor.TopLeft, link, this.TextScale * this.TextScaleMultiplier)); } private void AlignAndSplitIfNecessary(Vector2 size) { var width = size.X - this.ScaledPadding.Width; var scale = this.TextScale * this.TextScaleMultiplier * this.Scale; if (this.lastAlignSplitWidth?.Equals(width, Element.Epsilon) == true && this.lastAlignSplitScale?.Equals(scale, Element.Epsilon) == true) return; this.lastAlignSplitWidth = width; this.lastAlignSplitScale = scale; if (this.TruncateIfLong) { this.tokenizedText.Truncate(this.RegularFont, width, scale, this.Ellipsis, this.Alignment); } else { this.tokenizedText.Split(this.RegularFont, width, scale, this.Alignment); } } private void SetAlignSplitDirty() { this.lastAlignSplitWidth = null; this.lastAlignSplitScale = null; } /// /// A delegate method used for /// /// The current paragraph public delegate string TextCallback(Paragraph paragraph); /// /// A link is a sub-element of the that is added onto it as a child for any tokens that contain , to make them selectable and clickable. /// public class Link : Element { /// /// The token that this link represents /// public readonly Token Token; private readonly float textScale; /// /// Creates a new link element with the given settings /// /// The link's anchor /// The token that this link represents /// The scale that text is rendered with public Link(Anchor anchor, Token token, float textScale) : base(anchor, Vector2.Zero) { this.Token = token; this.textScale = textScale; this.OnPressed += e => { foreach (var code in token.AppliedCodes.OfType()) { if (this.Parent is Paragraph p && p.LinkAction != null) { p.LinkAction.Invoke(this, code); } else { MlemPlatform.Current.OpenLinkOrFile(code.Match.Groups[1].Value); } } }; } /// public override void ForceUpdateArea() { // set the position offset and size to the token's first area var area = this.Token.GetArea(Vector2.Zero, this.textScale).FirstOrDefault(); if (this.Parent is Paragraph p) area.Location += new Vector2(p.GetAlignmentOffset() / p.Scale, 0); this.PositionOffset = area.Location; this.IsHidden = area.IsEmpty; this.Size = area.Size; base.ForceUpdateArea(); } /// public override Element GetElementUnderPos(Vector2 position) { var ret = base.GetElementUnderPos(position); if (ret != null) return ret; // check if any of our token's parts are hovered var location = this.Parent.DisplayArea.Location; if (this.Parent is Paragraph p) location.X += p.GetAlignmentOffset(); foreach (var rect in this.Token.GetArea(location, this.Scale * this.textScale)) { if (rect.Contains(this.TransformInverse(position))) return this; } return null; } } } }