namespace OrpaonVision.SiteApp.Runtime.Contracts
{
    /// <summary>
    /// 相机采集帧信息。
    /// </summary>
    public sealed class CameraFrameDto
    {
        /// <summary>
        /// 帧唯一标识。
        /// </summary>
        public Guid FrameId { get; set; }

        /// <summary>
        /// 采集时间（UTC）。
        /// </summary>
        public DateTime CapturedAtUtc { get; set; }

        /// <summary>
        /// 相机标识。
        /// </summary>
        public string CameraId { get; set; } = string.Empty;

        /// <summary>
        /// 图像时间戳。
        /// </summary>
        public DateTime Timestamp { get; set; }

        /// <summary>
        /// 图像数据。
        /// </summary>
        public byte[] ImageData { get; set; } = Array.Empty<byte>();

        /// <summary>
        /// 图像宽度。
        /// </summary>
        public int Width { get; set; }

        /// <summary>
        /// 图像高度。
        /// </summary>
        public int Height { get; set; }

        /// <summary>
        /// 像素格式。
        /// </summary>
        public string PixelFormat { get; set; } = string.Empty;
    }
}