diff --git a/images/tools/selections-elliptical-selection-options.png b/images/tools/selections-elliptical-selection-options.png new file mode 100644 index 000000000..81d2f98e9 Binary files /dev/null and b/images/tools/selections-elliptical-selection-options.png differ diff --git a/images/tools/selections-outline-selection-options.png b/images/tools/selections-outline-selection-options.png new file mode 100644 index 000000000..5be6111d2 Binary files /dev/null and b/images/tools/selections-outline-selection-options.png differ diff --git a/images/tools/selections-polygonal-selection-options.png b/images/tools/selections-polygonal-selection-options.png new file mode 100644 index 000000000..e1f48ac6e Binary files /dev/null and b/images/tools/selections-polygonal-selection-options.png differ diff --git a/images/tools/selections-rectangular-selection-options.png b/images/tools/selections-rectangular-selection-options.png new file mode 100644 index 000000000..9e3cf9e50 Binary files /dev/null and b/images/tools/selections-rectangular-selection-options.png differ diff --git a/images/tools/selections-right-click-menu.png b/images/tools/selections-right-click-menu.png new file mode 100644 index 000000000..9ebd5b3b3 Binary files /dev/null and b/images/tools/selections-right-click-menu.png differ diff --git a/images/tools/selections-similar-color-selection-options.png b/images/tools/selections-similar-color-selection-options.png new file mode 100644 index 000000000..631595ef9 Binary files /dev/null and b/images/tools/selections-similar-color-selection-options.png differ diff --git a/reference_manual/tools/elliptical_select.rst b/reference_manual/tools/elliptical_select.rst index 31b786f5b..ce094c9a6 100644 --- a/reference_manual/tools/elliptical_select.rst +++ b/reference_manual/tools/elliptical_select.rst @@ -1,62 +1,101 @@ .. meta:: :description: Krita's elliptical selector tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic + - Alberto Eleuterio Flores Guerrero :license: GNU free documentation license 1.3 or later. .. index:: Tools, Ellipse, Circle, Elliptical Select, Selection .. _ellipse_selection_tool: ========================= Elliptical Selection Tool ========================= |toolselectellipse| -This tool, represented by an ellipse with a dashed border, allows you to make :ref:`selections_basics` of a elliptical area. Simply click and drag around the section you wish to select. +This tool, represented by an ellipse with a dashed border, allows you to make :ref:`selections_basics` of a elliptical area. Simply |mouseleft| and drag around the section you wish to select. + +.. important:: + + Most of the behavior of the Elliptical Selection Tool is common to all other selection tools, please make sure to read :ref:`selections_basics` to learn more about this tool. Hotkeys and Stickykeys ---------------------- * :kbd:`J` selects this tool. * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. -* :kbd:`Shift` after starting the selection, constraints it to a perfect circle. -* :kbd:`Ctrl` after starting the selection, makes the selection resize from center. -* :kbd:`Alt` after starting the selection, allows you to move it. +* |mouseleft| + :kbd:`Shift` constrains the selection to a perfect circle. (Make sure to press |mouseleft| before :kbd:`Shift`) +* |mouseleft| + :kbd:`Ctrl` makes the selection resize from the center. (Make sure to press |mouseleft| before :kbd:`Ctrl`) +* |mouseleft| + :kbd:`Alt` allows you to move the selection. (Make sure to press |mouseleft| before :kbd:`Alt`) * :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. -* :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. -* :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. -* :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. +* :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. +* :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. +* :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 - * Hovering over a selection allows you to move it. + * Hovering your cursor over the dashed line of the selection, or marching ants as it is commonly called, turns the cursor into the move tool icon, which you |mouseleft| and drag to move the selection. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. -.. note:: +.. image:: /images/tools/selections-right-click-menu.png + :width: 200 + :alt: Menu of elliptical selection - So to subtract a perfect circle, you do :kbd:`Alt +` |mouseleft|, then release the :kbd:`Alt` key while dragging and press :kbd:`Shift` to constrain. +.. hint:: + To subtract a perfect circle, you can follow two different methods: -.. note:: + 1. Press :kbd:`S` to substract then |mouseleft| to select and press :kbd:`Shift` while dragging to constrain to a perfect circle. + + 2. Press :kbd:`Alt +` |mouseleft|, then release the :kbd:`Alt` key while dragging and press :kbd:`Shift` to constrain. + + +.. tip:: - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ +.. image:: /images/tools/selections-elliptical-selection-options.png + :width: 300 + :alt: Elliptical selection options + +Mode + This option is explained in the :ref:`pixel_vector_selection` section. +Action + This option is explained in the :ref:`pixel_vector_selection` section. Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. + +.. note:: + + Anti-aliasing is only available on Pixel Selection Mode. + Width - Gives the current width. Use the lock to force the next selection made to this width. + Shows you the current width while you are creating the selection. You can manually type the value and use the 'Lock Width' for your next selection to have the selected value. +Lock Width + Forces the next selection to have the current width. Height - Gives the current height. Use the lock to force the next selection made to this height. + Shows you the current height while you are creating the selection. You can manually type the value and use the 'Lock Height' for your next selection to have the selected value. +Lock Height + Forces the next selection to have the current height. Ratio - Gives the current ratio. Use the lock to force the next selection made to this ratio. + Shows the ratio between height and width of the selection. Similar to Height, and Width, you can manually type the value and use the 'Lock Ratio' for your next selection to have the selected value. +Lock Ratio + Forces the next selection to have the current ratio. + +.. hint:: + + If you want your selection to be of specific size: + 1. Type the width and height. + 2. Press the Lock Width and Lock Height buttons. + 3. |mouseleft| where you want your selection to be. diff --git a/reference_manual/tools/outline_select.rst b/reference_manual/tools/outline_select.rst index bed2d48cb..d061ee75b 100644 --- a/reference_manual/tools/outline_select.rst +++ b/reference_manual/tools/outline_select.rst @@ -1,48 +1,74 @@ .. meta:: :description: Krita's outline selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Radianart - - Raghavendra Kamath + - Raghavendra Kamath + - Alberto Eleuterio Flores Guerrero :license: GNU free documentation license 1.3 or later. .. index:: Tools, Selection, Freehand, Outline Select .. _outline_selection_tool: ====================== Outline Selection Tool ====================== |toolselectoutline| Make :ref:`selections_basics` by drawing freehand around the canvas. Click and drag to draw a border around the section you wish to select. +.. important:: + + Most of the behavior of the Outline Selection Tool is common to all other selection tools, please make sure to read :ref:`selections_basics` to learn more about this tool. + + Hotkeys and Sticky keys ----------------------- * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. -* :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. -* :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. -* :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. -* :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. +* :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. +* :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. +* :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. +* :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 - * Hovering over a selection allows you to move it. + * Hovering your cursor over the dashed line of the selection, or marching ants as it is commonly called, turns the cursor into the move tool icon, which you |mouseleft| and drag to move the selection. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. -.. note:: +.. image:: /images/tools/selections-right-click-menu.png + :width: 200 + :alt: Menu of outline selection + +.. tip:: + + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in Tool Settings in the :ref:`general_settings` + +.. tip:: + + This tool is not bound to any Hotkey, if you want to define one, go to :menuselection:`Settings --> Configure Krita --> Keyboard Shortcuts` and search for 'Outline Selection Tool', there you can select the shortcut you want. Check :ref:`shortcut_settings` for more info. - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ +.. image:: /images/tools/selections-outline-selection-options.png + :width: 300 + :alt: Outline selection options +Mode + This option is explained in the :ref:`pixel_vector_selection` section. +Action + This option is explained in the :ref:`pixel_vector_selection` section. Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. + +.. note:: + + Anti-aliasing is only available on Pixel Selection Mode. diff --git a/reference_manual/tools/polygonal_select.rst b/reference_manual/tools/polygonal_select.rst index db4d9551e..168b007a4 100644 --- a/reference_manual/tools/polygonal_select.rst +++ b/reference_manual/tools/polygonal_select.rst @@ -1,47 +1,74 @@ .. meta:: :description: Krita's polygonal selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic + - Alberto Eleuterio Flores Guerrero :license: GNU free documentation license 1.3 or later. .. index:: Tools, Polygon, Selection, Polygonal Selection .. _polygonal_selection_tool: ======================== Polygonal Selection Tool ======================== |toolselectpolygon| -This tool, represented by a polygon with a dashed border, allows you to make :ref:`selections_basics` of a polygonal area point by point. Click where you want each point of the Polygon to be. Double click to end your polygon and finalize your selection area. +This tool, represented by a polygon with a dashed border, allows you to make :ref:`selections_basics` in a polygonal shape. To make a polygonal selection |mouseleft| and place points or nodes of the polygon. To finalize your selection area you can do either |mouseleft| on the first created point, or double |mouseleft| click to end the polygon. + +.. important:: + + Most of the behavior of the Polygonal Selection Tool is common to all other selection tools, please make sure to read :ref:`selections_basics` to learn more about this tool. + Hotkeys and Sticky keys ----------------------- * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. -* :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. -* :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. -* :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. -* :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. +* :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. +* :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. +* :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. +* :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 - * Hovering over a selection allows you to move it. + * Hovering your cursor over the dashed line of the selection, or marching ants as it is commonly called, turns the cursor into the move tool icon, which you |mouseleft| and drag to move the selection. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. -.. note:: +.. image:: /images/tools/selections-right-click-menu.png + :width: 200 + :alt: Menu of polygonal selection + +.. tip:: + + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in Tool Settings in the :ref:`general_settings`. + +.. tip:: + + This tool is not bound to any Hotkey, if you want to define one, go to :menuselection:`Settings --> Configure Krita --> Keyboard Shortcuts` and search for 'Polygonal Selection Tool', there you can select the shortcut you want. Check :ref:`shortcut_settings` for more info. - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ +.. image:: /images/tools/selections-polygonal-selection-options.png + :width: 300 + :alt: Polygonal selection options + +Mode + This option is explained in the :ref:`pixel_vector_selection` section. +Action + This option is explained in the :ref:`pixel_vector_selection` section. Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. + +.. note:: + + Anti-aliasing is only available on Pixel Selection Mode. diff --git a/reference_manual/tools/rectangle.rst b/reference_manual/tools/rectangle.rst index d31f60057..a871e4b24 100644 --- a/reference_manual/tools/rectangle.rst +++ b/reference_manual/tools/rectangle.rst @@ -1,70 +1,71 @@ .. meta:: :description: Krita's rectangle tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier + - Alberto Eleuterio Flores Guerrero :license: GNU free documentation license 1.3 or later. .. index:: Tools, Ractangle .. _rectangle_tool: ============== Rectangle Tool ============== |toolrectangle| This tool can be used to paint rectangles, or create rectangle shapes on a vector layer. Click and hold |mouseleft| to indicate one corner of the rectangle, drag to the opposite corner, and release the button. Hotkeys and Sticky-keys ----------------------- There's no default hotkey for switching to rectangle. If you hold :kbd:`Shift` while drawing, a square will be drawn instead of a rectangle. Holding :kbd:`Ctrl` will change the way the rectangle is constructed. Normally, the first mouse click indicates one corner and the second click the opposite. With :kbd:`Ctrl`, the initial mouse position indicates the center of the rectangle, and the final mouse position indicates a corner. You can press :kbd:`Alt` while still keeping |mouseleft| down to move the rectangle to a different location. You can change between the corner/corner and center/corner drawing methods as often as you want by pressing or releasing :kbd:`Ctrl`, provided that you keep |mouseleft| pressed. With :kbd:`Ctrl` pressed, mouse movements will affect all four corners of the rectangle (relative to the center), without :kbd:`Ctrl`, one of the corners is unaffected. Tool Options ------------ Fill ~~~~ Not filled. The rectangle will be transparent from the inside. Foreground color The rectangle will use the foreground color as fill. Background color. The rectangle will use the background color as fill. Pattern The rectangle will use the active pattern as fill. Outline ~~~~~~~ No Outline The Rectangle will render without outline. Brush The Rectangle will use the current selected brush to outline. .. note:: On vector layers, the rectangle will not render with a brush outline, but rather a vector outline. Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. Width Gives the current width. Use the lock to force the next selection made to this width. Height Gives the current height. Use the lock to force the next selection made to this height. Ratio Gives the current ratio. Use the lock to force the next selection made to this ratio. .. versionadded:: 4.2 Round X The horizontal radius of the rectangle corners. Round Y The vertical radius of the rectangle corners. diff --git a/reference_manual/tools/rectangular_select.rst b/reference_manual/tools/rectangular_select.rst index 908ba8354..dfe347af1 100644 --- a/reference_manual/tools/rectangular_select.rst +++ b/reference_manual/tools/rectangular_select.rst @@ -1,68 +1,112 @@ .. meta:: :description: Krita's rectangular selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic + - Alberto Eleuterio Flores Guerrero :license: GNU free documentation license 1.3 or later. .. index:: Tools, Selection, Rectangle, Rectangular Selection .. _rectangle_selection_tool: ========================== Rectangular Selection Tool ========================== |toolselectrect| -This tool, represented by a rectangle with a dashed border, allows you to make :ref:`selections_basics` of a rectangular area. Simply click and drag around the section you wish to select. +This tool, represented by a rectangle with a dashed border, allows you to make :ref:`selections_basics` in a rectangular shape. To create a rectangular selection simply |mouseleft| and drag on the area of the canvas that you wish to select. + +.. important:: + + Most of the behavior of the Rectangular Selection Tool is common to all other selection tools, please make sure to read :ref:`selections_basics` to learn more about this tool. Hotkeys and Stickykeys ---------------------- -* :kbd:`J` selects this tool. +* :kbd:`Ctrl + R` selects this tool. * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. -* :kbd:`Shift` after starting the selection, constraints it to a perfect square. -* :kbd:`Ctrl` after starting the selection, makes the selection resize from center. -* :kbd:`Alt` after starting the selection, allows you to move it. +* |mouseleft| + :kbd:`Shift` constrains the selection to a perfect square. (Make sure to press |mouseleft| before :kbd:`Shift`) +* |mouseleft| + :kbd:`Ctrl` makes the selection resize from the center. (Make sure to press |mouseleft| before :kbd:`Ctrl`) +* |mouseleft| + :kbd:`Alt` allows you to move the selection. (Make sure to press |mouseleft| before :kbd:`Alt`) * :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. -* :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. -* :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. -* :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. +* :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. +* :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. +* :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 - * Hovering over a selection allows you to move it. + * Hovering your cursor over the dashed line of the selection, or marching ants as it is commonly called, turns the cursor into the move tool icon, which you |mouseleft| and drag to move the selection. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. -.. note:: +.. image:: /images/tools/selections-right-click-menu.png + :width: 200 + :alt: Menu of rectangular selection - So to subtract a perfect square, you do :kbd:`Alt +` |mouseleft|, then release the :kbd:`Alt` key while dragging and press :kbd:`Shift` to constrain. +.. hint:: -.. note:: + To subtract a perfect square, you can follow two different methods: + + 1. Press :kbd:`S` to substract then |mouseleft| to select and press :kbd:`Shift` while dragging to constrain to a perfect square. - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` + 2. Press :kbd:`Alt +` |mouseleft|, then release the :kbd:`Alt` key while dragging and press :kbd:`Shift` to constrain. + +.. tip:: + + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ - +.. image:: /images/tools/selections-rectangular-selection-options.png + :width: 300 + :alt: Rectangular selection options + +Mode + This option is explained in the :ref:`pixel_vector_selection` section. +Action + This option is explained in the :ref:`pixel_vector_selection` section. Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. + +.. note:: + + Anti-aliasing is only available on Pixel Selection Mode. + + Width - Gives the current width. Use the lock to force the next selection made to this width. + Shows you the current width while you are creating the selection. You can manually type the value and use the 'Lock Width' for your next selection to have the selected value. +Lock Width + Forces the next selection to have the current width. Height - Gives the current height. Use the lock to force the next selection made to this height. + Shows you the current height while you are creating the selection. You can manually type the value and use the 'Lock Height' for your next selection to have the selected value. +Lock Height + Forces the next selection to have the current height. Ratio - Gives the current ratio. Use the lock to force the next selection made to this ratio. + Shows the ratio between height and width of the selection. Similar to Height, and Width, you can manually type the value and use the 'Lock Ratio' for your next selection to have the selected value. +Lock Ratio + Forces the next selection to have the current ratio. + + +.. hint:: + + If you want your selection to be of specific size: + + 1. Type the width and height. + 2. Press the Lock Width and Lock Height buttons. + 3. |mouseleft| where you want your selection to be. + .. versionadded:: 4.1.3 Round X The horizontal radius of the rectangle corners. Round Y The vertical radius of the rectangle corners. + Chain Link + When linked the aspect ratio between the roundness of X and Y coordinates will be locked. To disconnect the chain just click in the links and it will separate in two parts. diff --git a/reference_manual/tools/similar_select.rst b/reference_manual/tools/similar_select.rst index 5b75b8efc..1808c6a53 100644 --- a/reference_manual/tools/similar_select.rst +++ b/reference_manual/tools/similar_select.rst @@ -1,46 +1,75 @@ .. meta:: :description: Krita's similar color selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic + - Alberto Eleuterio Flores Guerrero :license: GNU free documentation license 1.3 or later. .. index:: Tools, Selection, Similar Selection .. _similar_selection_tool: ============================ Similar Color Selection Tool ============================ |toolselectsimilar| -This tool, represented by a dropper over an area with a dashed border, allows you to make :ref:`selections_basics` by selecting a point of color. It will select any areas of a similar color to the one you selected. You can adjust the "fuzziness" of the tool in the tool options dock. A lower number will select colors closer to the color that you chose in the first place. +This tool, represented by a dropper over an area with a dashed border, allows you to make :ref:`selections_basics` by selecting a point of color. It will select any areas of a similar color to the one you selected. You can adjust the "fuzziness" of the tool in the tool options dock. A lower number will select colors closer to the color that you chose in the first place. + +.. important:: + + Most of the behavior of the Similar Color Selection Tool is common to all other selection tools, please make sure to read :ref:`selections_basics` to learn more about this tool. + Hotkeys and Sticky keys ----------------------- * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. -* :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. -* :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. -* :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. -* :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. +* :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. +* :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. +* :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. +* :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 - * Hovering over a selection allows you to move it. + * Hovering your cursor over the dashed line of the selection, or marching ants as it is commonly called, turns the cursor into the move tool icon, which you |mouseleft| and drag to move the selection. + * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. -.. note:: +.. image:: /images/tools/selections-right-click-menu.png + :width: 200 + :alt: Menu of similar color selection + +.. tip:: + + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in Tool Settings in the :ref:`general_settings` + +.. tip:: + + This tool is not bound to any Hotkey, if you want to define one, go to :menuselection:`Settings --> Configure Krita --> Keyboard Shortcuts` and search for 'Similar Color Selection Tool', there you can select the shortcut you want. Check :ref:`shortcut_settings` for more info. - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ +.. image:: /images/tools/selections-similar-color-selection-options.png + :width: 300 + :alt: Similar Color selection options + +Action + This option is explained in the :ref:`pixel_vector_selection` section. +Anti-aliasing + This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. + +.. note:: + + Anti-aliasing is only available on Pixel Selection Mode. + Fuzziness - This controls whether or not the contiguous selection sees another color as a border. + This controls the range of the color hue used to create the selection. A lower number will select colors closer to the color that you chose in the first place. And a higher number will expand the hue range and select colors even if they are not so similar to the original color. diff --git a/user_manual/selections.rst b/user_manual/selections.rst index b94275e65..b67e2bedc 100644 --- a/user_manual/selections.rst +++ b/user_manual/selections.rst @@ -1,145 +1,149 @@ .. meta:: :description: How selections work in Krita. .. metadata-placeholder :authors: - Scott Petrovic - Wolthera van Hövell tot Westerflier - Hulmanen + - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. index:: Selection .. _selections_basics: ========== Selections ========== -Selections allow you to pick a specific area of your artwork to change. This is useful for when you want to move a section, transform it, or paint on it without affecting the other sections. There are many selection tools available that select in different ways. Once an area is selected, most tools will stay inside that area. On that area you can draw or use gradients to quickly get colored and/or shaded shapes with hard edges. +Selections allow you to pick a specific area of your artwork to change. This is useful when you want to move a section of the painting, transform it, or paint on it without affecting the other sections. There are many selection tools available that select in different ways. Once an area is selected, most tools will stay inside that area. On that area you can draw or use gradients to quickly get colored and/or shaded shapes with hard edges. The selections in Krita are not limited to the canvas boundary, so you can also selection portions of the painting that are beyond the canvas boundary. Creating Selections ------------------- The most common selection tools all exist at the bottom of the toolbox. Each tool selects things slightly differently. The links for each tool go into a more detailed description of how to use it. .. csv-table:: :ref:`rectangle_selection_tool` , |toolselectrect|, Select the shape of a square. - :ref:`ellipse_selection_tool` , |toolselectellipse|, Select the shape of a circle. + :ref:`ellipse_selection_tool` , |toolselectellipse|, Select the shape of a circle. :ref:`polygonal_selection_tool` , |toolselectpolygon|, Click where you want each point of the Polygon to be. Double click to end your polygon and finalize your selection area. Use :kbd:`Shift + Z` to undo last point. - :ref:`outline_selection_tool` , |toolselectoutline|, Outline/Lasso tool is used for a rough selection by drawing the outline. - :ref:`similar_selection_tool` , |toolselectsimilar|, Similar Color Selection Tool. + :ref:`outline_selection_tool` , |toolselectoutline|, Outline/Lasso tool is used for a rough selection by drawing the outline. + :ref:`similar_selection_tool` , |toolselectsimilar|, Similar Color Selection Tool. :ref:`contiguous_selection_tool` , |toolselectcontiguous|, "Contiguous or “Magic Wand” selects a field of color. Adjust the :guilabel:`Fuzziness` to allow more changes in the field of color, by default limited to the current layer." :ref:`path_selection_tool` , |toolselectpath|, "Path select an area based on a vector path, click to get sharp corners or drag to get flowing lines and close the path with :kbd:`Enter` or connecting back to the first point." .. note:: - + You can also use the transform tools on your selection, a great way to try different proportions on parts of your image. Editing Selections ------------------ The tool options for each selection tool gives you the ability to modify your selection. +-------------+---------------+------------+---------------------------------------------------+ | Action | Modifier | Shortcut | Description | +-------------+---------------+------------+---------------------------------------------------+ | Replace | Ctrl | R | Replace the current selection. | +-------------+---------------+------------+---------------------------------------------------+ | Intersect | Shift + Alt | -- | Get the overlapping section of both selections | +-------------+---------------+------------+---------------------------------------------------+ | Add | Shift | A | Add the new selection to the current selection. | +-------------+---------------+------------+---------------------------------------------------+ | Subtract | Alt | S | Subtract the selection from the current selection.| +-------------+---------------+------------+---------------------------------------------------+ | Symmetric | -- | -- | Make a selection where both the new and current | | Difference | | | do not overlap. | +-------------+---------------+------------+---------------------------------------------------+ You can change this in :ref:`tool_options_settings`. If you hover over a selection with a selection tool and no selection is activated, you can move it. To quickly go into transform mode, |mouseright| and select :guilabel:`Edit Selection`. Removing Selections ------------------- If you want to delete the entire selection, the easiest way is to deselect everything. :menuselection:`Select --> Deselect`. Shortcut :kbd:`Ctrl + Shift + A`. +When you have one of the selection tool active, and the mode of selection is in intersect, replace or symmetric difference then you can also deselect by just |mouseleft| anywhere on the canvas. Display Modes ------------- In the bottom left-hand corner of the status bar there is a button to toggle how the selection is displayed. The two display modes are the following: (Marching) Ants and Mask. The red color with Mask can be changed in the preferences. You can edit the color under :menuselection:`Settings --> Configure Krita --> Display --> Selection Overlay`. If there is no selection, this button will not do anything. .. image:: /images/selection/Ants-displayMode.jpg Ants display mode (default) is best if you want to see the areas that are not selected. .. image:: /images/selection/Mask-displayMode.jpg Mask display mode is good if you are interested in seeing the various transparency levels for your selection. For example, when you have a selection with very soft edges due using feathering. .. versionchanged:: 4.2 Mask mode is activated as well when a selection mask is the active layer so you can see the different selection levels. Global Selection Mask (Painting a Selection) -------------------------------------------- The global Selection Mask is your selection that appears on the layers docker. By default, this is hidden, so you will need to make it visible via :menuselection:`Select --> Show Global Selection Mask`. .. image:: /images/selection/Global-selection-mask.jpg Once the global Selection Mask is shown, you will need to create a selection. The benefit of using this is that you can paint your selection using any of the normal painting tools, inlcuding the transform and move. The information is saved as grayscale. You can enter the global selection mask mode quickly from the selection tools by doing |mouseright| and select :guilabel:`Edit Selection`. Selection from layer transparency --------------------------------- You can create a selection based on a layer's transparency by right-clicking on the layer in the layer docker and selecting :guilabel:`Select Opaque` from the context menu. .. versionadded:: 4.2 You can also do this for adding, subtracting and intersecting by going to :menuselection:`Select --> Select Opaque`, where you can find specific actions for each. If you want to quickly select parts of layers, you can hold :kbd:`Ctrl +` |mouseleft| on the layer *thumbnail*. To add a selection do :kbd:`Ctrl + Shift+` |mouseleft|, to remove :kbd:`Ctrl + Alt +` |mouseleft| and to intersect :kbd:`Ctrl + Shift + Alt` |mouseleft|. This works with any mask that has pixel or vector data (so everything but transform masks). +.. _pixel_vector_selection: + Pixel and Vector Selection Types -------------------------------- Vector selections allow you to modify your selection with vector anchor tools. Pixel selections allow you to modify selections with pixel information. They both have their benefits and disadvantages. You can convert one type of selection to another. .. image:: /images/selection/Vector-pixel-selections.jpg When creating a selection, you can select what type of selection you want from the Mode in the selection tool options: Pixel or Vector. By default this will be a vector. Vector selections can be modified as any other :ref:`vector shape ` with the :ref:`shape_selection_tool`, if you try to paint on a vector selection mask it will be converted into a pixel selection. You can also convert vector shapes to selection. In turn, vector selections can be made from vector shapes, and vector shapes can be converted to vector selections using the options in the :guilabel:`Selection` menu. Krita will add a new vector layer for this shape. One of the most common reasons to use vector selections is that they give you the ability to move and transform a selection without the kind of resize artifacts you get with a pixel selection. You can also use the :ref:`shape_edit_tool` to change the anchor points in the selection, allowing you to precisely adjust bezier curves or add corners to rectangular selections. If you started with a pixel selection, you can still convert it to a vector selection to get these benefits. Go to :menuselection:`Select --> Convert to Vector Selection`. .. note:: If you have multiple levels of transparency when you convert a selection to vector, you will lose the semi-transparent values. Common Shortcuts while Using Selections --------------------------------------- - Copy -- :kbd:`Ctrl + C` or :kbd:`Ctrl + Ins` - Paste -- :kbd:`Ctrl + V` or :kbd:`Shift + Ins` - Cut -- :kbd:`Ctrl + X`, :kbd:`Shift + Del` - Copy From All Layers -- :kbd:`Ctrl + Shift + C` - Copy Selection to New Layer -- :kbd:`Ctrl + Alt + J` - Cut Selection to New Layer -- :kbd:`Ctrl + Shift + J` - Display or hide selection with :kbd:`Ctrl + H` - Select Opaque -- :kbd:`Ctrl +` |mouseleft| on layer thumbnail. - Select Opaque (Add) -- :kbd:`Ctrl + Shift` |mouseleft| on layer thumbnail. - Select Opaque (Subtract) -- :kbd:`Ctrl + Alt` |mouseleft| on layer thumbnail. - Select Opaque (Intersect) -- :kbd:`Ctrl + Shift + Alt` |mouseleft| on layer thumbnail.