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.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; private set; }
///
/// 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;
///
/// A multiplier that will be applied to .
/// To change the text scale itself, use .
///
public float TextScaleMultiplier = 1;
///
/// The text to render inside of this paragraph.
/// Use if the text changes frequently.
///
public string Text {
get {
this.QueryTextCallback();
return this.text;
}
set {
if (this.text != value) {
this.text = value;
this.IsHidden = string.IsNullOrWhiteSpace(this.text);
this.SetTextDirty();
}
}
}
///
/// If this paragraph should automatically adjust its width based on the width of the text within it
///
public bool AutoAdjustWidth;
///
/// 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;
///
/// 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 = "...";
///
/// 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 TextAlignment Alignment {
get => this.alignment;
set {
this.alignment = value;
this.SetTextDirty();
}
}
private string text;
private TextAlignment alignment;
private StyleProp regularFont;
///
/// 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, "", autoAdjustWidth) {
this.GetTextCallback = textCallback;
this.Text = textCallback(this);
if (this.Text == null)
this.IsHidden = true;
}
///
public Paragraph(Anchor anchor, float width, string text, bool autoAdjustWidth = false) : base(anchor, new Vector2(width, 0)) {
this.Text = text;
if (this.Text == null)
this.IsHidden = true;
this.AutoAdjustWidth = autoAdjustWidth;
this.CanBeSelected = false;
this.CanBeMoused = false;
}
///
protected override Vector2 CalcActualSize(RectangleF parentArea) {
var size = base.CalcActualSize(parentArea);
this.ParseText(size);
var (w, h) = this.TokenizedText.Measure(this.RegularFont) * this.TextScale * this.TextScaleMultiplier * this.Scale;
return new Vector2(this.AutoAdjustWidth ? w + this.ScaledPadding.Width : size.X, h + this.ScaledPadding.Height);
}
///
public override void Update(GameTime time) {
this.QueryTextCallback();
base.Update(time);
if (this.TokenizedText != null)
this.TokenizedText.Update(time);
}
///
public override void Draw(GameTime time, SpriteBatch batch, float alpha, BlendState blendState, SamplerState samplerState, DepthStencilState depthStencilState, Effect effect, Matrix matrix) {
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);
base.Draw(time, batch, alpha, blendState, samplerState, depthStencilState, effect, matrix);
}
///
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);
}
///
/// Parses this paragraph's into .
/// Additionally, this method adds any elements for tokenized links in the text.
///
/// The paragraph's default size
protected virtual void ParseText(Vector2 size) {
if (this.TokenizedText == null) {
// tokenize the text
this.TokenizedText = this.System.TextFormatter.Tokenize(this.RegularFont, this.Text, this.Alignment);
// 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));
}
var width = size.X - this.ScaledPadding.Width;
var scale = this.TextScale * this.TextScaleMultiplier * this.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);
}
}
///
/// A helper method that causes the to be reset.
/// Additionally, if this paragraph's area has changed enough to warrant it, or if it has any children.
///
protected void SetTextDirty() {
this.TokenizedText = null;
// only set our area dirty if our size changed as a result of this action
if (!this.AreaDirty && !this.CalcActualSize(this.ParentArea).Equals(this.DisplayArea.Size, Epsilon))
this.SetAreaDirty();
}
private void QueryTextCallback() {
if (this.GetTextCallback != null)
this.Text = this.GetTextCallback(this);
}
private float GetAlignmentOffset() {
switch (this.Alignment) {
case TextAlignment.Center:
return this.DisplayArea.Width / 2;
case TextAlignment.Right:
return this.DisplayArea.Width;
}
return 0;
}
///
/// 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;
}
}
}
}