diff options
| author | Robert Jonsson <spamatica@gmail.com> | 2010-10-13 19:34:22 +0000 |
|---|---|---|
| committer | Robert Jonsson <spamatica@gmail.com> | 2010-10-13 19:34:22 +0000 |
| commit | 8a2c2824a59d7644e13bc52c9a0ecbd641f21f95 (patch) | |
| tree | 064ad3f2bf8daab0ad27b128abd86a9bbdb1e496 /muse2/README.ladspaguis | |
| parent | a27706d9629e8b592cca4659f865b70adef24e6d (diff) | |
new branch muse2, first checkin
Diffstat (limited to 'muse2/README.ladspaguis')
| -rw-r--r-- | muse2/README.ladspaguis | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/muse2/README.ladspaguis b/muse2/README.ladspaguis new file mode 100644 index 00000000..c1b168ff --- /dev/null +++ b/muse2/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) + |