{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The final phase in developing an audio module library is to compile the source files and create a Dynamic Link Library (DLL) for the Server. Typically, a DLL contains multiple modules organized around a common theme. For example, Audio Weaver provides several module packs:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FrameDll.dll","type":"text","marks":[{"type":"em"}]},{"text":" — Standard Module Pack featuring basic modules","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ModulePackAweAdvancedDLL.dll — ","type":"text","marks":[{"type":"em"}]},{"text":"Advanced Module Pack featuring more specialized functionality","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ModulePackAweDeprecatedDLL.dll — ","type":"text","marks":[{"type":"em"}]},{"text":"Deprecated Module Pack, with modules that are no longer supported and should be avoided in new designs.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"After a DLL is built with the x86 Release configuration, it is copied into the directory containing the Server executable","type":"text"}]},{"type":"paragraph","content":[{"text":"\\Bin\\win32-142-rel","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The Server then loads the DLL next time it launches. The audio module DLL contains all of the information needed by the Server to instantiate, execute, and control the module. The DLL also contains the schema information facilitating real-time tuning.","type":"text"}]},{"type":"paragraph","content":[{"text":"This section describes how to generate an audio module DLL by working through the Examples module library discussed in ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://dspconcepts.atlassian.net/wiki/spaces/DOCHUB/pages/2955935802"}},{"text":". Building an audio module DLL requires Visual Studio 2019 or later. If you are running custom audio modules on an embedded processor, you'll need to build an audio module DLL and also rebuild the target executable. This section focuses on building the DLL. Refer to the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://dspconcepts.atlassian.net/wiki/spaces/DOCHUB/pages/2773450903"}},{"text":" for the additional steps needed on the target. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The steps described below indicate one method of structuring files and scripts to generate the module DLL. You can adapt this to fit your development process.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Building ExamplesDLL.dll","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"BuildingExamplesDLL.dll"}},"macroMetadata":{"macroId":{"value":"e2430a45f05ff37fad7cf022269b4db7"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"e20cdd76-cf68-466f-828e-4ee97235850c"}}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the master code generation script for this library","type":"text"},{"type":"hardBreak"},{"text":"make_examples","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open up the Visual Studio solution ","type":"text"},{"text":"\\AWEModules\\Source\\Examples\\Examples.sln","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"The solution contains two projects shown below:","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":298,"id":"b29e4460-a5e5-49d9-91ac-49076c9a38bb","collection":"contentId-2956034113","type":"file","height":469}}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"ExamplesLib","type":"text","marks":[{"type":"em"}]},{"text":" compiles the module source files and builds an overall library. The ","type":"text"},{"text":"ExamplesDLL","type":"text","marks":[{"type":"em"}]},{"text":" project builds the DLL. ","type":"text"},{"text":"ExamplesLib","type":"text","marks":[{"type":"em"}]},{"text":" is easily understood by C programmers. Understanding ","type":"text"},{"text":"ExamplesDLL","type":"text","marks":[{"type":"em"}]},{"text":" requires some Windows expertise. Fortunately, you can use the Examples projects as starting points for your own custom DLL development and do not have to delve into the underlying Windows issues.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To build the audio module DLL, right-click on ","type":"text"},{"text":"ExamplesDll","type":"text","marks":[{"type":"em"}]},{"text":" and select Rebuild, ensuring that the x86 Release configuration is selected. The project dependencies are set so that first ","type":"text"},{"text":"ExamplesLib ","type":"text","marks":[{"type":"em"}]},{"text":"will be built followed by ExampleDll.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ExamplesDLL ","type":"text","marks":[{"type":"em"}]},{"text":"generates DLL at the location ","type":"text"},{"text":"\\Bin\\win32-142-rel","type":"text","marks":[{"type":"em"}]},{"text":" directory so that it can be referenced by the Server.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":80.0},"content":[{"type":"media","attrs":{"width":410,"id":"a5b3701a-663b-4ba8-8bf0-3a936f5276cb","collection":"contentId-2956034113","type":"file","height":30}}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" If the AWE_Server.exe executable is not in the expected place, then change the destination directory in this General configuration step.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"If the DLL was properly built, you'll be able to open the Server and see the new library of examples listed. Select ","type":"text"},{"text":"Target > List Modules","type":"text","marks":[{"type":"em"}]},{"text":" and scroll down the list looking for the ","type":"text"},{"text":"ExamplesDLL.dll ","type":"text","marks":[{"type":"em"}]},{"text":"entry:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":31.0},"content":[{"type":"media","attrs":{"width":154,"id":"54d93f47-e7f3-4af0-8992-a26616430c21","collection":"contentId-2956034113","type":"file","height":88}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Cloning the Examples Library","type":"text"}]},{"type":"paragraph","content":[{"text":"We recommend that you use the Examples directory as a starting point for your own custom module libraries. We also recommend maintaining the existing directory structure. ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Begin by copying and renaming the entire Examples directory in ","type":"text"},{"text":"/","type":"text","marks":[{"type":"em"}]},{"text":". We'll assume that the new module library will be called MyModules and will be stored in the directory ","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete all generated files, they will be regenerated:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Examples.h","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/ExamplesSchema.cpp","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/ExamplesSchema.sch","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Examples.ncb, if exists","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Examples.suo, if exists","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Source/*","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Include/*","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Doc/*","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete all files in ","type":"text"},{"text":"/matlab","type":"text","marks":[{"type":"em"}]},{"text":" except ","type":"text"},{"text":"make_examples.m","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rename the following files from \"Example\" to \"MyModules\". You'll end up with:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/BuildDll/MyModulesDLL.vcproj","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/BuildLib/MyModulesLib.vcproj","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/matlab/make_mymodules.m","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/MyModules.sln","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Clear out any module m-files in the folder ","type":"text"},{"text":"\\matlab","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Clear out any code pieces in the following directories:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\\matlab\\code","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\\matlab\\process","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\\matlab\\test","type":"text","marks":[{"type":"em"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy in the files for your custom modules.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit ","type":"text"},{"text":"make_mymodules.m","type":"text","marks":[{"type":"em"}]},{"text":" and replace all the occurrences of “Examples” to “MyModules”. Also specify the list of modules you would like included in the library. Note that the module must be specified with complete arguments.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the class ID file ","type":"text"},{"text":"\\classids.csv","type":"text","marks":[{"type":"em"}]},{"text":" and specify unique class IDs for the modules in your library.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Issue the command ","type":"text"},{"text":"awe_init","type":"text","marks":[{"type":"code"}]},{"text":" in the MATLAB command window to initialize the Audio Weaver environment.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update the module search path using the ","type":"text"},{"text":"add_module_path","type":"text","marks":[{"type":"code"}]},{"text":" MATLAB function or the Audio Weaver menu option File->Set Module Path.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Issue the command ","type":"text"},{"text":"make_mymodules","type":"text","marks":[{"type":"code"}]},{"text":" in the MATLAB command window.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the ","type":"text"},{"text":"*.vcxproj","type":"text","marks":[{"type":"em"}]},{"text":" files in a text editor and delete the ","type":"text"},{"text":"ProjectGUID","type":"text","marks":[{"type":"code"}]},{"text":" string. This string is ","type":"text"},{"text":"supposed ","type":"text","marks":[{"type":"em"}]},{"text":"to be unique and thus uniquely identify the project within Visual Studio. However, since we just copied and renamed the ","type":"text"},{"text":".vcproj","type":"text","marks":[{"type":"em"}]},{"text":" file, the ProjectGUID will no longer be unique.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Find the line with the ","type":"text"},{"text":"ProjectGUID","type":"text","marks":[{"type":"code"}]},{"text":" keyword near the top each ","type":"text"},{"text":".vcproj","type":"text","marks":[{"type":"em"}]},{"text":" file:","type":"text"},{"type":"hardBreak"},{"text":"ProjectGUID=\"{5FEC38A8-50BF-41E6-A94F-E489381E2B85}\"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The line will be similar to this, but not exact. Change it to ","type":"text"},{"text":"ProjectGUID=\"\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"This forces Visual Studio to update the GUID next time the file is opened. Change all occurrences of \"Examples\" to \"MyModules\" throughout the file.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the file ","type":"text"},{"text":"\\BuildDll\\ModuleTable.cpp","type":"text","marks":[{"type":"em"}]},{"text":" and instead of including ","type":"text"},{"text":"Examples.h","type":"text","marks":[{"type":"code"}]},{"text":", change it to ","type":"text"},{"text":"MyModules.h","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open up the file ","type":"text"},{"text":"\\BuildDll\\ModuleLibDLL.def ","type":"text","marks":[{"type":"em"}]},{"text":"and change","type":"text"},{"type":"hardBreak"},{"text":"LIBRARY \"ExamplesDLL\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"to","type":"text"},{"type":"hardBreak"},{"text":"LIBRARY \"MyModulesDLL\"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the ","type":"text"},{"text":"MyModules.sln","type":"text","marks":[{"type":"em"}]},{"text":" in any editor window and look for “Examples” and replace this with “MyModules”. If doesn’t work, delete ","type":"text"},{"text":"MyModules.sln","type":"text","marks":[{"type":"em"}]},{"text":" and create a new solution. Then add the two projects, “MyModulesDLL.vcproj” and “MyModulesLib.vcproj”, to the solution.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add the generated source files from ","type":"text"},{"text":"\\Source\\","type":"text","marks":[{"type":"em"}]},{"text":" to the Source Files of “MyModulesLib.vcproj” and add files from ","type":"text"},{"text":"\\Include","type":"text","marks":[{"type":"em"}]},{"text":" to the ","type":"text"},{"text":"Include ","type":"text","marks":[{"type":"em"}]},{"text":"Files of “MyModulesLib.vcproj”.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"At this point, the projects are ready to build. Build the solution with the x86 Release configuration, and when complete, you'll have MyModulesDLL.dll in the ","type":"text"},{"text":"\\Bin\\win32-142-rel directory.","type":"text","marks":[{"type":"em"}]}]}],"version":1}