Steinberg::Vst::IXmlRepresentationController Class Reference

#include <ivstrepresentation.h>

Inheritance diagram for Steinberg::Vst::IXmlRepresentationController:

Public Member Functions
virtual tresult PLUGIN_API	getXmlRepresentationStream (RepresentationInfo &info, IBStream *stream)=0
Public Member Functions inherited from Steinberg::FUnknown
virtual tresult PLUGIN_API	queryInterface (const TUID _iid, void **obj)=0
virtual uint32 PLUGIN_API	addRef ()=0
virtual uint32 PLUGIN_API	release ()=0

Static Public Attributes
static const FUID	iid
Static Public Attributes inherited from Steinberg::FUnknown
static const FUID	iid

Detailed Description

Extended plug-in interface IEditController for a component: Vst::IXmlRepresentationController

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

A representation based on XML is a way to export, structure, and group plug-ins parameters for a specific remote (hardware or software rack (such as quick controls)).
It allows to describe each parameter more precisely (what is the best matching to a knob, different title lengths matching limited remote display,...).
See an Example.

• A representation is composed of pages (this means that to see all exported parameters, the user has to navigate through the pages).
• A page is composed of cells (for example 8 cells per page).
• A cell is composed of layers (for example a cell could have a knob, a display, and a button, which means 3 layers).
• A layer is associated to a plug-in parameter using the ParameterID as identifier:
  • it could be a knob with a display for title and/or value, this display uses the same parameterId, but it could an another one.
  • switch
  • link which allows to jump directly to a subpage (another page)
  • more... See Vst::LayerType

This representation is implemented as XML text following the Document Type Definition (DTD): http://dtd.steinberg.net/VST-Remote-1.1.dtd

Example

Here an example of what should be passed in the stream of getXmlRepresentationStream:

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE vstXML PUBLIC "-//Steinberg//DTD VST Remote 1.1//EN" "http://dtd.steinberg.net/VST-Remote-1.1.dtd">
<vstXML version="1.0">
        <plugin classID="341FC5898AAA46A7A506BC0799E882AE" name="Chorus" vendor="Steinberg Media Technologies" />
        <originator>My name</originator>
        <date>2010-12-31</date>
        <comment>This is an example for 4 Cells per Page for the Remote named ProductRemote 
                 from company HardwareCompany.</comment>
 
        <!-- ===================================== -->
        <representation name="ProductRemote" vendor="HardwareCompany" version="1.0">
                <page name="Root">
                        <cell>
                                <layer type="knob" parameterID="0">
                                        <titleDisplay>
                                                <name>Mix dry/wet</name>
                                                <name>Mix</name>
                                        </titleDisplay>
                                </layer>
                        </cell>
                        <cell>
                                <layer type="display"></layer>
                        </cell>
                        <cell>
                                <layer type="knob" parameterID="3">
                                        <titleDisplay>
                                                <name>Delay</name>
                                                <name>Dly</name>
                                        </titleDisplay>
                                </layer>
                        </cell>
                        <cell>
                                <layer type="knob" parameterID="15">
                                        <titleDisplay>
                                                <name>Spatial</name>
                                                <name>Spat</name>
                                        </titleDisplay>
                                </layer>
                        </cell>
                </page>
                <page name="Page 2">
                        <cell>
                                <layer type="LED" ledStyle="spread" parameterID="2">
                                        <titleDisplay>
                                                <name>Width +</name>
                                                <name>Widt</name>
                                        </titleDisplay>
                                </layer>
                                <!--this is the switch for shape A/B-->
                                <layer type="switch" switchStyle="pushIncLooped" parameterID="4"></layer>
                        </cell>
                        <cell>
                                <layer type="display"></layer>
                        </cell>
                        <cell>
                                <layer type="LED" ledStyle="singleDot" parameterID="17">
                                        <titleDisplay>
                                                <name>Sync Note +</name>
                                                <name>Note</name>
                                        </titleDisplay>
                                </layer>
                                <!--this is the switch for sync to tempo on /off-->
                                <layer type="switch" switchStyle="pushIncLooped" parameterID="16"></layer>
                        </cell>
                        <cell>
                                <layer type="knob" parameterID="1">
                                        <titleDisplay>
                                                <name>Rate</name>
                                        </titleDisplay>
                                </layer>
                        </cell>
                </page>
        </representation>
</vstXML>

Member Function Documentation

getXmlRepresentationStream()

virtual tresult PLUGIN_API Steinberg::Vst::IXmlRepresentationController::getXmlRepresentationStream ( RepresentationInfo & info, IBStream * stream )

pure virtual

Retrieves a stream containing a XmlRepresentation for a wanted representation info

Member Data Documentation

iid

const FUID Steinberg::Vst::IXmlRepresentationController::iid

static

---

The documentation for this class was generated from the following file:

• /home/runner/work/lmms-fork/lmms-fork/plugins/CarlaBase/carla/source/includes/vst3sdk/pluginterfaces/vst/ivstrepresentation.h