Palettes: How it should work
The current nightly build has a new feature named "Custom Palettes". The implementation is quite complete and need testing! Several users requested a way to add their own symbol in palettes, to delete some symbol or palette they don't use etc..., the custom palette facility has been developped with these use cases in mind.
Palettes or Palettes panel
The 1.x palettes panel is placed by default at the left side of the screen. The palette panel is undockable and you can relocate it to the other side of the screen. Drag the title bar of the palettes panel to undock and move it. Right click anywhere in the palettes panel and you can activate a single palette mode. Single palette mode will close all the other palette when you open one palette. By default this is deactivated and you can open several palettes at the same time.
A palette is one of the box in the palette panel. By default the first one is the Grace note palette. A palette has a name, located in the title bar. Clicking on the title bar, open and close the palette.
When a palette is open, it contains several cells. A cell is one "box" in the palette. All the cells in a palette have the same dimension. A cell contains an element that you can drag in the score or insert by selecting an element in the score and double click in the palette. A cell can also contain an image in SVG, PNG or JPG. Note that SVG being scalable, it's the best
The Master Palette is accessible from Display -> Master Palette. In this palette, you will find all the symbols built in MuseScore. If you messed up your Palette Panel or you miss a symbol in a default palette, you can get symbols from there.
On Windows, hold click for a second on a palette title bar to access the palette menu.
- You can move a palette up or down, and delete it
- You can also save a palette and load a palette
- You can change the palette name, the dimension of the cells, the scale of the symbol in the cells, if you want the cells to be separated with visible grid,... in Palette properties.
- You can switch on and off edition mode for a palette. If a palette is not in Edition Mode, you can't remove, delete or move content.
You can right click on a given cell to clear it. You can also change the properties of a given cell, name (appears in tooltip), offsets and scale.
Add content to palette cells
You can add content in palette cells from different sources. The palette should be in edition mode.
- From the current score: Use Ctrl + Shift + drag to drag something from a score to a palette cell
- From any palette in the palette panel: Just drag
- From the master palette: Just drag
- From your system file explorer/finder/internet browser, you can drag any image in SVG, PNG, JPG. SVG is the best format since it will scale nicely.
How to create the best possible SVG files to use in palette
- 10 pixels = 1 spatium. Spatium unit is the space between 2 lines of the staff. So if you want a squared symbol of the size of the staff, make it 40x40pixels. (5 lines in staff -> 4 spaces). If you choose to make your symbol non spatium dependent while in the score via the inspector, 10 pixels = 10mm.
- All the content must be inside the viewport of the SVG
- Transparency is supported. Use it for background.
- For quality/resizability no bitmaps should be used. Don't embed bitmaps in an SVG file, it defeats the purpose of using SVG in the first place.
- Qt and thus MuseScore, only supports the static features of SVG 1.2 Tiny. ECMA scripts and DOM manipulation are currently not supported.
Any change in the Palettes Panel is current selected profile. You can have different Palettes Panel by creating several profiles. For example, before making any changes to the Palette Panel, go to Edit -> Profiles -> New Profile, enter a name. Change your palette as you want. To switch to back to the default Palettes Panel, go to Edit -> Profiles -> default
The text above explains how Custom Palettes should work in MuseScore. Go ahead, test it! and report any bug you encounter.