DragonECS/src/DebugUtils/EcsDebug.cs

443 lines
15 KiB
C#
Raw Normal View History

2024-02-14 03:04:05 +08:00
using DCFApixels.DragonECS.Internal;
using System;
2024-09-13 11:03:51 +08:00
using System.Collections;
2024-09-12 03:01:22 +08:00
using System.Collections.Generic;
2023-03-27 17:34:12 +08:00
using System.Diagnostics;
2024-09-12 03:01:22 +08:00
using System.Linq;
using System.Runtime.CompilerServices;
2023-03-27 17:34:12 +08:00
namespace DCFApixels.DragonECS
{
public readonly struct EcsProfilerMarker
2023-03-30 06:03:05 +08:00
{
public readonly int id;
2024-02-26 10:56:18 +08:00
internal EcsProfilerMarker(int id) { this.id = id; }
2024-09-12 04:05:15 +08:00
public EcsProfilerMarker(string name)
{
id = DebugService.Instance.RegisterMark(name);
}
2023-03-30 11:17:17 +08:00
[MethodImpl(MethodImplOptions.AggressiveInlining)]
2024-02-26 10:56:18 +08:00
public void Begin() { DebugService.Instance.ProfilerMarkBegin(id); }
2023-03-30 11:17:17 +08:00
[MethodImpl(MethodImplOptions.AggressiveInlining)]
2024-02-26 10:56:18 +08:00
public void End() { DebugService.Instance.ProfilerMarkEnd(id); }
2023-03-30 11:17:17 +08:00
[MethodImpl(MethodImplOptions.AggressiveInlining)]
2024-02-26 10:56:18 +08:00
public AutoScope Auto() { return new AutoScope(id); }
2023-04-01 20:45:37 +08:00
public readonly ref struct AutoScope
{
private readonly int _id;
2024-06-08 02:08:20 +08:00
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public AutoScope(int id)
2023-03-30 06:03:05 +08:00
{
_id = id;
2023-06-12 20:30:44 +08:00
DebugService.Instance.ProfilerMarkBegin(id);
}
2024-06-08 02:08:20 +08:00
[MethodImpl(MethodImplOptions.AggressiveInlining)]
2024-02-26 10:56:18 +08:00
public void Dispose()
{
DebugService.Instance.ProfilerMarkEnd(_id);
}
2023-03-30 06:03:05 +08:00
}
2024-06-08 02:08:20 +08:00
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static explicit operator EcsProfilerMarker(string markerName) { return new EcsProfilerMarker(markerName); }
2023-03-30 06:03:05 +08:00
}
2024-06-13 18:04:18 +08:00
[MetaColor(MetaColor.DragonRose)]
[MetaGroup(EcsConsts.PACK_GROUP, EcsConsts.DEBUG_GROUP)]
[MetaDescription(EcsConsts.AUTHOR, "Debugging utility. To modify or change the behavior, create a new class inherited from DebugService and set this service using DebugService.Set<T>().")]
2023-03-27 17:34:12 +08:00
public static class EcsDebug
{
2023-11-22 11:28:15 +08:00
public const string WARNING_TAG = EcsConsts.DEBUG_WARNING_TAG;
public const string ERROR_TAG = EcsConsts.DEBUG_ERROR_TAG;
2023-12-31 21:03:00 +08:00
public const string PASS_TAG = EcsConsts.DEBUG_PASS_TAG;
2023-11-22 11:28:15 +08:00
2024-02-26 10:56:18 +08:00
public static void Set<T>() where T : DebugService, new()
{
DebugService.Set<T>();
}
public static void Set(DebugService service)
{
DebugService.Set(service);
}
2023-03-27 17:34:12 +08:00
[MethodImpl(MethodImplOptions.AggressiveInlining)]
2024-02-26 10:56:18 +08:00
public static void PrintWarning(object v)
{
2024-04-27 17:55:44 +08:00
#if (DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_DEBUGGER
2024-02-26 10:56:18 +08:00
DebugService.Instance.PrintWarning(v);
#endif
}
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static void PrintError(object v)
{
2024-04-27 17:55:44 +08:00
#if (DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_DEBUGGER
2024-02-26 10:56:18 +08:00
DebugService.Instance.PrintError(v);
#endif
}
[MethodImpl(MethodImplOptions.AggressiveInlining)]
2024-02-03 01:12:53 +08:00
public static void PrintErrorAndBreak(object v)
{
2024-04-27 17:55:44 +08:00
#if (DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_DEBUGGER
2024-02-26 10:56:18 +08:00
DebugService.Instance.PrintErrorAndBreak(v);
#endif
}
[MethodImpl(MethodImplOptions.AggressiveInlining)]
public static void PrintPass(object v)
{
2024-04-27 17:55:44 +08:00
#if (DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_DEBUGGER
2024-02-26 10:56:18 +08:00
DebugService.Instance.PrintPass(v);
#endif
2024-02-03 01:12:53 +08:00
}
2024-02-26 10:56:18 +08:00
[MethodImpl(MethodImplOptions.AggressiveInlining)]
2023-11-08 15:15:10 +08:00
public static void Print()
{
2024-04-27 17:55:44 +08:00
#if (DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_DEBUGGER
2024-02-26 10:56:18 +08:00
DebugService.Instance.Print();
2023-11-08 15:15:10 +08:00
#endif
}
2024-02-26 10:56:18 +08:00
[MethodImpl(MethodImplOptions.AggressiveInlining)]
2023-05-27 15:59:46 +08:00
public static void Print(object v)
{
2024-04-27 17:55:44 +08:00
#if (DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_DEBUGGER
2023-05-27 15:59:46 +08:00
DebugService.Instance.Print(v);
#endif
}
[MethodImpl(MethodImplOptions.AggressiveInlining)]
2023-03-27 17:34:12 +08:00
public static void Print(string tag, object v)
{
2024-04-27 17:55:44 +08:00
#if (DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_DEBUGGER
2023-03-27 17:34:12 +08:00
DebugService.Instance.Print(tag, v);
#endif
}
2024-02-26 10:56:18 +08:00
[MethodImpl(MethodImplOptions.AggressiveInlining)]
2023-06-30 00:32:25 +08:00
public static void Break()
{
2024-04-27 17:55:44 +08:00
#if (DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_DEBUGGER
2024-02-26 10:56:18 +08:00
DebugService.Instance.Break();
2023-06-30 00:32:25 +08:00
#endif
}
2023-03-27 17:34:12 +08:00
}
2023-03-30 06:03:05 +08:00
2023-03-27 17:34:12 +08:00
public abstract class DebugService
{
private static DebugService _instance;
2024-09-09 18:21:21 +08:00
private static object _lock = new object();
2023-06-12 20:46:51 +08:00
public static DebugService Instance
{
get
{
if (_instance == null)
2024-02-26 10:56:18 +08:00
{
2024-09-10 19:18:46 +08:00
lock (_lock)
{
_instance = new DefaultDebugService();
}
2024-02-26 10:56:18 +08:00
}
2023-06-12 20:46:51 +08:00
return _instance;
}
}
2023-03-27 17:34:12 +08:00
2024-09-13 11:03:51 +08:00
protected static string AutoConvertObjectToString(object o)
{
if (o is string str)
{
return str;
}
if (o is IEnumerable enumerable)
{
return string.Join(", ", enumerable.Cast<object>());
}
return o.ToString();
}
2024-09-12 03:01:22 +08:00
public readonly struct MarkerInfo
{
public readonly string Name;
public readonly int ID;
public MarkerInfo(string name, int iD)
{
Name = name;
ID = iD;
}
2024-09-12 03:24:06 +08:00
public override string ToString() { return this.AutoToString(); }
2024-09-12 03:01:22 +08:00
}
public IEnumerable<MarkerInfo> MarkerInfos
{
get { return _nameIdTable.Select(o => new MarkerInfo(o.Key, o.Value)); }
}
2024-02-26 10:56:18 +08:00
public static void Set<T>() where T : DebugService, new()
{
2024-09-10 19:18:46 +08:00
lock (_lock)
{
2024-09-12 03:01:22 +08:00
if (Instance is T == false)
{
Set(new T());
}
2024-09-10 19:18:46 +08:00
}
2024-02-26 10:56:18 +08:00
}
2023-03-27 17:34:12 +08:00
public static void Set(DebugService service)
{
2024-09-10 19:18:46 +08:00
lock (_lock)
{
2024-09-12 03:01:22 +08:00
if (_instance != service)
{
var oldService = _instance;
_instance = service;
2024-09-12 03:24:06 +08:00
if(_instance != null)
2024-09-12 04:05:15 +08:00
{ //TODO Так, всеже треды влияют друг на друга, скоерее всего проблема в использовании _nameIdTable/ Так вроде пофиксил, но не понял как конкретно
2024-09-12 03:24:06 +08:00
foreach (var info in oldService.MarkerInfos)
{
service._idDispenser.Use(info.ID);
service._nameIdTable.TryAdd(info.Name, info.ID);
service.OnNewProfilerMark(info.ID, info.Name);
}
2024-09-12 03:01:22 +08:00
}
service.OnServiceSetup(oldService);
OnServiceChanged(service);
}
2024-09-10 19:18:46 +08:00
}
2023-03-27 17:34:12 +08:00
}
2024-09-12 03:01:22 +08:00
protected virtual void OnServiceSetup(DebugService oldService) { }
2023-03-27 17:34:12 +08:00
public static Action<DebugService> OnServiceChanged = delegate { };
2024-09-12 03:01:22 +08:00
private IdDispenser _idDispenser = new IdDispenser(16, 0);
2024-09-12 04:05:15 +08:00
private Dictionary<string, int> _nameIdTable = new Dictionary<string, int>();
2023-03-27 17:34:12 +08:00
public abstract void Print(string tag, object v);
2023-06-30 00:31:17 +08:00
public abstract void Break();
2023-03-27 17:34:12 +08:00
public int RegisterMark(string name)
{
int id;
2023-05-30 18:30:10 +08:00
if (!_nameIdTable.TryGetValue(name, out id))
2023-03-27 17:34:12 +08:00
{
2024-09-09 18:21:21 +08:00
lock (_lock)
{
2024-09-12 04:05:15 +08:00
if (!_nameIdTable.TryGetValue(name, out id))
{
id = _idDispenser.UseFree();
_nameIdTable.Add(name, id);
OnNewProfilerMark(id, name);
}
2024-09-09 18:21:21 +08:00
}
2023-03-27 17:34:12 +08:00
}
return id;
}
public void DeleteMark(string name)
{
2024-09-10 19:18:46 +08:00
lock (_lock)
{
int id = _nameIdTable[name];
2024-09-12 04:05:15 +08:00
_nameIdTable.Remove(name);
2024-09-10 19:18:46 +08:00
_idDispenser.Release(id);
OnDelProfilerMark(id);
}
2023-03-27 17:34:12 +08:00
}
2023-06-12 20:30:44 +08:00
protected abstract void OnNewProfilerMark(int id, string name);
protected abstract void OnDelProfilerMark(int id);
2023-03-27 17:34:12 +08:00
2023-06-12 20:30:44 +08:00
public abstract void ProfilerMarkBegin(int id);
public abstract void ProfilerMarkEnd(int id);
2023-03-27 17:34:12 +08:00
}
2024-02-26 10:56:18 +08:00
public static class DebugServiceExtensions
{
public static void PrintWarning(this DebugService self, object v)
{
self.Print(EcsConsts.DEBUG_WARNING_TAG, v);
}
public static void PrintError(this DebugService self, object v)
{
self.Print(EcsConsts.DEBUG_ERROR_TAG, v);
}
public static void PrintErrorAndBreak(this DebugService self, object v)
{
self.Print(EcsConsts.DEBUG_ERROR_TAG, v);
self.Break();
}
public static void PrintPass(this DebugService self, object v)
{
self.Print(EcsConsts.DEBUG_PASS_TAG, v);
}
public static void Print(this DebugService self, object v)
{
self.Print(null, v);
}
public static void Print(this DebugService self)
{
self.Print("");
}
2024-09-08 19:39:43 +08:00
//TODO PrintJson возможно будет добавлено когда-то
2024-02-26 10:56:18 +08:00
}
2023-03-27 17:34:12 +08:00
public sealed class DefaultDebugService : DebugService
{
2024-04-27 17:55:44 +08:00
private const string PROFILER_MARKER = "ProfilerMark";
2024-09-12 03:01:22 +08:00
private readonly struct MarkerData
2024-04-27 17:55:44 +08:00
{
2024-09-12 03:01:22 +08:00
public readonly Stopwatch Stopwatch;
public readonly string Name;
public readonly int ID;
public MarkerData(Stopwatch stopwatch, string name, int id)
2024-04-27 17:55:44 +08:00
{
2024-09-12 03:01:22 +08:00
Stopwatch = stopwatch;
Name = name;
ID = id;
2024-04-27 17:55:44 +08:00
}
2024-09-12 03:24:06 +08:00
public override string ToString()
{
return this.AutoToString();
}
2024-04-27 17:55:44 +08:00
}
private MarkerData[] _stopwatchs;
[ThreadStatic]
private static char[] _buffer;
2024-09-12 03:01:22 +08:00
2023-03-27 17:34:12 +08:00
public DefaultDebugService()
{
2023-11-22 11:38:28 +08:00
Console.ForegroundColor = ConsoleColor.White;
Console.BackgroundColor = ConsoleColor.Black;
#if (DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_DEBUGGER
2024-04-27 17:55:44 +08:00
_stopwatchs = new MarkerData[64];
2023-03-27 17:34:12 +08:00
#endif
}
2023-11-22 11:38:28 +08:00
2023-03-27 17:34:12 +08:00
public override void Print(string tag, object v)
{
2023-11-22 11:28:15 +08:00
if (string.IsNullOrEmpty(tag))
{
2024-09-13 11:03:51 +08:00
Console.WriteLine(AutoConvertObjectToString(v));
2023-11-22 11:28:15 +08:00
}
else
{
var color = Console.ForegroundColor;
switch (tag)
{
case EcsDebug.ERROR_TAG:
Console.ForegroundColor = ConsoleColor.Red;
break;
case EcsDebug.WARNING_TAG:
Console.ForegroundColor = ConsoleColor.Yellow;
break;
2023-12-31 21:03:00 +08:00
case EcsDebug.PASS_TAG:
Console.ForegroundColor = ConsoleColor.Green;
break;
2023-11-22 11:28:15 +08:00
}
2024-09-13 11:03:51 +08:00
Console.WriteLine($"[{tag}] {AutoConvertObjectToString(v)}");
2023-11-22 11:28:15 +08:00
Console.ForegroundColor = color;
}
2023-03-27 17:34:12 +08:00
}
2023-06-30 00:31:17 +08:00
public override void Break()
{
2023-11-22 11:28:15 +08:00
var color = Console.ForegroundColor;
Console.ForegroundColor = ConsoleColor.Cyan;
Console.WriteLine("Press Enter to сontinue.");
Console.ReadKey();
Console.ForegroundColor = color;
2023-06-30 00:31:17 +08:00
}
2024-04-27 17:55:44 +08:00
private const string PROFILER_MARKER_CACHE = "[" + PROFILER_MARKER + "] ";
2023-06-12 20:30:44 +08:00
public override void ProfilerMarkBegin(int id)
2023-03-27 17:34:12 +08:00
{
#if ((DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_DEBUGGER) && !UNITY_5_3_OR_NEWER
var color = Console.ForegroundColor;
Console.ForegroundColor = ConsoleColor.DarkGray;
2024-09-12 03:24:06 +08:00
_stopwatchs[id].Stopwatch.Start();
2024-04-27 17:55:44 +08:00
Console.Write(PROFILER_MARKER_CACHE);
2024-09-12 03:24:06 +08:00
Console.Write(_stopwatchs[id].Name);
2024-04-27 17:55:44 +08:00
Console.WriteLine("> ");
Console.ForegroundColor = color;
2024-04-27 17:55:44 +08:00
#endif
2023-03-27 17:34:12 +08:00
}
2023-06-12 20:30:44 +08:00
public override void ProfilerMarkEnd(int id)
2023-03-27 17:34:12 +08:00
{
#if ((DEBUG && !DISABLE_DEBUG) || ENABLE_DRAGONECS_DEBUGGER) && !UNITY_5_3_OR_NEWER
2023-11-22 11:28:15 +08:00
var color = Console.ForegroundColor;
Console.ForegroundColor = ConsoleColor.DarkGray;
2024-09-12 03:24:06 +08:00
_stopwatchs[id].Stopwatch.Stop();
var time = _stopwatchs[id].Stopwatch.Elapsed;
_stopwatchs[id].Stopwatch.Reset();
2024-04-27 17:55:44 +08:00
Console.Write(PROFILER_MARKER_CACHE);
Console.Write("> ");
2024-09-12 03:24:06 +08:00
Console.Write(_stopwatchs[id].Name);
2024-04-27 17:55:44 +08:00
Console.Write(" s:");
int written = 0;
if (_buffer == null) { _buffer = new char[128]; }
ConvertDoubleToText(time.TotalSeconds, _buffer, ref written);
Console.WriteLine(_buffer, 0, written);
2023-11-22 11:28:15 +08:00
Console.ForegroundColor = color;
2024-04-27 17:55:44 +08:00
#endif
2023-03-27 17:34:12 +08:00
}
2024-04-27 17:55:44 +08:00
2023-06-12 20:30:44 +08:00
protected override void OnDelProfilerMark(int id)
2023-03-27 17:34:12 +08:00
{
2024-04-27 17:55:44 +08:00
_stopwatchs[id] = default;
2023-03-27 17:34:12 +08:00
}
2023-06-12 20:30:44 +08:00
protected override void OnNewProfilerMark(int id, string name)
2023-03-27 17:34:12 +08:00
{
2023-03-30 16:39:16 +08:00
if (id >= _stopwatchs.Length)
{
Array.Resize(ref _stopwatchs, _stopwatchs.Length << 1);
}
2024-09-12 03:01:22 +08:00
_stopwatchs[id] = new MarkerData(new Stopwatch(), name, id);
2024-04-27 17:55:44 +08:00
}
[MethodImpl(MethodImplOptions.AggressiveInlining)]
static void ConvertDoubleToText(double value, char[] stringBuffer, ref int written)
{
int bufferLength = stringBuffer.Length - 1;
decimal decimalValue = (decimal)value;
int intValue = (int)decimalValue;
decimal decimalPartValue = decimalValue - intValue;
int index = written;
if (intValue == 0)
{
stringBuffer[index++] = '0';
}
else
{
while (intValue > 0)
{
int digit = intValue % 10;
stringBuffer[index++] = (char)('0' + digit);
intValue /= 10;
}
Array.Reverse(stringBuffer, 0, index);
}
if (decimalPartValue != 0)
{
stringBuffer[index++] = '.';
}
int pathBufferLength = bufferLength - index;
int zeroPartLength = 0;
for (int i = 0; i < pathBufferLength; i++)
{
decimalPartValue = 10 * decimalPartValue;
int digit = (int)decimalPartValue;
if (digit == 0)
{
zeroPartLength++;
}
else
{
zeroPartLength = 0;
}
stringBuffer[index++] = (char)('0' + digit);
decimalPartValue -= digit;
}
written = bufferLength - zeroPartLength;
2023-03-27 17:34:12 +08:00
}
}
}