/// <summary>
/// Creates a colored string by parsing commands embedded in the string.
/// </summary>
/// <param name="value">The string to parse.</param>
/// <param name="surfaceIndex">Index of where this string will be printed.</param>
/// <param name="surface">The surface the string will be printed to.</param>
/// <param name="editor">A surface editor associated with the text surface.</param>
/// <param name="initialBehaviors">Any initial defaults.</param>
/// <returns></returns>
public static ColoredString Parse(string value, int surfaceIndex = -1, Consoles.ITextSurface surface = null, SurfaceEditor editor = null, ParseCommandStacks initialBehaviors = null)
{
var commandStacks = initialBehaviors != null ? initialBehaviors : new ParseCommandStacks();
List<ColoredGlyph> glyphs = new List<ColoredGlyph>(value.Length);
for (int i = 0; i < value.Length; i++)
{
var existingGlyphs = glyphs.ToArray();
if (value[i] == '`' && i + 1 < value.Length && value[i + 1] == '[')
continue;
if (value[i] == '[' && (i == 0 || value[i - 1] != '`'))
{
try
{
if (i + 4 < value.Length && value[i + 1] == 'c' && value[i + 2] == ':' && value.IndexOf(']', i + 2) != -1)
{
int commandExitIndex = value.IndexOf(']', i + 2);
string command = value.Substring(i + 3, commandExitIndex - (i + 3));
string commandParams = "";
if (command.Contains(" "))
{
var commandSections = command.Split(new char[] { ' ' }, 2);
command = commandSections[0].ToLower();
commandParams = commandSections[1];
}
// Check for custom command
ParseCommandBase commandObject = CustomProcessor != null ? CustomProcessor(command, commandParams, existingGlyphs, surface, editor, commandStacks) : null;
// No custom command found, run build in ones
if (commandObject == null)
switch (command)
{
case "recolor":
case "r":
commandObject = new ParseCommandRecolor(commandParams);
break;
case "mirror":
case "m":
commandObject = new ParseCommandSpriteEffect(commandParams);
break;
case "undo":
case "u":
commandObject = new ParseCommandUndo(commandParams, commandStacks);
break;
case "grad":
case "g":
commandObject = new ParseCommandGradient(commandParams);
break;
case "blink":
case "b":
commandObject = new ParseCommandBlink(commandParams, existingGlyphs, commandStacks, editor);
break;
case "sglyph":
case "sg":
commandObject = new ParseCommandSetGlyph(commandParams);
break;
default:
break;
}
if (commandObject != null && commandObject.CommandType != CommandTypes.Invalid)
{
commandStacks.AddSafe(commandObject);
i = commandExitIndex;
continue;
}
}
}
catch (System.Exception e1)
{
#if DEBUG
throw e1;
#endif
}
}
int fixedSurfaceIndex;
if (surfaceIndex == -1 || surface == null)
fixedSurfaceIndex = -1;
else
fixedSurfaceIndex = i + surfaceIndex < surface.Cells.Length ? i + surfaceIndex : -1;
ColoredGlyph newGlyph;
if (fixedSurfaceIndex != -1)
newGlyph = new ColoredGlyph(surface[i + surfaceIndex]) { Glyph = value[i] };
else
newGlyph = new ColoredGlyph(new Cell()) { Glyph = value[i] };
// Foreground
if (commandStacks.Foreground.Count != 0)
commandStacks.Foreground.Peek().Build(ref newGlyph, existingGlyphs, fixedSurfaceIndex, surface, editor, ref i, value, commandStacks);
// Background
if (commandStacks.Background.Count != 0)
commandStacks.Background.Peek().Build(ref newGlyph, existingGlyphs, fixedSurfaceIndex, surface, editor, ref i, value, commandStacks);
if (commandStacks.Glyph.Count != 0)
commandStacks.Glyph.Peek().Build(ref newGlyph, existingGlyphs, fixedSurfaceIndex, surface, editor, ref i, value, commandStacks);
// SpriteEffect
if (commandStacks.SpriteEffect.Count != 0)
commandStacks.SpriteEffect.Peek().Build(ref newGlyph, existingGlyphs, fixedSurfaceIndex, surface, editor, ref i, value, commandStacks);
// Effect
if (commandStacks.Effect.Count != 0)
commandStacks.Effect.Peek().Build(ref newGlyph, existingGlyphs, fixedSurfaceIndex, surface, editor, ref i, value, commandStacks);
glyphs.Add(newGlyph);
}
return new ColoredString(glyphs.ToArray()) { IgnoreEffect = !commandStacks.TurnOnEffects };
}
/// <summary>
/// Draws the string on the console at the specified location with the specified foreground and background color, wrapping if needed.
/// </summary>
/// <param name="x">X location of the text.</param>
/// <param name="y">Y location of the text.</param>
/// <param name="text">The string to display.</param>
/// <param name="foreground">Sets the foreground of all characters in the text.</param>
/// <param name="background">Sets the background of all characters in the text.</param>
public void Print(int x, int y, string text, Color foreground, Color background)
{
if (String.IsNullOrEmpty(text))
return;
if (x >= textSurface.Width || x < 0 || y >= textSurface.Height || y < 0)
throw new Exception("X,Y is out of range for Print");
int index = y * textSurface.Width + x;
if (!UsePrintProcessor)
{
int total = index + text.Length > textSurface.Cells.Length ? textSurface.Cells.Length - index : index + text.Length;
int charIndex = 0;
for (; index < total; index++)
{
textSurface.Cells[index].GlyphIndex = text[charIndex];
textSurface.Cells[index].Background = background;
textSurface.Cells[index].Foreground = foreground;
charIndex++;
}
}
else
{
var behaviorFore = new ParseCommandRecolor() { R = foreground.R, G = foreground.G, B = foreground.B, A = foreground.A, CommandType = CommandTypes.Foreground };
var behaviorBack = new ParseCommandRecolor() { R = background.R, G = background.G, B = background.B, A = background.A, CommandType = CommandTypes.Background };
var stacks = new ParseCommandStacks();
stacks.AddSafe(behaviorFore);
stacks.AddSafe(behaviorBack);
PrintNoCheck(index, ColoredString.Parse(text, index, textSurface, this, stacks));
}
}