CLK/Machines/AmstradCPC/AmstradCPC.hpp

//
//  AmstradCPC.hpp
//  Clock Signal
//
//  Created by Thomas Harte on 30/07/2017.
//  Copyright © 2017 Thomas Harte. All rights reserved.
//

#ifndef AmstradCPC_hpp
#define AmstradCPC_hpp

#include "../ConfigurationTarget.hpp"
#include "../CRTMachine.hpp"
#include "../KeyboardMachine.hpp"

#include <cstdint>
#include <vector>

namespace AmstradCPC {

enum ROMType: int {
	OS464 = 0,	BASIC464,
	OS664,		BASIC664,
	OS6128,		BASIC6128,
	AMSDOS
};

/*!
	Models an Amstrad CPC.
*/
class Machine:
	public CRTMachine::Machine,
	public ConfigurationTarget::Machine,
	public KeyboardMachine::Machine {
	public:
		virtual ~Machine();

		/// Creates and returns an Amstrad CPC.
		static Machine *AmstradCPC();

		/// Sets the contents of rom @c type to @c data. Assumed to be a setup step; has no effect once a machine is running.
		virtual void set_rom(ROMType type, const std::vector<uint8_t> &data) = 0;
};

}

#endif /* AmstradCPC_hpp */
Performed sufficient wiring to get to the point where attempting to load a CDT creates an instance of the Amstrad CPC and then fails only because the thing vends a `nullptr` CRT. 2017-07-31 02:05:29 +00:00			`//`
			`// AmstradCPC.hpp`
			`// Clock Signal`
			`//`
			`// Created by Thomas Harte on 30/07/2017.`
			`// Copyright © 2017 Thomas Harte. All rights reserved.`
			`//`

			`#ifndef AmstradCPC_hpp`
			`#define AmstradCPC_hpp`

			`#include "../ConfigurationTarget.hpp"`
			`#include "../CRTMachine.hpp"`
Formally declared the ZX80/81 and Amstrad CPC as keyboard machines in their public interface. Which means not having to repeat the meaning of set_key_state and clear_all_keys. So: a minor DRY improvement. 2017-08-03 16:38:22 +00:00			`#include "../KeyboardMachine.hpp"`
Performed sufficient wiring to get to the point where attempting to load a CDT creates an instance of the Amstrad CPC and then fails only because the thing vends a `nullptr` CRT. 2017-07-31 02:05:29 +00:00
Minor tidiness: included missing headers, and spaced out the ROM type and key lists for readability. 2017-08-03 16:45:42 +00:00			`#include <cstdint>`
			`#include <vector>`

Performed sufficient wiring to get to the point where attempting to load a CDT creates an instance of the Amstrad CPC and then fails only because the thing vends a `nullptr` CRT. 2017-07-31 02:05:29 +00:00			`namespace AmstradCPC {`

Sought: (i) to instruct the CPC that it should be a 664, not a 464, if given a disk image (at least until I have RAM paging implemented for a 6128); (ii) to support ROM selection within the CPC and allow paging in of AMSDOS. 2017-08-05 23:20:38 +00:00			`enum ROMType: int {`
			`OS464 = 0, BASIC464,`
			`OS664, BASIC664,`
			`OS6128, BASIC6128,`
Ensured that ROM images are loaded and passed to the Amstrad CPC. 2017-07-31 22:44:49 +00:00			`AMSDOS`
			`};`

Upped the documentation. 2017-08-03 00:37:26 +00:00			`/*!`
Corrected typo and removed replication of what's already declared formally. 2017-08-16 18:53:03 +00:00			`Models an Amstrad CPC.`
Upped the documentation. 2017-08-03 00:37:26 +00:00			`*/`
Performed sufficient wiring to get to the point where attempting to load a CDT creates an instance of the Amstrad CPC and then fails only because the thing vends a `nullptr` CRT. 2017-07-31 02:05:29 +00:00			`class Machine:`
			`public CRTMachine::Machine,`
Formally declared the ZX80/81 and Amstrad CPC as keyboard machines in their public interface. Which means not having to repeat the meaning of set_key_state and clear_all_keys. So: a minor DRY improvement. 2017-08-03 16:38:22 +00:00			`public ConfigurationTarget::Machine,`
			`public KeyboardMachine::Machine {`
Performed sufficient wiring to get to the point where attempting to load a CDT creates an instance of the Amstrad CPC and then fails only because the thing vends a `nullptr` CRT. 2017-07-31 02:05:29 +00:00			`public:`
Ensured that a virtual destructor is declared, so that the various automatically-generated real constructors get in on the action. 2017-08-11 16:07:48 +00:00			`virtual ~Machine();`

Moves the Electron implementation behind a more opaque interface, in line with changes elsewhere. 2017-08-16 19:33:40 +00:00			`/// Creates and returns an Amstrad CPC.`
As per my keenness for cleanliness improvements corresponding to my ever-increasing C++ ability: turned the Amstrad into something that a factory produces, allowing me completely to hide a bunch of implementation details. 2017-08-01 02:32:04 +00:00			`static Machine *AmstradCPC();`
Added enough stuff to put the emulated Amstrad CPC in a state of knowing whether its '0' key is pressed. 2017-08-01 21:31:56 +00:00
Upped the documentation. 2017-08-03 00:37:26 +00:00			`/// Sets the contents of rom @c type to @c data. Assumed to be a setup step; has no effect once a machine is running.`
Modifies the Vic-20 and C1540 to bring them into the realm of self-ROM fetching. Hence enables Vic-20 support within kiosk mode as currently drafted. 2017-11-08 02:19:51 +00:00			`virtual void set_rom(ROMType type, const std::vector<uint8_t> &data) = 0;`
Performed sufficient wiring to get to the point where attempting to load a CDT creates an instance of the Amstrad CPC and then fails only because the thing vends a `nullptr` CRT. 2017-07-31 02:05:29 +00:00			`};`

			`}`

			`#endif /* AmstradCPC_hpp */`