aboutsummaryrefslogtreecommitdiff
path: root/Src/replicant/decode
diff options
context:
space:
mode:
Diffstat (limited to 'Src/replicant/decode')
-rw-r--r--Src/replicant/decode/api_decode.h35
-rw-r--r--Src/replicant/decode/ifc_raw_media_reader.h20
-rw-r--r--Src/replicant/decode/svc_decode.h80
-rw-r--r--Src/replicant/decode/svc_raw_media_reader.h27
4 files changed, 162 insertions, 0 deletions
diff --git a/Src/replicant/decode/api_decode.h b/Src/replicant/decode/api_decode.h
new file mode 100644
index 00000000..3b5433c7
--- /dev/null
+++ b/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;
+};
diff --git a/Src/replicant/decode/ifc_raw_media_reader.h b/Src/replicant/decode/ifc_raw_media_reader.h
new file mode 100644
index 00000000..562c0859
--- /dev/null
+++ b/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;
+};
diff --git a/Src/replicant/decode/svc_decode.h b/Src/replicant/decode/svc_decode.h
new file mode 100644
index 00000000..bdc7851b
--- /dev/null
+++ b/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; }
+};
diff --git a/Src/replicant/decode/svc_raw_media_reader.h b/Src/replicant/decode/svc_raw_media_reader.h
new file mode 100644
index 00000000..178b1f35
--- /dev/null
+++ b/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;
+};