It's a complete and utter mess. I added the dirty presets to it.
https://docs.krita.org/Loading_and_Saving_Brushes#The_Brush_Settings_Editor
Okay, here's an outline, help out by picking a section and add the text section as a comment, when adding images, use the new brush editor as a reference:
-----------------------
Loading and Saving Brushes
==========================
In the real world, when painting or drawing, you don't just use one tool. You use pencils, erasers, paintbrushes, different types of paint, inks, crayons, etcetera. All these have different ways of making marks.
In a digital program like Krita you have something similar. We call this a brush engine. And much like how cars have different engines that give different feels when driving, or how pencils make distinctly different marks than rollerbal pens, different brush engines have totally different feels.
The brush engines have a lot of different settings as well. So, you can save those settings into presets.
Unlike Photoshop, Krita makes a difference between brush-tips and brush-presets. Tips are only a stamp of sorts, while the preset uses a tip and many other settings to create the full brush.
The Brush settings dropdown
------------------------------------------------
To start, the Brush Settings Editor panel can be accessed in the toolbar, between the Blending Modes button on the right and the Patterns button on the left. Alternately, you can use the function key <keycap>f5</keycap> to open it.
When you open Brush Settings Editor panel you will see something like this:
### Tour of the brush settings dropdown
{F5709930}
The brush settings drop down is divided into six areas,
#### Section A - General Information
This contains the **Preset Icon**, **Live Brush Preview**, the **Preset Name**, the **Engine** name, and several buttons for saving, renaming, and reloading.
Krita's brush settings are stored into the metadata of a 200x200 png(The KPP file), where the image in the png file becomes the preset icon. The icon is used everywhere in Krita, and is useful for differentiating brushes in ways that the live preview cannot.
The live preview shows a stroke of the current brush as a little s-curve wiggle, with the pressure being non-existant on the left, and increasing to full pressure as it goes to the right. The live preview can thus show the effect of the Pressure, Drawing Angle, Distance, Fade and Fuzzy Dab sensors, but none of the others. For some brush engines it cannot show anything. For the color smudge, filter brush and clone tool, it shows a alternating line pattern because these brush engines use the pixels already on canvas to change their effect.
After the preset name, there's a button for **renaming** the brush. This will save the brush as a new brush and blacklist the previous name.
##### Engine
The engine of a brush is the underlying programming that generates the stroke from a brush. What that means is that different brush engines have different options and different results. You can see this as the difference between using crayons, pencils and inks, but because computers are maths devices, most of our brush engines produce different things in a more mathematical way.
For most artists the mathematical nature doesn't matter as much as the different textures and marks each brush engine, and each brush engine has it's own distinct flavor and use, and can be further customized by modifying the options.
##### Reloading
If you change a preset, an icon will appear behind the engine name. This is the reload button. You can use it to revert to the original brush settings.
##### Saving a preset.
On the right, there's **Save New Preset** and **Overwrite Preset**.
; Overwrite Preset
: This will only enable if there's any changes. Pressing this will override the current preset with the new settings, keeping the name and the icon intact. It will always make a timestamped back up in the resources folder.
; Save New Preset
: Will take the current preset and all it's changes and save it as a new preset. If no change was made, you will be making a copy of the current preset.
Save new preset will call up the following window, with a mini scratch pad, and all sorts of options to change the preset icon:
{F5710042}
The image on the left is a mini scratchpad, you can draw on it with the current brush, allowing small modifications on the fly.
; Brush Name
: The Name of your brush. This is also used for the KPP file. If there's already a brush with that name, it will effectively overwrite it.
; Load Existing Thumbnail
: This will load the existing thumbnail inside the preset.
; Load scratch pad thumbnail
: This will load the dashed area from the big scratch pad(Section C) into the thumbnail area.
; Load Image
: With this you can choose an image from disk to load as a thumbnail.
; Load from Icon Library
: This opens up the icon library.
; Clear Thumbnail
: This will make the mini scratch pad white.
##### The Icon Library
To make making presets icons faster, we added a icon library to Krita
{F5710048}
It allows you to select tool icons, and an optional small emblem. When you press OK it will load the resulting combination into the mini scratch pad and you can draw in the stroke.
If you go to your resources folder(Settings → Manage Resources → Open Resource Folder), there's a folder there called "preset_icons", and in this folder there's "tool_icons" and "emblem_icons". You can add semi-transparent pngs here and Krita will load those into the icon library as well so you can customise your icons even more!
At the top right of the icon library, there's three sliders. They allow you to adjust the tool icon. The top two are the same Hue and Saturation as in HSL adjustment, ad the lowest slider is a super simple levels filter. This is done this way because the levels filter allows maintaining the darkest shadows and brightest highlights on a tool icon, making it much better for quick adjustments.
If you're done with everything, you can press save in the Save New Preset dialog and Krita will save the new brush.
#### Section B - The Preset Chooser
The preset chooser is much the same like the preset docker and the preset dropdown on <kbd>F6</kbd>. It's unique in that it allows you to filter by engine and this is also where you can create brushes for an engine from scratch.
The top dropdown is set to "all" by default, which means it shows all engines. It then shows a tag section where you can select the tags, the preset list and the search bar.
Underneath that there's a plus icon, which when pressed gives you the full list of Krita's engines. Selecting an engine from the list will load a new empty preset for that engine into the settings.
The trashcan icon does the same as it does in the preset docker: Delete, or rather, blacklist a preset so it won't show up in the list.
#### Section C - The Scratch pad
When you tweak your brushes, you want to be able to check what each setting does. That's why, to the right of the settings drop down, there is a scratch pad.
When saving a new preset, you can choose to get the icon from the scratch pad, this will load the dash area into the mini scratch pad of the Save New Preset dialog.
The scratc hpad has four buttons underneath it. These are in order for: showing the current brush image, adding a gradient to the scratch pad(useful for smudge brushes), filling with the background color, and finally deleting everything on the scratch pad.
#### Section D - The Options List
The options, as stated above, are different per brush engine. These represent the different parameters, toggles and knobs that you can turn to make a brush preset unique. For a couple of options, the main things to change are sliders and checkboxes, but for a lot of them, they use curves instead.
Some options can be toggled, as noted by the little checkboxes next to them, but others, like flow and opacity are so fundamental to how the brush works, that they are always on.
The little padlock icon next to the options is for locking the brush. This has its own page.
#### Section E - Option Configuration Widget
Where section D is the list of options, section E is the widget where you can change things.
##### Using sensor curves
One of the big important things that makes art unique to the artist who created it is the style of the strokes. Strokes are different because they differ in speed, rotation, direction, and the amount of pressure put onto the stylus. Because these are so important, we would want to customise how these values are understood in detail. The best way to do this is to use curves.
!!NEEDSMORE!!
#### Section F - Miscelaneous options
Temporarily Save Tweaks to Preset (Dirty Presets)
: This enables dirty presets. Dirty presets store the tweaks you make as long as this session of Krita is active. After that, the revert to default. Dirtied presets can be recognized by the icon in the top-left of the preset.
Eraser Switch Size
:This switches the brush to a separately stored size when using the eraser(E) key.
Eraser Switch Opacity
: Same as above, but then with Eraser opacity.
Instant Preview
: This allows you to toggle instant preview on the brush. The Instant Preview has a super-secret feature: when you press the instant preview label, and then right click it, it will show a threshold slider. This slider determines at what brush size instant preview is activated for the brush. This is useful because small brushes can be slower with instant preview, so the threshold ensures it only activates when necessary.
###The On-canvas brush settings
Making a Brush Preset
-------------------------------------
### Getting a default for the brush engine.
### Example: Making an inking brush
### Saving the new Brush
### Painting the preset icon.
Making a Brush Tip
-------------------------------
Maybe link to the brush-tip resources page here and have that deal with importing/stamps/animated brushes?
Sharing Brushes
---------------------------
Okay, so you've made a new brush and want to share it. There's several ways to share a brush preset.
First, go to
### Sharing a single KPP file
#### Exporting the file.
#### Importing a single KPP file.
### Sharing via ZIP(old fashioned)
#### Creating a ZIP file with the relevant files.
#### Using a ZIP with the relevant files.
### Making a resource bundle
#### Making a resource bundle within Krita
#### Editing a resource bundle within Krita
#### Importing a resource bundle into Krita