Initial community commit

Src/Agave/Encode/svc_audioFileEncoder.h

@@ -0,0 +1,64 @@
+#pragma once
+/*
+Service for creating Audio Encoders which encode straight to a file.
+
+This interface is not meant to do the encoding itself, it is a factory to create and destroy
+encoder objects (ifc_audioFileEncoder)
+*/
+#include <bfc/dispatch.h>
+#include "ifc_audioFileEncoder.h"
+#include "../DecodeFile/api_decodefile.h" // for AudioParameters struct
+#include <bfc/std_mkncc.h> // for MKnCC()
+class svc_audioFileEncoder : public Dispatchable
+{
+protected:
+	svc_audioFileEncoder() {}
+	~svc_audioFileEncoder() {}
+public:
+	  static FOURCC getServiceType() { return svc_albumArtProvider::SERVICETYPE; }
+	/*
+	  General parameter notes (for all methods of this class):
+		@param profile is a filename of an INI file where the encoder settings are stored
+		@param parameters defines the input audio data.  For methods where this parameter
+		is optional (default parameter value == 0), it is meant to be passed to optionally
+		limit configuration choices.  For example, an AAC encoder could hide surround-sound
+		encoding options when parameters->channels == 2
+	*/
+
+	// return a user-friendly name for the encoder,
+	// e.g. "Nullsoft FLAC encoder v2.1"
+	const wchar_t *GetName();
+
+	// retrieve information about a particular profile
+	// @param profile_item information to retrieve.  currently, there are only three defined strings
+	// "bitrate" -- retrieve an estimate bitrate (in kbps) for the profile
+	// "profile" -- retrieve a more specific name for a given profile (and optional input parameters)
+  // e.g. an AAC encoder could return "HE-AAC v2, 16kbps, MP4 File Format" or "AAC LC, ADTS stream"
+	// "settings" -- retrieve a string that codifies the settings in the profile
+	// for most codecs, this should mirror what the commandline string would be for the corresponding
+	// commandline codec (flac.exe, lame.exe, etc).
+	// e.g. "-V 2" 
+	int GetProfileInfo(const wchar_t *profile, const wchar_t *profile_item, wchar_t *value, size_t value_cch, const AudioParameters *parameters = 0);
+
+	// not currently used for anything
+	int SetProfileInfo(const wchar_t *profile, const wchar_t *profile_item, const wchar_t *value, AudioParameters *parameters = 0);
+
+	// this function gets the party started.  call after you have opened your input file (thru
+	// api_decodefile, for example) so you can pass in a valid parameters struct.
+	// @param filename destination filename
+	int Create(ifc_audioFileEncoder **encoder, const wchar_t *filename, const wchar_t *profile, const AudioParameters *parameters);
+
+	// call this when you are done
+	void Destroy(ifc_audioFileEncoder *encoder);
+
+	// if parent is NULL, pop up a modal dialog/window
+	// if parent is not NULL, return a modeless child dialog/window 
+	HWND Configure(HWND parent, const wchar_t *profile, const AudioParameters *parameters = 0);
+
+
+	enum
+	{
+		SERVICETYPE = MK4CC('a','f','e', 'n')
+	};
+
+};