Commit 8f64a067 authored by Wolthera van Hövell's avatar Wolthera van Hövell 🛍

Initial page for the magnetic selection tool.

parent 1d9742f0
......@@ -180,6 +180,8 @@ rst_epilog = """
.. |toolselectpolygon| image:: /images/icons/polygonal_select_tool.svg
.. |toolselectmagnetic| image:: /images/icons/magnetic_select_tool.svg
.. |toolselectpath| image:: /images/icons/path_select_tool.svg
.. |toolselectoutline| image:: /images/icons/outline_select_tool.svg
......
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Created with Inkscape (http://www.inkscape.org/) -->
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
width="32"
height="32"
viewBox="0 0 32 32.000001"
id="svg2"
version="1.1"
inkscape:version="0.92.3 (2405546, 2018-03-11)"
sodipodi:docname="dark_tool_magnetic_selection.svg"
inkscape:export-filename="/run/media/andrei/C2942CC0942CB8B5/dribbble/krita icons/Collaborate/1_flat_dark/tools/light_tool_similar_selection.png"
inkscape:export-xdpi="45"
inkscape:export-ydpi="45">
<defs
id="defs4">
<filter
style="color-interpolation-filters:sRGB;"
inkscape:label="Drop Shadow"
id="filter4429">
<feFlood
flood-opacity="0.501961"
flood-color="rgb(0,0,0)"
result="flood"
id="feFlood4431" />
<feComposite
in="flood"
in2="SourceGraphic"
operator="in"
result="composite1"
id="feComposite4433" />
<feGaussianBlur
in="composite1"
stdDeviation="0"
result="blur"
id="feGaussianBlur4435" />
<feOffset
dx="0"
dy="-2"
result="offset"
id="feOffset4437" />
<feComposite
in="SourceGraphic"
in2="offset"
operator="over"
result="composite2"
id="feComposite4439" />
</filter>
<filter
style="color-interpolation-filters:sRGB;"
inkscape:label="Drop Shadow"
id="filter4238">
<feFlood
flood-opacity="0.501961"
flood-color="rgb(0,0,0)"
result="flood"
id="feFlood4240" />
<feComposite
in="flood"
in2="SourceGraphic"
operator="in"
result="composite1"
id="feComposite4242" />
<feGaussianBlur
in="composite1"
stdDeviation="0"
result="blur"
id="feGaussianBlur4244" />
<feOffset
dx="0"
dy="-2"
result="offset"
id="feOffset4246" />
<feComposite
in="SourceGraphic"
in2="offset"
operator="over"
result="composite2"
id="feComposite4248" />
</filter>
</defs>
<sodipodi:namedview
id="base"
pagecolor="#474747"
bordercolor="#666666"
borderopacity="1.0"
inkscape:pageopacity="0"
inkscape:pageshadow="2"
inkscape:zoom="5.6568543"
inkscape:cx="40.84614"
inkscape:cy="14.769291"
inkscape:document-units="px"
inkscape:current-layer="layer1"
showgrid="false"
units="px"
inkscape:showpageshadow="false"
showborder="true"
inkscape:window-width="1920"
inkscape:window-height="999"
inkscape:window-x="0"
inkscape:window-y="0"
inkscape:window-maximized="1"
objecttolerance="20"
showguides="false"
inkscape:snap-page="true">
<inkscape:grid
type="xygrid"
id="grid3336"
dotted="false"
empspacing="1"
snapvisiblegridlinesonly="true"
enabled="true"
visible="true"
empcolor="#aaaaff"
empopacity="0.25098039"
color="#7878ff"
opacity="0.1254902"
spacingx="2"
spacingy="2.0000001" />
</sodipodi:namedview>
<metadata
id="metadata7">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title>
<dc:creator>
<cc:Agent>
<dc:title>Andrei Rudenko</dc:title>
</cc:Agent>
</dc:creator>
</cc:Work>
</rdf:RDF>
</metadata>
<g
inkscape:groupmode="layer"
id="layer4"
inkscape:label="v2"
style="display:inline" />
<g
inkscape:groupmode="layer"
id="layer1"
inkscape:label="v3">
<path
style="display:inline;opacity:1;fill:#373737;fill-opacity:1;stroke:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:bevel;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:1;stroke-opacity:1"
d="M 0,0 V 4 8 H 4 V 4 H 8 V 0 Z m 0,12 v 8 h 4 v -8 z m 0,12 v 4 4 H 8 V 28 H 4 v -4 z m 28,0 v 4 h -4 v 4 h 8 v -4 -4 z m -16,4 v 4 h 8 v -4 z"
id="rect4883-3"
inkscape:connector-curvature="0"
sodipodi:nodetypes="cccccccccccccccccccccccccccccccccc" />
<path
inkscape:connector-curvature="0"
style="fill:#373737;fill-opacity:1;stroke:none;stroke-width:1.375"
d="M 28.363961,17.778175 C 32.659725,13.48241 33.399006,7.2568702 29.071068,2.9289318 24.74313,-1.3990065 18.51759,-0.65972556 14.221825,3.6360386 l -2.474873,2.4748737 2.916816,2.9168162 2.474874,-2.4748738 c 2.684854,-2.684854 6.861086,-2.8616307 9.01561,-0.7071064 2.154524,2.154524 1.977748,6.3307567 -0.707106,9.0156107 l -2.474874,2.474874 2.916815,2.916815 z M 24.916815,21.225321 21.999999,18.308505 19.083185,21.22532 22,24.142136 Z M 13.691495,10.000001 10.774679,7.0831848 7.8578644,9.9999996 10.774681,12.916816 Z"
class="ColorScheme-Text"
id="path4"
sodipodi:nodetypes="szsccszsccscccccccccc" />
</g>
</svg>
......@@ -45,5 +45,6 @@ The contents of the toolbox docker.
tools/contiguous_select
tools/path_select
tools/similar_select
tools/magnetic_select
tools/zoom
tools/pan
.. meta::
:description:
Krita's Magnetic Selection tool reference.
.. metadata-placeholder
:authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
- Kuntal Majumer
: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:
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, or press :kbd:`Enter` to end the magnetic selection.
The second is to |mouseleft| + drag over a portion of an image.
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`.
.. 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 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 'Magnetic Selection Tool', there you can select the shortcut you want. Check :ref:`shortcut_settings` for more info.
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.
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 egde 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.
.. note::
Anti-aliasing is only available on Pixel Selection Mode.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment