From 72ba78579a92659c6a5323caa478fe6b02e0abe21ed3f20c42573fbf68658eb1 Mon Sep 17 00:00:00 2001
From: copecone <controld3785@gmail.com>
Date: Tue, 18 Aug 2026 14:16:40 +0900
Subject: [PATCH] Add `RenderResult`

---
 API/RenderResult.cs | 70 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 API/RenderResult.cs

diff --git a/API/RenderResult.cs b/API/RenderResult.cs
new file mode 100644
index 0000000..e560bf8
--- /dev/null
+++ b/API/RenderResult.cs
@@ -0,0 +1,70 @@
+using System;
+
+namespace ADOFAIRenderer.API
+{
+    /// <summary>
+    /// Represents the result and metadata of a completed or cancelled render session.
+    /// </summary>
+    public class RenderResult
+    {
+        /// <summary>
+        /// Indicates whether the rendering session completed successfully.
+        /// </summary>
+        public bool Success { get; }
+
+        /// <summary>
+        /// The absolute output path of the rendered video file. Empty string if rendering failed or output was not created.
+        /// </summary>
+        public string OutputPath { get; }
+
+        /// <summary>
+        /// Total number of video frames sent to the encoder.
+        /// </summary>
+        public long TotalFrames { get; }
+
+        /// <summary>
+        /// The calculated video duration in seconds (based on TotalFrames and FPS).
+        /// </summary>
+        public double VideoDuration { get; }
+
+        /// <summary>
+        /// Total wall-clock time spent rendering.
+        /// </summary>
+        public TimeSpan RenderDuration { get; }
+
+        /// <summary>
+        /// File size of the output video in bytes (0 if failed or file does not exist).
+        /// </summary>
+        public long FileSizeBytes { get; }
+
+        /// <summary>
+        /// Error message or reason if rendering failed or was cancelled; <c>null</c> on success.
+        /// </summary>
+        public string? ErrorMessage { get; }
+
+        public RenderResult(
+            bool success,
+            string outputPath,
+            long totalFrames,
+            double videoDuration,
+            TimeSpan renderDuration,
+            long fileSizeBytes = 0,
+            string? errorMessage = null)
+        {
+            Success = success;
+            OutputPath = outputPath;
+            TotalFrames = totalFrames;
+            VideoDuration = videoDuration;
+            RenderDuration = renderDuration;
+            FileSizeBytes = fileSizeBytes;
+            ErrorMessage = errorMessage;
+        }
+
+        public override string ToString()
+        {
+            return Success
+                ? $"[RenderResult: Success, Output={OutputPath}, Frames={TotalFrames}, VideoDuration={VideoDuration:F2}s, Time={RenderDuration.TotalSeconds:F1}s, Size={FileSizeBytes / 1024.0 / 1024.0:F2}MB]"
+                : $"[RenderResult: Failed/Cancelled, Error={ErrorMessage ?? "Unknown"}]";
+        }
+    }
+}