linuxsampler 2.3.1
|
Device Parameter 'ACTIVE'. More...
#include <AudioOutputDevice.h>
Public Member Functions | |
ParameterActive () | |
ParameterActive (String s) | |
virtual String | Description () OVERRIDE |
A human readable description, explaining the exact purpose of the driver parameter. | |
virtual bool | Fix () OVERRIDE |
Whether the parameter is read only. | |
virtual bool | Mandatory () OVERRIDE |
Whether the parameter must be supplied by the user at device creation time. | |
virtual std::map< String, DeviceCreationParameter * > | DependsAsParameters () OVERRIDE |
Might return a unique key-value pair list (map) reflecting the dependencies of this parameter to other parameters. | |
virtual optional< bool > | DefaultAsBool (std::map< String, String > Parameters) OVERRIDE |
virtual void | OnSetValue (bool b) OVERRIDE throw (Exception) |
virtual String | Type () OVERRIDE |
Some name reflecting the parameter's value type, like "BOOL,
"INT", "FLOAT", "STRING", "STRINGS". | |
virtual bool | Multiplicity () OVERRIDE |
Whether the parameter only allows to set one scalar value, or if true is returned here, the parameter allows to manage a list of values instead. | |
virtual optional< String > | Default (std::map< String, String > Parameters) OVERRIDE |
Might return a default value for this parameter. | |
virtual optional< String > | Default () |
Might return a default value for this parameter. | |
virtual optional< String > | RangeMin (std::map< String, String > Parameters) OVERRIDE |
Might return a minimum value for this parameter. | |
virtual optional< String > | RangeMin () |
Might return a minimum value for this parameter. | |
virtual optional< String > | RangeMax (std::map< String, String > Parameters) OVERRIDE |
Might return a maximum value for this parameter. | |
virtual optional< String > | RangeMax () |
Might return a maximum value for this parameter. | |
virtual optional< String > | Possibilities (std::map< String, String > Parameters) OVERRIDE |
Might return a comma separated list as String with possible values for this parameter. | |
virtual optional< String > | Possibilities () |
Might return a comma separated list as String with possible values for this parameter. | |
virtual String | Value () OVERRIDE |
The current value of this parameter (encoded as String). | |
virtual void | SetValue (String val) OVERRIDE throw (Exception) |
Alter the parameter with the value given by val. | |
virtual void | SetValue (bool b) throw (Exception) |
virtual bool | ValueAsBool () |
virtual optional< String > | Depends () |
Might return a comma separated list of parameter names this parameter depends on. | |
void | Attach (Device *pDevice) |
Sets the internal device pointer to a specific device (driver instance) for this parameter object. | |
Static Public Member Functions | |
static String | Name () |
Protected Member Functions | |
void | InitWithDefault () |
Protected Attributes | |
bool | bVal |
Device * | pDevice |
Device Parameter 'ACTIVE'.
Used to activate / deactivate the audio output device.
Definition at line 64 of file AudioOutputDevice.h.
LinuxSampler::AudioOutputDevice::ParameterActive::ParameterActive | ( | ) |
LinuxSampler::AudioOutputDevice::ParameterActive::ParameterActive | ( | String | s | ) |
Sets the internal device pointer to a specific device (driver instance) for this parameter object.
Descendants usually use that internal pointer to interact with their specific driver implementation class.
Definition at line 751 of file DeviceParameter.h.
Might return a default value for this parameter.
The default value will be used if the user does not provide a specific value for this parameter at device creation time. If the parameter does not have a reasonable default value, it will return optional<String>::nothing
.
This method already provides an implementation, which usually is not overridden by descendants. A descendant would rather implement the other Default() method taking arguments.
|
virtualinherited |
Might return a default value for this parameter.
The default value will be used if the user does not provide a specific value for this parameter at device creation time.
This method must be implemented by descendants. If the parameter does not have a reasonable default value, it should return optional<String>::nothing
.
As arguments, the parameters are passed to this method automatically, which the user already provided. For example a parameter "CARD" the user already did set for selecting a specific sound card. So such arguments resolve dependencies of this parameter.
Parameters | - other parameters which the user already supplied |
Implements LinuxSampler::DeviceCreationParameter.
|
virtual |
Implements LinuxSampler::DeviceCreationParameterBool.
Might return a comma separated list of parameter names this parameter depends on.
See this class's introduction about a discussion of parameters with dependencies. If this method returns optional<String>::nothing
, then it does not have any dependencies to other parameters.
This method already provides an implementation, which usually is not overridden by descendants. A descendant would rather implement DependsAsParameters() instead.
|
virtual |
Might return a unique key-value pair list (map) reflecting the dependencies of this parameter to other parameters.
Each entry in the map consists of a key-value pair, the key being the parameter name of the respective dependent parameter, and the value being an instance of the dependency parameter of that name.
A descendant MUST implement this method, informing about its dependencies. If the parameter does not have any dependencies it should return an empty map.
See this class's introduction about a discussion of parameters with dependencies.
Implements LinuxSampler::DeviceCreationParameter.
A human readable description, explaining the exact purpose of the driver parameter.
The text returned here can be used to display the user in a GUI frontend some helping text, that explains what the parameter actually does.
Implements LinuxSampler::DeviceRuntimeParameter.
Whether the parameter is read only.
Not to be confused with "creation" parameters! A driver parameter which returns true here can never be set or altered at any time. Not even at instanciation time of the driver! A typical example would be a parameter "SAMPLERATE" for a specific sound card, where the specific sound card does not allow to switch the sound card's sample rate in any way. Yet the value returned by the parameter (read only) might be different, depending on the actual sound card the user selected with the audio driver.
Implements LinuxSampler::DeviceRuntimeParameter.
|
protectedinherited |
Whether the parameter must be supplied by the user at device creation time.
If this method return false
, then the parameter is optional
Implements LinuxSampler::DeviceCreationParameter.
Whether the parameter only allows to set one scalar value, or if true
is returned here, the parameter allows to manage a list of values instead.
A typical example of multiplicity parameter is i.e. a "ROUTING" parameter, that would allow a user to interconnect the sampler with other apps and devices with drivers that support such concepts (like JACK and ALSA MIDI do).
Implements LinuxSampler::DeviceRuntimeParameter.
|
virtual |
Implements LinuxSampler::DeviceCreationParameterBool.
|
virtualinherited |
Might return a comma separated list as String with possible values for this parameter.
If the parameter does not have reasonable, specific possible values, it will return optional<String>::nothing
.
This method already provides an implementation, which usually is not overridden by descendants. A descendant would rather implement the other Possibilities() method taking arguments.
Implements LinuxSampler::DeviceRuntimeParameter.
|
virtualinherited |
Might return a comma separated list as String with possible values for this parameter.
This method must be implemented by descendants. If the parameter does not have reasonable, specific possible values, it should return optional<String>::nothing
.
As arguments, the parameters are passed to this method automatically, which the user already provided. For example a parameter "CARD" the user already did set for selecting a specific sound card. So such arguments resolve dependencies of this parameter.
Parameters | - other parameters which the user already supplied |
Implements LinuxSampler::DeviceCreationParameter.
Might return a maximum value for this parameter.
If the parameter does not have a reasonable maximum value, it will return optional<String>::nothing
.
This method already provides an implementation, which usually is not overridden by descendants. A descendant would rather implement the other RangeMax() method taking arguments.
Implements LinuxSampler::DeviceRuntimeParameter.
|
virtualinherited |
Might return a maximum value for this parameter.
This method must be implemented by descendants. If the parameter does not have a reasonable maximum value, it should return optional<String>::nothing
.
As arguments, the parameters are passed to this method automatically, which the user already provided. For example a parameter "CARD" the user already did set for selecting a specific sound card. So such arguments resolve dependencies of this parameter.
Parameters | - other parameters which the user already supplied |
Implements LinuxSampler::DeviceCreationParameter.
Might return a minimum value for this parameter.
If the parameter does not have a reasonable minimum value, it will return optional<String>::nothing
.
This method already provides an implementation, which usually is not overridden by descendants. A descendant would rather implement the other RangeMin() method taking arguments.
Implements LinuxSampler::DeviceRuntimeParameter.
|
virtualinherited |
Might return a minimum value for this parameter.
This method must be implemented by descendants. If the parameter does not have a reasonable minimum value, it should return optional<String>::nothing
.
As arguments, the parameters are passed to this method automatically, which the user already provided. For example a parameter "CARD" the user already did set for selecting a specific sound card. So such arguments resolve dependencies of this parameter.
Parameters | - other parameters which the user already supplied |
Implements LinuxSampler::DeviceCreationParameter.
|
virtualinherited |
|
virtualinherited |
Alter the parameter with the value given by val.
The respective deriving parameter class automatically parses the String value supplied here, and converts it into its native value type like int, float or String vector ("Strings").
- | new parameter value encoded as string |
Exception | - if val is out of bounds, not encoded correctly in its string representation or any other reason the driver might not want to accept the given value. |
Implements LinuxSampler::DeviceRuntimeParameter.
Some name reflecting the parameter's value type, like "BOOL, "INT", "FLOAT", "STRING", "STRINGS".
Upon the value returned here, the object can be casted to the respective implementing parameter class.
Implements LinuxSampler::DeviceRuntimeParameter.
The current value of this parameter (encoded as String).
You might want to cast to the respective deriving parameter class like DeviceRuntimeParameterInt and use its method ValueAsInt() for not being forced to parse the String here.
Implements LinuxSampler::DeviceRuntimeParameter.
|
protectedinherited |
Definition at line 787 of file DeviceParameter.h.
|
protectedinherited |
Definition at line 753 of file DeviceParameter.h.