1/* Copyright (c) 2013-2014 Jeffrey Pfau
  2 *
  3 * This Source Code Form is subject to the terms of the Mozilla Public
  4 * License, v. 2.0. If a copy of the MPL was not distributed with this
  5 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
  6#ifndef GBA_THREAD_H
  7#define GBA_THREAD_H
  8
  9#include "util/common.h"
 10
 11#include "gba.h"
 12#include "gba-input.h"
 13
 14#include "util/threading.h"
 15
 16struct GBAThread;
 17struct GBAArguments;
 18struct GBAOptions;
 19typedef void (*ThreadCallback)(struct GBAThread* threadContext);
 20typedef void (*LogHandler)(struct GBAThread*, enum GBALogLevel, const char* format, va_list args);
 21
 22enum ThreadState {
 23	THREAD_INITIALIZED = -1,
 24	THREAD_RUNNING = 0,
 25	THREAD_INTERRUPTED,
 26	THREAD_INTERRUPTING,
 27	THREAD_PAUSED,
 28	THREAD_PAUSING,
 29	THREAD_RESETING,
 30	THREAD_EXITING,
 31	THREAD_SHUTDOWN,
 32	THREAD_CRASHED
 33};
 34
 35struct GBASync {
 36	int videoFramePending;
 37	bool videoFrameWait;
 38	int videoFrameSkip;
 39	bool videoFrameOn;
 40	Mutex videoFrameMutex;
 41	Condition videoFrameAvailableCond;
 42	Condition videoFrameRequiredCond;
 43
 44	bool audioWait;
 45	Condition audioRequiredCond;
 46	Mutex audioBufferMutex;
 47};
 48
 49struct GBAAVStream {
 50	void (*postVideoFrame)(struct GBAAVStream*, struct GBAVideoRenderer* renderer);
 51	void (*postAudioFrame)(struct GBAAVStream*, int32_t left, int32_t right);
 52};
 53
 54struct GBAThread {
 55	// Output
 56	enum ThreadState state;
 57	struct GBA* gba;
 58	struct ARMCore* cpu;
 59
 60	// Input
 61	struct GBAVideoRenderer* renderer;
 62	struct GBASIODriverSet sioDrivers;
 63	struct ARMDebugger* debugger;
 64	struct VDir* gameDir;
 65	struct VDir* stateDir;
 66	struct VFile* rom;
 67	struct VFile* save;
 68	struct VFile* bios;
 69	struct VFile* patch;
 70	const char* fname;
 71	int activeKeys;
 72	struct GBAAVStream* stream;
 73
 74	// Run-time options
 75	int frameskip;
 76	float fpsTarget;
 77	size_t audioBuffers;
 78
 79	// Threading state
 80	Thread thread;
 81
 82	Mutex stateMutex;
 83	Condition stateCond;
 84	enum ThreadState savedState;
 85	int interruptDepth;
 86
 87	LogHandler logHandler;
 88	int logLevel;
 89	ThreadCallback startCallback;
 90	ThreadCallback cleanCallback;
 91	ThreadCallback frameCallback;
 92	void* userData;
 93
 94	struct GBASync sync;
 95
 96	int rewindBufferSize;
 97	int rewindBufferCapacity;
 98	int rewindBufferInterval;
 99	int rewindBufferNext;
100	struct GBASerializedState** rewindBuffer;
101	int rewindBufferWriteOffset;
102
103	bool skipBios;
104};
105
106void GBAMapOptionsToContext(const struct GBAOptions*, struct GBAThread*);
107void GBAMapArgumentsToContext(const struct GBAArguments*, struct GBAThread*);
108
109bool GBAThreadStart(struct GBAThread* threadContext);
110bool GBAThreadHasStarted(struct GBAThread* threadContext);
111bool GBAThreadHasExited(struct GBAThread* threadContext);
112bool GBAThreadHasCrashed(struct GBAThread* threadContext);
113void GBAThreadEnd(struct GBAThread* threadContext);
114void GBAThreadReset(struct GBAThread* threadContext);
115void GBAThreadJoin(struct GBAThread* threadContext);
116
117bool GBAThreadIsActive(struct GBAThread* threadContext);
118void GBAThreadInterrupt(struct GBAThread* threadContext);
119void GBAThreadContinue(struct GBAThread* threadContext);
120
121void GBAThreadPause(struct GBAThread* threadContext);
122void GBAThreadUnpause(struct GBAThread* threadContext);
123bool GBAThreadIsPaused(struct GBAThread* threadContext);
124void GBAThreadTogglePause(struct GBAThread* threadContext);
125void GBAThreadPauseFromThread(struct GBAThread* threadContext);
126struct GBAThread* GBAThreadGetContext(void);
127
128#ifdef USE_PNG
129void GBAThreadTakeScreenshot(struct GBAThread* threadContext);
130#endif
131
132void GBASyncPostFrame(struct GBASync* sync);
133bool GBASyncWaitFrameStart(struct GBASync* sync, int frameskip);
134void GBASyncWaitFrameEnd(struct GBASync* sync);
135bool GBASyncDrawingFrame(struct GBASync* sync);
136
137void GBASyncSuspendDrawing(struct GBASync* sync);
138void GBASyncResumeDrawing(struct GBASync* sync);
139
140void GBASyncProduceAudio(struct GBASync* sync, bool wait);
141void GBASyncLockAudio(struct GBASync* sync);
142void GBASyncUnlockAudio(struct GBASync* sync);
143void GBASyncConsumeAudio(struct GBASync* sync);
144
145#endif