diff --git a/images/en/Interface-tour.png b/images/en/Interface-tour.png
deleted file mode 100644
index fb6fd9a79..000000000
Binary files a/images/en/Interface-tour.png and /dev/null differ
diff --git a/images/en/Interface-tour.svg b/images/en/Interface-tour.svg
new file mode 100644
index 000000000..7e8a93811
--- /dev/null
+++ b/images/en/Interface-tour.svg
@@ -0,0 +1,265 @@
+
+
+
+
diff --git a/images/en/Krita-popuppalette.png b/images/en/Krita-popuppalette.png
index 781e4aca7..7c0ab3d37 100644
Binary files a/images/en/Krita-popuppalette.png and b/images/en/Krita-popuppalette.png differ
diff --git a/images/en/popup-palette-detail.svg b/images/en/popup-palette-detail.svg
new file mode 100644
index 000000000..a9a2ccb33
--- /dev/null
+++ b/images/en/popup-palette-detail.svg
@@ -0,0 +1,388 @@
+
+
+
+
diff --git a/images/en/workspace-chooser-button.svg b/images/en/workspace-chooser-button.svg
new file mode 100644
index 000000000..1d6e98318
--- /dev/null
+++ b/images/en/workspace-chooser-button.svg
@@ -0,0 +1,229 @@
+
+
+
+
diff --git a/reference_manual/popup-palette.rst b/reference_manual/popup-palette.rst
new file mode 100644
index 000000000..75dd11450
--- /dev/null
+++ b/reference_manual/popup-palette.rst
@@ -0,0 +1,32 @@
+.. meta::
+ :description:
+ The Pop-up Palette in Krita
+
+.. metadata-placeholder
+
+ :authors: - Raghavendra Kamath
+ :license: GNU free documentation license 1.3 or later.
+
+.. index:: Pop-up Palette
+.. _pop-up_palette:
+
+Pop-up Palette
+==============
+
+The Pop-up Palette is a feature unique to Krita amongst the digital painting applications. It is designed to increase productivity and save time of the artists by providing quick access to some of the most frequently used tools and features in Krita. The Pop-up palette can be accessed by |mouseright| on the canvas. A circular palette similar to what is shown in the image below will spawn at the position your mouse cursor.
+
+.. image:: /images/en/popup-palette-detail.svg
+
+As shown in the image above, the pop-up palette has the following tools and quick access shortcuts integrated into it
+
+- Foreground Color Indicator and Background color Indicators on the top right of the palette.
+- A canvas rotation slider, which can help the artist quickly rotate the canvas while painting.
+- A group of brush presets, based on the tag selected by the artist. By default the **My Favorite** tag is selected. By default only first 10 presets from the tag are shown, however you can change the number of brush presets shown by changing the value in the :ref:`Miscellaneous Settings Section ` of the dialog box.
+- Color Selector with which you can select the hue from the circular ring and lightness and saturation from the triangular area in the middle.
+- Color history area shows the most recent color swatches that you have used while painting.
+- The tag list for brush preset will show you the list of both and default tags to choose from, selecting a tag from this list will show the corresponding brush presets in the palette.
+- The common brush options such as size, opacity, angle et cetera will be shown when you click the **>** icon. A dialog box will appear which will have the sliders to adjust the brush options. You can choose which options are shown in this dialog box by clicking on the settings icon.
+- The zoom slider allows you to quickly zoom the canvas.
+- The 100% button sets the zoom to the 100% of the image size
+- The button with the canvas icon switches to the canvas only mode, where the toolbar and dockers are hidden.
+- The button with the mirror icon mirrors the canvas to help you spot the errors in the painting.
diff --git a/reference_manual/preferences/general_settings.rst b/reference_manual/preferences/general_settings.rst
index 24a9a8cbc..29c35fb02 100644
--- a/reference_manual/preferences/general_settings.rst
+++ b/reference_manual/preferences/general_settings.rst
@@ -1,260 +1,260 @@
.. meta::
:description:
General Preferences in Krita.
.. metadata-placeholder
:authors: - Wolthera van Hövell tot Westerflier
- Scott Petrovic
- Greig
:license: GNU free documentation license 1.3 or later.
.. index:: Preferences, Settings, Cursor, Autosave, Tabbed Documents, Subwindow Documents, Pop up palette, File Dialog, Maximum Brush Size, Kinetic Scrolling, Sessions
.. _general_settings:
================
General Settings
================
You can access the General Category of the preferences by first going to :menuselection:`Settings --> Configure Krita`.
.. image:: /images/en/Krita_Preferences_General.png
Cursor Settings
---------------
Customize the drawing cursor here:
Cursor Shape
~~~~~~~~~~~~
Select a cursor shape to use while the brush tools are used. This cursor will always be visible on the canvas. It is usually set to a type exactly where your pen nib is at. The available cursor types are shown below.
Tool Icon
Shows the currently selected tool icon, even for the freehand brush.
-
+
.. image:: /images/en/Settings_cursor_tool_icon.png
Arrow
Shows a generic cursor.
-
+
.. image:: /images/en/Settings_cursor_arrow.png
Crosshair
Shows a precision reticule.
.. image:: /images/en/Settings_cursor_crosshair.png
Small circle
Shows a small white dot with a black outline.
.. image:: /images/en/Settings_cursor_small_circle.png
No Cursor
Show no cursor, useful for tablet-monitors.
.. image:: /images/en/Settings_cursor_no_cursor.png
Triangle Right-Handed.
Gives a small white triangle with a black border.
.. image:: /images/en/Settings_cursor_triangle_righthanded.png
Triangle Left-Handed.
Same as above but mirrored.
.. image:: /images/en/Settings_cursor_triangle_lefthanded.png
Black Pixel
Gives a single black pixel.
.. image:: /images/en/Settings_cursor_black_pixel.png
White Pixel
Gives a single white pixel.
.. image:: /images/en/Settings_cursor_white_pixel.png
Outline Shape
~~~~~~~~~~~~~
Select an outline shape to use while the brush tools are used. This cursor shape will optionally show in the middle of a painting stroke as well. The available outline shape types are shown below.(pictures will come soon)
No Outline
No outline.
Circle Outline
Gives a circular outline approximating the brush size.
Preview Outline
Gives an outline based on the actual shape of the brush.
Tilt Outline
Gives a circular outline with a tilt-indicator.
While Painting...
~~~~~~~~~~~~~~~~~
Show Outline
This option when selected will show the brush outline while a stroke is being made. If unchecked the brush outline will not appear during stroke making, it will show up only after the brush stroke is finished. This option works only when Brush Outline is selected as the Cursor Shape.
.. versionchanged:: 4.1
Used to be called "Show Outline When Painting"
Use effective outline size
.. versionadded:: 4.1
This makes sure that the outline size will always be the maximum possible brush diameter, and not the current one as affected by sensors such as pressure. This makes the cursor a little less noisy to use.
-
+
Cursor Color:
The default cursor color. This is mixed with the canvas image so that it will usually have a contrasting color, but sometimes this mixing does not work. This is usually due driver problems. When that happens, you can configure a more pleasant color here.
.. _window_settings:
Window Settings
---------------
Multiple Document Mode
This can be either tabbed like :program:`GIMP` or :program:`Painttool Sai`, or subwindows, like :program:`Photoshop`.
Background image
Allows you to set a picture background for subwindow mode.
Window Background
Set the color of the subwindow canvas area.
Don't show contents when moving sub-windows
This gives an outline when moving windows to work around ugly glitches with certain graphics-cards.
Show on-canvas popup messages
Whether or not you want to see the on-canvas pop-up messages that tell you whether you are in tabbed mode, rotating the canvas, or mirroring it.
Enable Hi-DPI support
Attempt to use the Hi-DPI support. It is an option because we are still experiencing bugs on windows.
Allow only one instance of Krita
An instance is a single entry in your system's task manager. Turning this option makes sure that Krita will check if there's an instance of Krita open already when you instruct it to open new documents, and then have your documents opened in that single instance. There's some obscure uses to allowing multiple instances, but if you can't think of any, just keep this option on.
.. _tool_options_settings:
Tools Settings
--------------
In docker (default)
Gives you the tool options in a docker.
In toolbar
Gives you the tool options in the toolbar, next to the brush settings. You can open it with :kbd:`\\`.
-
+
Brush Flow Mode
In Krita 4.2 the behaviour of flow in combination with opacity was changed. This allows you to turn it back to the 4.1 behaviour. This will however be removed in future versions.
Switch Control/Alt Selection Modifiers
This switches the function of the :kbd:`Ctrl` and :kbd:`Alt` buttons when modifying selections. Useful for those used to Gimp instead of Photoshop, or Lefties without a right-:kbd:`Alt` key on their keyboard.
Enable Touchpainting
This allows finger painting with capacitive screens. Some devices have both capacitive touch and a stylus, and then this can interfere. In that case, just toggle this.
.. versionadded:: 4.2
Activate transform tool after pasting.
A convenience feature. When enabling this, the transform tool will activate after pasting for quick moving or rotating.
Kinetic Scrolling (Needs Restart)
This enables kinetic scrolling for scrollable areas.
.. figure:: /images/en/Krita_4_0_kinetic_scrolling.gif
:align: center
Kinetic scrolling on the brush chooser drop-down with activation mode set to :guilabel:`On Click Drag`, with this disabled all of these clicks would lead to a brush being selected regardless of drag motion.
Activation
How it is activated.
On Middle-Click Drag
Will activate when using the middle mouse button.
On Touch Drag
Will activate if it can recognize a touch event. May not always work.
On Click Drag
Will activate when it can recognize a click event, will always work.
Sensitivity
How quickly the feature activates, this effective determines the length of the drag.
Hide Scrollbar
Whether to show scrollbars when doing this.
.. _file_handling_settings:
File Handling
-------------
.. versionadded:: 4.2
Enable Autosaving
Determines whether or not Krita should periodically autosave.
Autosave Every
Here the user can specify how often Krita should autosave the file, you can tick the checkbox to turn it off. For Windows these files are saved in the %TEMP% directory. If you are on Linux it is stored in /home/'username'.
Unnamed autosave files are hidden by default
This determines whether the filename of autosaves has a period prepended to the name. On Linux and Mac OS this is a technique to ensure the file is hidden by default.
Create Backup File
When selected Krita will, upon save, rename the original file as a backup file and save the current image to the original name. The result is that you will have saved the image, and there will be a copy of the image that is saved seperately as a backup. This is useful in case of crashes during saves.
Backup File Location
The default location these backups should be stored.
Same Folder as Original File
Store the file in the same folder as the original file was stored.
User Folder
This is the main folder of your computer. On Linux and Mac OS this is the 'Home' folder, on Windows, the 'My Documents Folder'.
Temporary File Folder
This stored the file in the temp folder. Temp folders are special folders of which the contents are emptied when you shut down your computer. If you don't particularly care about your backup files and want them to be 'cleaned' automatically, this is the best place. If you want your backup files to be kept indefinitely, this is a wrong choice.
Backup File Suffix
The suffix that will be placed after the full filename. 'filename.kra' will then be saved as 'filename.kra~', ensuring the files won't show up in Krita's open file dialog.
Number of Backup Files Kept
Number of backup files Krita keeps, by default this is only one, but this can be up to 99. Krita will then number the backup files.
Compress \*.kra files more.
This increases the zip compression on the saved Krita files, which makes them lighter on disk, but this takes longer to load.
Use Zip64
Kra files are zip files. Zip64 allows you to use
.. _misc_settings:
Miscellaneous
-------------
When Krita starts
This is the option for handling user sessions. It has the following options:
Open Default Window
This opens the regular empty window with the last used workspace.
Load Previous Session
Load the last opened session. If you have :guilabel:`Save session when Krita closes` toggled, this becomes the last files you had open and the like.
Show Session Manager
Show the session manager directly so you can pick a session.
.. versionadded:: 4.1
Save session when Krita closes
Save the current open windows, documents and the like into the current session when closing Krita so you can resume where you left off.
.. versionadded:: 4.1
Upon importing Images as Layers, convert to the image color space.
This makes sure that layers are the same color space as the image, necessary for saving to PSD.
Undo Stack Size
This is the number of undo commands Krita remembers. You can set the value to 0 for unlimited undos.
Favorite Presets
This determines the amount of presets that can be used in the pop-up palette.
Hide splash screen on startup.
This'll hide the splash screen automatically once Krita is fully loaded.
.. deprecated:: 4.1
Deprecated because Krita now has a welcome widget when no canvas is open.
Enable Native File Dialog
This allows you to use the system file dialog. By default turned off because we cannot seem to get native file dialogues 100% bugfree.
Maximum brush size
This allows you to set the maximum brush size to a size of up to 10.000 pixels. Do be careful with using this, as a 10.000 pixel size can very quickly be a full gigabyte of data being manipulated, per dab. In other words, this might be slow.
Recalculate animation cache in background.
Krita will recalculate the cache when you're not doing anything.
.. versionchanged:: 4.1
This is now in the :ref:`performance_settings` under :guilabel:`Animation Cache`.
diff --git a/user_manual/getting_started/navigation.rst b/user_manual/getting_started/navigation.rst
index c8a96da15..264570030 100644
--- a/user_manual/getting_started/navigation.rst
+++ b/user_manual/getting_started/navigation.rst
@@ -1,113 +1,115 @@
.. meta::
:description:
Overview of Krita navigation.
.. metadata-placeholder
:authors: - Scott Petrovic
- Wolthera van Hövell tot Westerflier
- Raghavendra Kamath
- Boudewijn Rempt
:license: GNU free documentation license 1.3 or later.
.. index:: Navigation, Zoom, Rotate, Pan, Workspace, Pop-up Palette
.. _navigation:
==========
Navigation
==========
Interface
---------
-Krita provides an ample choice for the artists to arrange the workspace. An artist can snap and arrange the elements of the workspace, much like snapping together Lego blocks. Krita provides a set of construction kit parts in the form of Dockers and Toolbars. Every set of elements can be shown, hidden, moved and rearranged that let the artists easily customize their own user interface experience.
+Krita's interface is very flexible and provides an ample choice for the artists to arrange the elements of the workspace. An artist can snap and arrange the elements, much like snapping together Lego blocks. Krita provides a set of construction kit parts in the form of Dockers and Toolbars. Every set of elements can be shown, hidden, moved and rearranged that let the artists easily customize their own user interface experience.
A Tour of the Krita Interface
-----------------------------
-As we've said before, the Krita interface is very malleable and the way that you choose to configure the work surface may not resemble those above but, at least we can use these as a starting point.
+As we've said before, the Krita interface is very malleable and the way that you choose to configure the work surface may not resemble those shown below, but we can use these as a starting point.
-.. image:: /images/en/Interface-tour.png
+.. image:: /images/en/Interface-tour.svg
:width: 1000
:align: center
- **A** -- Traditional :guilabel:`File` or action menu found in most windowed applications.
- **B** -- Toolbar - This is where you can choose your brushes, set parameters such as opacity and size and other settings.
-- **C** -- Sidebars for the Movable Panels/Dockers. In some applications, these are known as Dockable areas. Krita also allows you to dock panels at the top and/or bottom as well.
-- **D** -- Status Bar - This space shows you preferred mode for showing selection i.e. marching ants or mask mode, your selected brush preset, :ref:`Color Space `, image size and provides a convenient zoom control.
-- **E** -- Floating Panel/Docker - These can be "popped" in and out of their docks at any time in order to see a greater range of options. A good example of this would be the :ref:`brush_preset_docker` or the :ref:`palette_docker`.
+- **C** -- Sidebars for the Movable Panels/Dockers. In some applications, these are known as Dockable areas. Krita also allows you to dock panels at the top and/or bottom as well.
+- **D** -- Status Bar - This space shows the preferred mode for showing selection i.e. marching ants or mask mode, your selected brush preset, :ref:`Color Space `, image size and provides a convenient zoom control.
+- **E** -- Floating Panel/Docker - These can be "popped" in and out of their docks at any time in order to see a greater range of options. A good example of this would be the :ref:`brush_preset_docker` or the :ref:`palette_docker`.
-Your canvas sits in the middle and unlike traditional paper or even most digital painting apps, Krita provides the artist with a scrolling canvas of infinite size (not that you'll need it of course!). The standard navigation tools are as follows:
+Your canvas sits in the middle and unlike traditional paper or even most digital painting applications, Krita provides the artist with a scrolling canvas of infinite size (not that you'll need it of course!). The standard navigation tools are as follows:
Navigation
----------
Many of the canvas navigation actions, like rotation, mirroring and zooming have default keys attached to them:
Panning
This can be done through |mousemiddle|, :kbd:`Space +` |mouseleft| and :kbd:`the directional keys`.
Zooming
Discrete zooming can be done through :kbd:`+`, and :kbd:`-`. Using :kbd:`Ctrl + Space` or :kbd:`Ctrl +` |mousemiddle| can allow for direct zooming with the stylus.
Mirroring
- You can mirror the view can be quickly done via :kbd:`M` key. Mirroring is a great technique that seasoned digital artists use to quickly review the composition of their work to ensure that it "reads" well, even when flipped horizontally.
+ You can mirror the view can be quickly done via :kbd:`M` key. Mirroring is a great technique that seasoned digital artists use to quickly review the composition of their work to ensure that it "reads" well, even when flipped horizontally.
Rotating
You can rotate the canvas without transforming. It can be done with :kbd:`Ctrl + [` or :kbd:`4` and the other way with :kbd:`Ctrl + ]` or :kbd:`6`. Quick mouse based rotation is :kbd:`Shift + Space` and :kbd:`Shift +` |mousemiddle|. To reset rotation use :kbd:`5` .
You can also find these under :menuselection:`View --> Canvas`.
Dockers
-------
-Krita subdivides many of its options into functional panels called Dockers (aka Docks).
+Krita subdivides many of its options into functional panels called Dockers (also known as Docks).
-Dockers are small windows that can contain, for example, things like the layer stack, Color Palette or Brush Presets. Think of them as the painter's palette, or his water, or his brushkit. They can be activated by choosing the :guilabel:`Settings` menu and the :guilabel:`Dockers` sub-menu. There you will find a long list of available options.
+Dockers are small windows that can contain, for example, things like the layer stack, Color Palette or list of Brush Presets. Think of them as the painter's palette, or his water, or his brush kit. They can be activated by choosing the :guilabel:`Settings` menu and the :guilabel:`Dockers` sub-menu. There you will find a long list of available options.
Dockers can be removed by clicking the **x** in the upper-right of the docker-window.
-Dockers, as the name implied, can be docked into the main interface. You can do this by dragging the docker to the sides of the canvas (or top or bottom if you prefer).
+Dockers, as the name implies, can be docked into the main interface. You can do this by dragging the docker to the sides of the canvas (or top or bottom if you prefer).
Dockers contain many of the "hidden", and powerful, aspects of **Krita** that you will want to explore as you start delving deeper into the application.
You can arrange the dockers in almost any permutation and combination according to the needs of your workflow, and then save these arrangements as Workspaces.
Dockers can be prevented from docking by pressing :kbd:`Ctrl` before starting to drag the docker.
Sliders
-------
Krita uses these to control values like brush size, opacity, flow, Hue, Saturation, etc... Below is an example of a Krita slider.
.. image:: /images/en/Krita_Opacity_Slider.png
-The total range is represented from left to right and blue bar gives an indication of where in the possible range the current value is. Clicking anywhere, left or right, of that slider will change the current number to something lower (to the left) or higher (to the right).
+The total range is represented from left to right and blue bar gives an indication of where in the possible range the current value is. Clicking anywhere, left or right, of that slider will change the current number to something lower (to the left) or higher (to the right).
To input a specific number, |mouseright| the slider. A number can now be entered directly for even greater precision.
Pressing :kbd:`Shift` while dragging the slider changes the values at a smaller increment, and pressing :kbd:`Ctrl` while dragging the slider changes the value in whole numbers or multiples of 5.
Toolbars
--------
.. image:: /images/en/Krita_Toolbar.png
-Toolbars are where some of the important actions and menus are placed so that they are readily and quickly available for the artist while painting.
+Toolbars are where some of the important actions and menus are placed so that they are readily and quickly available for the artist while painting.
You can learn more about the Krita Toolbars and how to configure them in over in the :ref:`Toolbars section ` of the manual.
Putting these to effective use can really speed up the Artist's workflow, especially for users of Tablet-Monitors and Tablet-PCs.
Workspace Chooser
~~~~~~~~~~~~~~~~~
-The button on the very right of the toolbar is the workspace chooser. This allows you to load and save common configurations of the user interface in Krita. There are a few common workspaces that come with Krita.
+The button on the very right of the Toolbar is the workspace chooser. This allows you to load and save common configurations of the user interface in Krita. There are a few common workspaces that come with Krita.
+
+.. image:: /images/en/workspace-chooser-button.svg
Pop-up Palette
--------------
.. image:: /images/en/Krita-popuppalette.png
:align: center
-Pop-up Palette is a unique feature in Krita designed to increase productivity of the artist. It is a circular menu for quickly choosing brushes, foreground and background colors, recent colors while painting. To access the palette you have to just |mouseright| on the canvas. The palette will spawn at the place of the brush tip or cursor.
+:ref:`Pop-up Palette ` is a feature unique to Krita, designed to increase the productivity of the artist. It is a circular menu for quickly choosing brushes, foreground and background colors, recent colors while painting. To access the palette you have to just |mouseright| on the canvas. The palette will spawn at the position of the brush tip or cursor.
-By tagging your brush presets you can add particular sets of brushes to this palette. For example, if you add some inking brush presets to inking tag you can change the tags to inking in the pop-up palette and you'll get all the inking brushes in the palette.
+By tagging your brush presets you can add particular sets of brushes to this palette. For example, if you add some inking brush presets to inking tag you can change the tags to inking in the pop-up palette and you'll get all the inking brushes in the palette.
-You can :ref:`tag ` brush presets via the :ref:`brush_preset_docker`, check out the resource overview page to know more about tagging in general.
+You can :ref:`tag ` brush presets via the :ref:`brush_preset_docker`, check out the :ref:`resource overview page ` to know more about tagging in general.
-If you call up the pop-up palette again, you can click the wrench icon, and select the tag. In fact, you can make multiple tags and switch between them.
-When you need more than ten presets, go into :menuselection:`Settings --> Configure Krita --> General --> Favorite presets` and change the number of presets from 10 to something you feel comfortable.
+If you call up the pop-up palette again, you can click the tag icon, and select the tag. In fact, you can make multiple tags and switch between them.
+When you need more than ten presets, go into :menuselection:`Settings --> Configure Krita --> General --> Miscellaneous --> Number of Palette Presets` and change the number of presets from 10 to something you feel comfortable.