2016-01-05 04:40:43 +00:00
|
|
|
//
|
|
|
|
// MachineDocument.swift
|
|
|
|
// Clock Signal
|
|
|
|
//
|
|
|
|
// Created by Thomas Harte on 04/01/2016.
|
|
|
|
// Copyright © 2016 Thomas Harte. All rights reserved.
|
|
|
|
//
|
|
|
|
|
|
|
|
import Cocoa
|
2016-01-15 01:33:22 +00:00
|
|
|
import AudioToolbox
|
2016-01-05 04:40:43 +00:00
|
|
|
|
2016-06-17 00:51:35 +00:00
|
|
|
class MachineDocument:
|
|
|
|
NSDocument,
|
|
|
|
NSWindowDelegate,
|
2016-06-21 01:47:27 +00:00
|
|
|
CSMachineDelegate,
|
2016-06-17 00:51:35 +00:00
|
|
|
CSOpenGLViewDelegate,
|
|
|
|
CSOpenGLViewResponderDelegate,
|
|
|
|
CSBestEffortUpdaterDelegate,
|
|
|
|
CSAudioQueueDelegate
|
|
|
|
{
|
2018-02-19 03:09:03 +00:00
|
|
|
fileprivate let actionLock = NSLock()
|
|
|
|
fileprivate let drawLock = NSLock()
|
|
|
|
fileprivate let bestEffortLock = NSLock()
|
|
|
|
|
2016-10-02 20:57:57 +00:00
|
|
|
var machine: CSMachine!
|
2016-06-28 01:38:14 +00:00
|
|
|
var name: String! {
|
|
|
|
get {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
}
|
2016-06-01 02:32:38 +00:00
|
|
|
|
2016-06-01 23:04:07 +00:00
|
|
|
func aspectRatio() -> NSSize {
|
|
|
|
return NSSize(width: 4.0, height: 3.0)
|
|
|
|
}
|
|
|
|
|
2017-02-11 17:58:47 +00:00
|
|
|
@IBOutlet weak var openGLView: CSOpenGLView!
|
2016-10-02 20:31:50 +00:00
|
|
|
@IBOutlet var optionsPanel: MachinePanel!
|
2016-09-16 02:12:12 +00:00
|
|
|
@IBAction func showOptions(_ sender: AnyObject!) {
|
2016-04-18 01:43:39 +00:00
|
|
|
optionsPanel?.setIsVisible(true)
|
|
|
|
}
|
|
|
|
|
2016-09-16 02:12:12 +00:00
|
|
|
fileprivate var audioQueue: CSAudioQueue! = nil
|
2017-10-01 01:34:43 +00:00
|
|
|
fileprivate var bestEffortUpdater: CSBestEffortUpdater?
|
2016-01-15 01:33:22 +00:00
|
|
|
|
2017-09-20 03:06:37 +00:00
|
|
|
override var windowNibName: NSNib.Name? {
|
|
|
|
return NSNib.Name(rawValue: "MachineDocument")
|
2016-10-02 20:57:57 +00:00
|
|
|
}
|
|
|
|
|
2016-09-16 02:12:12 +00:00
|
|
|
override func windowControllerDidLoadNib(_ aController: NSWindowController) {
|
2016-01-05 04:40:43 +00:00
|
|
|
super.windowControllerDidLoadNib(aController)
|
|
|
|
|
2016-06-01 23:04:07 +00:00
|
|
|
// establish the output aspect ratio and audio
|
|
|
|
let displayAspectRatio = self.aspectRatio()
|
|
|
|
aController.window?.contentAspectRatio = displayAspectRatio
|
2016-09-16 02:12:12 +00:00
|
|
|
openGLView.perform(glContext: {
|
2016-06-24 01:09:34 +00:00
|
|
|
self.machine.setView(self.openGLView, aspectRatio: Float(displayAspectRatio.width / displayAspectRatio.height))
|
2016-06-01 23:04:07 +00:00
|
|
|
})
|
2016-06-01 02:36:53 +00:00
|
|
|
|
2016-06-24 01:09:34 +00:00
|
|
|
self.machine.delegate = self
|
2017-02-11 17:58:47 +00:00
|
|
|
self.bestEffortUpdater = CSBestEffortUpdater()
|
|
|
|
|
|
|
|
// callbacks from the OpenGL may come on a different thread, immediately following the .delegate set;
|
|
|
|
// hence the full setup of the best-effort updater prior to setting self as a delegate
|
|
|
|
self.openGLView.delegate = self
|
|
|
|
self.openGLView.responderDelegate = self
|
|
|
|
|
|
|
|
setupClockRate()
|
2016-10-03 02:04:47 +00:00
|
|
|
self.optionsPanel?.establishStoredOptions()
|
2016-10-25 02:08:24 +00:00
|
|
|
|
|
|
|
// bring OpenGL view-holding window on top of the options panel
|
|
|
|
self.openGLView.window!.makeKeyAndOrderFront(self)
|
2017-02-27 02:58:43 +00:00
|
|
|
|
|
|
|
// start accepting best effort updates
|
2017-10-01 01:34:43 +00:00
|
|
|
self.bestEffortUpdater!.delegate = self
|
2016-06-21 01:47:27 +00:00
|
|
|
}
|
|
|
|
|
2016-09-16 02:12:12 +00:00
|
|
|
func machineDidChangeClockRate(_ machine: CSMachine!) {
|
2016-06-21 01:47:27 +00:00
|
|
|
setupClockRate()
|
|
|
|
}
|
|
|
|
|
2016-09-16 02:12:12 +00:00
|
|
|
func machineDidChangeClockIsUnlimited(_ machine: CSMachine!) {
|
2018-02-19 03:09:03 +00:00
|
|
|
bestEffortLock.lock()
|
2017-10-01 01:34:43 +00:00
|
|
|
self.bestEffortUpdater?.runAsUnlimited = machine.clockIsUnlimited
|
2018-02-19 03:09:03 +00:00
|
|
|
bestEffortLock.unlock()
|
2016-09-13 02:06:03 +00:00
|
|
|
}
|
|
|
|
|
2016-09-16 02:12:12 +00:00
|
|
|
fileprivate func setupClockRate() {
|
2016-06-01 23:04:07 +00:00
|
|
|
// establish and provide the audio queue, taking advice as to an appropriate sampling rate
|
2016-06-15 12:07:25 +00:00
|
|
|
let maximumSamplingRate = CSAudioQueue.preferredSamplingRate()
|
2016-09-16 02:12:12 +00:00
|
|
|
let selectedSamplingRate = self.machine.idealSamplingRate(from: NSRange(location: 0, length: NSInteger(maximumSamplingRate)))
|
2016-06-05 15:20:05 +00:00
|
|
|
if selectedSamplingRate > 0 {
|
2016-06-15 12:07:25 +00:00
|
|
|
audioQueue = CSAudioQueue(samplingRate: Float64(selectedSamplingRate))
|
2016-06-17 00:51:35 +00:00
|
|
|
audioQueue.delegate = self
|
2016-06-24 01:09:34 +00:00
|
|
|
self.machine.audioQueue = self.audioQueue
|
2016-10-10 11:45:09 +00:00
|
|
|
self.machine.setAudioSamplingRate(selectedSamplingRate, bufferSize:audioQueue.preferredBufferSize)
|
2016-06-05 15:20:05 +00:00
|
|
|
}
|
2016-06-17 00:39:46 +00:00
|
|
|
|
2018-02-19 03:09:03 +00:00
|
|
|
bestEffortLock.lock()
|
2017-10-01 01:34:43 +00:00
|
|
|
self.bestEffortUpdater?.clockRate = self.machine.clockRate
|
2018-02-19 03:09:03 +00:00
|
|
|
bestEffortLock.unlock()
|
2016-01-05 04:40:43 +00:00
|
|
|
}
|
|
|
|
|
2016-06-01 02:32:38 +00:00
|
|
|
override func close() {
|
2017-10-01 00:07:04 +00:00
|
|
|
optionsPanel?.setIsVisible(false)
|
|
|
|
optionsPanel = nil
|
|
|
|
|
2018-02-19 03:09:03 +00:00
|
|
|
bestEffortLock.lock()
|
2017-10-01 01:34:43 +00:00
|
|
|
bestEffortUpdater!.delegate = nil
|
2018-03-01 03:15:22 +00:00
|
|
|
bestEffortUpdater!.flush()
|
2017-10-01 00:07:04 +00:00
|
|
|
bestEffortUpdater = nil
|
2018-02-19 03:09:03 +00:00
|
|
|
bestEffortLock.unlock()
|
2017-10-01 00:07:04 +00:00
|
|
|
|
2016-06-01 02:32:38 +00:00
|
|
|
actionLock.lock()
|
|
|
|
drawLock.lock()
|
2017-10-01 00:07:04 +00:00
|
|
|
machine = nil
|
2018-02-19 03:09:03 +00:00
|
|
|
openGLView.delegate = nil
|
2016-06-01 02:32:38 +00:00
|
|
|
openGLView.invalidate()
|
|
|
|
actionLock.unlock()
|
|
|
|
drawLock.unlock()
|
|
|
|
|
|
|
|
super.close()
|
|
|
|
}
|
|
|
|
|
2016-09-01 02:03:42 +00:00
|
|
|
// MARK: configuring
|
2016-09-16 02:12:12 +00:00
|
|
|
func configureAs(_ analysis: CSStaticAnalyser) {
|
2018-01-25 01:14:15 +00:00
|
|
|
if let machine = CSMachine(analyser: analysis) {
|
2016-10-02 20:57:57 +00:00
|
|
|
self.machine = machine
|
|
|
|
}
|
2016-10-02 20:31:50 +00:00
|
|
|
|
2018-02-13 02:46:21 +00:00
|
|
|
if let optionsPanelNibName = analysis.optionsPanelNibName {
|
|
|
|
Bundle.main.loadNibNamed(NSNib.Name(rawValue: optionsPanelNibName), owner: self, topLevelObjects: nil)
|
|
|
|
self.optionsPanel.machine = self.machine
|
|
|
|
showOptions(self)
|
|
|
|
}
|
2016-09-01 02:03:42 +00:00
|
|
|
}
|
|
|
|
|
2016-10-02 21:04:14 +00:00
|
|
|
override func read(from url: URL, ofType typeName: String) throws {
|
|
|
|
if let analyser = CSStaticAnalyser(fileAt: url) {
|
|
|
|
self.displayName = analyser.displayName
|
|
|
|
self.configureAs(analyser)
|
2016-10-12 01:03:01 +00:00
|
|
|
} else {
|
|
|
|
throw NSError(domain: "MachineDocument", code: -1, userInfo: nil)
|
2016-10-02 21:04:14 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-06-19 20:35:04 +00:00
|
|
|
// MARK: the pasteboard
|
2016-09-16 02:12:12 +00:00
|
|
|
func paste(_ sender: AnyObject!) {
|
2017-09-20 03:06:37 +00:00
|
|
|
let pasteboard = NSPasteboard.general
|
|
|
|
if let string = pasteboard.string(forType: .string) {
|
2016-06-24 01:09:34 +00:00
|
|
|
self.machine.paste(string)
|
2016-06-19 20:35:04 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-06-17 00:51:35 +00:00
|
|
|
// MARK: CSBestEffortUpdaterDelegate
|
2016-09-16 02:12:12 +00:00
|
|
|
final func bestEffortUpdater(_ bestEffortUpdater: CSBestEffortUpdater!, runForCycles cycles: UInt, didSkipPreviousUpdate: Bool) {
|
2016-06-16 22:19:23 +00:00
|
|
|
runForNumberOfCycles(Int32(cycles))
|
2016-01-05 04:40:43 +00:00
|
|
|
}
|
|
|
|
|
2016-09-16 02:12:12 +00:00
|
|
|
func runForNumberOfCycles(_ numberOfCycles: Int32) {
|
2018-02-19 03:09:03 +00:00
|
|
|
bestEffortLock.lock()
|
2017-10-01 01:34:43 +00:00
|
|
|
if let bestEffortUpdater = bestEffortUpdater {
|
2018-02-19 23:44:12 +00:00
|
|
|
bestEffortLock.unlock()
|
2017-10-01 01:34:43 +00:00
|
|
|
let cyclesToRunFor = min(numberOfCycles, Int32(bestEffortUpdater.clockRate / 10))
|
|
|
|
if actionLock.try() {
|
|
|
|
self.machine.runForNumber(ofCycles: cyclesToRunFor)
|
|
|
|
actionLock.unlock()
|
|
|
|
}
|
2018-02-19 23:44:12 +00:00
|
|
|
} else {
|
|
|
|
bestEffortLock.unlock()
|
2016-06-17 00:51:35 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// MARK: CSAudioQueueDelegate
|
2016-10-17 12:18:32 +00:00
|
|
|
final func audioQueueIsRunningDry(_ audioQueue: CSAudioQueue) {
|
2018-02-19 03:09:03 +00:00
|
|
|
bestEffortLock.lock()
|
2017-10-01 01:34:43 +00:00
|
|
|
bestEffortUpdater?.update()
|
2018-02-19 03:09:03 +00:00
|
|
|
bestEffortLock.unlock()
|
2016-06-01 02:32:38 +00:00
|
|
|
}
|
|
|
|
|
2016-06-17 00:51:35 +00:00
|
|
|
// MARK: CSOpenGLViewDelegate
|
2016-09-16 02:12:12 +00:00
|
|
|
final func openGLView(_ view: CSOpenGLView, drawViewOnlyIfDirty onlyIfDirty: Bool) {
|
2018-02-19 03:09:03 +00:00
|
|
|
bestEffortLock.lock()
|
2017-10-01 01:34:43 +00:00
|
|
|
if let bestEffortUpdater = bestEffortUpdater {
|
2018-02-19 23:44:12 +00:00
|
|
|
bestEffortLock.unlock()
|
2017-10-01 01:34:43 +00:00
|
|
|
bestEffortUpdater.update()
|
|
|
|
if drawLock.try() {
|
|
|
|
self.machine.drawView(forPixelSize: view.backingSize, onlyIfDirty: onlyIfDirty)
|
|
|
|
drawLock.unlock()
|
|
|
|
}
|
2018-02-19 23:44:12 +00:00
|
|
|
} else {
|
|
|
|
bestEffortLock.unlock()
|
2016-06-01 02:32:38 +00:00
|
|
|
}
|
|
|
|
}
|
2016-01-05 04:40:43 +00:00
|
|
|
|
2017-08-17 14:48:29 +00:00
|
|
|
final func openGLView(_ view: CSOpenGLView, didReceiveFileAt URL: URL) {
|
2017-08-17 15:00:08 +00:00
|
|
|
let mediaSet = CSMediaSet(fileAt: URL)
|
|
|
|
if let mediaSet = mediaSet {
|
|
|
|
mediaSet.apply(to: self.machine)
|
|
|
|
}
|
2017-08-17 14:48:29 +00:00
|
|
|
}
|
|
|
|
|
2016-06-05 01:43:50 +00:00
|
|
|
// MARK: NSDocument overrides
|
2016-09-16 02:12:12 +00:00
|
|
|
override func data(ofType typeName: String) throws -> Data {
|
2016-06-05 01:43:50 +00:00
|
|
|
throw NSError(domain: NSOSStatusErrorDomain, code: unimpErr, userInfo: nil)
|
|
|
|
}
|
2016-06-05 12:53:05 +00:00
|
|
|
|
2016-10-03 12:01:04 +00:00
|
|
|
// MARK: Input management
|
2016-09-16 02:12:12 +00:00
|
|
|
func windowDidResignKey(_ notification: Notification) {
|
2017-10-16 01:25:56 +00:00
|
|
|
self.machine.clearAllKeys()
|
2016-06-05 12:53:05 +00:00
|
|
|
}
|
|
|
|
|
2016-09-16 02:12:12 +00:00
|
|
|
func keyDown(_ event: NSEvent) {
|
2018-02-26 03:47:47 +00:00
|
|
|
self.machine.setKey(event.keyCode, characters: event.characters, isPressed: true)
|
2016-06-05 12:53:05 +00:00
|
|
|
}
|
|
|
|
|
2016-09-16 02:12:12 +00:00
|
|
|
func keyUp(_ event: NSEvent) {
|
2018-02-26 03:47:47 +00:00
|
|
|
self.machine.setKey(event.keyCode, characters: event.characters, isPressed: false)
|
2016-06-05 12:53:05 +00:00
|
|
|
}
|
|
|
|
|
2016-09-16 02:12:12 +00:00
|
|
|
func flagsChanged(_ newModifiers: NSEvent) {
|
2018-02-26 03:47:47 +00:00
|
|
|
self.machine.setKey(VK_Shift, characters: nil, isPressed: newModifiers.modifierFlags.contains(.shift))
|
|
|
|
self.machine.setKey(VK_Control, characters: nil, isPressed: newModifiers.modifierFlags.contains(.control))
|
|
|
|
self.machine.setKey(VK_Command, characters: nil, isPressed: newModifiers.modifierFlags.contains(.command))
|
|
|
|
self.machine.setKey(VK_Option, characters: nil, isPressed: newModifiers.modifierFlags.contains(.option))
|
2016-06-05 12:53:05 +00:00
|
|
|
}
|
2016-01-05 04:40:43 +00:00
|
|
|
}
|