Jamba C++ API 8.0.0
Loading...
Searching...
No Matches
GUIOptionalParam.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2019 pongasoft
3 *
4 * Licensed under the Apache License, Version 2.0 or the MIT license,
5 * at your option. You may not use this file except in compliance with
6 * one of these licenses. You may obtain copies of the licenses at:
7 *
8 * https://www.apache.org/licenses/LICENSE-2.0
9 * https://opensource.org/licenses/MIT
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
13 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
14 * License for the specific language governing permissions and limitations under
15 * the License.
16 *
17 * @author Yan Pujante
18 */
19#pragma once
20
21#include <pluginterfaces/vst/vsttypes.h>
22#include <pongasoft/logging/logging.h>
24#include "IGUIParameter.h"
25#include "GUIValParameter.h"
26
28
29using namespace Steinberg::Vst;
30
46template<std::semiregular T>
47class GUIOptionalParam: public Utils::Operators::Dereferenceable<GUIOptionalParam<T>>
48{
49public:
51 using ParamType = T;
53 using Editor = std::unique_ptr<EditorType>;
54
55public:
60 class Value {
61 public:
62 constexpr T const *operator ->() const { return &fValue; }
63 friend class GUIOptionalParam;
64 private:
65 explicit Value(T const &iValue) : fValue{iValue} {}
67 };
68
69public:
70 // Constructor
73
74 // Constructor
75 explicit GUIOptionalParam(T const &iDefaultValue) :
76 fParameter{VstUtils::make_sfo<GUIValParameter<T>>(UNDEFINED_PARAM_ID, iDefaultValue)} {}
77
78 // Constructor
79 explicit GUIOptionalParam(std::shared_ptr<ITGUIParameter<T>> iParameter) : fParameter{std::move(iParameter) } {
80 DCHECK_F(fParameter != nullptr);
81 }
82
85 bool exists() const { return true; }
86
89 ParamID getParamID() const { return fParameter->getParamID(); }
90
95 {
96 ParamType res;
97 fParameter->accessValue([&res](auto const &iValue) { res = iValue; });
98 return res;
99 }
100
102 ParamType value() const { return getValue(); }
103
106 bool update(ParamType const &iValue)
107 {
108 return fParameter->update(iValue);
109 }
110
113 tresult setValue(ParamType const &iValue)
114 {
115 return fParameter->setValue(iValue);
116 }
117
120 tresult resetToDefault() { return fParameter->resetToDefault(); }
121
124 std::unique_ptr<EditorType> edit()
125 {
126 return fParameter->edit();
127 }
128
131 std::unique_ptr<EditorType> edit(ParamType const &iValue)
132 {
133 return fParameter->edit(iValue);
134 }
135
138 int32 getStepCount() const { return fParameter->getStepCount(); }
139
141 constexpr ParamType operator *() const { return getValue(); }
142
144 constexpr Value operator ->() const { return Value{getValue()}; }
145
148 GUIOptionalParam &operator=(T const &iValue) { update(iValue); return *this; }
149
152 std::string toUTF8String(int32 iPrecision) const { return fParameter->toUTF8String(iPrecision); }
153
156 std::unique_ptr<FObjectCx> connect(Parameters::IChangeListener *iChangeListener) const
157 {
158 return fParameter->connect(iChangeListener);
159 }
160
163 std::unique_ptr<FObjectCx> connect(Parameters::ChangeCallback iChangeCallback) const
164 {
165 return fParameter->connect(iChangeCallback);
166 }
167
168private:
169 std::shared_ptr<ITGUIParameter<ParamType>> fParameter;
170};
171
172
173template<typename T>
174using GUIOptionalParamEditor = std::unique_ptr<typename GUIOptionalParam<T>::EditorType>;
175
178
179}
Implements all the various equality and relational operators for the type T which is assumed to encap...
Definition Operators.h:56
constexpr T const * operator->() const
Definition GUIOptionalParam.h:62
Value(T const &iValue)
Definition GUIOptionalParam.h:65
T fValue
Definition GUIOptionalParam.h:66
friend class GUIOptionalParam
Definition GUIOptionalParam.h:63
Represents an optional parameter (Jmb, Vst or no param at all).
Definition GUIOptionalParam.h:48
GUIOptionalParam class_type
Definition GUIOptionalParam.h:50
ITGUIParameter< T >::ITEditor EditorType
Definition GUIOptionalParam.h:52
std::unique_ptr< EditorType > edit()
Creates an editor to modify the parameter in a transactional fashion.
Definition GUIOptionalParam.h:124
int32 getStepCount() const
When a parameter is a discrete parameter (which means its underlying backing type is an int32 with va...
Definition GUIOptionalParam.h:138
std::unique_ptr< EditorType > edit(ParamType const &iValue)
Shortcut api which creates an editor followed by ITEditor::setValue(ParamType const &) to set the par...
Definition GUIOptionalParam.h:131
constexpr ParamType operator*() const
allow writing *param to access the underlying value (or in other words, *param is the same param....
Definition GUIOptionalParam.h:141
GUIOptionalParam(T const &iDefaultValue)
Definition GUIOptionalParam.h:75
std::string toUTF8String(int32 iPrecision) const
Returns the current value of the parameter as a string (which is properly UTF-8 encoded).
Definition GUIOptionalParam.h:152
ParamID getParamID() const
Each parameter has a unique ID returned by this method.
Definition GUIOptionalParam.h:89
ParamType value() const
Synonym to getValue().
Definition GUIOptionalParam.h:102
std::unique_ptr< FObjectCx > connect(Parameters::ChangeCallback iChangeCallback) const
Creates a connection between this parameter and the callback: whenever the parameter changes,...
Definition GUIOptionalParam.h:163
GUIOptionalParam()
Definition GUIOptionalParam.h:71
bool exists() const
Always return true because by definition an optional parameter always exists.
Definition GUIOptionalParam.h:85
std::unique_ptr< FObjectCx > connect(Parameters::IChangeListener *iChangeListener) const
Creates a connection between this parameter and the change listener: whenever the parameter changes,...
Definition GUIOptionalParam.h:156
bool update(ParamType const &iValue)
First check if the value provided (iValue) is different from the current value and if that is the cas...
Definition GUIOptionalParam.h:106
GUIOptionalParam(std::shared_ptr< ITGUIParameter< T > > iParameter)
Definition GUIOptionalParam.h:79
ParamType getValue() const
Definition GUIOptionalParam.h:94
tresult setValue(ParamType const &iValue)
Unconditionally sets the value of the parameter to the value provided.
Definition GUIOptionalParam.h:113
std::shared_ptr< ITGUIParameter< ParamType > > fParameter
Definition GUIOptionalParam.h:169
T ParamType
Definition GUIOptionalParam.h:51
constexpr Value operator->() const
allow writing param->x to access the underlying value when T is a struct or class
Definition GUIOptionalParam.h:144
tresult resetToDefault()
Resets the param to its default value.
Definition GUIOptionalParam.h:120
std::unique_ptr< EditorType > Editor
Definition GUIOptionalParam.h:53
GUIOptionalParam & operator=(T const &iValue)
Allow to write param = 3 instead of param.update(3) for example.
Definition GUIOptionalParam.h:148
This parameter is not tied to any parameter definition/registration and is primarily used by the opti...
Definition GUIValParameter.h:39
Defines the API for the editor, which can be obtained by calling ITGUIParameter::edit().
Definition IGUIParameter.h:241
Represents a gui parameter with its underlying backing type T (aka ParamType).
Definition IGUIParameter.h:175
Interface to implement to receive parameter changes.
Definition Parameters.h:47
std::function< void()> ChangeCallback
A callback that will be invoked for changes.
Definition Parameters.h:61
Definition GUIState.h:40
std::unique_ptr< typename GUIOptionalParam< T >::EditorType > GUIOptionalParamEditor
Definition GUIOptionalParam.h:174
GUIOptionalParam< ParamValue > GUIRawOptionalParam
Definition GUIOptionalParam.h:176
GUIOptionalParamEditor< ParamValue > GUIRawOptionalParamEditor
Definition GUIOptionalParam.h:177
Definition ExpiringDataCache.h:28
constexpr ParamID UNDEFINED_PARAM_ID
Constant used throughout the code to test whether the ParamID represents a valid id or an undefined o...
Definition Types.h:48