diff --git a/reference_manual/blending_modes/arithmetic.rst b/reference_manual/blending_modes/arithmetic.rst index 798cdfe39..5158824d2 100644 --- a/reference_manual/blending_modes/arithmetic.rst +++ b/reference_manual/blending_modes/arithmetic.rst @@ -1,172 +1,172 @@ .. meta:: :description lang=en: Page about the arithmetic blending modes in Krita: Addition, Divide, Inverse Subtract, Multiply and Subtract. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Maria Luisac :license: GNU free documentation license 1.3 or later. .. _bm_cat_arithmetic: Arithmetic ---------- These blending modes are based on simple maths. -.. index:: Addition(Blending Mode) +.. index:: Addition (Blending Mode) .. _bm_addition: Addition ~~~~~~~~ Adds the numerical values of two colors together: Yellow(1, 1, 0) + Blue(0, 0, 1) = White(1, 1, 1) Darker Gray(0.4, 0.4, 0.4) + Lighter Gray(0.5, 0.5, 0.5) = Even Lighter Gray (0.9, 0.9, 0.9) .. figure:: /images/blending_modes/arithmetic/Blending_modes_Addition_Gray_0.4_and_Gray_0.5_n.png :align: center Left: **Normal**. Right: **Addition**. Light Blue(0.1608, 0.6274, 0.8274) + Orange(1, 0.5961, 0.0706) = (1.1608, 1.2235, 0.8980) → Very Light Yellow(1, 1, 0.8980) .. figure:: /images/blending_modes/arithmetic/Blending_modes_Addition_Light_blue_and_Orange.png :align: center Left: **Normal**. Right: **Addition**. Red(1, 0, 0) + Gray(0.5, 0.5, 0.5) = Pink(1, 0.5, 0.5) .. figure:: /images/blending_modes/arithmetic/Blending_modes_Addition_Red_plus_gray.png :align: center Left: **Normal**. Right: **Addition**. When the result of the addition is more than 1, white is the color displayed. Therefore, white plus any other color results in white. On the other hand, black plus any other color results in the added color. .. figure:: /images/blending_modes/arithmetic/Blending_modes_Addition_Sample_image_with_dots.png :align: center Left: **Normal**. Right: **Addition**. .. _bm_divide: Divide ~~~~~~ Divides the numerical value from the lower color by the upper color. Red(1, 0, 0) / Gray(0.5, 0.5, 0.5) = (2, 0, 0) → Red(1, 0, 0) Darker Gray(0.4, 0.4, 0.4) / Lighter Gray(0.5, 0.5, 0.5) = Even Lighter Gray (0.8, 0.8, 0.8) .. figure:: /images/blending_modes/arithmetic/Blending_modes_Divide_Gray_0.4_and_Gray_0.5_n.png :align: center Left: **Normal**. Right: **Divide**. Light Blue(0.1608, 0.6274, 0.8274) / Orange(1, 0.5961, 0.0706) = (0.1608, 1.0525, 11.7195) → Aqua(0.1608, 1, 1) .. figure:: /images/blending_modes/arithmetic/Blending_modes_Divide_Light_blue_and_Orange.png :align: center Left: **Normal**. Right: **Divide**. .. figure:: /images/blending_modes/arithmetic/Blending_modes_Divide_Sample_image_with_dots.png :align: center Left: **Normal**. Right: **Divide**. .. _bm_inverse_subtract: Inverse Subtract ~~~~~~~~~~~~~~~~ This inverts the lower layer before subtracting it from the upper layer. Lighter Gray(0.5, 0.5, 0.5)_(1_Darker Gray(0.4, 0.4, 0.4)) = (-0.1, -0.1, -0.1) → Black(0, 0, 0) .. figure:: /images/blending_modes/arithmetic/Blending_modes_Inverse_Subtract_Gray_0.4_and_Gray_0.5_n.png :align: center Left: **Normal**. Right: **Inverse Subtract**. Orange(1, 0.5961, 0.0706)_(1_Light Blue(0.1608, 0.6274, 0.8274)) = (0.1608, 0.2235, -0.102) → Dark Green(0.1608, 0.2235, 0) .. figure:: /images/blending_modes/arithmetic/Blending_modes_Inverse_Subtract_Light_blue_and_Orange.png :align: center Left: **Normal**. Right: **Inverse Subtract**. .. figure:: /images/blending_modes/arithmetic/Blending_modes_Inverse_Subtract_Sample_image_with_dots.png :align: center Left: **Normal**. Right: **Inverse Subtract**. .. _bm_multiply: Multiply ~~~~~~~~ Multiplies the two colors with each other, but does not go beyond the upper limit. This is often used to color in a black and white lineart. One puts the black and white lineart on top, and sets the layer to 'Multiply', and then draw in color on a layer beneath. Multiply will all the color to go through. White(1,1,1) x White(1, 1, 1) = White(1, 1, 1) White(1, 1, 1) x Gray(0.5, 0.5, 0.5) = Gray(0.5, 0.5, 0.5) Darker Gray(0.4, 0.4, 0.4) x Lighter Gray(0.5, 0.5, 0.5) = Even Darker Gray (0.2, 0.2, 0.2) .. figure:: /images/blending_modes/arithmetic/Blending_modes_Multiply_Gray_0.4_and_Gray_0.5_n.png :align: center Left: **Normal**. Right: **Multiply**. Light Blue(0.1608, 0.6274, 0.8274) x Orange(1, 0.5961, 0.0706) = Green(0.1608, 0.3740, 0.0584) .. figure:: /images/blending_modes/arithmetic/Blending_modes_Multiply_Light_blue_and_Orange.png :align: center Left: **Normal**. Right: **Multiply**. .. figure:: /images/blending_modes/arithmetic/Blending_modes_Multiply_Sample_image_with_dots.png :align: center Left: **Normal**. Right: **Multiply**. .. _bm_subtract: Subtract ~~~~~~~~ Subtracts the top layer from the bottom layer. White(1, 1, 1)_White(1, 1, 1) = Black(0, 0, 0) White(1, 1, 1)_Gray(0.5, 0.5, 0.5) = Gray(0.5, 0.5, 0.5) Darker Gray(0.4, 0.4, 0.4)_Lighter Gray(0.5, 0.5, 0.5) = (-0.1, -0.1, -0.1) → Black(0, 0, 0) .. figure:: /images/blending_modes/arithmetic/Blending_modes_Subtract_Gray_0.4_and_Gray_0.5_n.png :align: center Left: **Normal**. Right: **Subtract**. Light Blue(0.1608, 0.6274, 0.8274) - Orange(1, 0.5961, 0.0706) = (-0.8392, 0.0313, 0.7568) → Blue(0, 0.0313, 0.7568) .. figure:: /images/blending_modes/arithmetic/Blending_modes_Subtract_Light_blue_and_Orange.png :align: center Left: **Normal**. Right: **Subtract**. .. figure:: /images/blending_modes/arithmetic/Blending_modes_Subtract_Sample_image_with_dots.png :align: center Left: **Normal**. Right: **Subtract**. diff --git a/reference_manual/layers_and_masks/fill_layers.rst b/reference_manual/layers_and_masks/fill_layers.rst index 95e36f900..b1c147288 100644 --- a/reference_manual/layers_and_masks/fill_layers.rst +++ b/reference_manual/layers_and_masks/fill_layers.rst @@ -1,50 +1,50 @@ .. meta:: :description: How to use fill layers in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Alan :license: GNU free documentation license 1.3 or later. .. index:: Layers, Fill, Generator .. _fill_layers: =========== Fill Layers =========== A Fill Layer is a special layer that Krita generates on-the-fly that can contain either a pattern or a solid color. .. image:: /images/layers/Fill_Layer.png 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. 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 (http://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. Looping Whether or not to force the pattern to loop. Frequency The frequency of the waves used to generate the pattern. Higher frequency results in a finer noise pattern. 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). Painting on a fill layer ------------------------ A fill-layer is a single-channel layer, meaning it only has transparency. Therefore, you can erase and paint on fill-layers to make them semi-opaque, or for when you want to have a particular color only. Being single channel, fill-layers are also a little bit less memory-consuming than regular 4-channel paint layers. diff --git a/reference_manual/layers_and_masks/split_alpha.rst b/reference_manual/layers_and_masks/split_alpha.rst index 391e36496..8a95da2f2 100644 --- a/reference_manual/layers_and_masks/split_alpha.rst +++ b/reference_manual/layers_and_masks/split_alpha.rst @@ -1,36 +1,36 @@ .. meta:: :description: Split Alpha: how to work with color and alpha channels of the layer separately .. metadata-placeholder :authors: - Dmitry Kazakov - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. index:: Layers, Transparency, Alpha channel, Game .. _split_alpha: =========== Split Alpha =========== Sometimes especially in the field of game development, artists need to work with the alpha channel of the texture separately. To assist such workflow, Krita has a special functionality called :menuselection:`Split Alpha`. It allows splitting alpha channel of a paint layer into a separate :ref:`transparency_masks`. The artist can work on the transparency mask in an isolated environment and merge it back when he has finished working. How to work with alpha channel of the layer ------------------------------------------- #. |mouseright| the paint layer in the layers docker. #. Choose :menuselection:`Split Alpha --> Alpha into Mask` #. Use your preferred paint tool to paint on the Transparency Mask. Black paints transparency (see-through), white paints opacity (visible). Gray values paint semi-transparency. -#. If you would like to isolate alpha channel, enter Isolated Mode by |mouseright| + :menuselection:`Isolated Mode` (or :kbd:`Alt` + |mouseleft|) -#. When finished editing the Transparency Mask, |mouseright| on it and select :menuselection:`Split Alpha->Write as Alpha` +#. If you would like to isolate alpha channel, enter Isolated Mode by |mouseright| + :menuselection:`Isolate Layer` (or :kbd:`Alt` + |mouseleft|) +#. When finished editing the Transparency Mask, |mouseright| on it and select :menuselection:`Split Alpha --> Write as Alpha` How to save a PNG texture and keep color values in fully transparent areas -------------------------------------------------------------------------- Normally, when saving an image to a file, all fully transparent areas of the image are filled with black color. It happens because when composing the layers of the image, Krita drop color data of fully transparent pixels for efficiency reason. To avoid this of color data loss you can either avoid compositing of the image i.e. limit image to only one layer without any masks or effects, or use the following method: #. |mouseright| the layer in the layers docker. #. Choose :menuselection:`Split Alpha --> Alpha into Mask` #. |mouseright| on the created mask and select :menuselection:`Split Alpha --> Save Merged...` diff --git a/reference_manual/preferences/tablet_settings.rst b/reference_manual/preferences/tablet_settings.rst index fc211cc2b..0ac12ed9b 100644 --- a/reference_manual/preferences/tablet_settings.rst +++ b/reference_manual/preferences/tablet_settings.rst @@ -1,91 +1,91 @@ .. meta:: :description: Configuring the tablet in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Alvin Wong :license: GNU free documentation license 1.3 or later. .. index:: Preferences, Settings, Tablet, Pressure Curve .. _tablet_settings: =============== Tablet Settings =============== .. image:: /images/preferences/Krita_Preferences_Tablet_Settings.png Tablet Input Pressure Global Curve : This is the global curve setting that your tablet will use in Krita. The settings here will make your tablet feel soft or hard globally. Use Mouse Events for Right and Middle clicks. - Some tablet devices don't tell us whether the side buttons on a stylus . If you have such a device, you can try activate this workaround. Krita will try to read right and middle-button clicks as if they were coming from a mouse instead of a tablet. It may or may not work on your device (depends on the tablet driver implementation). After changing this option Krita should be restarted. + Some tablet devices don't tell us whether the side buttons on a stylus. If you have such a device, you can try activate this workaround. Krita will try to read right and middle-button clicks as if they were coming from a mouse instead of a tablet. It may or may not work on your device (depends on the tablet driver implementation). After changing this option Krita should be restarted. .. versionadded:: 4.2 For Krita 3.3 or later:Tablet Input API on Windows 8 or above only WinTab Use the WinTab API to receive tablet pen input. This is the API being used before Krita 3.3. This option is recommended for most Wacom tablets. Windows 8+ Pointer Input Use the Pointer Input messages to receive tablet pen input. This option depends on Windows Ink support from the tablet driver. This is a relatively new addition so it's still considered to be experimental, but it should work well enough for painting. You should try this if you are using an N-Trig device (e.g. recent Microsoft Surface devices) or if your tablet does not work well with WinTab. Advanced Tablet Settings for WinTab ----------------------------------- .. image:: /images/preferences/advanced-settings-tablet.png When using multiple monitors or using a tablet that is also a screen, Krita will get conflicting information about how big your screen is, and sometimes if it has to choose itself, there will be a tablet offset. This window allows you to select the appropriate screen resolution. Use Information Provided by Tablet Use the information as given by the tablet. Map to entire virtual screen Use the information as given by Windows. Map to Custom Area Type in the numbers manually. Use this when you have tried the other options. You might even need to do trial and error if that is the case, but at the least you can configure it. If you have a dual monitor setup and only the top half of the screen is reachable, you might have to enter the total width of both screens plus the double height of your monitor in this field. .. versionadded:: 4.2 To access this dialog in Krita versions older than 4.2, you had to do the following: #. Put your stylus away from the tablet. #. Start Krita without using a stylus, that is using a mouse or a keyboard. #. Press :kbd:`Shift` key and hold it. #. Touch a tablet with your stylus so Krita would recognize it. If adjusting this doesn't work, and if you have a Wacom tablet, an offset in the canvas can be caused by a faulty Wacom preference file which is not removed or replaced by reinstalling the drivers. To fix it, use the “Wacom Tablet Preference File Utility” to clear all the preferences. This should allow Krita to detect the correct settings automatically. .. warning:: Clearing all wacom preferences will reset your tablet's configuration, thus you will need to recalibrate/reconfigure it. Tablet Tester ------------- .. versionadded:: 4.1 This is a special feature for debugging tablet input. When you click on it, it will open a window with two sections. The left section is the **Drawing Area** and the right is the **Text Output**. If you draw over the Drawing Area, you will see a line appear. If your tablet is working it should be both a red and blue line. The red line represents mouse events. Mouse events are the most basic events that Krita can pick up. However, mouse events have crude coordinates and have no pressure sensitivity. The blue line represents the tablet events. The tablet events only show up when Krita can access your tablet. These have more precise coordinates and access to sensors like pressure sensitivity. .. important:: If you have no blue line when drawing on the lefthand drawing area, Krita cannot access your tablet. Check out the :ref:`page on drawing tablets ` for suggestions on what is causing this. When you draw a line, the output on the right will show all sorts of text output. This text output can be attached to a help request or a bug report to figure out what is going on. External Links -------------- `David Revoy wrote an indepth guide on using this feature to maximum advantage. `_ diff --git a/reference_manual/welcome_screen.rst b/reference_manual/welcome_screen.rst index 0d3156280..cbc94854c 100644 --- a/reference_manual/welcome_screen.rst +++ b/reference_manual/welcome_screen.rst @@ -1,41 +1,41 @@ .. meta:: :description: The welcome screen in Krita. .. metadata-placeholder :authors: - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. index:: Welcome Screen .. _welcome_screen: Welcome Screen ============== When you open Krita, starting from version 4.1.3, you will be greeted by a welcome screen. This screen makes it easy for you to get started with Krita, as it provides a collection of shortcuts for the most common tasks that you will probably be doing when you open Krita. .. image:: /images/welcome_screen.png :width: 800 The screen is divided into 4 sections: -- The "Start" section there are links to create new document as well to open - and existing document. +- The :guilabel:`Start` section there are links to create new document as well to open + an existing document. -- The "Recent Documents" section has a list of recently opened documents from +- The :guilabel:`Recent Documents` section has a list of recently opened documents from your previous sessions in Krita. -- The "Community Section" provides some links to get help, Supporting +- The :guilabel:`Community` section provides some links to get help, Supporting development of Krita, Source code of Krita and to links to interact with our user community -- The "News Section", which is disabled by default, when enabled provides you +- The :guilabel:`News` section, which is disabled by default, when enabled provides you with latest news feeds fetched from Krita website, this will help you stay up to date with the release news and other events happening in our community. Other than the above sections the welcome screen also acts as a drop area for opening any document. You just have to drag and drop a Krita document or any supported image files on the empty area around the sections to open it in Krita.