#ifndef NMFFMPEGVIDEOWRITER_H
#define NMFFMPEGVIDEOWRITER_H

#include "nmSubWxs_global.h"

#include <QString>
#include <QStringList>

/** @brief 使用项目固定FFmpeg 1.1 DLL编码RGB24视频。 */
class NM_SUB_WXS_EXPORT nmFFmpegVideoWriter
{
public:
    /** @brief 打开视频编码器所需的规范化参数。 */
    struct VideoSettings
    {
        /** @brief 创建尚未指定文件、尺寸和帧率的空参数。 */
        VideoSettings();

        /** @brief Writer规范为绝对路径后写入，并在失败或取消时删除的临时文件。 */
        QString m_sTemporaryFilePath;
        /** @brief 决定固定容器和编码器组合的扩展名，可带或不带点号。 */
        QString m_sFileExtension;
        /** @brief 输出宽度，单位为像素，必须是2～8192之间的偶数。 */
        int m_nWidth;
        /** @brief 输出高度，单位为像素，必须是2～8192之间的偶数。 */
        int m_nHeight;
        /** @brief 视频帧率，正式有效范围为1～5000 FPS。 */
        int m_nFramesPerSecond;
    };

    /** @brief 创建尚未打开编码会话的Writer。 */
    nmFFmpegVideoWriter();
    /** @brief 析构Writer；仍在编码时按取消路径清理临时文件。 */
    ~nmFFmpegVideoWriter();

    /**
     * @brief 创建编码器并打开临时文件；失败时不会留下半成品。
     * @param oSettings 已规范化的视频参数。
     * @param pError 可选错误输出；进入函数后先清空。
     * @return 编码器、容器和自定义文件IO全部初始化成功时返回true。
     */
    bool open(const VideoSettings& oSettings, QString* pError = nullptr);

    /**
     * @brief 写入一帧RGB24数据，stride允许包含行尾填充。
     * @param pData 输入帧首地址，只在本次调用期间读取。
     * @param nStride 每行字节数，不得小于宽度乘3。
     * @param bBottomUp 为true时首地址对应图像底行，Writer负责垂直翻转。
     * @param pError 可选错误输出；进入函数后先清空。
     * @return 完整帧成功交给编码器和Muxer时返回true。
     */
    bool writeRgb24Frame(const unsigned char* pData,
                         int nStride,
                         bool bBottomUp,
                         QString* pError = nullptr);

    /**
     * @brief 刷新编码器并写完容器；成功后临时文件才可发布。
     * @param pError 可选错误输出；进入函数后先清空。
     * @return Trailer、IO刷新和非空文件校验全部成功时返回true。
     */
    bool finish(QString* pError = nullptr);

    /** @brief 中止编码并删除Writer拥有的临时文件。 */
    void cancel();

    /**
     * @brief 校验固定DLL主版本及全部正式格式组合是否可用。
     * @param pError 可选错误输出；失败时说明具体版本、格式或组件。
     * @return 八种正式格式全部可用时返回true。
     */
    static bool isBackendAvailable(QString* pError = nullptr);

    /** @brief 返回正式支持的八种文件扩展名，均不包含点号。 */
    static QStringList getSupportedExtensions();

    /** @brief 判断扩展名是否属于正式格式，比较时忽略大小写和前导点号。 */
    static bool isSupportedExtension(const QString& sExtension);

private:
    Q_DISABLE_COPY(nmFFmpegVideoWriter)

    /** @brief 隔离FFmpeg头文件和编码资源的私有实现。 */
    class Private;
    /** @brief Writer独占的状态、FFmpeg对象及临时文件资源。 */
    Private* m_pPrivate;
};

#endif // NMFFMPEGVIDEOWRITER_H