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.
It is by default collapsed, so you will need to press the arrow at the top left of the brush engine to show it.
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.
It is by default collapsed, so you will have to press the arrow at the top right of the brush settings to show it.
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 scratch pad has five buttons underneath it. These are in order for:
The scratc hpad has four buttons underneath it1. showing the current brush image
2. These arCopying the current image in orderto the scratchpad(useful for: showing the current smudge and filter brush image,es)
3. adding a gradient to the scratch pad(useful for smudge brushes),
4. filling with the background color,
5. and finally deletingclearing 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.
Curves show up with the size widget for example. With an inking brush, we want to have size mapped to pressure. Just toggling the size option in the option list will do that.
However, different people have different wrists and thus will press differently on their stylus. Someone who presses softly tends to find it easy to make thin strokes, but very difficult to make thick strokes. Conversely, someone who presses hard on their stylus naturally will have a hard time making thin strokes, but easily makes thick ones.
Such a situation can be improve by using the curves to map pressure to output thinner lines or thicker ones.
The brush settings curves even have quick curve buttons for these at the top. Someone who has a hard time making small strokes should try the second to last concave button, while someone who has a hard time making thick strokes should try the third button, the S shape.
Underneath the curve widget there's two more options:
; Share Curves across all settings
: This is for the list of sensors. Toggling this will make all the sensors use the same curve. Untoggled, all toggled sensors will have seperate curves.
; Curves Calculation Mode
: This indicates how the multiple values of the sensor curves are used. The curves always go from 0 to 1.0, so if one curve outputs 0.5 and the other 0.7, then...
:; Multiply
:: will mutiply the two values, 0.5*0.7 = 0.35
:; Addition
:: will add the the two to a maximum of 1.0, so 0.5+0.7 = 1.2, which is then capped at 1.0.
:; Maximum
:: Will compare the two and pick the largest. So in the case of 0.5 and 0.7, the result is 0.7.
:; Minimum
:: Will compare the two and pick the smallest. So in the case of 0.5 and 0.7, the result is 0.5.
:; Difference
:: Will subtract the smallest value from the largest, so 0.7-0.5 = 0.2
It's maybe better to see with the following example:
{F5710633}
1. Is a brush with size set to the distance sensor.
2. Is a brush with the size set to the fade sensor.
These are fairly similar sensors. Now, if we combine the two, the calculation mode will give different results:
!!NEEDSMORE!!3. The size is calculated from the fade and distance sensors multiplied.
4. The size is calculated from the fade and distance sensors added to each other. Notice how thick it is.
5. The size takes the maximum value from the values of the fade and distance sensors.
6. The size takes the minimum value from the values of the face and distance sensors.
7. The size is calculated by having the largest of the values subtracted with the smallest of the values.
#### 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