diff --git a/images/icons/magnetic_selection_tool.svg b/images/icons/magnetic_select_tool.svg similarity index 100% rename from images/icons/magnetic_selection_tool.svg rename to images/icons/magnetic_select_tool.svg diff --git a/images/tools/magnetic_selection_anchor_gap.png b/images/tools/magnetic_selection_anchor_gap.png index f1fd35361..d201bb15d 100644 Binary files a/images/tools/magnetic_selection_anchor_gap.png and b/images/tools/magnetic_selection_anchor_gap.png differ diff --git a/reference_manual/tools/magnetic_select.rst b/reference_manual/tools/magnetic_select.rst index 9ba620873..f6b0c5945 100644 --- a/reference_manual/tools/magnetic_select.rst +++ b/reference_manual/tools/magnetic_select.rst @@ -1,105 +1,109 @@ .. meta:: :description: Krita's Magnetic Selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Kuntal Majumder :license: GNU free documentation license 1.3 or later. .. index:: Tools, Magnet, Selection, Magnetic Selection .. _magnetic_selection_tool: ======================= Magnetic Selection Tool ======================= |toolselectmagnetic| This tool, represented by a magnet over a selection border, allows you to make freeform :ref:`selections_basics`, but unlike the :ref:`polygonal_selection_tool` or the :ref:`outline_selection_tool`, it will try to magnetically snap to sharp contrasts in your image, simplifying the creation of selection drastically. There are two ways to make a magnetic selection: -.. image:: /images/tools/magnetic_selection_mode_1.gif +.. figure:: /images/tools/magnetic_selection_mode_1.gif :width: 320 - :align:center - :alt: Animation showing the first mode of creating a magnetic selection. + :align: center + + Animation showing the first mode of creating a magnetic selection. The first is to use |mouseleft| and place points or nodes of the magnetic selection. To finalize your selection area you can do either |mouseleft| on the first created point to complete the loop and click on it again to create a selection, or press :kbd:`Enter` to end the magnetic selection. -.. image:: /images/tools/magnetic_selection_mode_2.gif +.. figure:: /images/tools/magnetic_selection_mode_2.gif :width: 320 - :align:center - :alt: Animation showing the second mode of creating a magnetic selection. + :align: center + + Animation showing the second (interactive) mode of creating a magnetic selection. The second, interactive mode, is to |mouseleft| + drag over a portion of an image. -.. figure:: /images/tools/magnetic_selection_mode_1.gif +.. figure:: /images/tools/magnetic_selection_mode_mixed.gif :width: 320 - :align:center - :Caption: The first and second mode can be mixed. + :align: center + + The first and second mode can be mixed. -You can edit previous points by |mouseleft| dragging them. You can remove points by double |mouseleft| the point, or dragging it out of the canvas area. After a path is closed, you can add points by clicking on nearby empty space. Points can be undone with :kbd:`Shift + Z`. A selection can be canceled with :kbd:`Esc`. +You can edit previous points by |mouseleft| dragging them. You can remove points by double |mouseleft| the point, or dragging it out of the canvas area. After a path is closed, you can add points by clicking on nearby empty space. Points can be undone with :kbd:`Shift + Z`. A halfway done magnetic selection can be canceled with :kbd:`Esc`. .. important:: Most of the behavior of the Magnetic 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'. .. versionadded:: 4.2 * 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. .. image:: /images/tools/selections-right-click-menu.png :width: 200 :alt: Menu of magnetic 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 'Magnetic Selection Tool', there you can select the shortcut you want. Check :ref:`shortcut_settings` for more info. Tool 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. Filter Radius: Determine the radius of the edge detection kernel. This determines how agressively the tool will interpret contrasts. Low values mean only the sharpest of contrast will be a seen as an edge. High values will pick up on subtle contrasts. The range of which is from 2.5 to 100. Threshold: From 0 to 255, how sharp your edge is, 0 is least while 255 is the most. Used in the interactive mode only. Search Radius: The area in which the tool will search for a sharp contrast within an image. More pixels means less precision is needed when placing the points, but this will require Krita to do more work, and thus slows down the tool. Anchor Gap: - When using |mouseleft|+drag to place points automatically, this value determines the average gap between 2 anchors. Low values give high precision by placing many nodes, but this is also harder to edit afterwards. + When using |mouseleft| + drag to place points automatically, this value determines the average gap between 2 anchors. Low values give high precision by placing many nodes, but this is also harder to edit afterwards. The pixels are in screen dimensions and not image dimensions, meaning it is affect by zoom. - .. figure:: /images/tools/magnetic_selection_anchor_gap.png - :width: 640 - :align:center - :caption: Various anchor gaps + .. figure:: /images/tools/magnetic_selection_anchor_gap.png + :width: 640 + :align: center + + To the **left**: 20 px anchor gap, to the **right**: 40px anchor gap. .. note:: Anti-aliasing is only available on Pixel Selection Mode.