January 23rd, 2014, 9:00 pm
'Since the release of the next version of LMMS is getting near, I thought it'd be nice to post some guidelines on porting themes from 0.4.15 to the new LMMS.
This covers the most important things, some things may still be added but probably not too many, I'll update this text if needed.
=======================
Stylesheet
----------
Namechanges:
trackContainerView -> TrackContainerView
Additions - OpulenZ plugin knob style:
This is needed for the new instrument. You can leave it as is or modify the knob line colour, like on other instruments.
Additions - sfxr plugin knob style:
Same as above.
The default stylesheet now also contains separate colours for the sfxr knobs. Your theme will work without these, but the knobs will not look as nice. Copy-paste them from the default theme CSS if you want them preserved.
Additions - Palette block:
Notes: each line must begin with "palette:", with no leading whitespace, and the next word must be written right next to it - no space after the colon (:). The color value **MUST** be of the form #RRGGBB, no rgb(x,y,z) or rgba(x,y,z,a), no #RGB. I know this is a bit clunky and hacky, but that's how it is right now and at least it lets you modify colours.
Omitting the palette block will not break the theme, but instead the default colours will be used for things - so you'll probably want to add it in and modify the colour values to make them fit your theme.
The "brighttext" colour is used on the FX mixer to highlight the text of the active channel, and on those blinky things on the instrument tracks that blink in time with the notes.
"button" is used as the base colour for buttons, although you can override this with CSS so it's not all that useful. "buttontext" is the same.
"highlight" and "highlightedtext" - like it says on the tin. Again, these can be overridden with CSS - but not everywhere, I think... so better set them just in case.
"windowtext" is an important one: it is used for the lines on the default knobs (not ones on instruments), both the large and small ones. So you can now style your knobs better!
Look at the new stylesheet for hints on how to do some more cool things, such as modifying scrollbars, or that neat (if I say so myself) popping-up effect of the text boxes.
Addition - pattern colours:
This covers the most important things, some things may still be added but probably not too many, I'll update this text if needed.
=======================
Stylesheet
----------
Namechanges:
trackContainerView -> TrackContainerView
Additions - OpulenZ plugin knob style:
[code]
\topl2instrumentView knob {
\t\tcolor: rgb(128,128,128);
\t\tqproperty-outerColor: rgb(255,255,255);
\t\tqproperty-innerRadius: 2;
\t\tqproperty-outerRadius: 9;
\t\tqproperty-lineWidth: 2;
\t}
[/code] This is needed for the new instrument. You can leave it as is or modify the knob line colour, like on other instruments.
Additions - sfxr plugin knob style:
[code]sfxrInstrumentView knob {
color: #b06319;
qproperty-outerColor: rgb(194, 177, 145);
qproperty-innerRadius: 2;
qproperty-outerRadius: 10;
qproperty-lineWidth: 2;
}[/code] Same as above.
The default stylesheet now also contains separate colours for the sfxr knobs. Your theme will work without these, but the knobs will not look as nice. Copy-paste them from the default theme CSS if you want them preserved.
Additions - Palette block:
[code]
\tpalette:background {color: #5b6571}
\tpalette:windowtext {color: #f0f0f0}
\tpalette:base {color: #808080}
\tpalette:text {color: #e0e0e0}
\tpalette:button {color: #c9c9c9}
\tpalette:shadow {color: #000000}
\tpalette:buttontext {color: #000000}
\tpalette:brighttext {color: #4afd85}
\tpalette:highlight {color: #202020}
\tpalette:highlightedtext {color: #ffffff}
[/code] Notes: each line must begin with "palette:", with no leading whitespace, and the next word must be written right next to it - no space after the colon (:). The color value **MUST** be of the form #RRGGBB, no rgb(x,y,z) or rgba(x,y,z,a), no #RGB. I know this is a bit clunky and hacky, but that's how it is right now and at least it lets you modify colours.
Omitting the palette block will not break the theme, but instead the default colours will be used for things - so you'll probably want to add it in and modify the colour values to make them fit your theme.
The "brighttext" colour is used on the FX mixer to highlight the text of the active channel, and on those blinky things on the instrument tracks that blink in time with the notes.
"button" is used as the base colour for buttons, although you can override this with CSS so it's not all that useful. "buttontext" is the same.
"highlight" and "highlightedtext" - like it says on the tin. Again, these can be overridden with CSS - but not everywhere, I think... so better set them just in case.
"windowtext" is an important one: it is used for the lines on the default knobs (not ones on instruments), both the large and small ones. So you can now style your knobs better!
Look at the new stylesheet for hints on how to do some more cool things, such as modifying scrollbars, or that neat (if I say so myself) popping-up effect of the text boxes.
Addition - pattern colours:
[code]
