使用音频引擎MITA创建自己的编码器的源代码

关注

原创最新推荐文章于 2025-10-08 16:30:19 发布 819 阅读 AI 写同款· GEO 优化 ›

音频引擎IrrKlang学习笔记01:播放控制与音效设置本系列与FMOD系列、Irrlicht系列是并列的。关于IrrKlang，可以在早先的几篇博文中找到踪迹。 Irrlicht例程04:创造一个有声世界(上) Irrlicht例程05:创造一个有声世界(下) 鬼火(irrlicht)的复燃这几篇博文中已经涉及到IrrKlang的使用，但是本系列是专门研究Audio处理的，因此独立出来。同时也方便与FMOD等进行对比。与F 阅读详情

#include "../../include/mita.h" /**< @brief MITA SDK Header */
#ifdef _DEBUG
#pragma comment(lib, "../../library/mitaD.lib")
#else
#pragma comment(lib, "../../library/mita.lib")
#endif

#include <windows.h>
#include <stdio.h>
#include <conio.h>
#include <math.h>

#define _IID_Example MITA_UUID_Make(AAAABBBB,5059,11E0,8000,0B15,00000A15)

typedef struct MITA_TAG_MODULEHEADER
{
MITA_IEncoder base;
//////////////////////////////////////////////////////////////////////////
//TODO: 添加额外的模块数据
}MITA_MODULEHEADER;

#pragma warning(push)
#pragma warning(disable:4996)

MITA_STATIC
MITA_INLINE
MITA_VOID
MITA_CheckError(MITA_VOID)
{
MITA_ERROR lastError = MITA_GetLastError();
if (lastError != MITA_ERROR_OK)
{
printf("ERROR: MITA Framework error with %u codes\n", lastError);
exit(lastError);
}
}

MITA_STATIC
MITA_INLINE
MITA_BYTE
MITA_EnterKey(MITA_VOID)
{
MITA_INT32 key = 0xFF;
do
{
if (kbhit())
{
key = getch();
break;
}
} while (1);
if (key >= 'a' && key <= 'z')
key -= 32;
return key;
}

//////////////////////////////////////////////////////////////////////////

MITA_STATIC
MITA_VOID
MITA_CALLBACK
Example_Release(MITA_MODULEHEADER *pThis)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 释放资源
if (pThis)
MITA_Free(pThis);
}

MITA_STATIC
MITA_BOOL
MITA_CALLBACK
Example_SetParam(MITA_MODULEHEADER *pThis, MITA_UINT32 nParamID, MITA_LPCVOID lpParam)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 添加参数设置
return MITA_FALSE;
}

MITA_STATIC
MITA_BOOL
MITA_CALLBACK
Example_GetParam(MITA_MODULEHEADER *pThis, MITA_UINT32 nParamID, MITA_LPVOID lpParam)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 添加参数获取
return MITA_FALSE;
}

MITA_SIZE
MITA_CALLBACK
Example_GetFileDescribeNums(MITA_MODULEHEADER *pThis)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 获取所支持的文件列表长度
return MITA_NULL;
}

MITA_LPCAFD
MITA_CALLBACK
Example_GetFileDescribe(MITA_MODULEHEADER *pThis, MITA_SIZE nIndex)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 获取所支持的文件列表
// 请参见 MITA_AFD 结构体
// 这里允许用户添加自定义数据
return MITA_NULL;
}

MITA_DWORD
MITA_CALLBACK
Example_GetFlags(MITA_MODULEHEADER *pThis)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 获取解码的支持标签
// 参见MITA_EF_XXXX
//注意：如果不支持seek的话，一定不能添加 MITA_EF_SEEKABLE
return MITA_DF_DEFAULT;
}

MITA_BOOL
MITA_CALLBACK
Example_IsOpen(MITA_MODULEHEADER *pThis)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 判断当前"编码器"是否已经初始化完毕
return MITA_FALSE;
}

MITA_BOOL
MITA_CALLBACK
Example_IsEof(MITA_MODULEHEADER *pThis)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 判断是否已经编码结束
return MITA_FALSE;
}

MITA_LPCTIMEPOS
MITA_CALLBACK
Example_GetCurPos(MITA_MODULEHEADER *pThis)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 获取当前编码位置
return MITA_NULL;
}

MITA_LPCCHANNELFORMAT
MITA_CALLBACK
Example_GetChannelInfo(MITA_MODULEHEADER* pThis)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 获取当前编码源的通道格式信息
return MITA_NULL;
}

MITA_STATIC
MITA_INLINE
MITA_HSTREAM
getStream(MITA_HINSTANCE Instance, MITA_DWORD flag, MITA_LPCFILEPARAM lpParam, MITA_LPBOOL pNeedDelete)
{
MITA_HSTREAM hStream;
if (!MITA_ParseFileParam(Instance, (MITA_LPCFILEPARAM)lpParam, flag, (MITA_LPBOOL)pNeedDelete, &hStream))
return MITA_NULL;
return hStream;
}

MITA_HTAG
MITA_CALLBACK
Example_CreateTag(MITA_MODULEHEADER *pThis)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 创建文件Tag描述对象
return MITA_NULL;
}

MITA_BOOL
MITA_CALLBACK
Example_Seek(MITA_MODULEHEADER *pThis, MITA_LPCTIME pCurTime)
{
//////////////////////////////////////////////////////////////////////////
//TODO: Seek audio source.
return MITA_TRUE;
}

MITA_BOOL
MITA_CALLBACK
Example_Startup(MITA_MODULEHEADER *pThis, MITA_LPCFILEPARAM lpParam, MITA_HARRAY hSoundArray)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 添加你的初始化代码
return MITA_TRUE;
}

MITA_SIZE
MITA_CALLBACK
Example_Encode(MITA_MODULEHEADER *pThis, MITA_LPCVOID pFrames, MITA_SIZE nFrames)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 添加您的编码代码
return (-1);
}

MITA_BOOL
MITA_CALLBACK
Example_Terminate(MITA_MODULEHEADER *pThis)
{
//////////////////////////////////////////////////////////////////////////
//TODO: 添加你的结束代码
return MITA_FALSE;
}

MITA_STATIC
MITA_LPCMODULEINFO
MITA_CALLBACK
Example_GetModuleInfo(MITA_IModule* pThis)
{
return pThis->PlusObject->getModuleInfo(pThis->PlusObject);
}

MITA_STATIC
MITA_BOOL
MITA_CALLBACK
Example_HasWindow(MITA_IModule* pThis, MITA_DWORD dwType)
{
return pThis->PlusObject->hasWindow(pThis->PlusObject, dwType);
}

MITA_STATIC
MITA_BOOL
MITA_CALLBACK
Example_ShowWindow(MITA_IModule* pThis, MITA_DWORD dwType, MITA_HANDLE hParent, MITA_BOOL bShow)
{
return pThis->PlusObject->showWindow(pThis->PlusObject, dwType, hParent, bShow);
}

MITA_STATIC
MITA_IModule*
MITA_CALLBACK
Example_CreateObject(MITA_IStaticPlus *pThis, MITA_HINSTANCE hInstance)
{
MITA_MODULEHEADER *pExample = (MITA_MODULEHEADER *)MITA_Malloc(sizeof(MITA_MODULEHEADER));
if (pExample == MITA_NULL)
return MITA_NULL;

pExample->base.base.PlusObject = &pThis->base;
pExample->base.base._instance = hInstance;
pExample->base.base._resverd = MITA_MODULE_RESVERD_ENCODER;
pExample->base.base.release = Example_Release;
pExample->base.base.getModuleInfo = Example_GetModuleInfo;
pExample->base.base.hasWindow = Example_HasWindow;
pExample->base.base.showWindow = Example_ShowWindow;
pExample->base.setParam = Example_SetParam;
pExample->base.getParam = Example_GetParam;
pExample->base.getFileDescribeNums = Example_GetFileDescribeNums;
pExample->base.getFileDescribe = Example_GetFileDescribe;
pExample->base.getFlags = Example_GetFlags;
pExample->base.seek = Example_Seek;
pExample->base.createTag = Example_CreateTag;
pExample->base.startup = Example_Startup;
pExample->base.encode = Example_Encode;
pExample->base.terminate = Example_Terminate;
pExample->base.isEof = Example_IsEof;
pExample->base.isOpen = Example_IsOpen;
pExample->base.getCurPos = Example_GetCurPos;
pExample->base.getChannelInfo = Example_GetChannelInfo;
//////////////////////////////////////////////////////////////////////////
//TODO: 添加额外的初始化操作。

return (MITA_IModule*)pExample;
}

MITA_STATIC
MITA_LPCMODULEINFO
MITA_CALLBACK
Plus_GetModuleInfo(MITA_IStaticPlus *pThis)
{
return &pThis->moduleInfo;
}
MITA_STATIC
MITA_BOOL
MITA_CALLBACK
Plus_HasWindow(MITA_IStaticPlus *pThis, MITA_DWORD dwType)
{
return MITA_FALSE;
}
MITA_STATIC
MITA_BOOL
MITA_CALLBACK
Plus_ShowWindow(MITA_IStaticPlus *pThis, MITA_DWORD dwType, MITA_HANDLE hParent, MITA_BOOL bShow)
{
return MITA_FALSE;
}

MITA_STATIC
MITA_IStaticPlus
gExamplePlugin =
{
Plus_GetModuleInfo,
Plus_HasWindow,
Plus_ShowWindow,
Example_CreateObject,
{
MITA_MT_ENCODER,
_IID_Example,
1,
L"MITA Plugin Example",
L"MITA Plugin Example Module",
L"Copyright(C) Hangzhou Migan Technology 2008-2011. All rights reserved.",
MITA_NULL
}
};

MITA_STATIC
MITA_HPLUSOBJECT
MITA_CALL
Example_ModuleMain(void)
{
return (MITA_HPLUSOBJECT)&gExamplePlugin;
}

//////////////////////////////////////////////////////////////////////////
//如果你想要导出dll的话，那么还需要添加一个接口函数
// MITA_GetPlusMains, nIndex 为模块的序号
_declspec(dllexport)
MITA_MODULEMAIN
MITA_CALL
MITA_GetPlusMains(MITA_SIZE nIndex)
{
switch (nIndex)
{
case 0:
return Example_ModuleMain;
}
return MITA_NULL;
}

void main(void)
{
MITA_HINSTANCE hInstance;
MITA_HPLUGIN hExamplePlugin;
MITA_HMODULE hExampleModule;
MITA_HOBJECT hExampleObject;
MITA_UUID RegGuid;
MITA_MODULEINFO moduleInfo;
MITA_BYTE Key;

printf(";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n");
printf(";;Copyright(C) 杭州蜜柑科技有限公司 2008 - 2010. 保留所有权利。;;\n");
printf(";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n");
printf(";;Plugin Encoder Example ;;\n");
printf(";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n");

//////////////////////////////////////////////////////////////////////////
//1. Create a global instance handle.
hInstance = MITA_Initialize(MITA_NULL);
MITA_CheckError();

printf("Press A use static module loader.\n");
printf("Press B use export module loader.\n");
Key = MITA_EnterKey() - 'A';

if (Key == 0)
{
//////////////////////////////////////////////////////////////////////////
//2. Register Module
MITA_Ins_RegisterModule(hInstance, Example_ModuleMain, &RegGuid, &hExampleModule);
MITA_CheckError();
}
else
{
//////////////////////////////////////////////////////////////////////////
//2. Load Plugin, just this exe file.
MITA_Ins_LoadPlugin(hInstance, L"make_your_encoder.exe", &hExamplePlugin);
MITA_CheckError();
MITA_Ins_GetModuleByIndex(hInstance, 0, &hExampleModule);
MITA_CheckError();
}

//////////////////////////////////////////////////////////////////////////
//3. Create Module Object
MITA_Module_CreateModuleObject(hExampleModule, &hExampleObject);
MITA_CheckError();

//////////////////////////////////////////////////////////////////////////
MITA_Object_GetModuleInfo(hExampleObject, &moduleInfo);
MITA_CheckError();

printf("\n");
printf("Name: %s\n", MITA_Text_ToSystemS(moduleInfo.name, MITA_TCT_DEFAULT));
printf("Vers: %08X\n", moduleInfo.version);
printf("Desc: %s\n", MITA_Text_ToSystemS(moduleInfo.describe, MITA_TCT_DEFAULT));
printf("Copy: %s\n", MITA_Text_ToSystemS(moduleInfo.copyright, MITA_TCT_DEFAULT));
printf("\n");

/*
use MITA_Encoder_XXXX operations.
*/

//////////////////////////////////////////////////////////////////////////
//4. Delete Module Object
MITA_CloseHandle(hExampleObject);
MITA_CheckError();

//////////////////////////////////////////////////////////////////////////
//*: 这一步不是必须的
if (Key == 0)
{
//////////////////////////////////////////////////////////////////////////
//5*. Unregister Module，这一步不是必须的，在释放“实例句柄”的时候，会自动
// 进行移除操作。
MITA_Ins_UnregisterModule(hInstance, &RegGuid);
MITA_CheckError();
}
else
{
MITA_Ins_UnregisterPluginModule(hInstance, hExamplePlugin, MITA_NULL);
MITA_CheckError();
}

//////////////////////////////////////////////////////////////////////////
//6. Delete global instance handle.
MITA_CloseHandle(hInstance);
}

#pragma warning(pop)

收录于