Initial community commit

Src/replicant/decode/api_decode.h

@@ -0,0 +1,35 @@
+#pragma once
+#include "foundation/dispatch.h"
+#include "audio/ifc_audio_decoder_callback.h"
+#include "audio/parameters.h"
+#include "service/types.h"
+#include "nx/nxuri.h"
+
+// {AA4404BC-69E7-4898-9296-420F774C3331}
+static const GUID decode_api_service_guid = 
+{ 0xaa4404bc, 0x69e7, 0x4898, { 0x92, 0x96, 0x42, 0xf, 0x77, 0x4c, 0x33, 0x31 } };
+
+/* benski> some of this is TODO as of 25-Jan-2012
+We want to have several ways to create a decoder
+1) Simple method.  Create a decoder of the desired style (callback, pull, packet).  api_decode will convert between styles if necessary
+2) Constraint method: Non-zero values for nsaudio::Parameters members are treated as requirements and api_decode will convert.  Flags might indicate that sample rate or channels is a "maximum" rather than a strict requirement
+3) Multiple nsaudio::Parameters values.  Used if you are a little more flexible in the data format, e.g. if you can handle 16bit audio or floating point
+*/
+class api_decode : public Wasabi2::Dispatchable
+{
+protected:
+	api_decode() : Wasabi2::Dispatchable(DISPATCHABLE_VERSION) {}
+	~api_decode() {}
+public:
+	static GUID GetServiceType() { return SVC_TYPE_UNIQUE; }
+	static GUID GetServiceGUID() { return decode_api_service_guid; }
+
+	int CreateAudioDecoder_Callback(ifc_audio_decoder_callback **decoder, nx_uri_t filename, nsaudio::Parameters *parameters, int flags) { return DecodeAPI_CreateAudioDecoder_Callback(decoder, filename, parameters, flags); }
+
+	enum
+	{
+		DISPATCHABLE_VERSION=0,
+	};
+private:
+	virtual int WASABICALL DecodeAPI_CreateAudioDecoder_Callback(ifc_audio_decoder_callback **decoder, nx_uri_t filename, nsaudio::Parameters *parameters, int flags)=0;
+};

Src/replicant/decode/ifc_raw_media_reader.h

@@ -0,0 +1,20 @@
+#pragma once
+
+#include "foundation/dispatch.h"
+
+class ifc_raw_media_reader : public Wasabi2::Dispatchable
+{
+protected:
+	ifc_raw_media_reader() : Wasabi2::Dispatchable(DISPATCHABLE_VERSION) {}
+	~ifc_raw_media_reader() {}
+public:
+	int Read(void *buffer, size_t buffer_size, size_t *bytes_read) { return RawMediaReader_Read(buffer, buffer_size, bytes_read); }
+	/* TODO: we'll probably need stuff in here like EndOfFile, determining a good buffer size, etc */
+
+	enum
+	{
+		DISPATCHABLE_VERSION=0,
+	};
+protected:
+	virtual int WASABICALL RawMediaReader_Read(void *buffer, size_t buffer_size, size_t *bytes_read)=0;
+};

Src/replicant/decode/svc_decode.h

@@ -0,0 +1,80 @@
+#pragma once
+#include "foundation/dispatch.h"
+#include "audio/parameters.h" 
+#include "audio/ifc_audio_decoder_callback.h"
+#include "audio/ifc_audio_decoder_pull.h"
+#include "nx/nxuri.h"
+
+
+/* if you return NErr_TryAgain, you will be called again with pass=1 after all other services get a chance at the file */
+
+// DA3BB978-4A85-409F-B67C-10E3E1CF73CB
+static const GUID decode_service_type_guid =
+{ 0xDA3BB978, 0x4A85, 0x409F, { 0xB6, 0x7C, 0x10, 0xE3, 0xE1, 0xCF, 0x73, 0xCB } };
+
+class svc_decode : public Wasabi2::Dispatchable
+{
+protected:
+	svc_decode() : Dispatchable(DISPATCHABLE_VERSION) {}
+	~svc_decode() {}
+public:
+	static GUID GetServiceType() { return decode_service_type_guid; }
+
+	/*
+	* return values for the CreateAudioDecoder family of functions
+	* * NErr_Success: Decoder successfully created
+	* * NErr_False: File type not supported by this decoder
+	* * NErr_UnsupportedInterface: File type is supported by this decoder, but not the particular style (callback, pull, packet).
+	* * Any other code is interpreted as an error and enumeration will stop!
+	*/
+
+	/* Flags are defined in ifc_audio_decoder_callback */
+	int CreateAudioDecoder_Callback(ifc_audio_decoder_callback **decoder, nx_uri_t filename, nsaudio::Parameters *parameters, int flags) { return DecodeService_CreateAudioDecoder_Callback(decoder, filename, parameters, flags); }
+	int CreateAudioDecoder_Pull(ifc_audio_decoder_pull **decoder, nx_uri_t filename, nsaudio::Parameters *parameters, int flags) { return DecodeService_CreateAudioDecoder_Pull(decoder, filename, parameters, flags); }
+
+	int CreateAudioDecoder_Callback(unsigned int pass, ifc_audio_decoder_callback **decoder, nx_uri_t filename, nsaudio::Parameters *parameters, int flags)
+	{
+		if (dispatchable_version == 0)
+		{
+			if (pass == 0)
+				return DecodeService_CreateAudioDecoder_Callback(decoder, filename, parameters, flags); 
+			else
+				return NErr_False;
+		}
+		else
+			return DecodeService_CreateAudioDecoder_Callback(pass, decoder, filename, parameters, flags); 
+	}
+
+	int CreateAudioDecoder_Pull(unsigned int pass, ifc_audio_decoder_pull **decoder, nx_uri_t filename, nsaudio::Parameters *parameters, int flags)
+	{
+		if (dispatchable_version == 0)
+		{
+			if (pass == 0)
+				return DecodeService_CreateAudioDecoder_Pull(decoder, filename, parameters, flags); 
+			else
+				return NErr_False;
+		}
+		else
+			return DecodeService_CreateAudioDecoder_Pull(pass, decoder, filename, parameters, flags); 
+	}
+
+	enum
+	{
+		/* Additional flags are defined in the specific decoder interface (e.g. ifc_audio_decoder_pull.h) 
+		They should start at 0x80000001 to ensure uniqueness */
+		FLAG_NO_METADATA= (1 << 0), // tells the decoder that it doesn't need to parse metadata
+		FLAG_VALIDATION = (1 << 1), // turns on codec/file-format specific extra validation checks.  for most implementations this means turning on CRC checking
+	};
+
+	enum
+	{
+		DISPATCHABLE_VERSION=1,
+	};
+private:
+	/* these two no longer have to be implemented */
+	virtual int WASABICALL DecodeService_CreateAudioDecoder_Callback(ifc_audio_decoder_callback **decoder, nx_uri_t filename, nsaudio::Parameters *parameters, int flags) { return DecodeService_CreateAudioDecoder_Callback(0, decoder, filename, parameters, flags); }
+	virtual int WASABICALL DecodeService_CreateAudioDecoder_Pull(ifc_audio_decoder_pull **decoder, nx_uri_t filename, nsaudio::Parameters *parameters, int flags) { return DecodeService_CreateAudioDecoder_Pull(0, decoder, filename, parameters, flags); }
+
+	virtual int WASABICALL DecodeService_CreateAudioDecoder_Callback(unsigned int pass, ifc_audio_decoder_callback **decoder, nx_uri_t filename, nsaudio::Parameters *parameters, int flags) { return NErr_NotImplemented; }
+	virtual int WASABICALL DecodeService_CreateAudioDecoder_Pull(unsigned int pass, ifc_audio_decoder_pull **decoder, nx_uri_t filename, nsaudio::Parameters *parameters, int flags) { return NErr_NotImplemented; }
+};

Src/replicant/decode/svc_raw_media_reader.h

@@ -0,0 +1,27 @@
+#pragma once
+
+#include "foundation/dispatch.h"
+#include "ifc_raw_media_reader.h"
+#include "nx/nxuri.h"
+
+// {BE616DD5-5F42-4E42-88CF-CB7DCB47A3CD}
+static const GUID svc_raw_media_reader_guid = 
+{ 0xbe616dd5, 0x5f42, 0x4e42, { 0x88, 0xcf, 0xcb, 0x7d, 0xcb, 0x47, 0xa3, 0xcd } };
+
+
+class svc_raw_media_reader : public Wasabi2::Dispatchable
+{
+protected:
+	svc_raw_media_reader() : Wasabi2::Dispatchable(DISPATCHABLE_VERSION) {}
+	~svc_raw_media_reader() {}
+public:
+	static GUID GetServiceType() { return svc_raw_media_reader_guid; }
+	int CreateRawMediaReader(ifc_raw_media_reader **reader, nx_uri_t filename, unsigned int pass) { return RawMediaReaderService_CreateRawMediaReader(reader, filename, pass); }
+
+	enum
+	{
+		DISPATCHABLE_VERSION = 0,
+	};
+protected:
+	virtual int WASABICALL RawMediaReaderService_CreateRawMediaReader(ifc_raw_media_reader **reader, nx_uri_t filename, unsigned int pass)=0;
+};