diff --git a/reference_manual/brushes/brush_engines/shape_brush_engine.rst b/reference_manual/brushes/brush_engines/shape_brush_engine.rst index 81a1a5bde..122cd879c 100644 --- a/reference_manual/brushes/brush_engines/shape_brush_engine.rst +++ b/reference_manual/brushes/brush_engines/shape_brush_engine.rst @@ -1,43 +1,43 @@ .. meta:: :description: The Shape Brush Engine manual page. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Brush Engine, Shape Brush Engine, Experiment Brush Engine, Al.Chemy .. _shape_brush_engine: ================== Shape Brush Engine ================== .. image:: /images/icons/shapebrush.svg An Al.chemy inspired brush-engine. Good for making chaos with! Parameters ---------- * :ref:`option_experiment` * :ref:`blending_modes` .. _option_experiment: Experiment Option ----------------- Speed This makes the outputted contour jaggy. The higher the speed, the jaggier. Smooth - Smoothens the output contour. This sows down the brush, but the higher the smooth, the smoother the contour. + Smoothens the output contour. This slows down the brush, but the higher the smooth, the smoother the contour. Displace This displaces the shape. The slow the movement, the higher the displacement and expansion. Fast movements shrink the shape. Winding Fill This gives you the option to use a 'non-zero' fill rules instead of the 'even-odd' fill rule, which means that where normally crossing into the shape created transparent areas, it now will not. Hard Edge Removes the anti-aliasing, to get a pixelized line. diff --git a/reference_manual/brushes/brush_settings/locked_brush_settings.rst b/reference_manual/brushes/brush_settings/locked_brush_settings.rst index 59e9337f6..7ac1e891b 100644 --- a/reference_manual/brushes/brush_settings/locked_brush_settings.rst +++ b/reference_manual/brushes/brush_settings/locked_brush_settings.rst @@ -1,46 +1,46 @@ .. meta:: :description: How to keep brush settings locked in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Locked Brush Settings .. _locked_brush_settings: ===================== Locked Brush Settings ===================== -Normally, a changing to a different brush preset will change all brush settings.Locked presets are a way for you to prevent Krita from changing all settings.So, if you want to have the texture be that same over all brushes, you lock the texture parameter. That way, all brush-preset you select will now share the same texture! +Normally, a changing to a different brush preset will change all brush settings. Locked presets are a way for you to prevent Krita from changing all settings. So, if you want to have the texture be that same over all brushes, you lock the texture parameter. That way, all brush-preset you select will now share the same texture! Locking a brush parameter ------------------------- .. image:: /images/en/Krita_2_9_brushengine_locking_01.png -To lock an option, |mouseright| the little lock icon next to the parameter name, and set it to 'Lock'. It will now be highlighted to show it's locked: +To lock an option, |mouseright| the little lock icon next to the parameter name, and set it to :guilabel:`Lock`. It will now be highlighted to show it's locked: .. image:: /images/en/Krita_2_9_brushengine_locking_02.png And on the canvas, it will show that the texture-option is locked. .. image:: /images/en/Krita_2_9_brushengine_locking_04.png Unlocking a brush parameter --------------------------- To *unlock*, |mouseright| the icon again. .. image:: /images/en/Krita_2_9_brushengine_locking_03.png There will be two options: Unlock (Drop Locked) This will get rid of the settings of the locked parameter and take that of the active brush preset. So if your brush had no texture on, using this option will revert it to having no texture. Unlock (Keep Locked) This will keep the settings of the parameter even though it's unlocked. diff --git a/reference_manual/brushes/brush_settings/masked_brush.rst b/reference_manual/brushes/brush_settings/masked_brush.rst index 1ab9d3f77..804b31cc3 100644 --- a/reference_manual/brushes/brush_settings/masked_brush.rst +++ b/reference_manual/brushes/brush_settings/masked_brush.rst @@ -1,59 +1,59 @@ .. meta:: :description: How to use the masked brush functionality in Krita. This functionality is not unlike the dual brush option from photoshop. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Radianart - Scott Petrovic - Nmaghfurusman :license: GNU free documentation license 1.3 or later. .. index:: Dual Brush, Masked Brush, Stacked Brush .. _option_masked_brush: ============ Masked Brush ============ .. versionadded:: 4.0 Masked brush is new feature that is only available in the :ref:`pixel_brush_engine`. They are additional settings you will see in the brush editor. Masked brushes allow you to combine two brush tips in one stroke. One brush tip will be a mask for your primary brush tip. A masked brush is a good alternative to texture for creating expressive and textured brushes. .. image:: /images/en/Masking-brush1.jpg :align: center .. note:: due to technological constraints, the masked brush only works in the wash painting mode. However, do remember that flow works as opacity does in the build-up painting mode. :ref:`option_brush_tip` Like with normal brush tip you can choose any brush tip and change it size, spacing, and rotation. Masking brush size is relative to main brush size. This means when you change your brush size masking tip will be changed to keep the ratio. - :ref:`Blending mode (dropdown inside Brush tip)`: + :ref:`Blending mode (drop-down inside Brush tip)`: Blending modes changes how tips are combined. .. image:: /images/en/Masking-brush2.jpg :align: center :ref:`option_size` The size sensor option of the second tip. :ref:`option_opacity_n_flow` The opacity and flow of the second tip. This is mapped to a sensor by default. Flow can be quite aggressive on subtract mode, so it might be an idea to turn it off there. :ref:`option_ratio` This affects the brush ratio on a given brush. :ref:`option_mirror` The Mirror option of the second tip. :ref:`option_rotation` The rotation option of the second tip. Best set to "fuzzy dab". :ref:`option_scatter` The scatter option. The default is quite high, so don't forget to turn it lower. .. topic:: Difference from :ref:`option_texture` You don’t need seamless texture to make cool looking brush Stroke generates on the fly, it always different Brush strokes looks same on any brush size Easier to fill some areas with solid color but harder to make it hard textured diff --git a/reference_manual/dockers/advanced_color_selector.rst b/reference_manual/dockers/advanced_color_selector.rst index 2a6d61cb9..f1ff3384e 100644 --- a/reference_manual/dockers/advanced_color_selector.rst +++ b/reference_manual/dockers/advanced_color_selector.rst @@ -1,155 +1,155 @@ .. 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 `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. +Then, under shape, you can select one of the shapes available within that color 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 an equilateral triangle selector. + Triangle is in all color models because to a certain extent, it is a wildcard shape: All color models look the same in an equilateral triangle selector. Luma Coefficients ~~~~~~~~~~~~~~~~~ This allows you to edit the Luma coefficients for the HSY model selectors to your leisure. Want to use `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 the 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 becomes 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 + 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`. +The common patches are generated from the image, and are the most common color in the image. The hotkey for them on canvas is :kbd:`U`. External Info ------------- -`HSI and HSY for Krita’s advanced colour selector. `_ +`HSI and HSY for Krita’s advanced color selector. `_ diff --git a/reference_manual/dockers/animation_docker.rst b/reference_manual/dockers/animation_docker.rst index 097f58b65..dea67b83a 100644 --- a/reference_manual/dockers/animation_docker.rst +++ b/reference_manual/dockers/animation_docker.rst @@ -1,36 +1,36 @@ .. meta:: :description: Overview of the animation docker. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier :license: GNU free documentation license 1.3 or later. .. index:: Animation, Animation Playback, Play/Pauze, Framerate, FPS, Speed .. _animation_docker: ================ Animation Docker ================ .. image:: /images/en/Animation_docker.png To have a playback of the animation, you need to use the animation docker. The first big box represents the current Frame. The frames are counted with programmer's counting so they start at 0. -Then there's two boxes for you change the playback range here.So, if you want to do a 10 frame animation, set the end to 10, and then Krita will cycle through the frames 0 to 10. +Then there are two boxes for you to change the playback range here. So, if you want to do a 10 frame animation, set the end to 10, and then Krita will cycle through the frames 0 to 10. The bar in the middle is filled with playback options, and each of these can also be hot-keyed. The difference between a keyframe and a normal frame in this case is that a normal frame is empty, while a keyframe is filled. Then, there's buttons for adding, copying and removing frames. More interesting is the next row: Onion Skin Opens the :ref:`onion_skin_docker` if it wasn't open before. Auto Frame Mode Will make a frame out of any empty frame you are working on. Currently automatically copies the previous frame. Drop frames This'll drop frames if you computer isn't fast enough to show all frames at once. This process is automatic, but the icon will become red if it's forced to do this. You can also set the speedup of the playback, which is different from the framerate. diff --git a/reference_manual/dockers/digital_color_mixer.rst b/reference_manual/dockers/digital_color_mixer.rst index 361113651..1e5aae5ce 100644 --- a/reference_manual/dockers/digital_color_mixer.rst +++ b/reference_manual/dockers/digital_color_mixer.rst @@ -1,27 +1,27 @@ .. meta:: :description: Overview of the digital color mixer docker. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Color, Color Mixing, Digital Color Mixer, Color Selector .. _digital_color_mixer_docker: =================== Digital Color Mixer =================== .. image:: /images/en/Krita_Digital_Color_Mixer_Docker.png This docker allows you to do simple mathematical color mixing. It works as follows: You have on the left side the current color. Next to that there are six columns. Each of these columns consists of three rows: -The lowest row is the color that you are mixing the current color with. Ticking this button allows you to set a different colour using a palette and the mini-color wheel. The slider above this mixing color represent the proportions of the mixing color and the current color. The higher the slider, the less of the mixing color will be used in mixing. Finally, the result color. Clicking this will change your current color to the result color. +The lowest row is the color that you are mixing the current color with. Ticking this button allows you to set a different color using a palette and the mini-color wheel. The slider above this mixing color represent the proportions of the mixing color and the current color. The higher the slider, the less of the mixing color will be used in mixing. Finally, the result color. Clicking this will change your current color to the result color. diff --git a/reference_manual/dockers/layers.rst b/reference_manual/dockers/layers.rst index a1d611d29..e2fd21aed 100644 --- a/reference_manual/dockers/layers.rst +++ b/reference_manual/dockers/layers.rst @@ -1,92 +1,92 @@ .. meta:: :description: Overview of the layers docker. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. index:: ! Layers, Passthrough Mode, Alpha Inheritance, Blending Mode, Label, Onion Skin, Layer Style, Alpha Lock .. _layer_docker: ====== Layers ====== .. image:: /images/en/Krita_Layers_Docker.png The Layers docker is for one of the core concepts of Krita: :ref:`Layer Management `. You can add, delete, rename, duplicate and do many other things to layers here. The Layer Stack --------------- You can select the active layer here. Using :kbd:`Shift` and :kbd:`Ctrl` you can select multiple layers and drag-and-drop them. You can also change the visibility, edit state, alpha inheritance and rename layers. You can open and close groups, and you can drag and drop layers, either to reorder them, or to put them in groups. Name The Layer name, just do double- |mouseleft| to make it editable, and press :kbd:`Enter` to finish editing. Label This is a color that you can set on the layer. |mouseright| the layer to get a context menu to assign a color to it. You can then later filter on these colors. Blending Mode This will set the :ref:`blending_modes` of the layer. Opacity This will set the opacity of the whole layer. Visibility An eye-icon. Clicking this can hide a whole layer. Edit State (Or layer Locking) A lock Icon. Clicking this will prevent the layer from being edited, useful when handling large amounts of layers. Alpha Lock - This will prevent the alpha of the layer being edited. In more plain terms: This will prevent the transparency of a layer being changed. Useful in colouring images. + This will prevent the alpha of the layer being edited. In more plain terms: This will prevent the transparency of a layer being changed. Useful in coloring images. Pass-through mode Only available on Group Layers, this allows you to have the blending modes of the layers within affect the layers outside the group. Doesn't work with masks currently, therefore these have a strike-through on group layers set to pass-through. Alpha Inheritance This will use the alpha of all the peers of this layer as a transparency mask. For a full explanation see :ref:`layers_and_masks`. Open or Close Layers (An Arrow Icon) This will allow you to access sub-layers of a layer. Seen with masks and groups. Onion Skin This is only available on :ref:`animated layers `, and toggles the onion skin feature. Layer Style This is only available on layers which have a :ref:`layer_style` assigned. The button allows you to switch between on/off quickly. To edit these properties on multiple layers at once, press the properties option when you have multiple layers selected or press :kbd:`F3` There, to change the names of all layers, the checkbox before :guilabel:`name` should be ticked after which you can type in a name. Krita will automatically add a number behind the layer-names. You can change other layer properties like visibility, opacity, lock states etc too. .. image:: /images/en/Krita-multi-layer-edit.png Lower buttons ------------- These are buttons for doing layer operations. Add Will by default add a new Paint Layer, but using the little arrow, you can call a sub-menu with the other layer types. Duplicate Will Duplicate the active layer(s). Can be quickly invoked with :kbd:`Ctrl` + |mouseleft| + drag. Move layer up. Will move the active layer up. Will switch them out and in groups when coming across them. Move layer down. Will move the active layer down. Will switch them out and in groups when coming across them. Layer properties. Will open the layer properties window. Delete Will delete the active layer(s). For safety reasons, you can only delete visible layers. Hot keys and Sticky Keys ------------------------ * :kbd:`Shift + Ctrl` for selecting multiple layers. * :kbd:`Ctrl` + |mouseleft| + drag - makes a duplicate of the selected layers, for you to drag and drop. * :kbd:`Ctrl + E` for merging a layer down. This also merges selected layers, layer styles and will keep selection masks in tact. Using :kbd:`Ctrl + E` on a single layer with a mask will merge down the mask into the layer. * :kbd:`Ctrl + Shift + E` merges all layers. -* :kbd:`R` + |mouseleft| allows you to select layers on canvas, similar to picking colours directly on canvas. Use :kbd:`Shift + R` + |mouseleft| for multiple layers. +* :kbd:`R` + |mouseleft| allows you to select layers on canvas, similar to picking colors directly on canvas. Use :kbd:`Shift + R` + |mouseleft| for multiple layers. * :kbd:`Ins` for adding a new layer. * :kbd:`Ctrl + G` will create a group layer. If multiple layers are selected, they are put into the group layer. * :kbd:`Ctrl + Shift + G` will quickly set-up a clipping group, with the selected layers added into the group, and a new layer added on top with alpha-inheritance turned on, ready for painting! * :kbd:`Ctrl + Alt + G` will ungroup layers inside a group. * :kbd:`Alt` + |mouseleft| on the thumbnail for isolated view of a layer. This will maintain between layers till the same action is repeated again. * :kbd:`Shift` + |mouseleft| on the eye-icon for hiding all but the current layer. * :kbd:`Page Up` and :kbd:`Page Down` for switching between layers. * :kbd:`Ctrl + Page Up` and :kbd:`Ctrl + Page Down` will move the selected layers up and down. diff --git a/reference_manual/dockers/onion_skin.rst b/reference_manual/dockers/onion_skin.rst index 451fe6556..fb0a8f3fe 100644 --- a/reference_manual/dockers/onion_skin.rst +++ b/reference_manual/dockers/onion_skin.rst @@ -1,37 +1,37 @@ .. meta:: :description: Overview of the onion skin docker. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier :license: GNU free documentation license 1.3 or later. .. index:: Animation, ! Onion Skin .. _onion_skin_docker: ================= Onion Skin Docker ================= .. image:: /images/en/Onion_skin_docker.png To make animation easier, it helps to see both the next frame as well as the previous frame sort of layered on top of the current. This is called *onion-skinning*. .. image:: /images/en/Onion_skin_01.png Basically, they are images that represent the frames before and after the current frame, usually colored or tinted. You can toggle them by clicking the lightbulb icon on a layer that is animated (so, has frames), and isn’t fully opaque. (Krita will consider white to be white, not transparent, so don’t animated on an opaque layer if you want onion skins.) -The term onionskin comes from the fact that onions are semi-transparent. In traditional animation animations would make their initial animations on semitransparent paper on top of an light-table (of the special animators variety), and they’d start with so called keyframes, and then draw frames in between. For that, they would place said keyframes below the frame they were working on, and the light table would make the lines of the keyframes shine through, so they could reference them. +The term onionskin comes from the fact that onions are semi-transparent. In traditional animation animators would make their initial animations on semitransparent paper on top of an light-table (of the special animators variety), and they’d start with so called keyframes, and then draw frames in between. For that, they would place said keyframes below the frame they were working on, and the light table would make the lines of the keyframes shine through, so they could reference them. Onion-skinning is a digital implementation of such a workflow, and it’s very useful when trying to animate. .. image:: /images/en/Onion_skin_02.png -The slider and the button with zero offset control the master opacity and visibility of all the onion skins. The boxes at the top allow you to toggle them on and off quickly, the main slider in the middle is a sort of ‘master transparancy’ while the sliders to the side allow you to control the transparency per keyframe offset. +The slider and the button with zero offset control the master opacity and visibility of all the onion skins. The boxes at the top allow you to toggle them on and off quickly, the main slider in the middle is a sort of ‘master transparency’ while the sliders to the side allow you to control the transparency per keyframe offset. Tint controls how strongly the frames are tinted, the first screen has 100%, which creates a silhouette, while below you can still see a bit of the original colors at 50%. Previous and next frame allows you set the colors. diff --git a/reference_manual/dockers/specific_color_selector.rst b/reference_manual/dockers/specific_color_selector.rst index fcbfe05d9..0e7d8e4ef 100644 --- a/reference_manual/dockers/specific_color_selector.rst +++ b/reference_manual/dockers/specific_color_selector.rst @@ -1,38 +1,38 @@ .. meta:: :description: Overview of the specific 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, Specific Color Selector, Color Space .. _specific_color_selector_docker: ======================= Specific Color Selector ======================= .. image:: /images/en/Krita_Specific_Color_Selector_Docker.png -The specific color selector allows you to choose specific colours within a color space. +The specific color selector allows you to choose specific colors within a color space. Color Space Chooser ------------------- Fairly straightforward. This color space chooser allows you to pick the color space, the bit depth and the icc profile in which you are going to pick your color. Use the checkbox 'show color space selector' to hide this feature. Sliders ------- These change per color space. If you chose 16bit float or 32 bit float, these will go from 0 to 1.0, with the decimals deciding the difference between colors. Hex Color Selector ------------------ This is only available for the color spaces with a depth of 8 bit. This allows you to input hex color codes, and receive the RGB, CMYK, LAB, XYZ or YCrCb equivalent, and the other way around! diff --git a/reference_manual/filters/adjust.rst b/reference_manual/filters/adjust.rst index 69bbe29c4..2bcd21c68 100644 --- a/reference_manual/filters/adjust.rst +++ b/reference_manual/filters/adjust.rst @@ -1,196 +1,196 @@ .. meta:: :description: Overview of the adjust filters. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. index:: Filters .. _adjust_filters: ====== Adjust ====== The Adjustment filters are image-wide and are for manipulating colors and contrast. .. index:: Dodge Dodge ----- An image-wide dodge-filter. Dodge is named after a trick in traditional dark-room photography that gave the same results. .. image:: /images/en/Dodge-filter.png Shadows The effect will mostly apply to dark tones. Midtones The effect will apply to mostly midtones. Highlights This will apply the effect on the highlights only. Exposure The strength at which this filter is applied. .. index:: Burn Burn ---- An image-wide burn-filter. Burn is named after a trick in traditional dark-room photography that gave similar results. .. image:: /images/en/Burn-filter.png Shadows The effect will mostly apply to dark tones. Midtones The effect will apply to mostly midtones. Highlights This will apply the effect on the highlights only. Exposure The strength at which this filter is applied. .. index:: Levels Filter Levels ------ This filter allows you to directly modify the levels of the tone-values of an image, by manipulating sliders for highlights, midtones and shadows. you can even set an output and input range of tones for the image.A histogram is displayed to show you the tonal distribution. The default shortcut for levels filter is :kbd:`Ctrl + L` . .. image:: /images/en/Levels-filter.png This is very useful to do an initial cleanup of scanned lineart or greyscale images. If the scanned lineart is light you can slide the black triangle to right to make it darker or if you want to remove the grey areas you can slide the white slider to left. Auto levels is a quick way to adjust tone of an image. If you want to change the settings later you can click on the :guilabel:`Create Filter Mask` button to add the levels as a filter mask. .. index:: Color Adjustment Curves, RGB Curves, Curves Filter Color Adjustment Curves ----------------------- This filter allows you to adjust each channel by manipulating the curves. You can even adjust the alpha channel and the lightness channel though this filter. This is used very often by artists as a post processing filter to slightly heighten the mood of the painting by adjust the overall color. For example a scene with fire breathing dragon may be made more red and yellow by adjusting the curves to give it more warmer look, similarly a snowy mountain scene can be made to look cooler by adjusting the blues and greens. The default shortcut for this filter is :kbd:`Ctrl + M` . .. versionchanged:: 4.1 Since 4.1 this filter can also handle Hue and Saturation curves. .. image:: /images/en/Color-adjustment-curve.png .. index:: ! Cross Channel Color Adjustment, Driving Adjustment by channel Cross-channel color adjustment ------------------------------ .. versionadded:: 4.1 Sometimes, when you are adjusting the colors for an image, you want bright colors to be more saturated, or have a little bit of brightness in the purples. The Cross-channel color adjustment filter allows you to do this. -At the top, there's two drop downs. The first one is to choose which :guilabel:`Channel` you wish to modify. The :guilabel:`Driver Channel` drop down is what channel you use to control which parts are modified. +At the top, there are two drop-downs. The first one is to choose which :guilabel:`Channel` you wish to modify. The :guilabel:`Driver Channel` drop down is what channel you use to control which parts are modified. .. image:: /images/en/cross_channel_filter.png The curve, on the horizontal axis, represents the driver channel, while the vertical axis represent the channel you wish to modify. -So if you wish to increase the saturation in the lighter parts, you pick :guilabel:`Saturation` in the first drop down, and :guilabel:`Lightness` as the driver channel. Then, pull up the right end to the top. +So if you wish to increase the saturation in the lighter parts, you pick :guilabel:`Saturation` in the first drop-down, and :guilabel:`Lightness` as the driver channel. Then, pull up the right end to the top. If you wish to desaturate everything but the teal/blues, you select :guilabel:`Saturation` for the channel and :guilabel:`Hue` for the driver. Then put a dot in the middle and pull down the dots on either sides. Brightness/Contrast curves -------------------------- This filter allows you to adjust the brightness and contrast of the image by adjusting the curves. .. deprecated:: 4.0 These have been removed in Krita 4.0, because the Color Adjustment filter can do the same. Old files with brightness/contrast curves will be loaded as Color Adjustment curves .. index:: ! Color Balance Color Balance ------------- This filter allows you to control the color balance of the image by adjusting the sliders for Shadows, Midtones and Highlights. The default shortcut for this filter is :kbd:`Ctrl + B` . .. image:: /images/en/Color-balance.png .. index:: Saturation, Desaturation, Gray Desaturate ---------- Image-wide desaturation filter. Will make any image Greyscale. Has several choices by which logic the colors are turned to grey. The default shortcut for this filter is :kbd:`Ctrl + Shift + U` . .. image:: /images/en/Desaturate-filter.png Lightness This will turn colors to grey using the HSL model. Luminosity (ITU-R BT.709) Will turn the color to grey by using the appropriate amount of weighting per channel according to ITU-R BT.709. Luminosity (ITU-R BT.601) Will turn the color to grey by using the appropriate amount of weighting per channel according to ITU-R BT.601. Average Will make an average of all channels. Min Subtracts all from one another to find the grey value. Max Adds all channels together to get a grey-value .. index:: Invert, Negative Invert ------ This filter like the name suggests inverts the color values in the image.So white (1,1,1) becomes black (0,0,0), yellow (1,1,0) becomes blue (0,1,1), etc. The default shortcut for this filter is :kbd:`Ctrl + I`. .. index:: Contrast Auto Contrast ------------- Tries to adjust the contrast the universally acceptable levels. .. index:: Hue, Saturation, Lightness, Value, Brightness, Chroma HSV/HSL Adjustment ------------------ With this filter, you can adjust the Hue, Saturation, Value or Lightness, through sliders. The default shortcut for this filter is :kbd:`Ctrl + U` . .. image:: /images/en/Hue-saturation-filter.png .. index:: Threshold, Black and White Threshold --------- A simple black and white threshold filter that uses sRGB luminosity. It'll convert any image to a image with only black and white, with the input number indicating the threshold value at which black becomes white. .. index:: ASC CDL, Slope Offset Power Curves Slope, Offset, Power -------------------- A different kind of color balance filter, with three color selectors, which will have the same shape as the one used in settings. This filter is particular because it has been defined by the American Society for Cinema as "ASC_CDL", meaning that it is a standard way of describing a color balance method. .. image:: /images/en/Krita_filters_asc_cdl.png :width: 800 :align: center Slope This represents a multiplication and determine the adjustment of the brighter colors in an image. Offset This determines how much the bottom is offset from the top, and so determines the color of the darkest colors. Power This represents a power function, and determines the adjustment of the mid-tone to dark colors of an image. diff --git a/reference_manual/filters/colors.rst b/reference_manual/filters/colors.rst index 285b64934..e0be3f591 100644 --- a/reference_manual/filters/colors.rst +++ b/reference_manual/filters/colors.rst @@ -1,60 +1,60 @@ .. meta:: :description: Overview of the color filters. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. index:: Filters .. _color_filters: ===== Color ===== -Similar to the Adjust filters, the color filter are image wide color operations. +Similar to the Adjust filters, the color filters are image wide color operations. .. index:: ! Color to Alpha .. _filter_color_to_alpha: Color to Alpha -------------- This filter allows you to make one single color transparent (alpha). By default when you run this filter white is selected, you can choose a color that you want to make transparent from the color selector .. image:: /images/en/Color-to-alpha.png The Threshold indicates how much other colors will be considered mixture of the removed color and non-removed colors. For example, with threshold set to 255, and the removed color set to white, a 50% grey will be considered a mixture of black+white, and thus transformed in a 50% transparent black. .. image:: /images/en/Krita-color-to-alpha.png :align: center This filter is really useful in separating line-art from the white background. .. _filter_color_transfer: Color Transfer -------------- This filter converts the colors of the image to colors from the reference image. This is a quick way to change a color combination of an artwork to an already saved image or a reference image. .. image:: /images/en/Color-transfer.png .. _filter_maximize_channel: Maximize Channel ---------------- This filter checks for all the channels of a each single color and set all but the highest value to 0. .. _filter_minimize_channel: Minimize Channel ---------------- -This is reverse to Maximise channel, it checks all the channels of a each single color and sets all but the lowest to 0. +This is reverse to Maximize channel, it checks all the channels of a each single color and sets all but the lowest to 0. diff --git a/reference_manual/filters/wavelet_decompose.rst b/reference_manual/filters/wavelet_decompose.rst index e544c5b82..82bc26469 100644 --- a/reference_manual/filters/wavelet_decompose.rst +++ b/reference_manual/filters/wavelet_decompose.rst @@ -1,27 +1,27 @@ .. meta:: :description: Overview of the wavelet decompose in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: ! Wavelet Decompose .. _wavelet_decompose: ================= Wavelet Decompose ================= Wavelet decompose uses wavelet scales to turn the current layer into a set of layers with each holding a different type of pattern that is visible within the image. This is used in texture and pattern making to remove unwanted noise quickly from a texture. You can find it under :menuselection:`Layers`. -When you select it, it will ask for the amount of wavelet scales. More scales, more different layers. Press okay, and t will generate a group layer containing the layers with their proper blending modes: +When you select it, it will ask for the amount of wavelet scales. More scales, more different layers. Press :guilabel:`OK`, and it will generate a group layer containing the layers with their proper blending modes: .. image:: /images/en/Wavelet_decompose.png :align: center Adjust a given layer with middle gray to neutralise it, and merge everything with the :guilabel:`Grain Merge` blending mode to merge it into the end image properly. diff --git a/reference_manual/layers_and_masks/filter_layers.rst b/reference_manual/layers_and_masks/filter_layers.rst index 7c9fb6d56..c7c9eae6d 100644 --- a/reference_manual/layers_and_masks/filter_layers.rst +++ b/reference_manual/layers_and_masks/filter_layers.rst @@ -1,31 +1,31 @@ .. meta:: :description: How to use filter layers in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Alan - Bugsbane - Boudewijn Rempt :license: GNU free documentation license 1.3 or later. .. index:: Layers, Filters .. _filter_layers: ============ Filter Layer ============ Filter layers show whatever layers are underneath them, but with a filter such as Layer Styles, Blur, Levels, Brightness / Contrast. For example, if you add a **Filter Layer**, and choose the Blur filter, you will see every layer under your filter layer blurred. Unlike applying a filter directly on to a section of a Paint Layer, Filter Layers do not actually alter the original image in the Paint Layers below them. Once again, non-destructive editing! You can tweak the filter at any time, and the changes can always be altered or removed. Unlike Filter Masks though, Filter Layers apply to the entire canvas for the layers beneath. If you wish to apply a filter layer to only *some* layers, then you can utilize the Group Layer feature and add those layers into a group with the filter layer on top of the stack. You can edit the settings for a filter layer, by double clicking on it in the Layers docker. .. note:: - Only Krita native filters (the ones in the Filter menu) can be used with Filter Layers. Filter Layers are not supported using the externally integrated G'Mic filters. + Only Krita native filters (the ones in the :guilabel:`Filters` menu) can be used with Filter Layers. Filter Layers are not supported using the externally integrated G'Mic filters. diff --git a/reference_manual/layers_and_masks/paint_layers.rst b/reference_manual/layers_and_masks/paint_layers.rst index 6d1ccc4b6..cc55e5144 100644 --- a/reference_manual/layers_and_masks/paint_layers.rst +++ b/reference_manual/layers_and_masks/paint_layers.rst @@ -1,30 +1,30 @@ .. meta:: :description: How to use paint layers in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Raghavendra Kamath - Bugsbane - Boudewijn Rempt - Alan :license: GNU free documentation license 1.3 or later. .. index:: Layers, Paint Layer, Raster, Bitmap .. _paint_layers: ============ Paint Layers ============ -Paint layers are the most commonly used type of layers used in digital paint or image manipulation software like Krita. If you've ever used layers in :program:`Photoshop` or the :program:`Gimp`, you'll be used to how they work. In short, a paint layer, also called a pixel, bitmap or raster layer, is a bitmap image (an image made up of many points of color). +Paint layers are the most commonly used type of layers used in digital paint or image manipulation software like Krita. If you've ever used layers in :program:`Photoshop` or the :program:`Gimp`, you'll be used to how they work. In short, a paint layer, also called a pixel, bitmap or raster layer, is a bitmap image (an image made up of many points of color). Paint layers let you apply many advanced effects such as smearing, smudging and distorting. This makes them the most flexible type of layer. However, paint layers don't scale well when enlarged (they pixelate), and any effects that have been applied can't be edited. To deal with these two drawbacks, digital artists will typically work at higher Pixel Per Inch (PPI) counts. It is not unusual to see PPI settings of 400 to 600 PPI for a canvas with a good amount of detail. To combat the issue of applied effects that cannot be edited it is best to take advantage of the non-destructive layer capabilities of filter, transparency and transform masks. -As long as you have enough resolution / size on your canvas though, and as long as you aren't going to need to go back and tweak an effect you created previously, then a paint layer is usually the type of layer you will want. If you click on the :guilabel:`New layer` icon in the layers docker you'll get a paint layer. Of course you can always choose the :guilabel:`New layer` dropdown to get another type. +As long as you have enough resolution / size on your canvas though, and as long as you aren't going to need to go back and tweak an effect you created previously, then a paint layer is usually the type of layer you will want. If you click on the :guilabel:`New layer` icon in the layers docker you'll get a paint layer. Of course you can always choose the :guilabel:`New layer` drop-down to get another type. The hotkey for adding a new paint layer is :kbd:`Ins`. diff --git a/reference_manual/preferences/color_selector_settings.rst b/reference_manual/preferences/color_selector_settings.rst index 43392dc3e..ea40b4dd2 100644 --- a/reference_manual/preferences/color_selector_settings.rst +++ b/reference_manual/preferences/color_selector_settings.rst @@ -1,51 +1,51 @@ .. meta:: :description: The color selector settings in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Preferences, Settings, Color Selector, Color .. _color_selector_settings: ======================= Color Selector Settings ======================= These settings directly affect Advanced Color Selector Dockers and the same dialog box appears when the user clicks the settings button in that docker as well. They also affect certain hotkey actions. -This settings menu has a dropdown for Advanced Color Selector, and Color Hotkeys. +This settings menu has a drop-down for Advanced Color Selector, and Color Hotkeys. Advanced Color Selector ----------------------- These settings are described on the page for the :ref:`advanced_color_selector_docker`. Color Hotkeys ------------- These allow you to set the steps for the following actions: Make Brush Color Darker This is defaultly set to :kbd:`K` and uses the :guilabel:`lightness` steps. This uses luminance when possible. Make Brush Color Lighter This is defaultly set to :kbd:`L` and uses the :guilabel:`lightness` steps. This uses luminance when possible. Make Brush Color More Saturated This is defaultly unset and uses the :guilabel:`saturation` steps. Make Brush Color More Desaturated This is defaultly unset and uses the :guilabel:`saturation` steps. Shift Brushcolor Hue clockwise This is defaultly unset and uses the :guilabel:`Hue` steps. Shift Brushcolor Hue counter-clockwise This is defaultly unset and uses the :guilabel:`Hue` steps. Make Brush Color Redder This is defaultly unset and uses the :guilabel:`Redder/Greener` steps. Make Brush Color Greener This is defaultly unset and uses the :guilabel:`Redder/Greener` steps. Make Brush Color Yellower This is defaultly unset and uses the :guilabel:`Bluer/Yellower` steps. Make Brush Color Bluer This is defaultly unset and uses the :guilabel:`Bluer/Yellower` steps. diff --git a/reference_manual/preferences/shortcut_settings.rst b/reference_manual/preferences/shortcut_settings.rst index a9b201aaa..85756db4f 100644 --- a/reference_manual/preferences/shortcut_settings.rst +++ b/reference_manual/preferences/shortcut_settings.rst @@ -1,42 +1,42 @@ .. meta:: :description: Configuring shortcuts in Krita. .. metadata-placeholder :authors: - Micheal Abrahams - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Preferences, Settings, Shortcuts .. _shortcut_settings: ================= Shortcut Settings ================= Most of Krita's shortcuts are configured in the menu section :menuselection:`Settings --> Configure Krita --> Configure Shortcuts`. The shortcuts configured here are simple key combinations, for example :kbd:`Ctrl + X` to cut. Shortcuts can also be sequences of key combinations (e.g. :kbd:`Shift + S` then :kbd:`B`). Krita also has a special interface for configuring the mouse and stylus events sent to the canvas, found under :ref:`canvas_input_settings`. Menu Items ---------- Search bar Entering text here will search for matching shortcuts in the shortcut list. Shortcut List Shortcuts are organized into sections. Each shortcut can be given a primary and alternate key combination Load/Save Shortcuts Profiles The bottom row of buttons contains commands for exporting and import keyboard shortcuts. .. image:: /images/en/Krita_Configure_Shortcuts.png Configuration ------------- Primary and alternate shortcuts Each shortcut is assigned a default, which may be empty. The user can assign up to two custom shortcuts, known as primary and alternate shortcuts. Simply click on a "Custom" button and type the key combination you wish to assign to the shortcut. If the key combination is already in use for another shortcut, the dialog will prompt the user to resolve the conflict. Shortcut schemes Many users migrate to Krita from other tools with different default shortcuts. Krita users may change the default shortcuts to mimic these other programs. Currently, Krita ships with defaults for Photoshop and Paint Tool Sai. Additional shortcut schemes can be placed in the ~/.config/krita/input/ folder. Saving, loading and sharing custom shortcuts - Users may wish to export their shortcuts to use across machines, or even share with other users. This can be done with the save/load drop down. Note: the shortcuts can be saved and overridden manually by backingup the text file kritashortcutsrc located in ~/.config/krita/. Additionally, the user can export a custom shortcut scheme file generated by merging the existing scheme defaults with the current customizations. + Users may wish to export their shortcuts to use across machines, or even share with other users. This can be done with the save/load drop-down. Note: the shortcuts can be saved and overridden manually by backingup the text file kritashortcutsrc located in ~/.config/krita/. Additionally, the user can export a custom shortcut scheme file generated by merging the existing scheme defaults with the current customizations. diff --git a/reference_manual/resource_management.rst b/reference_manual/resource_management.rst index 325ab322c..0103480c2 100644 --- a/reference_manual/resource_management.rst +++ b/reference_manual/resource_management.rst @@ -1,111 +1,111 @@ .. meta:: :description: Overview of Resource Management in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Resources, Bundles .. _resource_management: =================== Resource Management =================== Resources are pluggable bits of data, like brush presets or patterns. Krita has variety of resources and also has a good resource management starting from 2.9, making it really easy for artists to share and collate all the resources together Bundles ------- Starting from 2.9 Krita has a new format to manage resources it is called ''Bundles'', a bundle is just a compressed file containing all the resources together. Tags ---- Krita also has a robust tagging system for you to manage the resources on the fly while painting.All Krita resources can be tagged. These tags can be added via the resource manager, but also via the respective dockers such as brush preset docker, pattern docker etc. you can |mouseleft| the plus icon in the docker and add a tag name. in addition to adding you can rename and delete a tag as well. .. image:: /images/en/Tags-krita.png :align: center * Resources can belong to one or more tags. For example, you may have a Brush Preset of a favorite **Ink Pen** variant and have it tagged so it shows in up in your Inking, Painting, Comics and Favorites groups of brushes. * Brushes in the "Predefined" tab of the Brush Settings Editor can be also tagged and grouped for convenience. Filtering ~~~~~~~~~ Some dockers, for example the brush preset docker as shown below, have a resource filter, which functions like a powerful search bar for the resource in question. .. image:: /images/en/Brushpreset-filters.png -You can enter brush name, tag name to quickly pull up a list of brush preset you want. When you select any tag from the tag dropdown and want to include brush presets from other tags as well then you can add filters the following way: +You can enter brush name, tag name to quickly pull up a list of brush preset you want. When you select any tag from the tag drop-down and want to include brush presets from other tags as well then you can add filters the following way: * To filter based on the partial, case insensitive name of the resources you can add ``partialname`` or ``!partialname`` * To include other Tags type the respective name of the tag in square brackets like this ``[Tagname]`` or to exclude a tag type ``![Tagname]``. * For case sensitive matching of preset name type ``"Preset name"`` or ``! "Preset name"`` to exclude. An incredibly quick way to save a group or brushes into a tag is to: #. Create a new tag by |mouseleft| on the green plus sign. This will empty out the contents of the Brush Preset docker. #. Use the :guilabel:`Resource Filter` at the bottom of the :guilabel:`Brush Presets` dock or :guilabel:`Brush Settings Editor` to type in what you want to group. For instance: if you type **Pencil** in the filter box you will get all Brush Presets with **Pencil** somewhere in their name. Now you have all the Pencil-related Brush Presets together in one place. #. To finish, click the :guilabel:`Save` button (small disk icon to the right of the :guilabel:`Resource Filter` box) or press :kbd:`Enter` and all the items will be saved with the new tag you created. Now, anytime you want to open up your "digital pencil box" and see what you have to work with all you have to do is use the pull-down and select '''Pencils'''. The Resource Filter works the same way in other parts of Krita so be on the lookout for it! Resource Zooming If you find the thumbnails of the resources such as color swatches brushes and pattern to be small you can make them bigger or '''zoom in'''. All resource selectors can be zoomed in and out of, by hovering over the selector and using :kbd:`Ctrl +` |mousescroll| Managing Resources ------------------ As mentioned earlier Krita has a flexible resource management system. Starting from version 2.9 you can share various resources mentioned above by sharing a single compressed zip file created within Krita. The manage resources section in the settings was also revamped for making it easy for the artists to prepare these bundle files. You can open manage resource section by going to :menuselection:`Settings` then :menuselection:`Manage Resources` .. image:: /images/en/Manageresources.png :align: center Importing Bundles ~~~~~~~~~~~~~~~~~ To import a bundle click on :guilabel:`Import Bundles/Resources` button on the top right side of the dialog. Select .bundle file format from the file type if it is not already selected, browse to the folder where you have downloaded the bundle, select it and click open. Once the bundle is imported it will be listed in the :guilabel:`Active Bundle` section, If you don't need the bundle you can temporarily make it inactive by selecting it and clicking on the arrow button, this will move it to the :guilabel:`Inactive` section. Creating your own Bundle ~~~~~~~~~~~~~~~~~~~~~~~~ You can create your own bundle from the resources of your choice. Click on the :guilabel:`Create bundle` button. This will open a dialog box as shown below .. image:: /images/en/Creating-bundle.png The left hand section is for filling up information about the bundle like author name, website, email , bundle icon, etc. the right hand side provides a list of available resources. Choose the type of resource you wish to add in to the bundle from the drop-down above and add it to the bundle by selecting a resource and clicking on the arrow button. .. warning:: Make sure you add brush tips for used in the respective paintop preset you are adding to the bundle. If you don't provide the brush tips then the brush presets loaded from this bundle will have a 'X' mark on the thumbnail denoting that the texture is missing. And the brush preset won't be the same Once you have added all the resources you can create bundle by clicking on the save button, the bundle will be saved in the location you have specified. You can then share this bundle with other artists or load it on other workstations. Deleting Backup files --------------------- When you delete a preset from Krita. Krita doesn't actually delete the physical copy of the preset. It just adds it to a black list so that Next time when you start Krita the presets from this list are not loaded. To delete the brushes from this list click on delete backup files Deleting Imported Bundles ------------------------- In-case you wish to delete the bundles you have imported permanently click on the :guilabel:`Open Resource Folder` button in the :guilabel:`Manage Resources` dialog. This will open the resource folder in your file manager / explorer. Go inside the bundles folder and delete the bundle file which you don't need any more. The next time you start Krita the bundle and its associated resources will not be loaded. Resource Types in Krita ----------------------- .. toctree:: :maxdepth: 1 :glob: resource_management/* diff --git a/reference_manual/resource_management/resource_patterns.rst b/reference_manual/resource_management/resource_patterns.rst index 5c1071666..249518734 100644 --- a/reference_manual/resource_management/resource_patterns.rst +++ b/reference_manual/resource_management/resource_patterns.rst @@ -1,61 +1,61 @@ .. meta:: :description: Creating and managing patterns in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Resources, Patterns .. _resource_patterns: ======== Patterns ======== .. image:: /images/en/Krita_Patterns.png :align: center Patterns are small raster files that tile. They can be used as following: * As fill for a vector shape. * As fill-tool color. * As height-map for a brush using the 'texture' functionality. * As fill for a generated layer. Adding new patterns ------------------- You can add new patterns via the pattern docker, or the pattern-quick-access menu in the toolbar. -At the bottom of the docker, beneath the resource-filter input field, there's the 'import resource' and 'delete resource' buttons. Select the former to add png or jpg files to the pattern list. +At the bottom of the docker, beneath the resource-filter input field, there are the :guilabel:`Import resource` and :guilabel:`Delete resource` buttons. Select the former to add png or jpg files to the pattern list. -Similarly, removing patterns can be done by pressing the 'delete resource' button. Krita will not delete the actual file then, but rather black list it, and thus not load it. +Similarly, removing patterns can be done by pressing the :guilabel::`Delete resource` button. Krita will not delete the actual file then, but rather black list it, and thus not load it. Temporary patterns and generating patterns from the canvas ---------------------------------------------------------- You can use the pattern drop-down to generate patterns from the canvas but also to make temporary ones. -First, draw a pattern and open the pattern-drop down. +First, draw a pattern and open the pattern drop-down. .. image:: /images/en/Generating_custom_patterns1.png :align: center Then go into :guilabel:`custom` and first press :guilabel:`Update` to show the pattern in the docker. Check if it's right. Here, you can also choose whether you use this layer only, or the whole image. Since 3.0.2, Krita will take into account the active selection as well when getting the information of the two. .. image:: /images/en/Generating_custom_patterns2.png :align: center Then, click either :guilabel:`Use as Pattern` to use it as a temporary pattern, or :guilabel:`Add to predefined patterns` to save it into your pattern resources! -You can then start using it in Krita by for example making a canvas and doing :guilabel:`edit --> fill with pattern`. +You can then start using it in Krita by for example making a canvas and doing :guilabel:`Edit --> Fill with Pattern`. .. image:: /images/en/Generating_custom_patterns3.png :align: center :ref:`pattern_docker` --------------------- You can tag patterns here, and filter them with the resource filter. diff --git a/reference_manual/resource_management/resource_workspace.rst b/reference_manual/resource_management/resource_workspace.rst index f4fdae7e9..228e1c7e4 100644 --- a/reference_manual/resource_management/resource_workspace.rst +++ b/reference_manual/resource_management/resource_workspace.rst @@ -1,41 +1,41 @@ .. meta:: :description: Managing workspaces and sessions in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Resources, ! Workspaces, ! Window Layouts, ! Sessions .. _resource_workspaces: ========== Workspaces ========== Workspaces are basically saved configurations of dockers. Each workspace saves how the dockers are grouped and where they are placed on the screen. They allow you to easily move between workflows without having to manual reconfigure your setup each time. They can be as simple or as complex as you want. Workspaces can only be accessed via the toolbar or :menuselection:`Window --> Workspaces` There's no docker for them. You can save workspaces, in which your current configuration is saved. You can also import them (from a \*.kws file), or delete them (which black lists them). Workspaces can technically be tagged, but outside of the resource manager this is not possible. Window Layouts -------------- When you work with multiple screens, a single window with a single workspace won't be enough. For multi monitor setups we instead can use sessions. Window layouts allow us to store multiple windows, their positions and the monitor they were on. -You can access Window Layouts from the workspace dropdown in the toolbar. +You can access Window Layouts from the workspace drop-down in the toolbar. Primary Workspace Follows Focus This treats the workspace in the first window as the 'primary' workspace, and when you switch focus, it will switch the secondary windows to that primary workspace. This is useful when the secondary workspace is a very sparse workspace with few dockers, and the primary is one with a lot of different dockers. Show Active Image In All Windows This will synchronise the currently viewed image in all windows. Without it, different windows can open separate views for an image via :menuselection:`Window --> New View --> document.kra`. Sessions -------- Sessions allow Krita to store the images and windows opened. You can tell Krita to automatically save current or recover previous sessions if so configured in the :ref:`misc_settings`. You can access sessions from :menuselection:`File --> Sessions`. diff --git a/reference_manual/tools/calligraphy.rst b/reference_manual/tools/calligraphy.rst index 6b595ae7b..1ab72e0b9 100644 --- a/reference_manual/tools/calligraphy.rst +++ b/reference_manual/tools/calligraphy.rst @@ -1,57 +1,57 @@ .. meta:: :description lang=en: Krita's calligraphy tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Tools, Vector, Path, Variable Width Stroke, Calligraphy .. _calligraphy_tool: ================ Calligraphy Tool ================ |toolcalligraphy| The Calligraphy tool allows for variable width lines, with input managed by the tablet. Press down with the stylus/left mouse button on the canvas to make a line, lifting the stylus/mouse button ends the stroke. Tool Options ------------ **Fill** Doesn't actually do anything. **Calligraphy** -The dropdown menu holds your saved presets, the save button next to it allows you to save presets. +The drop-down menu holds your saved presets, the save button next to it allows you to save presets. Follow Selected Path If a stroke has been selected with the default tool, the calligraphy tool will follow this path. Use Tablet Pressure Uses tablet pressure to control the stroke width. Thinning This allows you to set how much thinner a line becomes when speeding up the stroke. Using a negative value makes it thicker. Width Base width for the stroke. Use Tablet Angle Allows you to use the tablet angle to control the stroke, only works for tablets supporting it. Angle The angle of the dab. Fixation The ratio of the dab. 1 is thin, 0 is round. Caps Whether or not an stroke will end with a rounding or flat. Mass How much weight the stroke has. With drag set to 0, high mass increases the 'orbit'. Drag How much the stroke follows the cursor, when set to 0 the stroke will orbit around the cursor path. .. note:: The calligraphy tool can be edited by the edit-line tool, but currently you can't add or remove nodes without converting it to a normal path. diff --git a/reference_manual/tools/color_selector.rst b/reference_manual/tools/color_selector.rst index f76e0c6c0..fb2b95c06 100644 --- a/reference_manual/tools/color_selector.rst +++ b/reference_manual/tools/color_selector.rst @@ -1,32 +1,32 @@ .. meta:: :description: Krita's color selector tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Emmet O'Neill :license: GNU free documentation license 1.3 or later. .. index:: Tools, Colors, Eyedropper, Color Selector .. _color_picker_tool: =================== Color Selector Tool =================== This tool allows you to choose a point from the canvas and make the color of that point the active foreground color. When a painting or drawing tool is selected the Color Picker tool can also be quickly accessed by pressing :kbd:`Ctrl`. .. image:: /images/en/Color_Dropper_Tool_Options.png There are several options shown in the :guilabel:`Tool Options` docker when the :guilabel:`Color Picker` tool is active: -The first drop down box allows you to select whether you want to sample from all visible layers or only the active layer. You can choose to have your selection update the current foreground color, to be added into a color palette, or to do both. +The first drop-down box allows you to select whether you want to sample from all visible layers or only the active layer. You can choose to have your selection update the current foreground color, to be added into a color palette, or to do both. .. versionadded:: 4.1 The middle section contains a few properties that change how the Color Picker picks up color; you can set a :guilabel:`Radius`, which will average the colors in the area around the cursor, and you can now also set a :guilabel:`Blend` percentage, which controls how much color is "soaked up" and mixed in with your current color. Read :ref:`mixing_colors` for information about how the Color Picker's blend option can be used as a tool for off-canvas color mixing. At the very bottom is the Info Box, which displays per-channel data about your most recently picked color. Color data can be shown as 8-bit numbers or percentages. diff --git a/reference_manual/tools/perspective_grid.rst b/reference_manual/tools/perspective_grid.rst index effdda489..f96c6398c 100644 --- a/reference_manual/tools/perspective_grid.rst +++ b/reference_manual/tools/perspective_grid.rst @@ -1,38 +1,38 @@ .. meta:: :description: Krita's perspective grid tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Tools, Perspective, Grid .. _perspective_grid_tool: ===================== Perspective Grid Tool ===================== |toolperspectivegrid| .. deprecated:: 3.0 Deprecated in 3.0, use the :ref:`assistant_perspective` instead. The perspective grid tool allows you to draw and manipulate grids on the canvas that can serve as perspective guides for your painting. A grid can be added to your canvas by first clicking the tool in the tool bar and then clicking four points on the canvas which will serve as the four corners of your grid. .. image:: /images/en/Perspectivegrid.png -The grid can be manipulated by pulling on any of its four corners. The grid can be extended by clicking and dragging a midpoint of one of its edges. This will allow you to expand the grid at other angles.This process can be repeated on any subsequent grid or grid section. You can join the corners of two grids by dragging one onto the other. Once they are joined they will always move together, they cannot be separated. You can delete any grid by clicking on the red X at its center. This tool can be used to build reference for complex scenes. +The grid can be manipulated by pulling on any of its four corners. The grid can be extended by clicking and dragging a midpoint of one of its edges. This will allow you to expand the grid at other angles. This process can be repeated on any subsequent grid or grid section. You can join the corners of two grids by dragging one onto the other. Once they are joined they will always move together, they cannot be separated. You can delete any grid by clicking on the red X at its center. This tool can be used to build reference for complex scenes. * As displayed while the Perspective Grid tool is active: * .. image:: /images/en/Multigrid.png * As displayed while any other tool is active: * .. image:: /images/en/KritaPersgridnoedit.png You can toggle the visibility of the grid from the main menu :menuselection:`View --> Show Perspective Grid` option. You can also clear any grid setup you have and start over by using the :menuselection:`View --> Clear Perspective Grid`. diff --git a/reference_manual/tools/text.rst b/reference_manual/tools/text.rst index 5a2a40bce..ed27160dd 100644 --- a/reference_manual/tools/text.rst +++ b/reference_manual/tools/text.rst @@ -1,226 +1,226 @@ .. meta:: :description: Krita's text tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Tools, Text, Vector .. _text_tool: ========= Text Tool ========= |tooltext| This tool allows you to add text to your artwork. You use it by doing |mouseleft| + drag to create a rectangular selection. When releasing |mouseleft| a default text will be created and the text editor window will pop-up. Hovering over other text shapes will highlight their bounding box. |mouseleft| on a highlighted text will select it as the active text. Tool Options ------------ .. image:: /images/en/Krita-tool-options-text.png Create new texts with... This contains features with which to create new texts, the following items are available: Font The letter type used by newly created texts. Size in pt The letter-size used by newly created texts. It is in pts (points), which is a common standard for fonts that is measured 72 points per inch. It therefore will stay proportionally the same size if you increase or decrease canvas dpi. Anchor/Align text to the left/middle/right Text alignment. This allows you to align text to the left, center it, or to the right. This is called text-anchor because svg 1.1's multiline text only uses text-anchor, and this is a slight bit different than text-align (and also the reason justify isn't available at the moment). Edit Text This will summon the text editor for the currently selected shape. This can be quickly invoked with either pressing :kbd:`Enter` or Double - |mouseleft| the shape. Text Editor ----------- A small window for all your text editing needs. The Text Editor has two tabs: Rich text and SVG source. .. image:: /images/en/Text-editor-example.png Activating You can use the Text tool to first create a text box. There are a few options in the tool options if you want to customize how the text will be adding. You will need to drag a rectangle on the canvas to create the text area. There is no word wrapping, so for now the box you draw will not have an effect on the results. Once your text is created, you can edit the text from two ways: #. Select the text with the shape selection tool (first tool). Press the :kbd:`Enter` key. The text editor will appear. #. Select the text with the shape selection tool (first tool). Then click the Text tool. In the tool options there is an :guilabel:`Edit Text` button. When you click that the text editor window will appear. Editing If you are unfamiliar with the way svg text works, use the rich text tab, it will allow you to edit the text as you see it, at the cost of not having all functionality. If you are a little bit more familiar with svg text, you can directly edit the SVG source. Do note that certain things, like stroke, fill, letter-spacing don't convert back to the rich text editor, so do be careful when switching back. Press :guilabel:`Save` as you're done with your edits to preview them on canvas. File Save :kbd:`Ctrl + S` Save current edits to the text on canvas. Close :kbd:`Ctrl + W` Close the editor Edit Basic editing functions Undo :kbd:`Ctrl + Z` Undo the last action in the text editor. Redo :kbd:`Ctrl + Shift + Z` Redo the last undone action in the text editor. Cut :kbd:`Ctrl + X` Cut selected text to the clipboard. Copy :kbd:`Ctrl + C` Copy selected text to the clipboard. Paste :kbd:`Ctrl + V` Paste text from the clipboard. Select all :kbd:`Ctrl + A` Select all text in the active editor. Deselect :kbd:`Ctrl + Shift + A` Deselect any selected text. Find :kbd:`Ctrl + F` Pops up a window with an input to find the given text in the active editor. Find Next :kbd:`F3` Searches for the next text using the last search key. Find Previous :kbd:`Shift + F3` Searches for the last text using the last search key. Replace... :kbd:`Ctrl + R` Pops up a dialog with two inputs: The string you wish to find, and the string you wish to replace it with. Will always replace ALL found instances. View Zoom Out :kbd:`Ctrl + -` Zoom out the text. Zoom In :kbd:`Ctrl + +` Zoom in the text. Insert Special Character... :kbd:`Alt + Shift + C` Pops up a dialog that allows you to search for special characters that are difficult to type in with your keyboard. Format Bold :kbd:`Ctrl + B` Set the font-weight to **bold**. Italic :kbd:`Ctrl + I` Sets the selected text *italic*. Underline :kbd:`Ctrl + U` Underline the selected text. Strike-Through Adds a strike-through text decoration. Superscript :kbd:`Ctrl + Shift + P` Sets the text to super-script baseline. Subscript :kbd:`Ctrl + Shift + B` Sets the text to subscript baseline. Weight Sets the font weight a little more specifically. Possibilities are... Light, Normal, Bold, and Black. Align Left Align the selected paragraph to the left. Align Center :kbd:`Ctrl + Alt + C` Center the selected paragraph. Align Right :kbd:`Ctrl + Alt + R` Align the selected paragraph to the right. Settings Settings... Calls up the text-editor settings dialog. Text Editor Settings ~~~~~~~~~~~~~~~~~~~~ The settings that can be configured for the text editor. Editor Mode Whether you want both the Rich Text Editor and the SVG Source Editor, or only one of either. Colors Here you can configure the syntax highlighting for the SVG source. Keyword These highlights important characters like <, /, and > Element The format for highlighting the element tag name. **text** and **tspan** are examples of element names. Attribute The format for highlighting the attributes of the tag. For example, font-family, when it isn't in the style tag is usually written as an attribute. Value The format for highlighting value of attributes. Comment This highlights xml comments, which are written as following: ````. Comments are pieces of text that never get interpreted. Editor Text Color The main color of the editor. Editor background color The main background color of the editor. Fonts - This allows you to filter the selection of fonts in the editor by writing system. Some systems have a lot of fonts specifically for showing foreign languages properly, but these might not be useful for you. You just tick the writing systems which you use yourself, and the font dropdown will only show fonts that have full support for that language. + This allows you to filter the selection of fonts in the editor by writing system. Some systems have a lot of fonts specifically for showing foreign languages properly, but these might not be useful for you. You just tick the writing systems which you use yourself, and the font drop-down will only show fonts that have full support for that language. Fine typographic control with the SVG Source tab ------------------------------------------------ So, the rich text editor cannot control all functionality that SVG text allows for. For that, you will need to touch the SVG source directly. But to do that, you will first need to go to the text editor settings and enable either :guilabel:`SVG Source` or :guilabel:`Both`. The Rich Text editor will lose some information, so if you go all out, use :guilabel:`SVG Source`. Word-spacing, Letter-spacing and Kerning ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ These three are written and read from the rich text tab, but have no sliders associated with them, because there was no time. Kerning `Kerning, in SVG 1.1 `_ behaves slightly differently than font-kerning in css. Krita by default uses the auto property for this, which means it is on. To turn it off use kerning:0 in the style section of the text. .. image:: /images/en/Krita_4_0_text_kerning.png :align: center :: No Kerning on Valhalla Tower. Letter-spacing This is the distance between letters in pts, usually. Just write ``letter-spacing`` in the style and add a distance in pts behind it. A negative value will decrease the value between words. Word-spacing This is the extra distance between words, defaulting to pts. By default, ``word-spacing: 0;`` will have it use only the width of the space character for that font. A negative value will decrease the amount of space between words: .. image:: /images/en/Krita_4_0_letter_and_word_spacing.png :align: center :: No Adjustment. Letter spacing: 2 Letter spacing: -2 Word spacing: 5 Word spacing: -5 x, y, dx, dy ~~~~~~~~~~~~ These are even finer-grained controls that can be used to position text. However, they CANNOT be reliably converted to the format of the rich text editor, because the rich text editor uses these to figure out if a line is a new-line and thus writes to these. X and Y X and Y are absolute coordinates. But because you cannot change the absolute coordinates of the text from the editor, these get added to the position when they show up in a tspan. dx and dy These are relative coordinates to the position of the previous letter. Font-stretch and Small-caps ~~~~~~~~~~~~~~~~~~~~~~~~~~~ These can also be stored and written to the rich text tab's internal format, but they don't get used in the on screen text object. Dominant Baseline, Alignment baseline, Font-size-adjust, Writing mode, Glyph-orientation, rotate ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ These are not stored in the rich text right now, and while they can be written into the SVG text, the SVG text-shape doesn't do anything with them. Krita generates font-size-adjust for the font when coming from rich text, as this can help designers when they want to use the SVG source as a basis for later adjustments. diff --git a/tutorials/flat-coloring.rst b/tutorials/flat-coloring.rst index 5d5f62178..319320583 100644 --- a/tutorials/flat-coloring.rst +++ b/tutorials/flat-coloring.rst @@ -1,329 +1,329 @@ .. meta:: :description lang=en: Common workflows used in Krita .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier :license: GNU free documentation license 1.3 or later. .. _flat_coloring: ============= Flat Coloring ============= So you've got a cool black on white drawing, and now you want to color it! The thing we’ll aim for in this tutorial is to get your line art colored in with flat colors. So no shading just yet. We’ll be going through some techniques for preparing the line art, and we’ll be using the layer docker to put each color on a separate layer, so we can easily access each color when we add shading. .. note:: This tutorial is adapted from this `tutorial `_ by the original author. Understanding Layers -------------------- To fill line art comfortably, it's best to take advantage of the layerstack. The layer stack is pretty awesome, and it's one of those features that make digital art super-convenient. In traditional art, it is not uncommon to first draw the full background before drawing the subject. Or to first draw a line art and then color it in. Computers have a similar way of working. In programming, if you tell a computer to draw a red circle, and then afterwards tell it to draw a smaller yellow circle, you will see the small yellow circle overlap the red circle. Switch the commands around, and you will not see the yellow circle at all: it was drawn before the red circle and thus ‘behind’ it. This is referred to as the “drawing order”. So like the traditional artist, the computer will first draw the images that are behind everything, and layer the subject and foreground on top of it. The layer docker is a way for you to control the drawing order of multiple images, so for example, you can have your line art drawn later than your colors, meaning that the lines will be drawn over the colors, making it easier to make it neat! Other things that a layer stack can do are blending the colors of different layers differently with blending modes, using a filter in the layer stack, or using a mask that allows you to make parts transparent. .. tip:: Programmers talk about transparency as ''Alpha'', which is because the 'a' symbol is used to present transparency in the algorithms for painting one color on top of another. Usually when you see the word ''Alpha'' in a graphics program, just think of it as affecting the transparency. Preparing your line-art ----------------------- Put the new layer underneath the layer containing the line art (drag and drop or use the up/down arrows for that), and draw on it. .. image:: /images/en/flat-coloring/Krita_filling_lineart14.png :alt: layer structure for flatting in krita …And notice nothing happening. This is because the white isn’t transparent. You wouldn’t really want it to either, how else would you make convincing highlights? So what we first need to do to color in our drawing is prepare our line art. There’s several methods of doing so, each with varying qualities. The Multiply Blending Mode -------------------------- -So, typically, to get a black and white line art usable for coloring, you can set the blending mode of the line art layer to Multiply. You do this by selecting the layer and going to the drop down that says **Normal** and setting that to **Multiply**. +So, typically, to get a black and white line art usable for coloring, you can set the blending mode of the line art layer to Multiply. You do this by selecting the layer and going to the drop-down that says **Normal** and setting that to **Multiply**. .. image:: /images/en/flat-coloring/Krita_filling_lineart1.png :alt: blend mode setup of line art flat coloring And then you should be able to see your colors! Multiply is not a perfect solution however. For example, if through some image editing magic I make the line art blue, it results into this: .. image:: /images/en/flat-coloring/Krita_filling_lineart2.png :alt: effects of multiply blend mode This is because multiply literally multiplies the colors. So it uses maths! What it first does is take the values of the RGB channels, then divides them by the max (because we're in 8bit, this is 255), a process we call normalising. Then it multiplies the normalised values. Finally, it takes the result and multiplies it with 255 again to get the result values. .. list-table:: :header-rows: 1 * - - Pink - Pink (normalised) - Blue - Blue (normalised) - Normalised, multiplied - Result * - Red - 222 - 0.8705 - 92 - 0.3607 - 0.3139 - 80 * - Green - 144 - 0.5647 - 176 - 0.6902 - 0.3897 - 99 * - Blue - 123 - 0.4823 - 215 - 0.8431 - 0.4066 - 103 This isn't completely undesirable, and a lot of artists use this effect to add a little richness to their colors. Advantages """""""""" Easy, can work to your benefit even with colored lines by softening the look of the lines while keeping nice contrast. Disadvantages """"""""""""" Not actually transparent. Is a little funny with colored lines. Using Selections ---------------- The second method is one where we'll make it actually transparent. In other programs this would be done via the channel docker, but Krita doesn't do custom channels, instead it uses Selection Masks to store custom selections. 1. Duplicate your line art layer. 2. Convert the duplicate to a selection mask. |mouseright| the layer, then :menuselection:`Convert --> to Selection Mask`. .. image:: /images/en/flat-coloring/Krita_filling_lineart_selection_1.png 3. Invert the selection mask. :menuselection:`Select --> Invert Selection`. 4. Make a new layer, and do :menuselection:`Edit --> Fill with Foreground Color`. .. image:: /images/en/flat-coloring/Krita_filling_lineart_selection_2.png And you should now have the line art on a separate layer. Advantages """""""""" Actual transparency. Disadvantages """"""""""""" Doesn't work when the line art is colored. Using Masks ----------- This is a simpler variation of the above. 1. Make a filled layer underneath the line art layer. .. image:: /images/en/flat-coloring/Krita_filling_lineart_mask_1.png 2. Convert the line art layer to a transparency mask |mouseright| the layer, then :menuselection:`Convert --> to Transparency Mask`. .. image:: /images/en/flat-coloring/Krita_filling_lineart_mask_2.png 3. Invert the transparency mask by going to :menuselection:`Filter --> Adjust --> Invert` .. image:: /images/en/flat-coloring/Krita_filling_lineart_mask_3.png Advantages """""""""" Actual transparency. You can also very easily doodle a pattern on the filled layer where the mask is on without affecting the transparency. Disadvantages """"""""""""" Doesn't work when the line art is colored already. We can still get faster. Using Color to Alpha -------------------- By far the fastest way to get transparent line art. 1. Select the line art layer and apply the color to alpha filter. :menuselection:`Filter --> Colors --> Color to Alpha`. The default values should be sufficient for line art. .. image:: /images/en/flat-coloring/Krita_filling_lineart_color_to_alpha.png Advantages """""""""" Actual transparency. Works with colored line art as well, because it removes the white specifically. Disadvantages """"""""""""" You'll have to lock the layer transparency or separate out the alpha via the right-click menu if you want to easily color it. Colouring the image =================== Much like preparing the line art, there's many different ways of coloring a layer. You could for example fill in everything by hand, but while that is very precise it also takes a lot of work. Let's take a look at the other options, shall we? Fill Tool --------- .. image:: /images/icons/fill_tool.svg :alt: fill-tool icon In most cases the fill-tool can’t deal with the anti-aliasing (the soft edge in your line art to make it more smooth when zoomed out) In Krita you have the grow-shrink option. Setting that to say… 2 expands the color two pixels. Threshold decides when the fill-tool should consider a different color pixel to be a border. And the feathering adds a extra soft border to the fill. Now, if you click on a gapless-part of the image with your preferred color… (Remember to set the opacity to 1.0!) Depending on your line art, you can do flats pretty quickly. But setting the threshold low can result in little artifacts around where lines meet: .. image:: /images/en/flat-coloring/Krita_filling_lineart7.png :alt: colors filled with fill tool However, setting the threshold high can end with the fill not recognizing some of the lighter lines. Besides these little artifacts can be removed with the brush easily. Advantages """""""""" Pretty darn quick depending on the available settings. Disadvantages """"""""""""" Again, not great with gaps or details. And it works best with aliased line-art. Selections ---------- Selections work using the selection tools. .. image:: /images/en/flat-coloring/Krita_filling_lineart15.png :alt: selecting with selection tools for filling color For example with the :ref:`bezier_curve_selection_tool` you can easily select a curved area, and the with :kbd:`Shift` + |mouseleft| (not |mouseleft| + :kbd:`Shift`, there's a difference!) you can easily add to an existing selection. .. image:: /images/en/flat-coloring/Krita_filling_lineart16.png :alt: selection mask in Krita You can also edit the selection if you have :menuselection:`Select --> Show Global Selection Mask` turned on. Then you can select the global selection mask, and paint on it. (Above with the alternative selection mode, activated in the lower-left corner of the stats bar) When done, select the color you want to fill it with and press :kbd:`Shift` + `backspace`. .. image:: /images/en/flat-coloring/Krita_filling_lineart17.png :alt: filling color in selection You can save selections in selection masks by |mouseright| a layer, and then going to :menuselection:`Add --> Local Selection`. You first need to deactivate a selection by pressing the circle before adding a new selection. This can serve as an alternative way to split out different parts of the image, which is good for more painterly pieces: .. image:: /images/en/flat-coloring/Krita_filling_lineart18.png :alt: result of coloring made with the help of selection tools Advantages """""""""" A bit more precise than filling. Disadvantages """"""""""""" Previewing your color isn't as easy. Geometric tools --------------- So you have a tool for making rectangles or circles. And in the case of Krita, a tool for bezier curves. Select the path tool (|path tool|), and set the tool options to fill=foreground and outline=none. Make sure that your opacity is set to 1.00 (fully opaque). .. |path tool| image:: /images/icons/bezier_curve.svg By clicking and holding, you can influence how curvy a line draw with the path tool is going to be. Letting go of the mouse button confirms the action, and then you’re free to draw the next point. .. image:: /images/en/flat-coloring/Krita_filling_lineart8.png :alt: filling color in line art using path tool You can also erase with a geometric tool. Just press :kbd:`E` or the eraser button. .. image:: /images/en/flat-coloring/Krita_filling_lineart9.png :alt: erasing with path tool Advantages """""""""" Quicker than using the brush or selections. Also decent with line art that contains gaps. Disadvantages """"""""""""" Fiddly details aren’t easy to fill in with this. So I recommend skipping those and filling them in later with a brush. Colorize Mask ------------- So, this is a bit of an odd one. In the original tutorial, you'll see I'm suggesting using G'Mic, but that was a few years ago, and g'mic is a little unstable on windows. Therefore, the Krita developers have been attempting to make an internal tool doing the same. It is disabled in 3.1, but if you use 4.0 or later, it is in the toolbox. Check the Colorize Mask for more information. So it works like this: 1. Select the colorize mask tool. 2. Tick the layer you're using. 3. Paint the colors your want to use on the colorize mask 4. Click update to see the results: .. image:: /images/en/flat-coloring/Krita_filling_lineart10.png :alt: coloring with colorise mask When you are satisfied, |mouseright| the colorize mask, and go to :menuselection:`Convert --> Paint Layer`. This will turn the colorize mask to a generic paint layer. Then, you can fix the last issues by aking the line art semi-transparent and painting the flaws away with a pixel art brush. .. image:: /images/en/flat-coloring/Krita_filling_lineart11.png :alt: result from the colorise mask Then, when you are done, split the layers via :menuselection:`Layers --> Split --> Split Layer`. There's a few options you can choose, but the following should be fine: .. image:: /images/en/flat-coloring/Krita_filling_lineart12.png :alt: slitting colors into islands Finally, press **Ok** and you should get the following. Each color patch it on a different layer, named by the palette in the menu and alpha locked, so you can start painting right away! .. image:: /images/en/flat-coloring/Krita_filling_lineart13.png :alt: resulting color islands from split layers Advantages """""""""" Works with anti aliased line art. Really quick to get the base work done. Can auto-close gaps. Disadvantages """"""""""""" No anti aliasing of it’s own. You have to choose between getting details right or the gaps auto-closed. Conclusion ---------- I hope this has given you a good idea of how to fill in flats using the various techniques, as well as getting a hand of different Krita features. Remember that a good flat filled line art is better than a badly shaded one, so keep practising to get the best out of these techniques! diff --git a/tutorials/krita-brush-tips/bokeh-brush.rst b/tutorials/krita-brush-tips/bokeh-brush.rst index 27c17c751..b3d608502 100644 --- a/tutorials/krita-brush-tips/bokeh-brush.rst +++ b/tutorials/krita-brush-tips/bokeh-brush.rst @@ -1,41 +1,41 @@ .. meta:: :description lang=en: Creating bokeh effect with the help of some simple brush tip. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier :license: GNU free documentation license 1.3 or later. .. _bokeh_brush_tips: ================= Brush Tips: Bokeh ================= Question -------- How do you do bokeh effects? First, blur your image with the Lens Blur to roughly 50 pixels. .. image:: /images/en/brush-tips/Krita-brushtips-bokeh_01.png :alt: krita bokeh brush setup background :width: 800 Take smudge_textured, add scattering, turn off tablet input. .. image:: /images/en/brush-tips/Krita-brushtips-bokeh_02.png :alt: Krita bokeh brush tips scatter settings Change the brush-tip to ‘Bokeh’ and check ‘overlay’ (you will want to play with the spacing as well). .. image:: /images/en/brush-tips/Krita-brushtips-bokeh_03.png :alt: Choosing the brush tip for the bokeh effect -Then make a new layer over your drawing, set that to ‘lighter color’(it’s under lighter category) and painter over it with you brush. +Then make a new layer over your drawing, set that to ‘lighter color’ (it’s under lighter category) and painter over it with you brush. .. image:: /images/en/brush-tips/Krita-brushtips-bokeh_04.png :alt: paint the bokeh circles on the background Overlay mode on the smudge brush allows you to sample all the layers, and the ‘lighter color’ blending mode makes sure that the Bokeh circles only show up when they are a lighter color than the original pixels underneath. You can further modify this brush by adding a ‘fuzzy’ sensor to the spacing and size options, changing the brush blending mode to ‘addition’, or by choosing a different brush-tip. diff --git a/tutorials/krita-brush-tips/hair.rst b/tutorials/krita-brush-tips/hair.rst index 240e3b89c..aad1855b1 100644 --- a/tutorials/krita-brush-tips/hair.rst +++ b/tutorials/krita-brush-tips/hair.rst @@ -1,30 +1,30 @@ .. meta:: :description lang=en: A tutorial about painting hair in Krita .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier :license: GNU free documentation license 1.3 or later. .. _hair: =============== Brush-tips:Hair =============== .. image:: /images/en/brush-tips/Krita-brushtips-hair_01.png :alt: some examples of hair brush Usually, most digital styles tend to focus on simple brushes, like the round brushes, and their usage in hair is no different. So, the typical example would be the one on the left, where we use *fill_round* to draw a silhouette and build up to lighter values. The reason I use *fill_round* here is because the pressure curve on the size is s-shaped. My tablet has a spring-loaded nib which also causes and s-shaped curve hard-ware wise. This means that it becomes really easy to draw thin lines and big lines. Having a trained inking hand helps a lot with this as well, and it’s something you build up over time. .. image:: /images/en/brush-tips/Krita-brushtips-hair_02.png :alt: curve setting in brush editor We then gloss the shadow parties with the *basic_tip_default*. So you can get really far with basic brushes and basic painting skills and indeed I am almost convinced tysontan, who draws our mascot, doesn’t use anything but the *basic_tip_default* sometimes. .. image:: /images/en/brush-tips/Krita-brushtips-hair_03.png :alt: brush-tip dialog -However, if you want an easy hair brush, just take the *fill_round*, go to the brush-tip pick predefined and select *A2-sparkle-1* as the brush tip. You can fiddle with the spacing below the selection of predefined brushtip to space the brush, but I believe the default should be fine enough to get result 2. +However, if you want an easy hair brush, just take the *fill_round*, go to the brush-tip, pick predefined and select *A2-sparkle-1* as the brush tip. You can fiddle with the spacing below the selection of predefined brushtip to space the brush, but I believe the default should be fine enough to get result. diff --git a/user_manual/introduction_from_other_software/introduction_from_photoshop.rst b/user_manual/introduction_from_other_software/introduction_from_photoshop.rst index 0c6e9633e..e650ed54a 100644 --- a/user_manual/introduction_from_other_software/introduction_from_photoshop.rst +++ b/user_manual/introduction_from_other_software/introduction_from_photoshop.rst @@ -1,392 +1,392 @@ .. meta:: :description: This is a introduction to Krita for users coming from Photoshop. .. metadata-placeholder :authors: - David Revoy, davidrevoy@gmail.com - Inge Wallin, inge.wallin@kogmbh.com - Wolthera van Hövell tot Westerflier, griffinvalley@gmail.com - AnetK - JakeD - Radianart - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. index:: Photoshop .. _introduction_from_photoshop: =========================================== Introduction to Krita coming from Photoshop =========================================== Introduction ------------ This document gives an introduction to Krita for users who have been using Photoshop. The intention is to make you productive in Krita as fast as possible and ease the conversion of old habits into new ones. This introduction is written with Krita version 2.9 and Photoshop CS2 and CS3 in mind. But even though things may change in the future, the basics will most likely remain the same. The first thing to remember is that Krita is a 2D paint application while Photoshop (PS) is an image manipulation program. This means that PS has more features than Krita in general, but Krita has the tools that are relevant to digital painting. When you get used to Krita, you will find that Krita has some features that are not part of PS. Krita Basics ------------ This chapter covers how you use Krita in the basic operations compared to PS. View and Display ~~~~~~~~~~~~~~~~ Navigation ^^^^^^^^^^ In Krita you can navigate your document using all these methods: #. '*Mouse wheel*': |mousescroll| down and up for zoom, and press |mousemiddle| down to pan your document. #. '*Keyboard*': with :kbd:`+` and :kbd:`-` on your numpad keyboard #. As in Photoshop, Painter, Manga Studio: :kbd:`Ctrl + Space` to zoom, and :kbd:`Space` to pan. .. note:: If you add :kbd:`Alt` and so do a :kbd:`Ctrl + Alt + Space` you’ll have a discrete zoom. Rotation ^^^^^^^^ Rotate the canvas with :kbd:`Shift + Space`, or :kbd:`Ctrl + [` and :kbd:`Ctrl + ]` or with 4 or 6. Reset the rotation with 5. Mirror ^^^^^^ Press :kbd:`M` to see your drawing or painting mirrored in the viewport. Move and Transform ^^^^^^^^^^^^^^^^^^ Moving and Transformation of contents is done using tools in Krita. You can then find them in the toolbar. If you are familiar with the way to move layers in PS by holding down :kbd:`Ctrl`, you can do the same in Krita by pressing the :kbd:`T` key for the move tool (think ‘T’ranslate) or :kbd:`Ctrl + T` for transform tool. Press :kbd:`B` to go back to the brush tool when the transformation or translation is done. To find how to make advanced deformations using the :guilabel:`Transform` tool, do not right-click on the on-canvas widget: all the option are in the :guilabel:`Tool Options` docker. Changes can be applied with :kbd:`Enter` for the Transform tool. .. note:: Move tool changes are auto-applied. Selections ~~~~~~~~~~ Like in PS, you can use :kbd:`Alt` or :kbd:`Shift` during a selection to remove or add selection to the active selection. Krita also offers sub tools for this, and you can select them in the :guilabel:`Tool Options` if a select tool is active. These sub tools are represented as icons. You can switch to those sub modes by pressing: * :kbd:`R` to replace selection * :kbd:`T` to intersect * :kbd:`A` to add to the selection (this is the one you will want to use often) * :kbd:`S` to subtract from the selection (the other one popular) Or hold: * :kbd:`Alt` to subtract from the selection * :kbd:`Shift` to add to the selection * :kbd:`Alt + Shift` to intersect .. note:: You cannot press :kbd:`Ctrl` to move the content of the selection (you have to press :kbd:`T` or select the :guilabel:`Move Tool`). Some other tips: * If you want to convert a layer to a selection (to select the visible pixels), right-click on the layer docker, and choose :guilabel:`Select Opaque`. * If you use a polygonal selection tool, or a selection which needs to be ‘closed’, you will be able to do it or by using a double-click, or by using a :kbd:`Shift` - |mouseleft| . You can scale selection. To do this, choose :menuselection:`Select --> Scale`. .. note:: Also, in the :guilabel:`Select` menu there are more classical options to grow, shrink, feather, border, etc. If you enable :guilabel:`Show Global Selection Mask` (:guilabel:`Select` menu) you can scale/rotate/transform/move or paint on selection like on regular greyscale layer. * :kbd:`Ctrl + H`: Show / Hide selection (same shortcut) * :kbd:`Ctrl + A`: Select All * :kbd:`Ctrl + Shift + A`: deselect All (and not :kbd:`Ctrl + D` as in PS) Note for Gimp user: Krita auto-expands and auto defloats new layers created from a selection after a :kbd:`Ctrl + C`, :kbd:`Ctrl + V` so you do not have to worry about not being able to paint outside the pasted element. .. note:: This doesn't work as intended right now. Intersect is a selection mode which uses :kbd:`T` as the shortcut. However :kbd:`T` is also used to switch to the :guilabel:`Move tool` so this shortcut is not functional right now. You have to use the button on the :guilabel:`Tool Options`. Layer Handling ~~~~~~~~~~~~~~ The most common shortcuts are very similar in PS and Krita: * :kbd:`Ctrl + J`: duplicate * :kbd:`Ctrl + E`: merge down * :kbd:`Ctrl + Shift + E`: flattens all (not :kbd:`Ctrl + Shift + M` as in PS) * :kbd:`Ins`: insert a new paint layer * :kbd:`Ctrl + G`: create new layer group and move selected layers to this group Groups and Blending Mode (Composite Mode): ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The group blending mode in Krita has priority over child layers and overrides it. This can be surprising for Photoshop users. On Photoshop you can use groups to just clean your layer stack and keep blending mode of your layer compositing through all the stack. In Krita the compositing will happen at first level inside the group, then taking into account the blending mode of the group itself. Both systems have pros and cons. Krita’s way is more predictable according to some artists, compositing-wise. The PS way leads to a cleaner and better ordered layer stack visually wise. Multi Layer Transform or Move ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You can select multiple layers on the stack by holding down :kbd:`Shift` as in PS, and if you move the layer inside a group you can move or transform the whole group - including doing selection on the group and cut all the sub layers inside on the fly. You can not apply filters to group to affect multiple layers. Clipping Masks ^^^^^^^^^^^^^^ Krita has no clipping mask, but there is a workaround involving layer groups and :guilabel:`Inherit alpha` (see the alpha icon). Place a layer with the shape you want to clip the other with at the bottom of a group and layers above with the :guilabel:`Inherit alpha` option. This will create the same effect as the “clipping mask” PS feature. This process of arranging groups for inherit alpha can be done automatically by :kbd:`Ctrl + Shift + G` shortcut. It creates a group with base layer and a layer above it with inherit alpha option checked by default. Pass-through mode ^^^^^^^^^^^^^^^^^ This is available in Krita, but not implemented as a blending mode. Rather, it is an option next to ‘inherit alpha’ on group layers. Smart Layers ^^^^^^^^^^^^ Instead of having smart layers that you can do non-destructive transforms on, Krita has the following set of functionality: File Layers These are layers which point to an outside file, and will get automatically updated if the outside file changes. Clone Layers These are layers that are an ‘instance’ of the layer you had selected when creating them. They get updated automatically when the original layer updates. Transform Masks These can be used to non-destructive transform all layer types, including the file and clone layers. Filter Masks Like adjustment layers, these can apply filters non-destructively to all layer types, including file and clone layers. Layer styles ^^^^^^^^^^^^ You can apply Photoshop layerstyles in Krita by right clicking any given layer type and selecting ‘layer style’ from the context menu. Krita can open and save ASL files, but not all layer style functionality is there yet. Other ^^^^^ Layers and groups can be exported. See the :guilabel:`Layer` top menu for this and many other options. -.. note:: Krita has at least 5 times more blending modes than PS. They are sorted by categories in the drop down menu. You can use the checkbox to add your most used to the Favorite categories. +.. note:: Krita has at least 5 times more blending modes than PS. They are sorted by categories in the drop-down menu. You can use the checkbox to add your most used to the Favorite categories. Paint tools ~~~~~~~~~~~ This is Krita's strong point. There are many paint tools and they have a lot of options. Tools ^^^^^ In Krita, there is a totally different paradigm for defining what ‘tools’ are compared to PS. Unlike in PS, you will not find the brush, eraser, clone, blur tool, etc. Instead, you will find a *way to trace* your strokes on the canvas: freehand, line, rectangle, circle, multiple brush, etc. When you have selected the ‘way to trace’ you can choose the *way to paint*: erasing / cloning / blurring, etc are all part of *way it paint* managed by the brush-engines options. These brush engine options are saved into so-called *presets*, which you can find on :guilabel:`Brush presets`. You can fine tune, and build your own presets using the :guilabel:`Edit Brush Settings` icon on the top tool bar. Erasing ^^^^^^^ In Krita, the eraser is not a tool, it is a Blending mode (or Composite mode). You can change each brush you have to erase by pressing :kbd:`E`. By pressing :kbd:`E` again you’ll be back to the last blending mode you had selected before pressing :kbd:`E` the first time. Useful shortcuts ^^^^^^^^^^^^^^^^ * :kbd:`Shift`: Grow or Shrink the brush size (or :kbd:`[` and :kbd:`]`). * :kbd:`/`: Switch last preset selected and current (ex: a pencil preset, and an eraser preset). * :kbd:`K` and :kbd:`L`: increment Darker and Lighter value of the active color * :kbd:`I` and :kbd:`O`: increment opacity plus or minus. * :kbd:`D`: Reset color to black/foreground and white/background * :kbd:`X`: Switch background and foreground colors * :kbd:`Shift + I` / :kbd:`Shift + N` / :kbd:`Shift + M`: a set of default keyboard shortcuts for accessing the on-canvas color selector. .. note:: Some people regard these shortcuts as somewhat unfortunate. The reason is that they are meant to be used during painting and left-:kbd:`Shift` is at the opposite end of the keyboard from :kbd:`I`, :kbd:`M` and :kbd:`N`. So for a right-handed painter, this is very difficult to do while using the stylus with a right hand. Note that you can reassign any shortcut by using the shortcut configuration in :menuselection:`Settings --> Configure Shortcuts`. Stabilization / Path Smoothing ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Using the freehand ‘paint with brush’ tool that you can find on the Tool Options, more settings for smoothing the path and stabilization of your brush strokes are available. Global pressure curve ^^^^^^^^^^^^^^^^^^^^^ If you find the feeling of Krita too hard or too soft regarding the pressure when you paint, you can set a softer or harder curve here: :menuselection:`Settings --> Configure Krita --> Tablet settings` Adjustment ^^^^^^^^^^ Like in PS, you can use the classic filters to adjust many things while painting: * :kbd:`Ctrl + L` : Levels * :kbd:`Ctrl + U`: HSV adjustment * :kbd:`Ctrl + I`: Invert Dodge / Burn / Blur Tools ^^^^^^^^^^^^^^^^^^^^^^^^^ Unlike Photoshop, where these are separate tools, in Krita, they are available via the Filter Brush Engine, which allows you to apply the majority of Krita's filters in brush form. Themes ^^^^^^ If you don’t like the dark default theme of Krita go to: :menuselection:`Settings --> Themes`, and choose a brighter or darker theme. If you don’t like the color outside your viewport go to: :menuselection:`Settings --> Configure Krita --> Display`, and change the Canvas border color. What Krita Has Over Photoshop ----------------------------- As mentioned in the introduction, Krita is a specialized paint application. Thus, it also has specialized tools for painting. Similar tools are not found in more generalized image manipulation applications such as PS. Here is a short list of the most important ones. Brush Engines ~~~~~~~~~~~~~ Krita has a lot of different so-called brush engines. These brush engines define various methods on how the pixels end up on your canvas. Brush engines with names like Grid, Particles, Sketch and others will bring you new experiences on how the brushes work and a new landscape of possible results. You can start customizing brushes by using the brush-settings editor, which is accessible via the toolbar, but it's much easier to just press :kbd:`F5`. Tags for brush presets ~~~~~~~~~~~~~~~~~~~~~~ This is a very useful way to configure brush presets. Each brush can have any amount of tags and be in any group. You can make tag for blending brushes, for texture brushes, for effect brushes, favorites etc. Settings curves ~~~~~~~~~~~~~~~ You can set setting to pressure (speed/distance/tilt/random/etc.) relation for each brush setting. .. image:: /images/en/Settings-curves.jpg :align: center The Pop-up Palette ~~~~~~~~~~~~~~~~~~ .. image:: /images/en/Krita-popuppalette.png :align: center Easily to be found on |mouseright|, the pop-up palette allows you to quickly access brushes, color history and a color selector within arm's reach. The brushes are determined by tag, and pressing the lower-right configure button calls a drop-down to change tags. This allows you to tag brushes in the preset docker by workflow, and quickly access the right brushes for the workflow you need for your image. Transformations ~~~~~~~~~~~~~~~ The Krita transformation tool can perform transformations on a group and affect child layers. There are several modes, like free, perspective, warp, the powerful cage and even liquify. Furthermore, you can use transformation masks to apply transforms non-destructively to any layer type, raster, vector group, you name it. .. figure:: /images/en/Krita-transform-mask.png :align: center :figwidth: 800 Transform masks allows non-destructive transforms Incremental Save ~~~~~~~~~~~~~~~~ You can save your artwork with the pattern : myartworksname_001.kra , myartworksname_002.kra, myartworksname_003.kra etc, by pressing a single key on the keyboard. Krita will increment the final number if the pattern "_XXX" is recognized at the end of the file's name. .. image:: /images/en/Krita-incremental-saves.png :align: center This feature allows you to avoid overwriting your files, and keep track to your older version and work in progress steps. Color to alpha Filter ~~~~~~~~~~~~~~~~~~~~~ If you want to delete the white of the paper from a scanned artwork, you can use this filter. It takes a color and turns it into pure transparency. .. image:: /images/en/Krita-color-to-alpha.png :align: center Many Blending Modes ~~~~~~~~~~~~~~~~~~~ If you like using blending modes, Krita has many of them -- over 70! You have plenty of room for experimentation. A special system of favorite blending modes has been created to let you have fast access to the ones you use the most. Painting Assistants ~~~~~~~~~~~~~~~~~~~ Krita has many painting assistants. This is a special type vector shapes with a magnetic influence on your brush strokes. You can use them as rulers, but with other shapes than just straight. .. figure:: /images/en/Krita_basic_assistants.png :align: center :figwidth: 800 Krita's vanishing point assistants in action Multibrushes: Symmetry / Parallel / Mirrored / Snowflake ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Krita's Multibrush tool allows you to paint with multiple brushes at the same time. Movements of the brushes other than the main brush is created by mirroring what you paint, or duplicating it by any number around any axis. They can also be used in parallel mode. .. image:: /images/en/Krita-multibrush.png :align: center A Wide Variety of Color Selectors ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The :guilabel:`Advanced Color Selector` docker offer you a wide choice of color selectors. .. image:: /images/en/Krita_Color_Selector_Types.png :align: center View dependent color filters ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Using the LUT docker, Krita allows you to have a separate color correction filter per view. While this is certainly useful to people who do color correction in daily life, to the artist this allows for seeing a copy of the image in luminance grayscale, so that they instantly know the values of the image. .. figure:: /images/en/Krita-view-dependant-lut-management.png :align: center :figwidth: 800 Using the LUT docker to change the colors per view HDR color painting ~~~~~~~~~~~~~~~~~~ This same LUT docker is the controller for painting with HDR colors. Using the LUT docker to change the exposure on the view, Krita allows you to paint with HDR colors, and has native open exr support! .. figure:: /images/en/Krita-hdr-painting.png :align: center :figwidth: 800 Painting with HDR colors What Krita Does Not Have ------------------------ Again, Krita is a digital paint application and Photoshop is an image manipulation program with some painting features. This means that there are things you can do in PS that you cannot do in Krita. This section gives a short list of these features. Filters ~~~~~~~ Krita has a pretty impressive pack of filters available, but you will probably miss one or two of the special filters or color adjustment tools you often use in Photoshop. For example, there is no possibility to tweak a specific color in HSV adjustment. Automatic healing tool ~~~~~~~~~~~~~~~~~~~~~~ Krita does not have an automatic healing tool. It does, however, have a so-called clone tool which can be used to do a healing correction, although not automatically. Macro Recording ~~~~~~~~~~~~~~~ Macro recording and playback exists in Krita, but it is not working well at this time. Text Tool ~~~~~~~~~ The text tool in Krita is less advanced than the similar tool in Photoshop. Blending Modes While Transforming ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When you transform a layer or a selection in Krita, the transformation appears on the top of your layer stack ignoring the layer blending mode. Other ~~~~~ Also, you cannot ‘Export for web’, ‘Image Ready’ for Gif frame or slicing web image, etc Conclusion ---------- Using these tips you will probably be up to speed with Krita in a short time. If you find other things worth mentioning in this document we, the authors, would be interested in hearing about them. Krita develops fast, so we believe that the list of things possible in Photoshop but not in Krita will become shorter in time. We will maintain this document as this happens. diff --git a/user_manual/introduction_from_other_software/introduction_from_sai.rst b/user_manual/introduction_from_other_software/introduction_from_sai.rst index f5c4216eb..68d3acab0 100644 --- a/user_manual/introduction_from_other_software/introduction_from_sai.rst +++ b/user_manual/introduction_from_other_software/introduction_from_sai.rst @@ -1,216 +1,216 @@ .. meta:: :description: This is a introduction to Krita for users coming from Paint Tool Sai. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - AnetK - Boudewijn Rempt :license: GNU free documentation license 1.3 or later. .. index:: Sai, Painttool Sai .. _introduction_from_sai: ================================================ Introduction to Krita coming from Paint Tool Sai ================================================ How do you do that in Krita? ---------------------------- This section goes over the functionalities that Krita and Paint Tool Sai share, but shows how they slightly differ. Canvas navigation ~~~~~~~~~~~~~~~~~ Krita, just like Sai, allows you to flip, rotate and duplicate the view. Unlike Sai, these are tied to keyboard keys. Mirror This is tied to :kbd:`M` to flip. Rotate There's a couple of possibilities here: either :kbd:`4` and :kbd:`6`, or :kbd:`Ctrl + [` and :kbd:`Ctrl + ]` for basic 15 degrees rotation left and right. But you can also have more sophisticated rotation with :kbd:`Shift + Space` + drag or :kbd:`Shift` + |mousemiddle| + drag. To reset the rotation, press :kbd:`5`. Zoom You can use :kbd:`+` and :kbd:`-` to zoom out and in, or use :kbd:`Ctrl` + |mousemiddle|. Use 1, 2 or 3 to reset the zoom, fit the zoom to page or fit the zoom to page width. You can use the Overview docker in :menuselection:`Settings --> Dockers` to quickly navigate over your image. You can also put these commands on the toolbar, so it'll feel a little like Sai. Go to :menuselection:`Settings --> Configure Toolbars`. There are two toolbars, but we'll add to the file toolbar. Then, you can type in something in the left column to search for it. So, for example, 'undo'. Then select the action 'undo freehand stroke' and drag it to the right. Select the action to the right, and click :menuselection:`Change text`. There, toggle :menuselection:`Hide text when toolbar shows action alongside icon` to prevent the action from showing the text. Then press :guilabel:`OK`. When done right, the :guilabel:`Undo` should now be sandwiched between the save and the gradient icon. -You can do the same for :guilabel:`Redo`, :guilabel:`Deselect`, :guilabel:`Invert Selection`, :guilabel:`Zoom out`, :guilabel:`Zoom in`, :guilabel:`Reset zoom`, :guilabel:`Rotate left`, :guilabel:`Rotate right`, :guilabel:`Mirror view` and perhaps :guilabel:`Smoothing: basic` and :guilabel:`Smoothing: stabilizer` to get nearly all the functionality of Sai's top bar in Krita's top bar. (Though, on smaller screens this will cause all the things in the brushes toolbar to hide inside a drop down to the right, so you need to experiment a little). +You can do the same for :guilabel:`Redo`, :guilabel:`Deselect`, :guilabel:`Invert Selection`, :guilabel:`Zoom out`, :guilabel:`Zoom in`, :guilabel:`Reset zoom`, :guilabel:`Rotate left`, :guilabel:`Rotate right`, :guilabel:`Mirror view` and perhaps :guilabel:`Smoothing: basic` and :guilabel:`Smoothing: stabilizer` to get nearly all the functionality of Sai's top bar in Krita's top bar. (Though, on smaller screens this will cause all the things in the brushes toolbar to hide inside a drop-down to the right, so you need to experiment a little). :guilabel:`Hide Selection`, :guilabel:`Reset Rotation` are currently not available via the Toolbar configuration, you'll need to use the shortcuts :kbd:`Ctrl + H` and :kbd:`5` to toggle these. .. note:: Krita 3.0 currently doesn't allow changing the text in the toolbar, we're working on it. Right click color picker ~~~~~~~~~~~~~~~~~~~~~~~~ You can actually set this in :menuselection:`Settings --> Configure Krita --> Canvas input settings --> Alternate invocation`. Just double-click the entry that says :kbd:`Ctrl` + |mouseleft| before :guilabel:`Pick foreground color from image` to get a window to set it to |mouseright|. .. note:: Krita 3.0 actually has a Paint-tool Sai-compatible input sheet shipped by default. Combine these with the shortcut sheet for Paint tool Sai to get most of the functionality on familiar hotkeys. Stabilizer ~~~~~~~~~~ This is in the tool options docker of the freehand brush. Use Basic Smoothing for more advanced tablets, and Stabilizer is much like Paint Tool Sai's. Just turn off :guilabel:`Delay` so that the dead-zone disappears. Transparency ~~~~~~~~~~~~~ So one of the things that throw a lot of Paint Tool Sai users off is that Krita uses checkers to display transparency, which is actually not that uncommon. Still, if you want to have the canvas background to be white, this is possible. Just choose :guilabel:`Background: As Canvas Color` in the new image dialogue and the image background will be white. You can turn it back to transparent via :menuselection:`Image --> Change image background color`. If you export a PNG or JPG, make sure to uncheck :guilabel:`Save transparency` and to make the background color white (it's black by default). .. image:: /images/en/Krita-color-to-alpha.png :align: center Like Sai, you can quickly turn a black and white image to black and transparent with the :menuselection:`Color to Alpha Filter` under :menuselection:`Filters --> Colors --> Color to Alpha` Brush Settings ~~~~~~~~~~~~~~ Another, somewhat amusing misconception is that Krita's brush engine is not very complex. After all, you can only change the Size, Flow and Opacity from the top bar. This is not quite true. It's rather that we don't have our brush settings in a docker but a drop-down on the toolbar. The easiest way to access this is with :kbd:`F5`. As you can see, it's actually quite complex. We have more than a dozen brush engines, which are a type of brush you can make. The ones you are used to from Paint Tool Sai are the Pixel Brush (ink), The Color Smudge Brush (brush) and the filter brush (dodge, burn). A simple inking brush recipe for example is to take a pixel brush, uncheck the :guilabel:`Enable Pen Settings` on opacity and flow, and uncheck everything but size from the option list. Then, go into brush-tip, pick :ref:`auto_brush_tip` from the tabs, and set the size to 25 (right-click a blue bar if you want to input numbers), turn on anti-aliasing under the brush icon, and set fade to 0.9. Then, as a final touch, set spacing to 'auto' and the spacing number to 0.8. You can configure the brushes in a lot of detail, and share the packs with others. Importing of packs and brushes can be done via the :menuselection:`Settings --> Manage Resources`, where you can import .bundle files or .kpp files. Erasing ~~~~~~~ Erasing is a blending mode in Krita, much like the transparency mode of Paint Tool Sai. It's activated with :kbd:`E` or you can select it from the Blending Mode drop-down... Blending Modes ~~~~~~~~~~~~~~ Krita has a lot of Blending modes, and thankfully all of Paint Tool Sai's are amongst them except binary. To manage the blending modes, each of them has a little check-box that you can tick to add them to the favorites. Multiple, Screen, Overlay and Normal are amongst the favorites. Krita's Luminosity is actually slightly different from Paint Tool Sai's and it replaces the relative brightness of color with the relative brightness of the color of the layer. Sai's Luminosity mode is actually the same as Krita's *Addition* or *linear dodge* mode. The Shade mode is the same as *Color Burn* and *Hard Mix* is the same as the lumi and shade mode. Layers ~~~~~~ Lock Alpha This is the checker box icon next to every layer. Clipping group For Clipping masks in Krita you'll need to put all your images in a single layer, and then press the 'a' icon, or press :kbd:`Ctrl + Shift + G` Ink layer This is a vector layer in Krita, and also holds the text. Masks These grayscale layers that allow you to affect the transparency are called transparency masks in Krita, and like Paint Tool Sai, they can be applied to groups as well as layers. If you have a selection and make a transparency mask, it will use the selection as a base. Clearing a layer This is under :menuselection:`Edit --> Clear`, but you can also just press :kbd:`Del`. Mixing between two colors ~~~~~~~~~~~~~~~~~~~~~~~~~ If you liked this docker in Paint Tool Sai, Krita's Digital Color Selector docker will be able to help you. Dragging the sliders will change how much of a color is mixed in. What do you get extra when using Krita? --------------------------------------- More brush customization ~~~~~~~~~~~~~~~~~~~~~~~~ You already met the brush settings editor. Sketch brushes, grid brushes, deform brushes, clone brushes, brushes that are textures, brushes that respond to tilt, rotation, speed, brushes that draw hatches and brushes that deform the colors. Krita's variety is quite big. More color selectors ~~~~~~~~~~~~~~~~~~~~ You can have HSV sliders, RGB sliders, triangle in a hue ring. But you can also have HSI, HSL or HSY' sliders, CMYK sliders, palettes, round selectors, square selectors, tiny selectors, big selectors, color history and shade selectors. Just go into :menuselection:`Settings --> Configure Krita --> Advanced Color Selector Settings` to change the shape and type of the main big color selector. .. image:: /images/en/Krita_Color_Selector_Types.png :align: center You can call the color history with :kbd:`H`, common colors with :kbd:`U` and the two shade selectors with :kbd:`Shift + N` and :kbd:`Shift + M`. The big selector can be called with :kbd:`Shift + I` on canvas. Geometric Tools ~~~~~~~~~~~~~~~ Circles, rectangles, paths, Krita allows you to draw these easily. Multibrush, Mirror Symmetry and Wrap Around ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ These tools allow you to quickly paint a mirrored image, mandala or tiled texture in no time. Useful for backgrounds and abstract vignettes. .. image:: /images/en/Krita-multibrush.png :align: center Assistants ~~~~~~~~~~ The painting assistants can help you to set up a perspective, or a concentric circle and snap to them with the brush. .. figure:: /images/en/Krita_basic_assistants.png :alt: Krita's vanishing point assistants in action :width: 800 Krita's vanishing point assistants in action Locking the Layer ~~~~~~~~~~~~~~~~~ Lock the layer with the padlock so you don't draw on it. Quick Layer select ~~~~~~~~~~~~~~~~~~ If you hold :kbd:`R` and press a spot on your drawing, Krita will select the layer underneath the cursor. Really useful when dealing with a large number of layers. Color Management ~~~~~~~~~~~~~~~~ This allows you to prepare your work for print, or to do tricks with the LUT docker so you can diagnose your image better. For example, using the LUT docker to turn the colors grayscale in a separate view, so you can see the values instantly. .. image:: /images/en/Krita-view-dependant-lut-management.png :align: center Advanced Transform Tools ~~~~~~~~~~~~~~~~~~~~~~~~ Not just rotate and scale, but also cage, wrap, liquify and non-destructive transforms with the transform tool and masks. .. image:: /images/en/Krita_transforms_recursive.png :align: center More Filters and non-destructive filter layers and masks ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ With filters like color balance and curves you can make easy shadow layers. In fact, with the filter layers and layer masks you can make them apply on the fly as you draw underneath. .. image:: /images/en/Krita_ghostlady_3.png :align: center Pop-up palette ~~~~~~~~~~~~~~~ This is the little circular thing that is by default on the right click. You can organize your brushes in tags, and use those tags to fill up the pop-up palette. It also keeps a little color selector and color history, so you can switch brushes on the fly. .. image:: /images/en/Krita-popuppalette.png :align: center What does Krita lack compared to Paint Tool Sai? ------------------------------------------------ * Variable width vector lines * The selection source option for layers * Dynamic hard-edges for strokes (the fringe effect) * No mix-docker. * No Preset-tied stabilizer. * No per-preset hotkeys. Conclusion ---------- I hope this introduction got you a little more excited to use Krita, if not feel a little more at home. diff --git a/user_manual/loading_saving_brushes.rst b/user_manual/loading_saving_brushes.rst index f29538db4..ced85280d 100644 --- a/user_manual/loading_saving_brushes.rst +++ b/user_manual/loading_saving_brushes.rst @@ -1,485 +1,485 @@ .. meta:: :description: Detailed guide on the brush settings dialog in Krita as well as how to make your own brushes and how to share them. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Raghavendra Kamath - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Brush Settings .. _loading_saving_brushes: ========================== Loading and Saving Brushes ========================== In the real world, when painting or drawing, you don't just use one tool. You use pencils, erasers, paintbrushes, different types of paint, inks, crayons, etc. All these have different ways of making marks. In a digital program like Krita you have something similar. We call this a brush engine. And much like how cars have different engines that give different feels when driving, or how pencils make distinctly different marks than rollerball pens, different brush engines have totally different feels. The brush engines have a lot of different settings as well. So, you can save those settings into presets. Unlike Photoshop, Krita makes a difference between brush-tips and brush-presets. Tips are only a stamp of sorts, while the preset uses a tip and many other settings to create the full brush. -The Brush settings dropdown ---------------------------- +The Brush settings drop-down +---------------------------- To start, the Brush Settings Editor panel can be accessed in the toolbar, between the :guilabel:`Blending Modes` button on the right and the :guilabel:`Patterns` button on the left. Alternately, you can use the function key :kbd:`F5` to open it. When you open Brush Settings Editor panel you will see something like this: -Tour of the brush settings dropdown -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Tour of the brush settings drop-down +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. image:: /images/en/Krita_4_0_Brush_Settings_Layout.svg :width: 800 -The brush settings drop down is divided into six areas, +The brush settings drop-down is divided into six areas, Section A - General Information ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This contains the **Preset Icon**, **Live Brush Preview**, the **Preset Name**, the **Engine** name, and several buttons for saving, renaming, and reloading. Krita's brush settings are stored into the metadata of a 200x200 png (the KPP file), where the image in the png file becomes the preset icon. This icon is used everywhere in Krita, and is useful for differentiating brushes in ways that the live preview cannot. The live preview shows a stroke of the current brush as a little s-curve wiggle, with the pressure being non-existent on the left, and increasing to full pressure as it goes to the right. It can thus show the effect of the Pressure, Drawing Angle, Distance, Fade and Fuzzy Dab sensors, but none of the others. For some brush engines it cannot show anything. For the color smudge, filter brush and clone tool, it shows an alternating line pattern because these brush engines use the pixels already on canvas to change their effect. After the preset name, there's a button for **renaming** the brush. This will save the brush as a new brush and blacklist the previous name. Engine '''''' The engine of a brush is the underlying programming that generates the stroke from a brush. What that means is that different brush engines have different options and different results. You can see this as the difference between using crayons, pencils and inks, but because computers are maths devices, most of our brush engines produce different things in a more mathematical way. For most artists the mathematical nature doesn't matter as much as the different textures and marks each brush engine, and each brush engine has its own distinct flavor and use, and can be further customized by modifying the options. Reloading ''''''''' If you change a preset, an icon will appear behind the engine name. This is the :guilabel:`reload` button. You can use it to revert to the original brush settings. Saving a preset '''''''''''''''' On the right, there's :guilabel:`Save New Brush Preset` and :guilabel:`Overwrite Brush`. Overwrite Brush This will only enable if there are any changes. Pressing this will override the current preset with the new settings, keeping the name and the icon intact. It will always make a timestamped back up in the resources folder. Save New Brush Preset Will take the current preset and all its changes and save it as a new preset. If no change was made, you will be making a copy of the current preset. Save new preset will call up the following window, with a mini scratch pad, and all sorts of options to change the preset icon: .. image:: /images/en/Krita_4_0_Save_New_Brush_Preset_Dialog.png The image on the left is a mini scratchpad, you can draw on it with the current brush, allowing small modifications on the fly. Brush Name The Name of your brush. This is also used for the KPP file. If there's already a brush with that name, it will effectively overwrite it. Load Existing Thumbnail This will load the existing thumbnail inside the preset. Load scratch pad thumbnail This will load the dashed area from the big scratch pad (Section C) into the thumbnail area. Load Image With this you can choose an image from disk to load as a thumbnail. Load from Icon Library This opens up the icon library. Clear Thumbnail This will make the mini scratch pad white. The Icon Library '''''''''''''''' To make making presets icons faster, Krita got an icon library. .. image:: /images/en/Krita_4_0_Preset_Icon_Library_Dialog.png It allows you to select tool icons, and an optional small emblem. When you press :guilabel:`OK` it will load the resulting combination into the mini scratch pad and you can draw in the stroke. If you go to your resources folder, there's a folder there called "preset\_icons", and in this folder there are "tool\_icons" and "emblem\_icons". You can add semi-transparent pngs here and Krita will load those into the icon library as well so you can customize your icons even more! At the top right of the icon library, there are three sliders. They allow you to adjust the tool icon. The top two are the same Hue and Saturation as in HSL adjustment, and the lowest slider is a super simple levels filter. This is done this way because the levels filter allows maintaining the darkest shadows and brightest highlights on a tool icon, making it much better for quick adjustments. If you're done with everything, you can press :guilabel:`Save` in the :guilabel:`Save New Preset` dialog and Krita will save the new brush. Section B - The Preset Chooser ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The preset chooser is much the same as the preset docker and the -preset dropdown on :kbd:`F6`. It's unique in that it allows you to filter by +preset drop-down on :kbd:`F6`. It's unique in that it allows you to filter by engine and this is also where you can create brushes for an engine from scratch. It is by default collapsed, so you will need to press the arrow at the top left of the brush engine to show it. -The top drop down is set to “all” by default, which means it shows all +The top drop-down is set to “all” by default, which means it shows all engines. It then shows a tag section where you can select the tags, the preset list and the search bar. Underneath that there's a plus icon, which when pressed gives you the full list of Krita's engines. Selecting an engine from the list will show the brushes for that engine. The trashcan icon does the same as it does in the preset docker: delete, or rather, blacklist a preset so it won't show up in the list. Section C - The Scratch pad ^^^^^^^^^^^^^^^^^^^^^^^^^^^ When you tweak your brushes, you want to be able to check what each -setting does. That's why, to the right of the settings drop down, there +setting does. That's why, to the right of the settings drop-down, there is a scratch pad. It is by default collapsed, so you will have to press the arrow at the top right of the brush settings to show it. When saving a new preset, you can choose to get the icon from the scratch pad, this will load the dash area into the mini scratch pad of the Save New Preset dialog. The scratch pad has five buttons underneath it. These are in order for: #. Showing the current brush image #. Adding a gradient to the scratch pad (useful for smudge brushes) #. Filling with the background color #. Clearing everything on the scratch pad. Section D - The Options List ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The options, as stated above, are different per brush engine. These represent the different parameters, toggles and knobs that you can turn to make a brush preset unique. For a couple of options, the main things to change are sliders and check boxes, but for a lot of them, they use curves instead. Some options can be toggled, as noted by the little check boxes next to them, but others, like flow and opacity are so fundamental to how the brush works, that they are always on. The little padlock icon next to the options is for locking the brush. This has its own page. Section E - Option Configuration Widget ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Where section D is the list of options, section E is the widget where you can change things. Using sensor curves ''''''''''''''''''' One of the big important things that make art unique to the artist who created it is the style of the strokes. Strokes are different because they differ in speed, rotation, direction, and the amount of pressure put onto the stylus. Because these are so important, we would want to customize how these values are understood in detail. The best way to do this is to use curves. Curves show up with the size widget for example. With an inking brush, we want to have size mapped to pressure. Just toggling the size option in the option list will do that. However, different people have different wrists and thus will press differently on their stylus. Someone who presses softly tends to find it easy to make thin strokes, but very difficult to make thick strokes. Conversely, someone who presses hard on their stylus naturally will have a hard time making thin strokes, but easily makes thick ones. Such a situation can be improved by using the curves to map pressure to output thinner lines or thicker ones. The brush settings curves even have quick curve buttons for these at the top. Someone who has a hard time making small strokes should try the second to last concave button, while someone who has a hard time making thick strokes should try the third button, the S shape. Underneath the curve widget there are two more options: Share Curves across all settings This is for the list of sensors. Toggling this will make all the sensors use the same curve. Unchecked, all checked sensors will have separate curves. Curves Calculation Mode This indicates how the multiple values of the sensor curves are used. The curves always go from 0 to 1.0, so if one curve outputs 0.5 and the other 0.7, then... Multiply Will multiply the two values, 0.5\*0.7 = 0.35 Addition Will add the two to a maximum of 1.0, so 0.5+0.7 = 1.2, which is then capped at 1.0. Maximum Will compare the two and pick the largest. So in the case of 0.5 and 0.7, the result is 0.7. Minimum Will compare the two and pick the smallest. So in the case of 0.5 and 0.7, the result is 0.5. Difference Will subtract the smallest value from the largest, so 0.7-0.5 = 0.2 It's maybe better to see with the following example: .. image:: /images/en/Krita_4_0_brush_curve_calculation_mode.png The first two are regular, the rest with different multiplication types. #. Is a brush with size set to the distance sensor. #. Is a brush with the size set to the fade sensor. #. The size is calculated from the fade and distance sensors multiplied. #. The size is calculated from the fade and distance sensors added to each other. Notice how thick it is. #. The size takes the maximum value from the values of the fade and distance sensors. #. The size takes the minimum value from the values of the fade and distance sensors. #. The size is calculated by having the largest of the values subtracted with the smallest of the values. Section F - Miscellaneous options ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Temporarily Save Tweaks to Preset (Dirty Presets) This enables dirty presets. Dirty presets store the tweaks you make as long as this session of Krita is active. After that, they revert to default. Dirtied presets can be recognized by the icon in the top-left of the preset. .. figure:: /images/en/Krita_4_0_dirty_preset_icon.png :figwidth: 450 The icon in the top left of the first two presets indicate it is “Dirty”, meaning there are tweaks made to the preset. Eraser Switch Size This switches the brush to a separately stored size when using the :kbd:`E` key. Eraser Switch Opacity Same as above, but then with Eraser opacity. Instant Preview This allows you to toggle instant preview on the brush. The Instant Preview has a super-secret feature: when you press the instant preview label, and then right click it, it will show a threshold slider. This slider determines at what brush size instant preview is activated for the brush. This is useful because small brushes can be slower with instant preview, so the threshold ensures it only activates when necessary. The On-canvas brush settings ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ There are on-canvas brush settings. If you open up the pop-up palette, there should be an icon on the bottom-right. Press that to show the on-canvas brush settings. You will see several sliders here, to quickly make small changes. At the top it shows the currently active preset. Next to that is a settings button, click that to get a list of settings that can be shown and organized for the given brush engine. You can use the up and down arrows to order their position, and then left and right arrows to add or remove from the list. You can also drag and drop. Making a Brush Preset --------------------- Now, let's make a simple brush to test the waters with: Getting a default for the brush engine. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ First, open the settings with :kbd:`F5`. Then, press the arrow on the upper left to open the preset chooser. There, press the “+” icon to get a list of engines. For this brush we're gonna make a pixel brush. Example: Making an inking brush ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ #. Draw on the scratch pad to see what the current brush looks like. If done correctly, you should have a 5px wide brush that has pressure set to opacity. #. Let us turn off the opacity first. Click on the :ref:`opacity ` option in the right-hand list. The settings should now be changed to a big curve. This is the sensor curve. #. Uncheck the :guilabel:`Enable Pen Settings` checkbox. #. Test on the scratch pad... there still seems to be something affecting opacity. This is due to the :ref:`flow ` option. #. Select the Flow option from the list on the right hand. Flow is like Opacity, except that Flow is per dab, and opacity is per stroke. #. Uncheck the :guilabel:`Enable Pen Settings` checkbox here as well. Test again. #. Now you should be getting somewhere towards an inking brush. It is still too small however, and kinda grainy looking. Click :ref:`Brush Tip ` in the brush engine options. #. Here, the diameter is the size of the brush-tip. You can touch the slider change the size, or right-click it and type in a value. Set it to 25 and test again. It should be much better. #. Now to make the brush feel a bit softer, turn down the fade parameter to about 0.9. This'll give the *brush mask* a softer edge. #. If you test again, you'll notice the fade doesn't seem to have much effect. This has to do with the spacing of the dabs: The closer they are together, the harder the line is. By default, this is 0.1, which is a bit low. If you set it to 10 and test, you'll see what kind of effect spacing has. The :ref:`Auto ` checkbox changes the way the spacing is calculated, and Auto Spacing with a value of 0.8 is the best value for inking brushes. Don't forget that you can use right-click to type in a value. #. Now, when you test, the fade seems to have a normal effect... except on the really small sizes, which look pixelly. To get rid of that, check the anti-aliasing check box. If you test again, the lines should be much nicer now. Saving the new Brush ~~~~~~~~~~~~~~~~~~~~ When you're satisfied, go to the upper left and select :guilabel::`Save new preset`. You will get the save preset dialog. Name the brush something like “My Preset”. Then, select :guilabel:`Load from Icon Library` to get the icon library. Choose a nice tool icon and press :guilabel:`OK`. The icon will be loaded into the mini scratch pad on the left. Now doodle a nice stroke next to it. If you feel you messed up, just go back to the icon library to load a new icon. Finally press :guilabel:`Save`, and your brush should be done. You can further modify your inking brush by... Changing the amount of pressure you need to put on a brush to make it full size. To do this, select the :ref:`size ` option, and press the pressure sensor from the list next to the curve. The curve should look like a straight line. Now if you want a brush that gets big with little pressure, tick on the curve to make a point, and drag the point to the upper-left. The more the point is to the upper-left, the more extreme the effect. If you want instead a brush that you have to press really hard on to get to full size, drag the dot to the lower-right. Such a brush is useful for fine details. Don't forget to save the changes to your brush when done. Making the fine lines look even softer by using the flow option. To do this, select the flow option, and turn back on the :guilabel:`Enable Pen Settings` check box. Now if you test this, it is indeed a bit softer, but maybe a bit too much. Click on the curve to make a dot, and drag that dot to the top-left, half-way the horizontal of the first square of the grid. Now, if you test, the thin lines are much softer, but the hard your press, the harder the brush becomes. Sharing Brushes --------------- Okay, so you've made a new brush and want to share it. There are several ways to share a brush preset. The recommended way to share brushes and presets is by using the resource bundle system. We have detailed instructions on how to use them on the :ref:`resource management page `. However, there are various old-fashioned ways of sharing brushes that can be useful when importing and loading very old packs: Sharing a single preset ~~~~~~~~~~~~~~~~~~~~~~~ There are three types of resources a single preset can take: #. A Paintoppreset file: This is the preset proper, with the icon and the curves stored inside. #. A Brush file: This is the brush tip. When using masked brushes, there's two of these. #. A Pattern file: this is when you are using textures. So when you have a brush that uses unique predefined tips for either brush tip or masked brush, or unique textures you will need to share those resources as well with the other person. To find those resources, go to :menuselection:`Settings --> Manage Resources --> Open Resource Folder`. There, the preset file will be inside paintoppresets, the brush tips inside brushes and the texture inside patterns. Importing a single KPP file. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Now, if you want to use the single preset, you should go to the preset chooser on :kbd:`F6` and press the folder icon there. This will give a file dialog. Navigate to the kpp file and open it to import it. If there are brush tips and patterns coming with the file, do the same with pattern via the pattern docker, and for the brush-tip go to the -settings dropdown (:kbd:`F5`) and then go to the “brush-tip” option. There, +settings drop-down (:kbd:`F5`) and then go to the “brush-tip” option. There, select predefined brush, and then the “import” button to call up the file dialog. Sharing via ZIP (old-fashioned) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Sharing via ZIP should be replaced with resource bundles, but older brush packs are stored in zip files. Using a ZIP with the relevant files. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ #. Go to :menuselection:`Settings --> Manage Resources --> Open Resource Folder` to open the resource folder. #. Then, open up the zip file. #. Copy the brushes, paintoppresets and patterns folders from the zip file to the resource folder. You should get a prompt to merge the folders, agree to this. #. Restart Krita #. Enjoy your brushes!