/*
 *   Copyright (C) 2009,2013 by Jonathan Naylor G4KLX
 *
 *   This program is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License as published by
 *   the Free Software Foundation; either version 2 of the License, or
 *   (at your option) any later version.
 *
 *   This program is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *   GNU General Public License for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with this program; if not, write to the Free Software
 *   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

#ifndef	DVTOOLFileWriter_H
#define DVTOOLFileWriter_H

#include "HeaderData.h"

#include "StdCompat.h"
#include <cstdio>
#include <cstdint>

/*
 * Sequential writer for .dvtool recording files (see DVTOOLFileReader.h for
 * the file format description).
 *
 * Usage:
 *   open()  — writes the "DVTOOL" signature and a placeholder record count,
 *              then writes the header record.
 *   write() — appends each DV data frame as a DSVT data record.
 *   close() — writes the trailer record, then seeks back to the placeholder
 *             and fills in the final record count (big-endian uint32).
 *
 * Two open() overloads are provided:
 *   open(filename, header) — uses a caller-supplied base filename.
 *   open(header)           — auto-generates a filename from a timestamp and
 *                            the callsigns embedded in the header.
 *
 * setDirectory() is a class-level (static) setting that prepends a directory
 * to all generated filenames.
 */
class CDVTOOLFileWriter {
public:
	CDVTOOLFileWriter();
	~CDVTOOLFileWriter();

	// Sets the output directory used by all CDVTOOLFileWriter instances.
	static void setDirectory(const std::string& dirName);

	std::string getFileName() const;

	bool open(const CHeaderData& header);
	bool open(const std::string& filename, const CHeaderData& header);
	bool write(const unsigned char* buffer, unsigned int length);
	void close();

private:
	static std::string m_dirName;

	std::string  m_fileName;
	FILE*        m_file;
	uint32_t     m_count;      // Number of DSVT records written (header + data + trailer).
	unsigned int m_sequence;   // Per-frame sequence counter (0–20, mirrors DSRP wire format).
	long         m_offset;     // File offset of the record-count field, for back-patching in close().

	bool writeHeader(const CHeaderData& header);
	bool writeTrailer();
};

#endif