Jamba C++ API
4.3.0
|
This class can be used to extend VSTGUI classes directly while still benefiting from the extensions added by Jamba. More...
#include <CustomView.h>
Inherits TView, ParamAware, and ICustomViewLifecycle.
Inherited by StateAwareCustomViewAdapter< TView, TGUIState >.
Classes | |
class | Creator |
Defines and registers the attributes exposed in the VSTGUI Editor and XML file (.uidesc ) for CustomViewAdapter . More... | |
Public Types | |
using | creator_super_type = TCustomViewCreator< CustomViewAdapter > |
Public Member Functions | |
void | afterApplyAttributes () override |
Handles the lifecycle behavior getting triggered once all the attributes have been set (which usually happens after the XML file (uidesc) has been read/processed, or when you modify attributes in the VSTGUI Editor). More... | |
template<typename... Args> | |
CustomViewAdapter (const CRect &iSize, Args &&...args) | |
TagID | getCustomViewTag () const |
The tag associated to this custom view. More... | |
bool | getEditorMode () const |
A flag whose purpose is to render/log information during development when the flag is set to true . More... | |
void | markDirty () |
Marks this view dirty which will (at the appropriate time in the rendering lifecycle) trigger a call to draw() More... | |
void | onParameterChange (ParamID iParamID) override |
Callback when a parameter changes. More... | |
void | setCustomViewTag (TagID iTag) |
void | setEditorMode (bool iEditorMode) |
Public Member Functions inherited from ParamAware | |
virtual void | initState (GUIState *iGUIState) |
Called during initialization. More... | |
void | invokeAll () |
Invoke all (currently) registered callbacks and onParameterChange() (if registered). More... | |
IGUIParam | registerBaseCallback (ParamID iParamID, Parameters::ChangeCallback iChangeCallback, bool iInvokeCallback) |
Registers a callback for the "base" param for the most generic use case. More... | |
IGUIParam | registerBaseCallback (ParamID iParamID, Parameters::ChangeCallback1< IGUIParam > iChangeCallback, bool iInvokeCallback) |
Registers a callback for the "base" param for the most generic use case. More... | |
IGUIParam | registerBaseParam (ParamID iParamID, bool iSubscribeToChanges=true) |
Registers the "base" param for the most generic use case but as a result is fairly limited and mainly gives access to the string representation of the param. More... | |
GUIRawVstParam | registerCallback (RawVstParam const &iParamDef, Parameters::ChangeCallback iChangeCallback, bool iInvokeCallback=false) |
Registers a raw parameter (no conversion). More... | |
GUIRawVstParam | registerCallback (RawVstParam const &iParamDef, Parameters::ChangeCallback1< GUIRawVstParam > iChangeCallback, bool iInvokeCallback=false) |
Registers a raw parameter (no conversion). More... | |
template<typename T > | |
GUIVstParam< T > | registerCallback (VstParam< T > const &iParamDef, Parameters::ChangeCallback iChangeCallback, bool iInvokeCallback=false) |
Convenient call to register a callback for the Vst param simply by using its description (accessible in state-aware views via fParams->fMyParam ). More... | |
template<typename T > | |
GUIVstParam< T > | registerCallback (VstParam< T > const &iParamDef, Parameters::ChangeCallback1< GUIVstParam< T >> iChangeCallback, bool iInvokeCallback=false) |
Convenient call to register a callback for the Vst param simply by using its description (accessible in state-aware views via fParams->fMyParam ). More... | |
template<typename T > | |
GUIJmbParam< T > | registerCallback (JmbParam< T > const &iParamDef, Parameters::ChangeCallback iChangeCallback, bool iInvokeCallback=false) |
Convenient call to register a callback for the Jmb param simply by using its description (accessible in state-aware views via fParams->fMyParam ). More... | |
template<typename T > | |
GUIJmbParam< T > | registerCallback (JmbParam< T > const &iParamDef, Parameters::ChangeCallback1< GUIJmbParam< T >> iChangeCallback, bool iInvokeCallback=false) |
Convenient call to register a callback for the Jmb param simply by using its description (accessible in state-aware views via fParams->fMyParam ). More... | |
template<typename T > | |
GUIJmbParam< T > | registerCallback (GUIJmbParam< T > &iParam, Parameters::ChangeCallback iChangeCallback, bool iInvokeCallback=false) |
Convenient call to register a callback for the Jmb param simply by using the param from the state (accessible in state-aware views via fState->fMyParam ). More... | |
template<typename T > | |
GUIJmbParam< T > | registerCallback (GUIJmbParam< T > &iParam, Parameters::ChangeCallback1< GUIJmbParam< T >> iChangeCallback, bool iInvokeCallback=false) |
Convenient call to register a callback for the Jmb param simply by using the param from the state (accessible in state-aware views via fState->fMyParam ). More... | |
template<typename T > | |
GUIJmbParam< T > | registerJmbCallback (ParamID iParamID, Parameters::ChangeCallback iChangeCallback, bool iInvokeCallback=false) |
Registers a callback for the Jmb param by its id and return the wrapper to the param. More... | |
template<typename T > | |
GUIJmbParam< T > | registerJmbCallback (ParamID iParamID, Parameters::ChangeCallback1< GUIJmbParam< T >> iChangeCallback, bool iInvokeCallback=false) |
Registers a callback for the Jmb param by its id and return the wrapper to the param. More... | |
template<typename T > | |
GUIJmbParam< T > | registerJmbParam (ParamID iParamID, bool iSubscribeToChanges=true) |
Registers the Jmb param by its id and return the wrapper to the param. More... | |
template<typename T > | |
GUIOptionalParam< T > | registerOptionalCallback (ParamID iParamID, Parameters::ChangeCallback iChangeCallback, bool iInvokeCallback=false) |
Registers an optional parameter which handles Vst, Jmb or no parameter at all. More... | |
template<typename T > | |
GUIOptionalParam< T > | registerOptionalCallback (ParamID iParamID, Parameters::ChangeCallback1< GUIOptionalParam< T >> iChangeCallback, bool iInvokeCallback=false) |
Registers an optional parameter which handles Vst, Jmb or no parameter at all. More... | |
GUIOptionalParam< int32 > | registerOptionalDiscreteCallback (ParamID iParamID, int32 iStepCount, Parameters::ChangeCallback iChangeCallback, bool iInvokeCallback=false) |
Registers an optional discrete parameter which handles Vst, Jmb or no parameter at all. More... | |
GUIOptionalParam< int32 > | registerOptionalDiscreteCallback (ParamID iParamID, int32 iStepCount, Parameters::ChangeCallback1< GUIOptionalParam< int32 >> iChangeCallback, bool iInvokeCallback=false) |
Registers an optional discrete parameter which handles Vst, Jmb or no parameter at all. More... | |
GUIOptionalParam< int32 > | registerOptionalDiscreteParam (ParamID iParamID, int32 iStepCount, bool iSubscribeToChanges=true) |
Registers an optional discrete parameter which handles Vst, Jmb or no parameter at all. More... | |
template<typename T > | |
GUIOptionalParam< T > | registerOptionalParam (ParamID iParamID, bool iSubscribeToChanges=true) |
Registers an optional parameter which handles Vst, Jmb or no parameter at all. More... | |
GUIRawVstParam | registerParam (RawVstParam const &iParamDef, bool iSubscribeToChanges=true) |
Registers a raw parameter (no conversion). More... | |
template<typename T > | |
GUIVstParam< T > | registerParam (VstParam< T > const &iParamDef, bool iSubscribeToChanges=true) |
Convenient call to register a Vst param simply by using its description (accessible in state-aware views via fParams->fMyParam ). More... | |
template<typename T > | |
GUIJmbParam< T > | registerParam (JmbParam< T > const &iParamDef, bool iSubscribeToChanges=true) |
Convenient call to register a Jmb param simply by using its description (accessible in state-aware views via fParams->fMyParam ). More... | |
template<typename T > | |
GUIJmbParam< T > | registerParam (GUIJmbParam< T > &iParam, bool iSubscribeToChanges=true) |
Convenient call to register a Jmb param simply by using the param from the state (accessible in state-aware views via fState->fMyParam ). More... | |
virtual void | registerParameters () |
Subclasses should override this method to register each parameter. More... | |
GUIRawVstParam | registerRawVstCallback (ParamID iParamID, Parameters::ChangeCallback iChangeCallback, bool iInvokeCallback=false) |
Registers a raw parameter (no conversion) The callback will be invoked when the parameter changes. More... | |
GUIRawVstParam | registerRawVstCallback (ParamID iParamID, Parameters::ChangeCallback1< GUIRawVstParam > iChangeCallback, bool iInvokeCallback=false) |
Registers a raw parameter (no conversion) The callback will be invoked when the parameter changes. More... | |
GUIRawVstParam | registerRawVstParam (ParamID iParamID, bool iSubscribeToChanges=true) |
Registers a raw parameter (no conversion) onParameterChange() will be called on changes (if iSubscribeToChanges is set to true ). More... | |
GUIVstParam< bool > | registerVstBooleanParam (ParamID iParamID, bool iSubscribeToChanges=true) |
template<typename T > | |
GUIVstParam< T > | registerVstCallback (ParamID iParamID, Parameters::ChangeCallback iChangeCallback, bool iInvokeCallback=false) |
Register a callback for a Vst parameter simply given its id The callback will be invoked when the parameter changes. More... | |
template<typename T > | |
GUIVstParam< T > | registerVstCallback (ParamID iParamID, Parameters::ChangeCallback1< GUIVstParam< T >> iChangeCallback, bool iInvokeCallback=false) |
Register a callback for a Vst parameter simply given its id The callback will be invoked when the parameter changes. More... | |
template<typename T > | |
GUIVstParam< T > | registerVstParam (ParamID iParamID, bool iSubscribeToChanges=true) |
Register a Vst parameter simply given its id onParameterChange() will be called on changes (if iSubscribeToChanges is set to true ). More... | |
GUIVstParam< Percent > | registerVstPercentParam (ParamID iParamID, bool iSubscribeToChanges=true) |
void | unregisterAll () |
Unregisters all parameters. More... | |
bool | unregisterParam (ParamID iParamID) |
Removes the registration of the provided param (closing the connection/stopping to listen) More... | |
GUIRawVstParam | unregisterParam (GUIRawVstParam const &iParam) |
Removes the registration of the provided param (closing the connection/stopping to listen) More... | |
template<typename T > | |
GUIVstParam< T > | unregisterParam (GUIVstParam< T > const &iParam) |
Removes the registration of the provided param (closing the connection/stopping to listen) More... | |
template<typename T > | |
GUIJmbParam< T > | unregisterParam (GUIJmbParam< T > const &iParam) |
Removes the registration of the provided param (closing the connection/stopping to listen) More... | |
virtual | ~ParamAware () |
Protected Attributes | |
TagID | fTag |
Protected Attributes inherited from ParamAware | |
std::unique_ptr< GUIParamCxMgr > | fParamCxMgr {} |
This class can be used to extend VSTGUI classes directly while still benefiting from the extensions added by Jamba.
CustomView
extends CView
to create a completely custom class. If, on the other end, you simply want to extend another class from VSTGUI (ex: CTextEdit
), you can use this class which implements most of the behavior from CustomView
.
In addition to the attributes exposed by TView
, this class exposes the following attributes:
Attribute | Description |
---|---|
custom-view-tag | The tag associated to this custom view. This tag (which is not related to a parameter), is optional and can be used to differentiate between views when implementing a custom controller. // Example CView *SampleEditController::verifyView(CView *iView, const UIAttributes &iAttributes, const IUIDescription *iDescription) { auto button = dynamic_cast<Views::TextButtonView *>(iView); if(button) { switch(button->getCustomViewTag()) { case ESampleSplitterParamID::kNormalize0Action: initButton(button, SampleDataAction::Type::kNormalize0, false); break; // .... } } } |
editor-mode | A flag whose purpose is to render/log information during development when the flag is set to // Example void SampleEditView::draw(CDrawContext *iContext) { // ... #if EDITOR_MODE if(getEditorMode()) { rdc.debug("SampleRange: [%.3f,%.3f] | PixelRange: [%.3f,%.3f] | Visible: [%.3f,%.3f] | BPM: %f", fState->fWESelectedSampleRange->fFrom, fState->fWESelectedSampleRange->fTo, fSelectedPixelRange.fFrom, fSelectedPixelRange.fTo, fVisibleSampleRange.fFrom, fVisibleSampleRange.fTo, fHostInfo->fTempo); } #endif }
|
TView | the view class (for ex: CTextEdit ) |
CustomView
for more details on the various methods to override CustomViewCreator
for more details on how to make sure the attributes from TView
are properly exposed
|
inlineexplicit |
|
inlineoverridevirtual |
Handles the lifecycle behavior getting triggered once all the attributes have been set (which usually happens after the XML file (uidesc) has been read/processed, or when you modify attributes in the VSTGUI Editor).
Reimplemented from ICustomViewLifecycle.
|
inline |
The tag associated to this custom view.
This tag (which is not related to a parameter), is optional and can be used to differentiate between views when implementing a custom controller.
|
inline |
A flag whose purpose is to render/log information during development when the flag is set to true
.
It can be flipped directly in the VSTGUI Editor without having to recompile the code.
getEditorMode()
always returns false
in release build mode, it is recommended to enclose such code in an #if / #endif
block as shown in the example.
|
inline |
Marks this view dirty which will (at the appropriate time in the rendering lifecycle) trigger a call to draw()
draw()
yourself but instead call this method which will invoke draw()
at the appropriate time (for example, calling markDirty()
3 times will not invoke draw()
3 times...).
|
inlineoverridevirtual |
Callback when a parameter changes.
By default simply marks the view as dirty. This method is intended to be overriden to implement specific behavior.
Reimplemented from ParamAware.
|
inline |
|
inline |
|
protected |