mirror of
https://github.com/TomHarte/CLK.git
synced 2024-08-27 13:29:12 +00:00
130 lines
3.8 KiB
C++
130 lines
3.8 KiB
C++
//
|
|
// LineBuffer.hpp
|
|
// Clock Signal
|
|
//
|
|
// Created by Thomas Harte on 12/02/2023.
|
|
// Copyright © 2023 Thomas Harte. All rights reserved.
|
|
//
|
|
|
|
#pragma once
|
|
|
|
#include "AccessEnums.hpp"
|
|
|
|
namespace TI::TMS {
|
|
|
|
// Temporary buffers collect a representation of each line prior to pixel serialisation.
|
|
|
|
struct SpriteBuffer {
|
|
// An active sprite is one that has been selected for composition onto
|
|
// _this_ line.
|
|
struct ActiveSprite {
|
|
int index = 0; // The original in-table index of this sprite.
|
|
int row = 0; // The row of the sprite that should be drawn.
|
|
int x = 0; // The sprite's x position on screen.
|
|
|
|
uint8_t image[4]; // Up to four bytes of image information.
|
|
//
|
|
// In practice:
|
|
//
|
|
// Master System mode: the four bytes of this 8x8 sprite;
|
|
// TMS and Yamaha: [0] = the left half of this sprite; [1] = the right side (if 16x16 sprites enabled); [2] = colour, early-clock bit, etc.
|
|
int shift_position = 0; // An offset representing how much of the image information has already been drawn.
|
|
|
|
// Yamaha helpers.
|
|
bool opaque() const {
|
|
return !(image[2] & 0x40);
|
|
}
|
|
|
|
/// @returns @c 0x20 if this sprite should generate collisions; @c 0x00 otherwise.
|
|
int collision_bit() const {
|
|
return ((image[2] & 0x20) | ((image[2] & 0x40) >> 1)) ^ 0x20;
|
|
}
|
|
|
|
// Yamaha and TMS helpers.
|
|
int early_clock() const {
|
|
return (image[2] & 0x80) >> 2;
|
|
}
|
|
} active_sprites[8];
|
|
|
|
int active_sprite_slot = 0; // A pointer to the slot into which a new active sprite will be deposited, if required.
|
|
bool sprites_stopped = false; // A special TMS feature is that a sentinel value can be used to prevent any further sprites
|
|
// being evaluated for display. This flag determines whether the sentinel has yet been reached.
|
|
uint8_t sprite_terminator = 0;
|
|
|
|
#ifndef NDEBUG
|
|
static constexpr bool test_is_filling = true;
|
|
#else
|
|
static constexpr bool test_is_filling = false;
|
|
#endif
|
|
bool is_filling = false;
|
|
|
|
void reset_sprite_collection();
|
|
};
|
|
|
|
struct LineBuffer {
|
|
LineBuffer() {}
|
|
|
|
// The fetch mode describes the proper timing diagram for this line;
|
|
// screen mode captures proper output mode.
|
|
FetchMode fetch_mode = FetchMode::Text;
|
|
ScreenMode screen_mode = ScreenMode::Text;
|
|
VerticalState vertical_state = VerticalState::Blank;
|
|
SpriteBuffer *sprites = nullptr;
|
|
|
|
// Holds the horizontal scroll position to apply to this line;
|
|
// of those VDPs currently implemented, affects the Master System only.
|
|
uint8_t latched_horizontal_scroll = 0;
|
|
|
|
// The names array holds pattern names, as an offset into memory, and
|
|
// potentially flags also.
|
|
union {
|
|
// This struct captures maximal potential detail across the TMS9918
|
|
// and Sega VDP for tiled modes (plus multicolour).
|
|
struct {
|
|
uint8_t flags[32]{};
|
|
|
|
// The patterns array holds tile patterns, corresponding 1:1 with names.
|
|
// Four bytes per pattern is the maximum required by any
|
|
// currently-implemented VDP.
|
|
uint8_t patterns[32][4]{};
|
|
} tiles;
|
|
|
|
// The Yamaha and TMS both have text modes, with the former going up to
|
|
// 80 columns plus 10 bytes of colour-esque flags.
|
|
struct {
|
|
uint8_t shapes[80];
|
|
uint8_t flags[10];
|
|
} characters;
|
|
|
|
// The Yamaha VDP also has a variety of bitmap modes,
|
|
// the widest of which is 512px @ 4bpp.
|
|
uint8_t bitmap[256];
|
|
};
|
|
|
|
/*
|
|
Horizontal layout (on a 342-cycle clock):
|
|
|
|
15 cycles right border
|
|
58 cycles blanking & sync
|
|
13 cycles left border
|
|
|
|
... i.e. to cycle 86, then:
|
|
|
|
border up to first_pixel_output_column;
|
|
pixels up to next_border_column;
|
|
border up to the end.
|
|
|
|
e.g. standard 256-pixel modes will want to set
|
|
first_pixel_output_column = 86, next_border_column = 342.
|
|
*/
|
|
int first_pixel_output_column = 94;
|
|
int next_border_column = 334;
|
|
int pixel_count = 256;
|
|
};
|
|
|
|
struct LineBufferPointer {
|
|
int row = 0, column = 0;
|
|
};
|
|
|
|
}
|