1 files changed, 71 insertions, 0 deletions
diff --git a/Src/replicant/player/ifc_playback.h b/Src/replicant/player/ifc_playback.h
new file mode 100644
index 00000000..e208dd5a
--- /dev/null
+++ b/Src/replicant/player/ifc_playback.h
@@ -0,0 +1,71 @@
+#pragma once
+#include "foundation/dispatch.h"
+#include "foundation/error.h"
+#include "types.h"
+#include "svc_output.h"
+#include "ifc_playback_parameters.h"
+
+/* Note that since a typical ifc_playback implementation
+is running on another thread, most functions will always succeed (except for out of memory or thread creation problems)
+but might report an error later to the ifc_player object that was passed
+when creating the playback object */
+
+class NOVTABLE ifc_playback : public Wasabi2::Dispatchable
+{
+protected:
+	ifc_playback() : Dispatchable(NUM_DISPATCH_CODES) {}
+	~ifc_playback() {}
+public:
+	/* optionally call Cue before calling Play to set the start and end positions 
+		in a cuesheet situation, these will might also get called after
+		you indicate that cue end position has been reached */
+	int Cue(Agave_PositionType position_type, Agave_Position start, Agave_Position end) { return Playback_Cue(position_type, start, end); }
+	// start only version of Cue
+	int CueStart(Agave_PositionType position_type, Agave_Position start) { return Playback_CueStart(position_type, start); }
+
+	// begins playback.
+	int Play(svc_output *output, ifc_playback_parameters *secondary_parameters) { return Playback_Play(output, secondary_parameters); }
+
+	int SeekSeconds(double seconds) { return Playback_SeekSeconds(seconds); }
+
+	// called on user-initiated stop.  not called if the playback object indiciated a stop (e.g. EOF)
+	int Stop() { return Playback_Stop(); }
+
+	int Pause() { return Playback_Pause(); }
+	int Unpause() { return Playback_Unpause(); }
+
+	/* called to shut things down.  
+	note that if your playback object is in a 'stopped' state, 
+	it should be prepared to receive Cue/Play call until Close() is called */
+	int Close() { return Playback_Close(); }
+
+	/* most of the time, you'll pass SetVolume and SetPan on to the output object
+	but some special-use playback objects (e.g. analog CD playback) might have to implement this */
+	// 0 to 1.0
+	int SetVolume(float volume) { return Playback_SetVolume(volume); }
+	// -1.0 to 1.0
+	int SetPan(float pan) { return Playback_SetPan(pan); }
+	
+	/* most of the time, you'll ignore SetEQ
+	but some special-use playback objects (e.g. analog CD playback) might have to implement this */
+	int SetEQ(float preamp, int num_bands, float *bands) { return Playback_SetEQ(preamp, num_bands, bands); }
+
+	enum
+	{
+		NUM_DISPATCH_CODES,
+	};
+
+protected:
+	virtual int WASABICALL Playback_Cue(Agave_PositionType position_type, Agave_Position start, Agave_Position end) { return NErr_NotImplemented; }
+	virtual int WASABICALL Playback_CueStart(Agave_PositionType position_type, Agave_Position start) { return NErr_NotImplemented; }
+	virtual int WASABICALL Playback_Play(svc_output *output, ifc_playback_parameters *secondary_parameters)=0;
+	virtual int WASABICALL Playback_SeekSeconds(double seconds)=0;
+	virtual int WASABICALL Playback_Stop()=0;
+	virtual int WASABICALL Playback_Pause()=0;
+	virtual int WASABICALL Playback_Unpause()=0;
+	virtual int WASABICALL Playback_Close()=0;
+	virtual int WASABICALL Playback_SetVolume(float volume) { return NErr_NotImplemented; }
+	virtual int WASABICALL Playback_SetPan(float pan) { return NErr_NotImplemented; }
+	virtual int WASABICALL Playback_SetEQ(float preamp, int num_bands, float *bands) { return NErr_NotImplemented; }
+};
+