CLK/Storage/Tape/Formats/TZX.hpp

//
//  TZX.hpp
//  Clock Signal
//
//  Created by Thomas Harte on 16/07/2017.
//  Copyright 2017 Thomas Harte. All rights reserved.
//

#pragma once

#include "../PulseQueuedTape.hpp"
#include "../../FileHolder.hpp"

#include <string>

namespace Storage::Tape {

/*!
	Provides a @c Tape containing a CSW tape image, which is a compressed 1-bit sampling.
*/
class TZX: public Tape {
public:
	/*!
		Constructs a @c TZX containing content from the file with name @c file_name.

		@throws ErrorNotTZX if this file could not be opened and recognised as a valid TZX file.
	*/
	TZX(const std::string &file_name);

	enum {
		ErrorNotTZX
	};

private:
	struct Serialiser: public PulseQueuedSerialiser {
		Serialiser(const std::string &file_name);

	private:
		Storage::FileHolder file_;

		void reset() override;
		void push_next_pulses() override;

		bool current_level_;

		void get_standard_speed_data_block();
		void get_turbo_speed_data_block();
		void get_pure_tone_data_block();
		void get_pulse_sequence();
		void get_pure_data_block();
		void get_direct_recording_block();
		void get_csw_recording_block();
		void get_generalised_data_block();
		void get_pause();

		void ignore_group_start();
		void ignore_group_end();
		void ignore_jump_to_block();
		void ignore_loop_start();
		void ignore_loop_end();
		void ignore_call_sequence();
		void ignore_return_from_sequence();
		void ignore_select_block();
		void ignore_stop_tape_if_in_48kb_mode();

		void get_set_signal_level();

		void ignore_text_description();
		void ignore_message_block();
		void ignore_archive_info();
		void get_hardware_type();
		void ignore_custom_info_block();

		void get_kansas_city_block();
		void ignore_glue_block();

		struct Data {
			unsigned int length_of_zero_bit_pulse;
			unsigned int length_of_one_bit_pulse;
			unsigned int number_of_bits_in_final_byte;
			unsigned int pause_after_block;
			uint32_t data_length;
		};

		struct DataBlock {
			unsigned int length_of_pilot_pulse;
			unsigned int length_of_sync_first_pulse;
			unsigned int length_of_sync_second_pulse;
			unsigned int length_of_pilot_tone;
			Data data;
		};

		void get_generalised_segment(
			uint32_t output_symbols,
			uint8_t max_pulses_per_symbol,
			uint8_t number_of_symbols,
			bool is_data
		);
		void get_data_block(const DataBlock &);
		void get_data(const Data &);

		void post_pulses(unsigned int count, unsigned int length);
		void post_pulse(unsigned int length);
		void post_gap(unsigned int milliseconds);

		void post_pulse(const Storage::Time &time);
	} serialiser_;
};

}