mirror of
https://github.com/TomHarte/CLK.git
synced 2024-12-30 19:30:17 +00:00
76 lines
1.9 KiB
C++
76 lines
1.9 KiB
C++
//
|
|
// PCMTrack.hpp
|
|
// Clock Signal
|
|
//
|
|
// Created by Thomas Harte on 10/07/2016.
|
|
// Copyright © 2016 Thomas Harte. All rights reserved.
|
|
//
|
|
|
|
#ifndef PCMTrack_hpp
|
|
#define PCMTrack_hpp
|
|
|
|
#include "Disk.hpp"
|
|
#include <vector>
|
|
|
|
namespace Storage {
|
|
namespace Disk {
|
|
|
|
/*!
|
|
A segment of PCM-sampled data.
|
|
|
|
Bits from each byte are taken MSB to LSB.
|
|
*/
|
|
struct PCMSegment {
|
|
Time length_of_a_bit;
|
|
unsigned int number_of_bits;
|
|
std::vector<uint8_t> data;
|
|
};
|
|
|
|
/*!
|
|
A subclass of @c Track that provides its @c Events by querying a pulse-code modulated record of original
|
|
flux detections, with an implied index hole at the very start of the data.
|
|
|
|
The data may consist of a single @c PCMSegment or of multiple, allowing a PCM-format track to contain
|
|
multiple distinct segments of data, each with a separate clock rate.
|
|
*/
|
|
class PCMTrack: public Track {
|
|
public:
|
|
/*!
|
|
Creates a @c PCMTrack consisting of multiple segments of data, permitting multiple clock rates.
|
|
*/
|
|
PCMTrack(std::vector<PCMSegment> segments);
|
|
|
|
/*!
|
|
Creates a @c PCMTrack consisting of a single continuous run of data, implying a constant clock rate.
|
|
The segment's @c length_of_a_bit will be ignored and therefore need not be filled in.
|
|
*/
|
|
PCMTrack(PCMSegment segment);
|
|
|
|
// as per @c Track
|
|
Event get_next_event();
|
|
Time seek_to(Time time_since_index_hole);
|
|
|
|
private:
|
|
// storage for the segments that describe this track
|
|
std::vector<PCMSegment> _segments;
|
|
|
|
// a helper to determine the overall track clock rate and it's length
|
|
void fix_length();
|
|
|
|
// the event perpetually returned; impliedly contains the length of the entire track
|
|
// as its clock rate, per the need for everything on a Track to sum to a length of 1
|
|
PCMTrack::Event _next_event;
|
|
|
|
// contains the master clock rate
|
|
unsigned int _track_clock_rate;
|
|
|
|
// a pointer to the first bit to consider as the next event
|
|
size_t _segment_pointer;
|
|
size_t _bit_pointer;
|
|
};
|
|
|
|
}
|
|
}
|
|
|
|
#endif /* PCMTrack_hpp */
|