diff options
| author | Florian Jung <flo@windfisch.org> | 2013-09-18 22:40:48 +0200 |
|---|---|---|
| committer | Florian Jung <flo@windfisch.org> | 2013-09-18 22:40:48 +0200 |
| commit | 32589cdd760755d685a76d31469798fde74ad827 (patch) | |
| tree | d50afd9a2a176846dd6c5b19d734ed9108e44aad /README.ladspaguis | |
| parent | af09b4f881888b97903cda57907cda571be83b18 (diff) | |
| parent | 48a93993cfce160fb7d4cf0b67b4b77e22db19e5 (diff) | |
Merge branch 'master' into audiomsg_overhaul
Diffstat (limited to 'README.ladspaguis')
| -rw-r--r-- | README.ladspaguis | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/README.ladspaguis b/README.ladspaguis new file mode 100644 index 00000000..c1b168ff --- /dev/null +++ b/README.ladspaguis @@ -0,0 +1,56 @@ +MusE can create LADSPA GUI's (graphical user interfaces) from +Qt designer *.ui files at runtime. +This allows a user to create or modify customized LADSPA guis without +recompiling MusE. + +====================== + Installation +===================== + +Copy the file muse/widgets/musewidgetsplugin.so into a directory were +Qt (designer) can find it. + +Example: + if you installed Qt in /usr/qt3: + su -c "cp -af musewidgetsplugin.so /usr/qt3/plugins/designer" +Check: + After starting the Qt designer you see all MusE specific widgets + under Tools/MusE. If you cannot find any MusE widgets, designer + did not find the file "musewidgetsplugin.so". + +====================== + Environment +====================== + +Naming: + The Qt designer files are named after the LADSPA plugin ID. + Example: the "freeverb" plugin has the id "1050". A gui for + freeverb has to be named "1050.ui". + The plugin ID is shown in the MusE plugin browser. + +Path: + MusE looks for *ui files at (museglobalshare)/plugins/. + If you installed MusE at "/usr" (configured with --prefix=/usr) + MusE looks at "/usr/share/muse/plugins" for *ui files. + +====================== + Creating *.ui file +====================== + +The association between LADSPA plugin parameters and Qt-Widgets is +done by name. All input widgets which manipulate a LADSPA parameter +must have a name starting with the letter "P" followed by the parameter +index. + Example: + A "Slider" widget which manipulates the 3th parameter of a + plugin has the name "P3slider". + +Supported Widgets: + "Slider" slider for float values + "DoubleLabel" entry for float values + "QCheckbox" to manipulate a on/off LADSPA parameter + "QComboBox" select from a list of named values; sets + integer LADSPA values + +(for more hints please look at the example *.ui files) + |