Commit 55d929bb authored by Wolthera van Hövell's avatar Wolthera van Hövell 🛍

Merge branch 'draft'

parents e3672577 0a1134bc
......@@ -174,6 +174,32 @@ Combines :ref:`bm_linear_dodge` and :ref:`bm_linear_burn`. When the lightness of
Left: **Normal**. Right: **Linear Light**.
.. _bm_luminosity_shine_sai:
Luminosity/Shine (SAI)
~~~~~~~~~~~~~~~~~~~~~~
Similar to :ref:`bm_addition`.
Takes the opacity of the new color (combined opacity of the layer, the brush, any used transparency masks etc.) and multiples the color by the opacity, then adds to the original/previous color.
.. math::
c_{new} = c_{above}*{\alpha}_{above} + c_{below}
The result of this operation is the same as combining the new pixels with a fully opaque black layer in a :ref:`bm_normal` mode and then combining the result with the original layer using :ref:`bm_addition` mode. It should be also the same as the results of "Luminosity" blending mode in SAI1 or "Shine" blending mode in SAI2.
.. figure:: /images/blending_modes/lighten/Blending_modes_Luminosity_Shine_SAI_Sample_image_with_dots.png
:align: center
Left: **Normal**. Right: **Luminosity/Shine (SAI)**.
.. _bm_p-norm_a:
P-Norm A
......
......@@ -90,3 +90,4 @@ Hot keys and Sticky Keys
* :kbd:`Page Up` and :kbd:`Page Down` keys for switching between layers.
* :kbd:`Ctrl + Page Up` and :kbd:`Ctrl + Page Down` shortcuts will move the selected layers up and down.
.. meta::
:description:
Overview of the snapshot docker.
.. metadata-placeholder
:authors: - Tusooa Zhu <tusooa@vista.aero>
:license: GNU free documentation license 1.3 or later.
.. index:: Snapshot
.. _snapshot_docker:
===============
Snapshot Docker
===============
A docker that allows you to create snapshots (copies) of the current document, and to return to these states afterwards.
.. image:: /images/dockers/snapshot-docker.png
The main part of the docker is a list of all saved snapshots. At the bottom of the docker, there are three buttons: from left to right, they are :guilabel:`Create snapshot`, :guilabel:`Switch to selected snapshot`, and :guilabel:`Remove selected snapshot`. You can create a snapshot from the current state of the document by clicking :guilabel:`Create snapshot`. Click :guilabel:`Switch to selected snapshot` to switch to the selected snapshot. The undo stack will be discarded after switching. If you would like to save the current state, make another snapshot before switching. Click :guilabel:`Remove selected snapshot` to delete the selected snapshot. You can edit the names of snapshots by double-clicking them.
Please be aware that all snapshots will be gone if you close the document. If you want to keep them, you need to explicitly save or export them.
......@@ -55,3 +55,44 @@ Gradient Map
Maps the lightness of the input to the selected gradient. Useful for fancy artistic effects.
In 3.x you could only select predefined gradients. In 4.0, you can select gradients and change them on the fly, as well as use the gradient map filter as a filter layer or filter brush.
Color Modes
~~~~~~~~~~~
* **Blend:** smoothly blend colors between stops
* **Nearest:** selects color from nearest stops
* **Dither:** dithers between stop colors as per `Dithering Threshold Modes`_.
.. index:: Palette, Palettize
Palettize
---------
Maps the color of the input to the nearest color in the selected palette. Useful for limiting color in pixel art and for artistic effects.
Optional dithering may be applied with the covered value range controlled by the spread value.
Colorspace Modes
~~~~~~~~~~~~~~~~
* **Lab:** finds nearest colors in Lab colorspace
* **RGB:** finds nearest colors in RGB colorspace
Dithering Threshold Modes
~~~~~~~~~~~~~~~~~~~~~~~~~
* **Pattern:** uses the lightness or alpha value of the selected pattern to threshold the input color between palette colors
* **Noise:** uses a randomly generated value per pixel to threshold the input color between palette colors
Dithering Color Modes
~~~~~~~~~~~~~~~~~~~~~
* **Per-Component Offset:** independently offsets each color channel by the threshold amount, scaled by the offset scale value
* **Nearest Colors:** finds the two nearest colors then applies the threshold amount to the relative distances of the two color to find the resulting color
Dithering Alpha Modes
~~~~~~~~~~~~~~~~~~~~~
* **Clip:** thresholds alpha at the clip position
* **Index:** uses the selected palette index as the transparent color
* **Dither:** applies dither to the alpha value as per `Dithering Threshold Modes`_
\ No newline at end of file
......@@ -21,8 +21,8 @@ Clone Layers
A clone layer is a layer that keeps an up-to-date copy of another layer. You cannot draw or paint on it directly, but it can be used to create effects by applying different types of layers and masks (e.g. filter layers or masks).
Example uses of Clone Layers.
-----------------------------
Example uses of Clone Layers
----------------------------
For example, if you were painting a picture of some magic person and wanted to create a glow around them that was updated as you updated your character, you could:
......@@ -33,3 +33,16 @@ For example, if you were painting a picture of some magic person and wanted to c
As you keep painting and adding details, erasing on the first layer, Krita will automatically update the clone layer, making your "glow" apply to every change you make.
Changing the source of Clone Layers
-----------------------------------
You can change the source of one or more Clone Layers in the Layers Docker. To do so, select one or more Clone Layers in the docker (hold :kbd:`Ctrl` or :kbd:`Shift` and left-click the layers). Then, right-click on any selected layer. In the context menu, there is an action named :guilabel:`Set Copy From`. Click it. A dialog will pop up and there is a drop-down menu with all possible layers to be set as the source of all selected Clone Layers. If the current source of them consists of multiple layers, the default activated selection in the drop-down menu will be blank. Otherwise, it would be the common source of selected Clone Layers.
Possible target layers are determined through the following criteria:
#. Any Clone Layer that is selected is invalid.
#. A parent or clone of any invalid layer is invalid.
#. All other layers are valid.
If you select one layer in the drop-down menu, a preview of the canvas will be shown. Click :guilabel:`OK` to apply the changes. Click :guilabel:`Cancel` to discard the changes. If you make changes to the image outside the dialog, the changes will be applied and the dialog will be automatically closed.
......@@ -20,21 +20,26 @@ A Fill Layer is a special layer that Krita generates on-the-fly that can contain
.. image:: /images/layers/Fill_Layer.png
Color
Fills the layer with a singular color. Since version 4.2, newly created colored fill layers will be assigned to the currently active foreground color.
Pattern
This fills the layer with a predefined pattern or texture that has been loaded into Krita through the Resource Management interface. Patterns can be a simple and interesting way to add texture to your drawing or painting, helping to recreate the look of watercolor paper, linen, canvas, hardboard, stone or an infinite other number of options. For example if you want to take a digital painting and finish it off with the appearance of it being on canvas you can add a Fill Layer with the Canvas texture from the texture pack below and set the opacity very low so the "threads" of the pattern are just barley visible. The effect is quite convincing.
This fills the layer with a predefined pattern or texture that has been loaded into Krita through the Resource Management interface. Patterns can be a simple and interesting way to add texture to your drawing or painting, helping to recreate the look of watercolor paper, linen, canvas, hardboard, stone or an infinite other number of options. For example if you want to take a digital painting and finish it off with the appearance of it being on canvas you can add a Fill Layer with the Canvas texture from the texture pack below and set the opacity very low so the "threads" of the pattern are just barley visible. The effect is quite convincing.
You can create your own and use those as well. For a great set of well designed and useful patterns check out one of our favorite artists and a great friend of Krita, David Revoy's free texture pack (https://www.davidrevoy.com/article156/texture-pack-1).
Color
The second option is not quite as exciting, but does the job. Fill the layer with a selected color.
Simplex Noise
.. versionadded:: 4.2
.. image:: /images/layers/fill_layer_simplex_noise.png
A noise generator that isn't Perline Noise (which is what typical 'clouds' generation is), but it looks similar and can actually loop. Uses the OpenSimplex code.
This fills the layer with generated OpenSimplex noise. OpenSimplex is different from the more common Perlin noise (often named 'clouds' in other software) and also different from Improved Perlin noise. OpenSimplex has less dimensional artifacts (the subtle "checker" texture often found high frequency Perlin noise) and is a ubiquitous open standard. Since OpenSimplex noise is important to texture generation, this fill layer has the option
to loop around the canvas edge. You can read more about OpenSimplex `here
<https://en.wikipedia.org/wiki/OpenSimplex_noise>`_.
There are a few different use cases for simplex noise. One of these is to create interesting looping patterns, achieved by stacking multiple simplex noise fills with different blending modes. It becomes even more expressive when combined with the levels adjustment layers. For texture artists, this can be a useful utility when combined with a gradient map filter layer to provide color diversity to a looping texture.
For traditional artists, simplex noise layers can be converted to selection masks to create brush transparency dynamics and masking effects. Experimenting with different combinations can be fun and produce interesting results!
Looping
Whether or not to force the pattern to loop.
Frequency
......@@ -42,7 +47,7 @@ Simplex Noise
Ratio
The ratio of the waves in the x and y dimensions. This makes the noise have a rectangular appearance.
Use Custom Seed
The seed for the random component. You can input any value or text here, and it will always try to use this value to generate the random values with (which then are always the same for a given seed).
The seed for the random component. You can input any value or text here, and it will always try to use this value to generate the random values with (which then are always the same for a given seed). Leaving the value empty will use the randomly-assigned seed value on layer creation.
Painting on a fill layer
------------------------
......
......@@ -6,6 +6,7 @@
:authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
- Scott Petrovic
- Raghavendra Kamath <raghu@raghukamath.com>
:license: GNU free documentation license 1.3 or later.
.. index:: Layers, Cut Layer, Copy Layer, Paste Layer, Convert, Import, Export, Transform, Metadata, Histogram, Flatten, Layer Style
......@@ -50,7 +51,7 @@ Import/Export
Import an image as a layer into the current file.
Import as...
Import an image as a specific layer type. The following layer types are supported:
* Paint layer
* Transparency Mask
* Filter Mask
......@@ -69,6 +70,8 @@ Convert
Convert a layer to a filter mask. The image will be converted to grayscale first, and these grayscale values are used to drive the filter effect area.
Selection Mask
Convert a layer to a selection mask. The image will be converted to grayscale first, and these grayscale values are used to drive the selected area.
File Layer
Convert the selected layer in to a file layer. This will open a dialog box, which will ask the user for a location to save the layer as file layer and reference it in place of the original layer. This feature cannot be used if the selected layer is either a clone layer or a file layer.
Convert Group to Animated Layer
This takes the images in the group layer and makes them into frames of an animated layer.
Convert Layer Color Space
......
......@@ -20,7 +20,7 @@ Show Canvas Only
Fullscreen mode
This will hide the system bar.
Wrap Around Mode
This will show the image as if tiled orthographically. Very useful for tiling 3d textures. Hit the :kbd:`W` key to quickly activate it.
This will show the image as if tiled orthographically. Very useful for tiling 3d textures.
Instant Preview
Toggle :ref:`instant_preview` globally.
Soft Proofing
......
......@@ -57,6 +57,14 @@ Allow LittleCMS optimizations
Uncheck this option when using Linear Light RGB or XYZ.
Enforce palette colors: always select the nearest color from the active palette
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
By default, palette selection widgets take the current foreground color, compare it to the swatches in it’s active palette and highlight the swatch that is nearest to the current foreground color.
When ‘Enforce palette colors’ option is checked, it switches the internal color selector into a mode in which, instead of just highlighting the swatch, the current foreground color is replaced with the color of the nearest swatch.
Display
-------
......
......@@ -6,6 +6,7 @@
:authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
- Scott Petrovic
- Alberto Eleuterio Flores Guerrero <barbanegra+bugs@posteo.mx>
:license: GNU free documentation license 1.3 or later.
.. index:: Tools, Ellipse, Circle, Elliptical Select, Selection
......@@ -17,7 +18,11 @@ 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
----------------------
......@@ -26,37 +31,73 @@ Hotkeys and Stickykeys
* :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.
* :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'.
* |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'.
.. 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 the :kbd:`Shift` key to constrain.
.. hint::
.. note::
To subtract a perfect circle, 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 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 behavior of the :kbd:`Alt` key to use the :kbd:`Ctrl` key 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.
......@@ -7,7 +7,8 @@
:authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
- Scott Petrovic
- Radianart
- Raghavendra Kamath
- Raghavendra Kamath <raghu@raghukamath.com>
- Alberto Eleuterio Flores Guerrero <barbanegra+bugs@posteo.mx>
:license: GNU free documentation license 1.3 or later.
.. index:: Tools, Selection, Freehand, Outline Select
......@@ -21,6 +22,11 @@ Outline Selection Tool
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
-----------------------
......@@ -34,15 +40,35 @@ Hotkeys and Sticky keys
.. 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 behavior of the :kbd:`Alt` key to use the :kbd:`Ctrl` key 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.
......@@ -6,6 +6,7 @@
:authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
- Scott Petrovic
- Alberto Eleuterio Flores Guerrero <barbanegra+bugs@posteo.mx>
:license: GNU free documentation license 1.3 or later.
.. index:: Tools, Polygon, Selection, Polygonal Selection
......@@ -17,7 +18,12 @@ 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
......@@ -26,22 +32,42 @@ 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 +` |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 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 behavior of the :kbd:`Alt` key to use the :kbd:`Ctrl` key 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.
......@@ -5,6 +5,7 @@
.. metadata-placeholder
:authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
- Alberto Eleuterio Flores Guerrero <barbanegra+bugs@posteo.mx>
:license: GNU free documentation license 1.3 or later.
.. index:: Tools, Rectangle
......
......@@ -6,6 +6,7 @@
:authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
- Scott Petrovic
- Alberto Eleuterio Flores Guerrero <barbanegra+bugs@posteo.mx>
:license: GNU free documentation license 1.3 or later.
.. index:: Tools, Selection, Rectangle, Rectangular Selection
......@@ -17,48 +18,89 @@ 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.
* :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'.
* |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'.
.. 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 the :kbd:`Shift` key 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 behavior of the :kbd:`Alt` key to use the :kbd:`Ctrl` key 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
......@@ -66,3 +108,5 @@ Ratio
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.
......@@ -23,8 +23,10 @@ The reference images tool is a replacement for the reference images docker. You
Tool Options
------------
Add reference image
Add Reference Image
Load a single image to display on the canvas.
Paste Reference Image
Load an image from the system clipboard and add it as a reference image.
Load Set
Load a set of reference images.
Save Set
......@@ -43,8 +45,8 @@ Storage mode
Embed to \*.kra
Store this reference image into the kra file. This is recommended for small vital files you'd easily lose track of otherwise.
Link to external file.
Only link to the reference image, krita will open it from the disk everytime it loads this file. This is recommended for big files, or files that change a lot.
You can move around reference images by selecting them with |mouseleft|, and dragging them. You can rotate reference images by holding the cursor close to the outside of the corners till the rotate cursor appears, while tilting is done by holding the cursor close to the outside of the middle nodes. Resizing can be done by dragging the nodes. You can delete a single reference image by clicking it and pressing the :kbd:`Del` key. You can select multiple reference images with the :kbd:`Shift` key and perform all of these actions.
Only link to the reference image, krita will open it from the disk everytime it loads this file. This is recommended for big files, or files that change a lot. This option is only available when reference images are loaded from a local path.
You can move around reference images by selecting them with |mouseleft|, and dragging them. You can rotate reference images by holding the cursor close to the outside of the corners till the rotate cursor appears, while tilting is done by holding the cursor close to the outside of the middle nodes. Resizing can be done by dragging the nodes. You can delete a single reference image by clicking it and pressing :kbd:`Del`. You can select multiple reference images with :kbd:`Shift` and perform all of these actions.
To hide all reference images temporarily use :menuselection:`View --> Show Reference Images`.
......@@ -6,6 +6,7 @@
:authors: - Wolthera van Hövell tot Westerflier <griffinvalley@gmail.com>
- Scott Petrovic
- Alberto Eleuterio Flores Guerrero <barbanegra+bugs@posteo.mx>
:license: GNU free documentation license 1.3 or later.
.. index:: Tools, Selection, Similar Selection
......@@ -17,7 +18,12 @@ 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
-----------------------
......@@ -25,22 +31,55 @@ 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.
<<<<<<< HEAD
* :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` + |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'.
>>>>>>> draft
* :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.
<<<<<<< HEAD
You can switch the behavior of the :kbd:`Alt` key to use the :kbd:`Ctrl` key instead by toggling the switch in the :ref:`general_settings`.
=======
>>>>>>> draft
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.
......@@ -178,7 +178,7 @@ Preparing Tiles and Textures
Many artists use Krita to create textures for 3d assets used for games animation etc. Krita has many texture templates for you to choose and get started with creating textures. These templates have common sizes, bit depth and color profiles that are used for texturing workflow.
Krita also has a real-time seamless tile mode to help texture artist prepare tiles and texture easily and check if it is seamless on the fly. The tiled mode is called wrap-around mode, to activate this mode you have press the :kbd:`W` key. Now when you paint the canvas is tiled in real-time allowing you to create seamless pattern and texture, it is also easy to prepare interlocking patterns and motifs in this mode.
Krita also has a real-time seamless tile mode to help texture artist prepare tiles and texture easily and check if it is seamless on the fly. The tiled mode is called wrap-around mode, to activate this mode got to :menuselection:`View --> Wrap Around Mode`. Now when you paint the canvas is tiled in real-time allowing you to create seamless pattern and texture, it is also easy to prepare interlocking patterns and motifs in this mode.
Creating Pixel Art
------------------
......
......@@ -24,7 +24,9 @@ There are a few steps involved:
4. Resize! Go to :menuselection:`Image --> Scale Image To New Size` or use the :kbd:`Ctrl + Alt + I` shortcut. This calls up the resize menu. A good rule of thumb for resizing is that you try to get both sizes to be less than 1200 pixels. (This being the size of HD formats). You can easily get there by setting the **Resolution** under **Print Size** to **72** dots per inch. Then press **OK** to have everything resized.
5. Save as a web-safe image format. There's three that are especially recommended:
5. Sharpen the image a little. This is especially necessary for social media. Social media websites often scale and convert your image in such a way that it gets a little blurry, because they optimize towards photos and not paintings. To have your images stay sharp, it is worth it to run a sharpen filter beforehand. Because the sharpen filter is quite powerful, you are best off adding a sharpen filter mask on top of the stack and lowering it's opacity till you feel the sharpness is appropriate.
6. Save as a web-safe image format. There's three that are especially recommended:
JPG
"""
......