PARAM_TEXT
Page is not ready
This article contains information from the official Blue Cat Audio KUIML reference that was not yet verified and edited.
Passive element (does not respond to mouse or keyboard) that displays a parameter as formatted text. It is like a Attributes Common to Text Widgets widget except that the string to display is generated from the parameter attributes.
Attributes brief detailed show all inherited
See Attributes Common to Text Widgets.
Specific Attributes
Examples
Most examples of the Attributes Common to Text Widgets chapter are applicable here. Only specific features of the param text widget are shown here.
-
Display the value and unit of the parameter, the value having a fixed number of characters: note that we used a fixed size font so that the overall text size does not change when the value changes:
- <?xml version="1.0" encoding="utf-8" ?>
- <SKIN language_version="1.0" background_color="#000000" font_face="Lucida Console" text_color="#ffffff"
- font_quality="cleartype" font_height="12" h_margin="2" v_margin="10">
- <PARAM_TEXT param_id="dsp.input1" content="{value} {unit}" value_format="+03.0" />
- </SKIN>
-
To replace the 0 padding with blank space, we just remove the '0' in value_format.
- <?xml version="1.0" encoding="utf-8" ?>
- <SKIN language_version="1.0" background_color="#000000" font_face="Lucida Console" text_color="#ffffff"
- font_quality="cleartype" font_height="12" h_margin="2" v_margin="10">
- <PARAM_TEXT param_id="dsp.input1" content="{value} {unit}" value_format="+3.0" />
- </SKIN>
-
Here is an example where the positive values do not show the + sign, but a blank instead (replace the '+' with ' '):
- <?xml version="1.0" encoding="utf-8" ?>
- <SKIN language_version="1.0" background_color="#000000" font_face="Lucida Console" text_color="#ffffff"
- font_quality="cleartype" font_height="12" h_margin="2" v_margin="10">
- <PARAM_TEXT param_id="dsp.input1" content="{value} {unit}" value_format=" 3.0" />
- </SKIN>
-
In order to see one digit, we replace '.0' at the end of the value_format string with '.1', and replace 3 with 5 since now we will need 5 characters instead of 3 (one for the '.' and one for the digit):
- <?xml version="1.0" encoding="utf-8" ?>
- <SKIN language_version="1.0" background_color="#000000" font_face="Lucida Console" text_color="#ffffff"
- font_quality="cleartype" font_height="12" h_margin="2" v_margin="10">
- <PARAM_TEXT param_id="dsp.input1" content="{value} {unit}" value_format=" 5.1" />
- </SKIN>