diff --git a/images/en/Krita_Artistic_Color_Selector_Docker.png b/images/en/Krita_Artistic_Color_Selector_Docker.png index 764a421f3..36c03801c 100644 Binary files a/images/en/Krita_Artistic_Color_Selector_Docker.png and b/images/en/Krita_Artistic_Color_Selector_Docker.png differ diff --git a/images/en/Krita_Artistic_Color_Selector_Docker_2.png b/images/en/Krita_Artistic_Color_Selector_Docker_2.png new file mode 100644 index 000000000..d7c0a4e5e Binary files /dev/null and b/images/en/Krita_Artistic_Color_Selector_Docker_2.png differ diff --git a/images/en/Krita_Artistic_Color_Selector_Docker_3.png b/images/en/Krita_Artistic_Color_Selector_Docker_3.png new file mode 100644 index 000000000..547417002 Binary files /dev/null and b/images/en/Krita_Artistic_Color_Selector_Docker_3.png differ diff --git a/images/en/Krita_Gamut_Mask_Docker.png b/images/en/Krita_Gamut_Mask_Docker.png new file mode 100644 index 000000000..2a477bb14 Binary files /dev/null and b/images/en/Krita_Gamut_Mask_Docker.png differ diff --git a/images/en/Krita_Gamut_Mask_Docker_2.png b/images/en/Krita_Gamut_Mask_Docker_2.png new file mode 100644 index 000000000..b9c7da332 Binary files /dev/null and b/images/en/Krita_Gamut_Mask_Docker_2.png differ diff --git a/reference_manual/dockers/artistic_color_selector.rst b/reference_manual/dockers/artistic_color_selector.rst index 4eab4fb43..31133f4ab 100644 --- a/reference_manual/dockers/artistic_color_selector.rst +++ b/reference_manual/dockers/artistic_color_selector.rst @@ -1,43 +1,73 @@ .. meta:: :description: Overview of the artistic color selector docker. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic + - Anna Medonosova :license: GNU free documentation license 1.3 or later. .. index:: Color, Color Selector, ! Artistic Color Selector .. _artistic_color_selector_docker: ============================ Artist Color Selector Docker ============================ .. image:: /images/en/Krita_Artistic_Color_Selector_Docker.png A round selector that tries to give you the tools to select colors ramps efficiently. -Preference ----------- +Usage +----- -Set the color model used by the selector, as well as the amount of segments. +Select hue and saturation on the wheel (5) and value on the value scale (4). |mouseleft| changes foreground color (6). |mouseright| changes background color (7). -Reset ------ +Last selected swatches are outlined with red. + +The blip shows the position of current foreground color on the wheel (black and white circle) and on the value scale (black and white line). -Reset the selector to a default stage. +This selector does not update on change of foreground color. -Absolute --------- +The selector +------------ -This changes the algorithm around so it gives proper values for the grey. Without absolute, it'll use HSV values for grey to the corresponding hue and lightness. +.. image:: /images/en/Krita_Artistic_Color_Selector_Docker_2.png -Usage ------ -|mouseleft| the swatches to change the foreground color. -Use |mouseright| + Drag to shift the alignment of the selector swatches within a specific saturation ring. Use |mouseleft| + Drag to shift the alignment of all swatches. +1 - gamut masking toolbar + The toolbar consists of a toggle button to turn the mask off and on (left) and current mask title (right). -This selector does not update on change of foreground color. + Masks are selected and managed in the “Gamut Masks” docker. (Link) +2 - color wheel preferences menu (link to section) +3 - selector settings menu (link to section) +4 - value scale + * Optional comparative gray scale with lightness percentage on the left + * The black and white line (the blip) shows current foreground color’s value + * For HSY model, the value scale can be adjusted by user-defined gamma + +5 - the wheel + * The wheel is divided into color swatches by hue sectors and saturation rings. + * The black and white circle (the blip) shows current foreground color’s hue and saturation. +6 - current foreground color +7 - current background color + +Wheel preferences +----------------- + +.. image:: /images/en/Krita_Artistic_Color_Selector_Docker_3.png + + +Sliders 1, 2, and 3 + adjust the number of steps of the value scale, number of hue sectors and saturation rings on the wheel, respectively. + +Continuous Mode + The value scale and hue sectors can also be set to continuous mode (with the infinity icon on the right of the slider). If toggled on, the respective area shows a continuous gradient instead of the discreet swatches. + +Invert saturation (4) + changes the order of saturation rings within the the hue sectors. By default, the wheel has gray in the center and most saturated colors on the perimeter. “Inverted saturation” puts gray on the perimeter and most saturated colors in the center. + +Reset to default (5) + loads default values for the sliders 1,2 and 3. These default values are configured in selector settings. diff --git a/reference_manual/dockers/gamut_mask_docker.rst b/reference_manual/dockers/gamut_mask_docker.rst new file mode 100644 index 000000000..ada95ca4e --- /dev/null +++ b/reference_manual/dockers/gamut_mask_docker.rst @@ -0,0 +1,72 @@ +.. meta:: + :description: + Overview of the gamut mask docker. + +.. metadata-placeholder + + :authors: - Anna Medonosova + + :license: GNU free documentation license 1.3 or later. + +.. index:: Color, Color Selector, ! Gamut Mask Docker, ! Gamut Mask +.. _gamut_mask_docker: + +================== +Gamut Masks Docker +================== + +.. image:: /images/en/Krita_Gamut_Mask_Docker.png + +.. versionadded:: 4.2 + + Docker for gamut masks selection and management. + +Usage +----- + +|mouseleft| an icon (1) to apply a mask to color selectors. + +Gamut Masks can be imported and exported in the resource manager. + + +Management Toolbar +~~~~~~~~~~~~~~~~~~ + +Create new mask (2) + opens the mask editor with an empty template. +Edit mask (3) + opens the the currently selected mask in the editor. +Duplicate mask (4) + creates a copy of the currently selected mask and opens the copy in the editor. +Delete mask (5) + deletes the currently selected mask. + + +Editing +------- + +If you choose to create a new mask, edit, or duplicate selected mask, the mask template documents opens as a new view (1). + +There you can modify the mask with standard vector tools, or create any vector shape supported by Krita. + +Fill in the fields at (2). + +Title (Mandatory) + The name of the gamut mask. +Description + A description. + +:guilabel:`Preview` the mask in the artistic color selector (4), :guilabel:`save` the mask (5), or :guilabel:`cancel` editing (3). + +Please note, that the shapes need to be added to the layer named “maskShapesLayer” (which is selected by default). The shapes need have solid background to show correctly in the editor. A template with no shapes cannot be saved. + +The mask is intended to be composed of basic vector shapes. Although interesting results might arise from using advanced vector drawing techniques, not all features are guaranteed to work properly (e.g. grouping, vector text, etc.). + +.. image:: /images/en/Krita_Gamut_Mask_Docker_2.png + +External Info +------------- + +- ``_ +- ``_ +- ``_