LV2 Port Groups

Ambisonic B stream of horizontal order 1 and peripheral order 0.

Ambisonic B stream of horizontal order 1 and peripheral order 1.

Ambisonic B stream of horizontal order 2 and peripheral order 0.

Ambisonic B stream of horizontal order 2 and peripheral order 1.

Ambisonic B stream of horizontal order 2 and peripheral order 2.

Ambisonic B stream of horizontal order 3 and peripheral order 0.

Ambisonic B stream of horizontal order 3 and peripheral order 1.

Ambisonic B stream of horizontal order 3 and peripheral order 2.

Ambisonic B stream of horizontal order 3 and peripheral order 3.

A group of Ambisonic channels.

These groups are divided into channels which together represent a position in an abstract n-dimensional space. The position of sound in one of these groups does not depend on a particular speaker configuration; a decoder can be used to convert an ambisonic stream for any speaker configuration.

A group of discrete channels.

These groups are divided into channels where each represents a particular speaker location. The position of sound in one of these groups depends on a particular speaker configuration.

An element of a group, with a designation and optional index.

A 5.1 (3-2 stereo with sub) discrete surround sound group.

A 5.0 (3-2 stereo) discrete surround sound group.

A 4.0 (Quadraphonic) discrete surround sound group.

A set of ports that are logically grouped together.

A group logically combines ports which should be considered part of the same stream. For example, two audio ports in a group may form a stereo stream.

Like ports, groups have a lv2:symbol that is unique within the context of the plugin, where group symbols and port symbols reside in the same namespace. In other words, a group on a plugin MUST NOT have the same symbol as any other group or port on that plugin. This makes it possible to uniquely reference a port or group on a plugin with a single identifier and no context.

Group definitions may be shared across plugins for brevity. For example, a plugin collection may define a single URI for a StereoGroup with the symbol "input" and use it in many plugins.

A group which contains exclusively inputs.

A 2-channel mid-side stereo audio group.

A single channel audio group.

A group which contains exclusively outputs.

A 7.1 discrete surround sound group.

A 7.1 wide discrete surround sound group.

A 6.1 discrete surround sound group.

A 2-channel discrete stereo audio group.

A 3.0 discrete surround sound group.

An element within a port group.

Group that this port is a part of.

Indicates that this port is a part of a group of ports on the plugin. The port should also have an lv2:designation property to define its designation within that group.

The degree coefficient (l) of the spherical harmonic for an Ambisonic channel.

The index coefficient (m) of the spherical harmonic for an Ambisonic channel.

The YuMa letter code for an Ambisonic channel.

Input group that is the primary input of the plugin.

Indicates that this group should be considered the "main" input, i.e. the primary task is processing the signal in this group. A plugin MUST NOT have more than one mainInput property.

Output group that is the primary output of the plugin.

Indicates that this group should be considered the "main" output. The main output group SHOULD have the main input group as a source.

Port or group is a side chain of another.

Indicates that this port or group should be considered a "side chain" of some other port or group. The precise definition of "side chain" depends on the plugin, but in general this group should be considered a modifier to some other group, rather than an independent input itself.

Port or group that this group is the output of.

Indicates that this port or group should be considered the "result" of some other port or group. This property only makes sense on groups with outputs when the source is a group with inputs. This can be used to convey a relationship between corresponding input and output groups with different types, for example in a mono to stereo plugin.

Group is a child of another group.

Indicates that this group is a child of another group. This property has no meaning with respect to plugin execution, but the host may find this information useful to provide a better user interface. Note that being a sub-group does not relax the restriction that the group MUST have a unique symbol with respect to the plugin.

Ambisonic channel 0 (W): degree 0, index 0.

Ambisonic channel 1 (Y): degree 1, index -1.

Ambisonic channel 10 (O): degree 3, index -2.

Ambisonic channel 11 (M): degree 3, index -1.

Ambisonic channel 12 (K): degree 3, index 0.

Ambisonic channel 13 (L): degree 3, index 1.

Ambisonic channel 14 (N): degree 3, index 2.

Ambisonic channel 15 (P): degree 3, index 3.

Ambisonic channel 2 (Z): degree 1, index 0.

Ambisonic channel 3 (X): degree 1, index 1.

Ambisonic channel 4 (V): degree 2, index -2.

Ambisonic channel 5 (T): degree 2, index -1.

Ambisonic channel 6 (R): degree 2, index 0.

Ambisonic channel 7 (S): degree 2, index 1.

Ambisonic channel 8 (U): degree 2, index 2.

Ambisonic channel 9 (Q): degree 3, index -3.

The center channel of a discrete audio group.

The center-left channel of a 7.1 wide surround sound group.

The center-right channel of a 7.1 wide surround sound group.

The left channel of a stereo audio group.

The LFE channel of a *.1 surround sound group.

The rear-center channel of a surround sound group.

The rear-left channel of a surround sound group.

The rear-right channel of a surround sound group.

The right channel of a stereo audio group.

The side channel of a mid-side audio group.

The side-left channel of a 6.1 or 7.1 surround sound group.

The side-right channel of a 6.1 or 7.1 surround sound group.