AK Channel Router

	Warning
	This plug-in is still experimental.

(See the AK Channel Router properties below.)

The AK Channel Router Effect plug-in allows you to route and mix multiple sounds or busses with different channel configurations into a single bus. This is especially useful when dealing with an Audio Device with many channels that require non-standard routing.

After inserting this Effect on a bus, you can add a Channel Router Settings metadata to any of its child busses or sounds that output to the bus to configure which channel they output to. A default value of 1 is used for any child busses that do not have this metadata. If there are multiple busses or sounds outputting to the same channel, these channels are mixed together.

	Note
	This plug-in can only be inserted on busses with their Bus Configuration set to Audio Objects. Thus, the plug-in cannot be inserted on top-level busses.

Example usage

Consider a scenario where you have an Audio Bus (Bus A) routed to an Audio Device with 16 channels and you want to output 7.1 content on the first eight channels (1 to 8) followed by 4.0 content on the next four channels (9 to 12) with silence on the remaining channels (13 to 16).

In the General Settings tab of the Property Editor for Bus A, set the Bus Configuration to Audio Objects.
In the Effects tab, add the AK Channel Router Effect plug-in.
Create a new child Audio Bus under Bus A named "Audio Bus 7-1".
In the Property Editor of Audio Bus 7-1:
1. In the General Settings tab, set the Bus Configuration to 7.1.
2. In the Metadata tab, add a Channel Router Settings metadata.
  Leave the Channel property of the Channel Router Settings metadata set to 1 so the output of this child bus is routed to channels 1-8 of the parent bus.
Create another child Audio Bus under Bus A. Name this child bus "Audio Bus 4-0".
In the Property Editor of Audio Bus 4-0:
1. In the General Settings tab, set the Bus Configuration to 4.0.
2. In the Metadata tab, add a Channel Router Settings metadata.
3. Set the Channel property of the Channel Router Settings metadata to 9 so the output of this child bus is routed to channels 9-13 of the parent bus.