64 lines
2.8 KiB
C++
64 lines
2.8 KiB
C++
#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')
|
|
};
|
|
|
|
}; |