mirror of
https://github.com/TomHarte/CLK.git
synced 2024-11-01 10:05:55 +00:00
270 lines
9.0 KiB
C++
270 lines
9.0 KiB
C++
//
|
|
// Video.hpp
|
|
// Clock Signal
|
|
//
|
|
// Created by Thomas Harte on 14/04/2018.
|
|
// Copyright 2018 Thomas Harte. All rights reserved.
|
|
//
|
|
|
|
#ifndef Video_hpp
|
|
#define Video_hpp
|
|
|
|
#include "../../Outputs/CRT/CRT.hpp"
|
|
#include "../../ClockReceiver/ClockReceiver.hpp"
|
|
|
|
#include <vector>
|
|
|
|
namespace AppleII {
|
|
namespace Video {
|
|
|
|
class BusHandler {
|
|
public:
|
|
uint8_t perform_read(uint16_t address) {
|
|
return 0xff;
|
|
}
|
|
};
|
|
|
|
class VideoBase {
|
|
public:
|
|
VideoBase();
|
|
static void setup_tables();
|
|
|
|
/// @returns The CRT this video feed is feeding.
|
|
Outputs::CRT::CRT *get_crt();
|
|
|
|
// Inputs for the various soft switches.
|
|
void set_graphics_mode();
|
|
void set_text_mode();
|
|
void set_mixed_mode(bool);
|
|
void set_video_page(int);
|
|
void set_low_resolution();
|
|
void set_high_resolution();
|
|
|
|
// Setup for text mode.
|
|
void set_character_rom(const std::vector<uint8_t> &);
|
|
|
|
protected:
|
|
std::unique_ptr<Outputs::CRT::CRT> crt_;
|
|
|
|
int video_page_ = 0;
|
|
int row_ = 0, column_ = 0, flash_ = 0;
|
|
uint16_t *pixel_pointer_ = nullptr;
|
|
std::vector<uint8_t> character_rom_;
|
|
|
|
enum class GraphicsMode {
|
|
LowRes,
|
|
HighRes,
|
|
Text
|
|
} graphics_mode_ = GraphicsMode::LowRes;
|
|
bool use_graphics_mode_ = false;
|
|
bool mixed_mode_ = false;
|
|
uint16_t graphics_carry_ = 0;
|
|
|
|
static uint16_t scaled_byte[256];
|
|
static uint16_t low_resolution_patterns[2][16];
|
|
};
|
|
|
|
template <class BusHandler> class Video: public VideoBase {
|
|
public:
|
|
/// Constructs an instance of the video feed; a CRT is also created.
|
|
Video(BusHandler &bus_handler) :
|
|
VideoBase(),
|
|
bus_handler_(bus_handler) {}
|
|
|
|
/*!
|
|
Advances time by @c cycles; expects to be fed by the CPU clock.
|
|
Implicitly adds an extra half a colour clock at the end of every
|
|
line.
|
|
*/
|
|
void run_for(const Cycles cycles) {
|
|
/*
|
|
Addressing scheme used throughout is that column 0 is the first column with pixels in it;
|
|
row 0 is the first row with pixels in it.
|
|
|
|
A frame is oriented around 65 cycles across, 262 lines down.
|
|
*/
|
|
const int first_sync_line = 220; // A complete guess. Information needed.
|
|
const int first_sync_column = 49; // Also a guess.
|
|
|
|
int int_cycles = cycles.as_int();
|
|
while(int_cycles) {
|
|
const int cycles_this_line = std::min(65 - column_, int_cycles);
|
|
|
|
if(row_ >= first_sync_line && row_ < first_sync_line + 3) {
|
|
crt_->output_sync(static_cast<unsigned int>(cycles_this_line) * 7);
|
|
} else {
|
|
const int ending_column = column_ + cycles_this_line;
|
|
const GraphicsMode line_mode = use_graphics_mode_ ? graphics_mode_ : GraphicsMode::Text;
|
|
|
|
// The first 40 columns are submitted to the CRT only upon completion;
|
|
// they'll be either graphics or blank, depending on which side we are
|
|
// of line 192.
|
|
if(column_ < 40) {
|
|
if(row_ < 192) {
|
|
if(!column_) {
|
|
pixel_pointer_ = reinterpret_cast<uint16_t *>(crt_->allocate_write_area(80, 2));
|
|
graphics_carry_ = 0;
|
|
}
|
|
|
|
const int pixel_end = std::min(40, ending_column);
|
|
const int character_row = row_ >> 3;
|
|
const int pixel_row = row_ & 7;
|
|
const uint16_t row_address = static_cast<uint16_t>((character_row >> 3) * 40 + ((character_row&7) << 7));
|
|
const uint16_t text_address = static_cast<uint16_t>(((video_page_+1) * 0x400) + row_address);
|
|
const uint16_t graphics_address = static_cast<uint16_t>(((video_page_+1) * 0x2000) + row_address + ((pixel_row&7) << 10));
|
|
const int row_shift = (row_&4);
|
|
|
|
GraphicsMode pixel_mode = (!mixed_mode_ || row_ < 160) ? line_mode : GraphicsMode::Text;
|
|
switch(pixel_mode) {
|
|
case GraphicsMode::Text: {
|
|
const uint8_t inverses[] = {
|
|
0xff,
|
|
static_cast<uint8_t>((flash_ / flash_length) * 0xff),
|
|
0x00,
|
|
0x00
|
|
};
|
|
for(int c = column_; c < pixel_end; ++c) {
|
|
const uint8_t character = bus_handler_.perform_read(static_cast<uint16_t>(text_address + c));
|
|
const std::size_t character_address = static_cast<std::size_t>(((character & 0x3f) << 3) + pixel_row);
|
|
|
|
const uint8_t character_pattern = character_rom_[character_address] ^ inverses[character >> 6];
|
|
pixel_pointer_[c] = scaled_byte[character_pattern & 0x7f];
|
|
}
|
|
} break;
|
|
|
|
case GraphicsMode::LowRes:
|
|
for(int c = column_; c < pixel_end; ++c) {
|
|
const uint8_t character = bus_handler_.perform_read(static_cast<uint16_t>(text_address + c));
|
|
pixel_pointer_[c] = low_resolution_patterns[c&1][(character >> row_shift)&0xf];
|
|
}
|
|
break;
|
|
|
|
case GraphicsMode::HighRes:
|
|
for(int c = column_; c < pixel_end; ++c) {
|
|
const uint8_t graphic = bus_handler_.perform_read(static_cast<uint16_t>(graphics_address + c));
|
|
pixel_pointer_[c] = scaled_byte[graphic];
|
|
if(graphic & 0x80) {
|
|
reinterpret_cast<uint8_t *>(&pixel_pointer_[c])[0] |= graphics_carry_;
|
|
}
|
|
graphics_carry_ = (graphic >> 6) & 1;
|
|
}
|
|
break;
|
|
}
|
|
|
|
if(ending_column >= 40) {
|
|
crt_->output_data(280, 80);
|
|
}
|
|
} else {
|
|
if(ending_column >= 40) {
|
|
crt_->output_blank(280);
|
|
}
|
|
}
|
|
}
|
|
|
|
/*
|
|
The left border, sync, right border pattern doesn't depend on whether
|
|
there were pixels this row and is output as soon as it is known.
|
|
*/
|
|
|
|
const int first_blank_start = std::max(40, column_);
|
|
const int first_blank_end = std::min(first_sync_column, ending_column);
|
|
if(first_blank_end > first_blank_start) {
|
|
crt_->output_blank(static_cast<unsigned int>(first_blank_end - first_blank_start) * 7);
|
|
}
|
|
|
|
const int sync_start = std::max(first_sync_column, column_);
|
|
const int sync_end = std::min(first_sync_column + 4, ending_column);
|
|
if(sync_end > sync_start) {
|
|
crt_->output_sync(static_cast<unsigned int>(sync_end - sync_start) * 7);
|
|
}
|
|
|
|
int second_blank_start;
|
|
if(line_mode != GraphicsMode::Text && (!mixed_mode_ || row_ < 159 || row_ >= 192)) {
|
|
const int colour_burst_start = std::max(first_sync_column + 4, column_);
|
|
const int colour_burst_end = std::min(first_sync_column + 7, ending_column);
|
|
if(colour_burst_end > colour_burst_start) {
|
|
crt_->output_default_colour_burst(static_cast<unsigned int>(colour_burst_end - colour_burst_start) * 7);
|
|
}
|
|
|
|
second_blank_start = std::max(first_sync_column + 7, column_);
|
|
} else {
|
|
second_blank_start = std::max(first_sync_column + 4, column_);
|
|
}
|
|
|
|
if(ending_column > second_blank_start) {
|
|
crt_->output_blank(static_cast<unsigned int>(ending_column - second_blank_start) * 7);
|
|
}
|
|
}
|
|
|
|
int_cycles -= cycles_this_line;
|
|
column_ = (column_ + cycles_this_line) % 65;
|
|
if(!column_) {
|
|
row_ = (row_ + 1) % 262;
|
|
flash_ = (flash_ + 1) % (2 * flash_length);
|
|
|
|
// Add an extra half a colour cycle of blank; this isn't counted in the run_for
|
|
// count explicitly but is promised.
|
|
crt_->output_blank(1);
|
|
}
|
|
}
|
|
}
|
|
|
|
/*!
|
|
Obtains the last value the video read prior to time now+offset.
|
|
*/
|
|
uint8_t get_last_read_value(Cycles offset) {
|
|
// Rules of generation:
|
|
// (1) a complete sixty-five-cycle scan line consists of sixty-five consecutive bytes of
|
|
// display buffer memory that starts twenty-five bytes prior to the actual data to be displayed.
|
|
// (2) During VBL the data acts just as if it were starting a whole new frame from the beginning, but
|
|
// it never finishes this pseudo-frame. After getting one third of the way through the frame (to
|
|
// scan line $3F), it suddenly repeats the previous six scan lines ($3A through $3F) before aborting
|
|
// to begin the next true frame.
|
|
//
|
|
// Source: Have an Apple Split by Bob Bishop; http://rich12345.tripod.com/aiivideo/softalk.html
|
|
|
|
// Determine column at offset.
|
|
int mapped_column = column_ + offset.as_int();
|
|
|
|
// Map that backwards from the internal pixels-at-start generation to pixels-at-end
|
|
// (so what was column 0 is now column 25).
|
|
mapped_column += 25;
|
|
|
|
// Apply carry into the row counter.
|
|
int mapped_row = row_ + (mapped_column / 65);
|
|
mapped_column %= 65;
|
|
mapped_row %= 262;
|
|
|
|
// Apple out-of-bounds row logic.
|
|
if(mapped_row >= 256) {
|
|
mapped_row = 0x3a + (mapped_row&255);
|
|
} else {
|
|
mapped_row %= 192;
|
|
}
|
|
|
|
// Calculate the address and return the value.
|
|
uint16_t read_address = static_cast<uint16_t>(get_row_address(mapped_row) + mapped_column - 25);
|
|
return bus_handler_.perform_read(read_address);
|
|
}
|
|
|
|
private:
|
|
uint16_t get_row_address(int row) {
|
|
const int character_row = row >> 3;
|
|
const int pixel_row = row & 7;
|
|
const uint16_t row_address = static_cast<uint16_t>((character_row >> 3) * 40 + ((character_row&7) << 7));
|
|
|
|
GraphicsMode pixel_mode = ((!mixed_mode_ || row < 160) && use_graphics_mode_) ? graphics_mode_ : GraphicsMode::Text;
|
|
return (pixel_mode == GraphicsMode::HighRes) ?
|
|
static_cast<uint16_t>(((video_page_+1) * 0x2000) + row_address + ((pixel_row&7) << 10)) :
|
|
static_cast<uint16_t>(((video_page_+1) * 0x400) + row_address);
|
|
}
|
|
|
|
const int flash_length = 8406;
|
|
BusHandler &bus_handler_;
|
|
};
|
|
|
|
}
|
|
}
|
|
|
|
#endif /* Video_hpp */
|