VST 3 Interfaces  VST 3.7
SDK for developing VST plug-in
[3.6.5] Channel Context Info Support

Channel context interface: Vst::IInfoListener.

  • [plug imp]
  • [extends IEditController]
  • [released: 3.6.5]
  • [optional]

Allows the host to inform the plug-in about the context in which the plug-in is instantiated, mainly channel based info (color, name, index,...). Index can be defined inside a namespace (for example, index start from 1 to N for Type Input/Output Channel (Index namespace) and index start from 1 to M for Type Audio Channel).
As soon as the plug-in provides this IInfoListener interface, the host will call setChannelContextInfos for each change occurring to this channel (new name, new color, new indexation,...)

Example

//------------------------------------------------------------------------
tresult PLUGIN_API MyPlugin::setChannelContextInfos (IAttributeList* list)
{
if (list)
{
// optional we can ask for the Channel Name Length
int64 length;
if (list->getInt (ChannelContext::kChannelNameLengthKey, length) == kResultTrue)
{
...
}
// get the Channel Name where we, as plug-in, are instantiated
String128 name;
if (list->getString (ChannelContext::kChannelNameKey, name, sizeof (name)) == kResultTrue)
{
...
}
// get the Channel UID
if (list->getString (ChannelContext::kChannelUIDKey, name, sizeof (name)) == kResultTrue)
{
...
}
// get Channel Index
int64 index;
if (list->getInt (ChannelContext::kChannelIndexKey, index) == kResultTrue)
{
...
}
// get the Channel Color
int64 color;
if (list->getInt (ChannelContext::kChannelColorKey, color) == kResultTrue)
{
uint32 channelColor = (uint32)color;
String str;
str.printf ("%x%x%x%x", ChannelContext::GetAlpha (channelColor),
ChannelContext::GetRed (channelColor),
ChannelContext::GetGreen (channelColor),
ChannelContext::GetBlue (channelColor));
String128 string128;
Steinberg::UString (string128, 128).fromAscii (str);
...
}
// get Channel Index Namespace Order of the current used index namespace
{
...
}
// get the channel Index Namespace Length
{
...
}
// get the channel Index Namespace
String128 namespaceName;
if (list->getString (ChannelContext::kChannelIndexNamespaceKey, namespaceName, sizeof (namespaceName)) == kResultTrue)
{
...
}
// get plug-in Channel Location
int64 location;
if (list->getInt (ChannelContext::kChannelPluginLocationKey, location) == kResultTrue)
{
String128 string128;
switch (location)
{
Steinberg::UString (string128, 128).fromAscii ("PreVolFader");
break;
Steinberg::UString (string128, 128).fromAscii ("PostVolFader");
break;
Steinberg::UString (string128, 128).fromAscii ("UsedAsPanner");
break;
default: Steinberg::UString (string128, 128).fromAscii ("unknown!");
break;
}
}
// do not forget to call addRef () if you want to keep this list
}
}



Back to Contents

Steinberg::Vst::ChannelContext::kChannelNameKey
const CString kChannelNameKey
string (TChar) [optional]: name of the channel like displayed in the mixer
Definition: ivstchannelcontextinfo.h:201
Steinberg::Vst::ChannelContext::kChannelIndexNamespaceLengthKey
const CString kChannelIndexNamespaceLengthKey
integer (int64) [optional]: number of characters in kChannelIndexNamespaceKey
Definition: ivstchannelcontextinfo.h:223
int64
long long int64
Steinberg::Vst::ChannelContext::kChannelUIDKey
const CString kChannelUIDKey
Keys used as AttrID (Attribute ID) in the return IAttributeList of IInfoListener::setChannelContextIn...
Definition: ivstchannelcontextinfo.h:195
Steinberg::Vst::ChannelContext::kChannelPluginLocationKey
const CString kChannelPluginLocationKey
integer (int64) [optional]: routing position of the plug-in in the channel (see ChannelPluginLocation...
Definition: ivstchannelcontextinfo.h:229
tresult
int32 tresult
Steinberg::Vst::ChannelContext::kUsedAsPanner
Definition: ivstchannelcontextinfo.h:166
Steinberg::UString::fromAscii
UString & fromAscii(const char *src, int32 srcSize=-1)
Steinberg::UString
Steinberg::Vst::String128
TChar String128[128]
128 character UTF-16 string
Definition: vsttypes.h:62
Steinberg::Vst::ChannelContext::kChannelIndexKey
const CString kChannelIndexKey
integer (int64) [optional]: index of the channel in a channel index namespace, start with 1 not * 0!
Definition: ivstchannelcontextinfo.h:210
kResultTrue
kResultTrue
Steinberg::Vst::ChannelContext::kChannelNameLengthKey
const CString kChannelNameLengthKey
integer (int64) [optional]: number of characters in kChannelNameKey
Definition: ivstchannelcontextinfo.h:204
Steinberg::Vst::ChannelContext::kChannelIndexNamespaceOrderKey
const CString kChannelIndexNamespaceOrderKey
integer (int64) [optional]: define the order of the current used index namespace, start with 1 not 0!...
Definition: ivstchannelcontextinfo.h:217
Steinberg::Vst::ChannelContext::kChannelIndexNamespaceKey
const CString kChannelIndexNamespaceKey
string (TChar) [optional]: name of the channel index namespace for example "Input",...
Definition: ivstchannelcontextinfo.h:220
Steinberg::Vst::ChannelContext::kPreVolumeFader
Definition: ivstchannelcontextinfo.h:164
Steinberg::Vst::ChannelContext::kPostVolumeFader
Definition: ivstchannelcontextinfo.h:165
uint32
unsigned int uint32
Steinberg::Vst::ChannelContext::kChannelColorKey
const CString kChannelColorKey
color (ColorSpec) [optional]: used color for the channel in mixer or track
Definition: ivstchannelcontextinfo.h:207
Empty

Copyright ©2020 Steinberg Media Technologies GmbH. All Rights Reserved. This documentation is under this license.