diff --git a/images/en/Krita_Artistic_Color_Selector_Docker.png b/images/en/Krita_Artistic_Color_Selector_Docker.png index 36c03801c..b2103605c 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 index d7c0a4e5e..53be3c79e 100644 Binary files a/images/en/Krita_Artistic_Color_Selector_Docker_2.png 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 index 547417002..1656036fe 100644 Binary files a/images/en/Krita_Artistic_Color_Selector_Docker_3.png 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 index 2a477bb14..e3f061a72 100644 Binary files a/images/en/Krita_Gamut_Mask_Docker.png 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 index b9c7da332..f5474d535 100644 Binary files a/images/en/Krita_Gamut_Mask_Docker_2.png and b/images/en/Krita_Gamut_Mask_Docker_2.png differ diff --git a/reference_manual/dockers/advanced_color_selector.rst b/reference_manual/dockers/advanced_color_selector.rst index a425bca18..c3ce282d2 100644 --- a/reference_manual/dockers/advanced_color_selector.rst +++ b/reference_manual/dockers/advanced_color_selector.rst @@ -1,155 +1,170 @@ .. meta:: :description: Overview of the advanced color selector docker. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Color, Color Selector, ! Advanced Color Selector .. _advanced_color_selector_docker: ======================= Advanced Color Selector ======================= .. image:: /images/en/Advancecolorselector.jpg As compared to other color selectors in Krita, Advance color selector provides more control and options to the user. To open Advance color selector choose :menuselection:`Settings --> Docker --> Advance Color Selector`. You can configure this docker by clicking on the little wrench icon on the top left corner. Clicking on the wrench will open a popup window with following tabs and options : Color Selector -------------- Here you configure the main selector. Type and Shape ~~~~~~~~~~~~~~ .. image:: /images/en/Krita_Color_Selector_Types.png Here you can pick the hsx model you'll be using. There's a small blurb explaining the characteristic of each model, but let's go into detail: HSV Stands for Hue, Saturation, Value. Saturation determines the difference between white, grey, black and the most colorful color. Value in turn measures either the difference between black and white, or the difference between black and the most colorful color. HSL Stands for Hue, Saturation, Lightness. All saturated colors are equal to 50% lightness. Saturation allows for shifting between grey and color. HSI This stands for Hue, Saturation and Intensity. Unlike HSL, this one determine the intensity as the sum of total rgb components. Yellow(1,1,0) has higher intensity than blue(0,0,1) but is the same intensity as cyan(0,1,1). HSY' Stands for Hue, Saturation, Luma, with Luma being an RGB approximation of true luminosity. (Luminosity being the measurement of relative lightness). HSY' uses the Luma Coefficients, like [http://en.wikipedia.org/wiki/Rec._709 Rec 709], to calculate the Luma. Due to this, HSY' can be the most intuitive selector to work with, or the most confusing. Then, under shape, you can select one of the shapes available within that colour model. .. note:: Triangle is in all colour models because to a certain extent, it is a wildcard shape: All colour models look the same in a equilateral triangle selector. Luma Coefficients ~~~~~~~~~~~~~~~~~ This allows you to edit the Luma coefficients for the HSY model selectors to your leisure. Want to use [http://en.wikipedia.org/wiki/Rec._601 Rec 601] instead of Rec 709? These boxes allow you to do that! By default, the Luma coefficients should add up to 1 at maximum. Gamma The HSY selector is linearised, this setting allows you to choose how much gamma is applied to the Luminosity for the gui element. 1.0 is fully linear, 2.2 is default. Color Space ~~~~~~~~~~~ This allows you to set the overall color space for the Advanced Color Selector. .. warning:: You can pick only sRGB colors in advanced color selector regardless of the color space of advanced color selector. This is a bug. Behaviour --------- When docker resizes ~~~~~~~~~~~~~~~~~~~ This determines the behavior of the widget as it become smaller. Change to Horizontal This'll arrange the shade selector horizontal to the main selector. Only works with the MyPaint shade selector Hide Shade Selector This hides the shade selector. Do nothing Does nothing, just resizes. Zoom selector UI ~~~~~~~~~~~~~~~~ If your have set the docker size considerably smaller to save space, this option might be helpful to you. This allows you to set whether or not the selector will give a zoomed view of the selector in a size specified by you, you have these options for the zoom selector: * when pressing middle mouse button * on mouse over * never The size given here, is also the size of the Main Color Selector and the MyPaint Shade Selector when they are called with :kbd:`shift + I` and :kbd:`shift`+:kbd:`M`, respectively. Hide Pop-up on click This allows you to let the pop-up selectors called with the above hotkeys to disappear upon clicking them instead of having to leave the pop-up boundary. This is useful for faster working. Shade selector -------------- Shade selector options. The shade selectors are useful to decide upon new shades of color. Update Selector ~~~~~~~~~~~~~~~ This allows you to determine when the shade selector updates. MyPaint Shade Selector ~~~~~~~~~~~~~~~~~~~~~~ Ported from MyPaint, and extended with all color models. Default hotkey is :kbd:`Shift+ M` Simple Shade Selector ~~~~~~~~~~~~~~~~~~~~~ This allows you to configure the simple shade selector in detail. Color Patches ------------- This sets the options of the color patches. Both Color History and Colors From the Image have similar options which will be explained below. Show This is a radio button to show or hide the section. It also determines whether or not the colors are visible with the advanced color selector docker. Size The size of the color boxes can be set here. Patch Count The number of patches to display. Direction The direction of the patches, Horizontal or Vertical. Allow Scrolling Whether to allow scrolling in the section or not when there are too many patches. Number of Columns/Rows The number of Columns or Rows to show in the section. Update After Every Stroke This is only available for Colors From the Image and tells the docker whether to update the section after every stroke or not, as after each stroke the colors will change in the image. History patches ~~~~~~~~~~~~~~~ The history patches remember which colors you've drawn on canvas with. They can be quickly called with :kbd:`H` Common Patches ~~~~~~~~~~~~~~ The common patches are generated from the image, and are the most common colour in the image. The hotkey for them on canvas is :kbd:`U`. +Gamut masking +------------- + +.. versionadded:: 4.2 + +.. note:: + + Gamut masking is available only when the selector shape is set to wheel. + +You can select and manage your gamut masks in the :ref:`gamut_mask_docker`. + +In the gamut masking toolbar at the top of the selector you can toggle the selected mask off and on (left button). You can also rotate the mask with the rotation slider (right). + + + External Info ------------- `HSI and HSY for Krita’s advanced colour selector. `_ diff --git a/reference_manual/dockers/artistic_color_selector.rst b/reference_manual/dockers/artistic_color_selector.rst index 31133f4ab..0c26ed0ed 100644 --- a/reference_manual/dockers/artistic_color_selector.rst +++ b/reference_manual/dockers/artistic_color_selector.rst @@ -1,73 +1,95 @@ .. 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 -============================ +============================== +Artistic 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. +A color selector inspired by traditional color wheel and workflows. Usage ----- -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). +.. figure:: /images/en/Krita_Artistic_Color_Selector_Docker.png -Last selected swatches are outlined with red. + Artistic color selector with a gamut mask -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). +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). -This selector does not update on change of foreground color. +The blip shows the position of current foreground color on the wheel (black&white circle) and on the value scale (black&white line). Last selected swatches are outlined. -The selector ------------- +Parameters of the wheel can be set in :ref:`artistic_color_selector_docker_wheel_preferences` menu (2). Selector settings are found under :ref:`artistic_color_selector_docker_selector_settings` menu (3). -.. image:: /images/en/Krita_Artistic_Color_Selector_Docker_2.png +Gamut Masking +~~~~~~~~~~~~~ +You can select and manage your gamut masks in the :ref:`gamut_mask_docker`. -1 - gamut masking toolbar - The toolbar consists of a toggle button to turn the mask off and on (left) and current mask title (right). +In the gamut masking toolbar (1) you can toggle the selected mask off and on (left button). You can also rotate the mask with the rotation slider (right). - 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 +.. _artistic_color_selector_docker_wheel_preferences: -Wheel preferences ------------------ +Color wheel preferences +----------------------- -.. image:: /images/en/Krita_Artistic_Color_Selector_Docker_3.png +.. _artistic_color_selector_docker_fig_wheel_preferences: +.. figure:: /images/en/Krita_Artistic_Color_Selector_Docker_3.png + Color wheel preferences -Sliders 1, 2, and 3 +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. + 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. :guilabel:`Invert 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. + loads default values for the sliders 1,2 and 3. These default values are configured in selector settings. + + +.. _artistic_color_selector_docker_selector_settings: + +Selector settings +----------------- + +.. figure:: /images/en/Krita_Artistic_Color_Selector_Docker_2.png + + Selector settings menu + +Selector Appearance (1) + Show background color indicator + toggles the bottom-right triangle with current background color. + Show numbered value scale + If checked, the value scale includes a comparative gray scale with lightness percentage. + +Color Space (2) + Set the color model used by the selector. For detailed information on color models, see :ref:`color_models`. + + Luma Coefficients (3) + If the selector's color space is HSY, you can set custom Luma coefficients and the amount of gamma correction applied to the value scale (set to 1.0 for linear scale; see :ref:`linear_and_gamma`). + +Gamut Masking Behavior (4) + The selector can be set either to :guilabel:`Enforce gamut mask`, so that colors outside the mask cannot be selected, or to :guilabel:`Just show the shapes`, where the mask is visible but color selection is not limited. + +Default Selector Steps Settings + Values the color wheel and value scale will be reset to when the :guilabel:`Reset to default` button in :ref:`artistic_color_selector_docker_wheel_preferences` is pressed. + +External Info +------------- +- `HSI and HSY for Krita’s advanced colour selector by Wolthera van Hövell tot Westerflier `_ +- `The Color Wheel, Part 7 by James Gurney `_ diff --git a/reference_manual/dockers/gamut_mask_docker.rst b/reference_manual/dockers/gamut_mask_docker.rst index ada95ca4e..00dfe917e 100644 --- a/reference_manual/dockers/gamut_mask_docker.rst +++ b/reference_manual/dockers/gamut_mask_docker.rst @@ -1,72 +1,78 @@ .. 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. +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. +.. warning:: -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.). + * 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. + +.. note:: + + 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 ------------- -- ``_ -- ``_ -- ``_ +- `Color Wheel Masking, Part 1 by James Gurney `_ +- `The Shapes of Color Schemes by James Gurney `_ +- `Gamut Masking Demonstration by James Gourney (YouTube) `_