1
0
mirror of https://github.com/livingcomputermuseum/Darkstar.git synced 2026-02-26 09:03:42 +00:00
Files
livingcomputermuseum.Darkstar/D/Display/DisplayController.cs
2019-01-15 12:55:18 -08:00

296 lines
10 KiB
C#

/*
BSD 2-Clause License
Copyright Vulcan Inc. 2017-2018 and Living Computer Museum + Labs 2018
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED.IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
using D.CP;
using D.Logging;
using System.Collections.Generic;
namespace D.Display
{
public class DisplayController
{
public DisplayController(DSystem system)
{
_system = system;
_lostSyncEvent = new Event(_lostSyncInterval, null, LostSyncCallback);
_fifo = new Queue<ushort>(16);
}
public void Reset()
{
_displayOn = false;
_blank = false;
_picture = false;
_invert = false;
_oddLine = false;
_scanline = 0;
_fifo.Clear();
if (_system.Display != null)
{
_system.Display.Clear();
}
}
public bool DisplayOn
{
get { return _displayOn; }
}
public void ClrDpRq()
{
//
// Put the display task to sleep
//
_system.CP.SleepTask(TaskType.Display);
}
public void SetDCtlFifo(ushort value)
{
// if (Log.Enabled) Log.Write(LogType.Verbose, LogComponent.DisplayControl, "DCtlFIFO<-0x{0:x4}", value);
if (_fifo.Count < 16)
{
_fifo.Enqueue(value);
}
else
{
if (Log.Enabled) Log.Write(LogType.Error, LogComponent.DisplayControl, "DCtlFIFO: FIFO overflow, word dropped.");
}
}
public void SetDCtl(ushort value)
{
bool displayOn = _displayOn;
_displayOn = (value & 0x01) != 0;
_blank = (value & 0x02) != 0;
_picture = (value & 0x04) != 0;
_invert = (value & 0x08) != 0;
if ((value & 0x20) != 0)
{
// Vertical Sync -- back to the top of the screen
_scanline = 0;
_oddLine = (value & 0x10) != 0;
_syncPresent = true;
_system.Display.Render();
}
if ((value & 0x40) == 0)
{
// Clear control fifo
_fifo.Clear();
}
if (!displayOn && _displayOn)
{
// Kick off the horizontal retrace callback since we're turning the display on.
_system.Scheduler.Schedule(_horizontalRetraceDelay, HorizontalRetraceCallback);
_system.Scheduler.Cancel(_lostSyncEvent);
_lostSyncEvent = _system.Scheduler.Schedule(_lostSyncInterval, LostSyncCallback);
}
else if (!_displayOn)
{
//
// Put the display task to sleep.
//
_system.CP.SleepTask(TaskType.Display);
}
if (Log.Enabled) Log.Write(LogType.Verbose, LogComponent.DisplayControl, "DCtl<-0x{0:x4}: On={1} Blank={2} Picture={3} Invert={4} Odd={5}"
, value,
_displayOn,
_blank,
_picture,
_invert,
_oddLine);
}
public void SetDBorder(ushort value)
{
_displayBorder = value;
if (Log.Enabled) Log.Write(LogType.Verbose, LogComponent.DisplayControl, "DBorder<-0x{0:x4}", value);
}
/// <summary>
/// Invoked at the end of every scanline: Wake display task, update state, schedule next callback
/// as necessary.
/// </summary>
/// <param name="skewNsec"></param>
/// <param name="context"></param>
private void HorizontalRetraceCallback(ulong skewNsec, object context)
{
int visibleOffset = _oddLine ? 37 : 36;
int effectiveScanline = _scanline - visibleOffset;
//
// Render this scanline, if there's anything to do.
//
if (_blank)
{
// Render blank scanline (no border, no picture)
for (int i = 0; i < _scanlineData.Length; i++)
{
_scanlineData[i] = 0;
}
}
else
{
if (_picture)
{
// Normal line : 32 bits of border pattern, 1024 bits of display, 32 bits of border pattern
// Border pattern: low byte on lines 4n, 4n+1; high byte on 4n+2, 4n+3.
int patternByte = (effectiveScanline & 0x2) == 0 ? _displayBorder & 0xff : _displayBorder >> 8;
ushort patternWord = (ushort)(patternByte | (patternByte << 8));
_scanlineData[0] = patternWord;
_scanlineData[1] = patternWord;
if (_fifo.Count > 0)
{
// Grab first segment from FIFO
ushort fifoWord = _fifo.Dequeue();
int lastWord = fifoWord >> 10;
int lineNumber = fifoWord & 0x3ff;
bool valid = false;
for (int word = 0; word < 64; word++)
{
_scanlineData[word + 2] = _system.MemoryController.DebugMemory.ReadWord((lineNumber << 6) | word, out valid);
// Grab next segment if this isn't the last word in the scanline.
if (word != 63 && word == lastWord && _fifo.Count > 0)
{
fifoWord = _fifo.Dequeue();
lastWord = fifoWord >> 10;
lineNumber = fifoWord & 0x3ff;
}
}
}
else
{
// Blank out display words, nothing in the FIFO.
for (int i = 2; i < 64; i++)
{
_scanlineData[i] = 0;
}
}
_scanlineData[66] = patternWord;
_scanlineData[67] = patternWord;
}
else
{
// Just display the border pattern everywhere:
// low byte on lines 4n, 4n+1; high byte on 4n+2, 4n+3.
int patternByte = (effectiveScanline & 0x2) == 0 ? _displayBorder & 0xff : _displayBorder >> 8;
ushort patternWord = (ushort)(patternByte | (patternByte << 8));
for (int i = 0; i < _scanlineData.Length; i++)
{
_scanlineData[i] = patternWord;
}
}
}
if (effectiveScanline > 0 && effectiveScanline < 860)
{
// Render to screen
_system.Display.DrawScanline(effectiveScanline, _scanlineData, _invert);
}
// Move to next scanline
_scanline += 2;
//
// Schedule next retrace as long as the display is still on.
//
if (_displayOn)
{
_system.Scheduler.Schedule(_horizontalRetraceDelay, HorizontalRetraceCallback);
//
// End of scanline: Wake up the display task.
//
_system.CP.WakeTask(TaskType.Display);
}
}
private void LostSyncCallback(ulong skewNsec, object context)
{
if (_syncPresent)
{
//
// Got sync, keep the display alive and reschedule ourselves.
_lostSyncEvent = _system.Scheduler.Schedule(_lostSyncInterval, LostSyncCallback);
}
else
{
// No sync since the last callback, blank the display and stop the sync callback.
_system.Display.Clear();
}
_syncPresent = false;
}
// Control bits
private bool _displayOn;
private bool _blank;
private bool _picture;
private bool _invert;
private bool _oddLine;
// Border bitmap
private ushort _displayBorder;
// Control FIFO. Max 16 entries.
private Queue<ushort> _fifo;
// Scanline
private int _scanline;
private ushort[] _scanlineData = new ushort[64 + 4]; // 1024 bits picture, 32 bits border on either side
private bool _syncPresent;
private DSystem _system;
//
// Timing and events
//
private readonly ulong _horizontalRetraceDelay = (ulong)(28.8 * Conversion.UsecToNsec); // 28.8uS
private Event _lostSyncEvent;
private readonly ulong _lostSyncInterval = (ulong)(52.91 * Conversion.MsecToNsec); // 53ms (one frame time)
}
}