diff --git a/reference_manual/blending_modes/modulo.rst b/reference_manual/blending_modes/modulo.rst index 9e68e747c..d12eb3304 100644 --- a/reference_manual/blending_modes/modulo.rst +++ b/reference_manual/blending_modes/modulo.rst @@ -1,98 +1,98 @@ .. meta:: :description: Page about the modulo blending modes in Krita: .. metadata-placeholder :authors: - Reptorian :license: GNU free documentation license 1.3 or later. .. index:: Modulo .. _bm_cat_modulo: Modulo ------ Modulo modes are special class of blending modes which loops values when the value of channel blend layer is less than the value of channel in base layers. All modes in modulo modes retains the absolute of the remainder if the value is greater than the maximum value or the value is less than minimum value. Continuous modes assume if the calculated value before modulo operation is within the range between a odd number to even number, then values are inverted in the end result, so values are perceived to be wave-like. Furthermore, this would imply that modulo modes are beneficial for abstract art, and manipulation of gradients. .. index:: ! Divisive Modulo .. _bm_cat_divisive_modulo: Divisive Modulo ~~~~~~~~~~~~~~~ First, Base Layer is divided by the sum of blend layer and the minimum possible value after zero. Then, performs a modulo calculation using the value found with the sum of blend layer and the minimum possible value after zero. .. figure:: /images/blending_modes/modulo/Blending_modes_Divisive_Modulo_Gradient_Comparison.png :align: center Left: **Base Layer**. Middle: **Blend Layer**. Right: **Divisive Modulo**. .. index:: ! Divisive Modulo - Continuous .. _bm_cat_divisive_modulo-continuous: Divisive Modulo - Continuous ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -First, Base Layer is divided by the sum of blend layer and the minimum possible value after zero. Then, performs a modulo calculation using the value found with the sum of blend layer and the minimum possible value after zero. As this is a continuous modes, anything between odd to even numbers are inverted. +First, Base Layer is divided by the sum of blend layer and the minimum possible value after zero. Then, performs a modulo calculation using the value found with the sum of blend layer and the minimum possible value after zero. As this is a continuous mode, anything between odd to even numbers are inverted. .. figure:: /images/blending_modes/modulo/Blending_modes_Divisive_Modulo_Continuous_Gradient_Comparison.png :align: center Left: **Base Layer**. Middle: **Blend Layer**. Right: **Divisive Modulo - Continuous**. .. index:: ! Modulo .. _bm_modulo: Modulo ~~~~~~ Performs a modulo calculation using the sum of blend layer and the minimum possible value after zero. .. figure:: /images/blending_modes/modulo/Blending_modes_Modulo_Gradient_Comparison.png :align: center Left: **Base Layer**. Middle: **Blend Layer**. Right: **Modulo**. .. index:: ! Modulo - Continuous .. _bm_modulo-continuous: Modulo - Continuous ~~~~~~~~~~~~~~~~~~~ -Performs a modulo calculation using the sum of blend layer and the minimum possible value after zero. As this is a continuous modes, anything between odd to even numbers are inverted. +Performs a modulo calculation using the sum of blend layer and the minimum possible value after zero. As this is a continuous mode, anything between odd to even numbers are inverted. .. figure:: /images/blending_modes/modulo/Blending_modes_Modulo_Continuous_Gradient_Comparison.png :align: center Left: **Base Layer**. Middle: **Blend Layer**. Right: **Modulo - Continuous**. .. index:: ! Modulo Shift .. _bm_modulo_shift: Modulo Shift ~~~~~~~~~~~~ Performs a modulo calculation with the result of the sum of base and blend layer by the sum of blend layer with the minimum possible value after zero. .. figure:: /images/blending_modes/modulo/Blending_modes_Modulo_Shift_Gradient_Comparison.png :align: center Left: **Base Layer**. Middle: **Blend Layer**. Right: **Modulo Shift**. .. index:: ! Modulo Shift - Continuous .. _bm_modulo_shift-continuous: Modulo Shift - Continuous ~~~~~~~~~~~~~~~~~~~~~~~~~ -Performs a modulo calculation with the result of the sum of base and blend layer by the sum of blend layer with the minimum possible value after zero. As this is a continuous modes, anything between odd to even numbers are inverted. +Performs a modulo calculation with the result of the sum of base and blend layer by the sum of blend layer with the minimum possible value after zero. As this is a continuous mode, anything between odd to even numbers are inverted. .. figure:: /images/blending_modes/modulo/Blending_modes_Modulo_Shift_Continuous_Gradient_Comparison.png :align: center Left: **Base Layer**. Middle: **Blend Layer**. Right: **Modulo Shift - Continuous**. diff --git a/reference_manual/brushes/brush_settings/opacity_and_flow.rst b/reference_manual/brushes/brush_settings/opacity_and_flow.rst index 6caa2716f..9e719c37a 100644 --- a/reference_manual/brushes/brush_settings/opacity_and_flow.rst +++ b/reference_manual/brushes/brush_settings/opacity_and_flow.rst @@ -1,62 +1,62 @@ .. meta:: :description: Opacity and flow in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Raghavendra Kamath - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Opacity, Flow, Transparency .. _option_opacity_n_flow: ================ Opacity and Flow ================ Opacity and flow are parameters for the transparency of a brush. .. image:: /images/brushes/Krita_Pixel_Brush_Settings_Flow.png They are interlinked with the painting mode setting. .. image:: /images/brushes/Krita_2_9_brushengine_opacity-flow_02.png Opacity The transparency of a stroke. Flow The transparency of separate dabs. Finally separated from Opacity in 2.9 .. image:: /images/brushes/Krita_4_2_brushengine_opacity-flow_01.svg .. versionchanged:: 4.2 In Krita 4.1 and below, the flow and opacity when combined with brush sensors would add up to one another, being only limited by the maximum opacity. This was unexpected compared to all other painting applications, so in 4.2 this finally got corrected to the flow and opacity multiplying, resulting in much more subtle strokes. This change can be switched back in the :ref:`tool_options_settings`, but we will be deprecating the old way in future versions. - The old behaviour can be simulated in the new system by... + The old behavior can be simulated in the new system by... 1. Deactivating the sensors on opacity. 2. Set the maximum value on flow to 0.5 3. Adjusting the pressure curve to be concave. .. image:: /images/brushes/flow_opacity_adapt_flow_preset.gif Painting mode ------------- Build-up Will treat opacity as if it were the same as flow. Wash Will treat opacity as stroke transparency instead of dab-transparency. .. image:: /images/brushes/Krita_2_9_brushengine_opacity-flow_03.png where the other images of this page had all three strokes set to painting mode: wash, this one is set to build-up. diff --git a/reference_manual/dockers/advanced_color_selector.rst b/reference_manual/dockers/advanced_color_selector.rst index 5acc0eba2..3be9e26af 100644 --- a/reference_manual/dockers/advanced_color_selector.rst +++ b/reference_manual/dockers/advanced_color_selector.rst @@ -1,175 +1,175 @@ .. 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/dockers/Advancecolorselector.jpg As compared to other color selectors in Krita, Advanced color selector provides more control and options to the user. To open Advanced color selector choose :menuselection:`Settings --> Dockers --> Advanced 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. .. versionadded:: 4.2 Show Color Selector This allows you to configure whether to show or hide the main color selector. Type and Shape ~~~~~~~~~~~~~~ .. image:: /images/dockers/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, gray, 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 gray 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 color model. .. note:: 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 ---------- +Behavior +-------- 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 color in the image. The hotkey for them on canvas is :kbd:`U`. Gamut masking ------------- .. versionadded:: 4.2 .. note:: Gamut masking is available only when the selector shape is set to wheel. You can select and manage your gamut masks in the :ref:`gamut_mask_docker`. In the gamut masking toolbar at the top of the selector you can toggle the selected mask off and on (left button). You can also rotate the mask with the rotation slider (right). External Info ------------- `HSI and HSY for Krita’s advanced color selector. `_ diff --git a/reference_manual/dockers/artistic_color_selector.rst b/reference_manual/dockers/artistic_color_selector.rst index 338f54895..24ce9e5a8 100644 --- a/reference_manual/dockers/artistic_color_selector.rst +++ b/reference_manual/dockers/artistic_color_selector.rst @@ -1,95 +1,95 @@ .. meta:: :description: Overview of the artistic color selector docker. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Anna Medonosova :license: GNU free documentation license 1.3 or later. .. index:: Color, Color Selector, ! Artistic Color Selector .. _artistic_color_selector_docker: ============================== Artistic Color Selector Docker ============================== A color selector inspired by traditional color wheel and workflows. Usage ----- .. figure:: /images/dockers/Krita_Artistic_Color_Selector_Docker.png Artistic color selector with a gamut mask Select hue and saturation on the wheel (5) and value on the value scale (4). |mouseleft| changes foreground color (6). |mouseright| changes background color (7). The blip shows the position of current foreground color on the wheel (black&white circle) and on the value scale (black&white line). Last selected swatches are outlined. Parameters of the wheel can be set in :ref:`artistic_color_selector_docker_wheel_preferences` menu (2). Selector settings are found under :ref:`artistic_color_selector_docker_selector_settings` menu (3). Gamut Masking ~~~~~~~~~~~~~ You can select and manage your gamut masks in the :ref:`gamut_mask_docker`. In the gamut masking toolbar (1) you can toggle the selected mask off and on (left button). You can also rotate the mask with the rotation slider (right). .. _artistic_color_selector_docker_wheel_preferences: Color wheel preferences ----------------------- .. _artistic_color_selector_docker_fig_wheel_preferences: .. figure:: /images/dockers/Krita_Artistic_Color_Selector_Docker_3.png Color wheel preferences Sliders 1, 2, and 3 adjust the number of steps of the value scale, number of hue sectors and saturation rings on the wheel, respectively. Continuous Mode - The value scale and hue sectors can also be set to continuous mode (with the infinity icon on the right of the slider). If toggled on, the respective area shows a continuous gradient instead of the discreet swatches. + The value scale and hue sectors can also be set to continuous mode (with the infinity icon on the right of the slider). If toggled on, the respective area shows a continuous gradient instead of the discrete swatches. Invert saturation (4) changes the order of saturation rings within the the hue sectors. By default, the wheel has gray in the center and most saturated colors on the perimeter. :guilabel:`Invert saturation` puts gray on the perimeter and most saturated colors in the center. Reset to default (5) - loads default values for the sliders 1,2 and 3. These default values are configured in selector settings. + loads default values for the sliders 1, 2, and 3. These default values are configured in selector settings. .. _artistic_color_selector_docker_selector_settings: Selector settings ----------------- .. figure:: /images/dockers/Krita_Artistic_Color_Selector_Docker_2.png Selector settings menu Selector Appearance (1) Show background color indicator toggles the bottom-right triangle with current background color. Show numbered value scale If checked, the value scale includes a comparative gray scale with lightness percentage. Color Space (2) Set the color model used by the selector. For detailed information on color models, see :ref:`color_models`. Luma Coefficients (3) If the selector's color space is HSY, you can set custom Luma coefficients and the amount of gamma correction applied to the value scale (set to 1.0 for linear scale; see :ref:`linear_and_gamma`). Gamut Masking Behavior (4) The selector can be set either to :guilabel:`Enforce gamut mask`, so that colors outside the mask cannot be selected, or to :guilabel:`Just show the shapes`, where the mask is visible but color selection is not limited. Default Selector Steps Settings - Values the color wheel and value scale will be reset to when the :guilabel:`Reset to default` button in :ref:`artistic_color_selector_docker_wheel_preferences` is pressed. + Values the color wheel and value scale will be reset to default when the :guilabel:`Reset to default` button in :ref:`artistic_color_selector_docker_wheel_preferences` is pressed. External Info ------------- - `HSI and HSY for Krita’s advanced colour selector by Wolthera van Hövell tot Westerflier `_ - `The Color Wheel, Part 7 by James Gurney `_ diff --git a/reference_manual/dockers/gamut_mask_docker.rst b/reference_manual/dockers/gamut_mask_docker.rst index ed7c28466..a62b9ae2c 100644 --- a/reference_manual/dockers/gamut_mask_docker.rst +++ b/reference_manual/dockers/gamut_mask_docker.rst @@ -1,78 +1,78 @@ .. meta:: :description: Overview of the gamut mask docker. .. metadata-placeholder :authors: - Anna Medonosova :license: GNU free documentation license 1.3 or later. .. index:: Color, Color Selector, ! Gamut Mask Docker, ! Gamut Mask .. _gamut_mask_docker: ================== Gamut Masks Docker ================== .. image:: /images/dockers/Krita_Gamut_Mask_Docker.png .. versionadded:: 4.2 Docker for gamut masks selection and management. Usage ----- |mouseleft| an icon (1) to apply a mask to color selectors. Gamut Masks can be imported and exported in the resource manager. Management Toolbar ~~~~~~~~~~~~~~~~~~ Create new mask (2) opens the mask editor with an empty template. Edit mask (3) opens the the currently selected mask in the editor. Duplicate mask (4) creates a copy of the currently selected mask and opens the copy in the editor. Delete mask (5) deletes the currently selected mask. Editing ------- -If you choose to create a new mask, edit, or duplicate selected mask, the mask template documents opens as a new view (1). +If you choose to create a new mask, edit, or duplicate selected mask, the mask template document will be opened as a new view (1). There you can create new shapes and modify the mask with standard vector tools (:ref:`vector_graphics`). Fill in the fields at (2). Title (Mandatory) The name of the gamut mask. Description A description. :guilabel:`Preview` the mask in the artistic color selector (4), :guilabel:`save` the mask (5), or :guilabel:`cancel` editing (3). .. warning:: * The shapes need to be added to the layer named “maskShapesLayer” (which is selected by default). * The shapes need have solid background to show correctly in the editor. * A template with no shapes cannot be saved. .. note:: The mask is intended to be composed of basic vector shapes. Although interesting results might arise from using advanced vector drawing techniques, not all features are guaranteed to work properly (e.g. grouping, vector text, etc.). .. image:: /images/dockers/Krita_Gamut_Mask_Docker_2.png External Info ------------- - `Color Wheel Masking, Part 1 by James Gurney `_ - `The Shapes of Color Schemes by James Gurney `_ - `Gamut Masking Demonstration by James Gourney (YouTube) `_ diff --git a/reference_manual/dockers/palette_docker.rst b/reference_manual/dockers/palette_docker.rst index e3d6ef5a6..aa6bedb66 100644 --- a/reference_manual/dockers/palette_docker.rst +++ b/reference_manual/dockers/palette_docker.rst @@ -1,91 +1,91 @@ .. meta:: :description: Overview of the palette docker. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. index:: Palettes, Color, Swatches .. _palette_docker: ============== Palette Docker ============== The palette docker displays various color swatches for quick use. It also supports editing palettes and organizing colors into groups, as well as arbitrary positioning of swatches. .. versionadded:: 4.2 The palette docker was overhauled in 4.2, allowing for grid ordering, storing palette in the document and more. .. image:: /images/dockers/Palette-docker.png You can choose from various default palettes or you can add your own colors to the palette. To choose from the default palettes click on the icon in the bottom left corner of the docker, it will show a list of pre-loaded color palettes. You can click on one and to load it into the docker, or click on import resources to load your own color palette from a file. Creating a new palette can be done by pressing the :guilabel:`+`. Fill out the :guilabel:`name` input, pressing :guilabel:`Save` and Krita will select your new palette for you. Since 4.2 Krita's color palettes are not just a list of colors to store, but also a grid to organize them on. That's why you will get a grid with 'transparency checkers', indicating that there is no entry. To add an entry, just click a swatch and a new entry will be added with a default name and the current foreground color. * Selecting colors is done by |mouseleft| on a swatch. * Pressing the delete icon will remove the selected swatch or group. When removing a group, Krita will always ask whether you'd like to keep the swatches. If so, the group will be merged with the default group. * Double |mouseleft| a swatch will call up the edit window where you can change the color, the name, the id and whether it's a spot color. On a group this will allow you to set the group name. * |mouseleft| drag will allow you to drag and drop swatches and groups to order them. * |mouseright| on a swatch will give you a context menu with modify and delete options. * Pressing the :guilabel:`+` icon will allow you to add a new swatch. * The drop down contains all the entries, id numbers and names. When a color is a spot color the thumbnail is circular. You can use the dropdown to search on color name or id. Pressing the Folder icon will allow you to modify the palette. Here you can add more columns, modify the default group's rows, or add more groups and modify their rows. Palette Name Modify the palette name. This is the proper name for the palette as shown in the palette chooser dropdown. File name This is the file name of the palette, which should be file system friendly. (Avoid quotation marks, for example). Column Count - The amount of columns in this palette. This counts for all entries. IF you accidentally make it small than the amount of entries that take up columns, you can still make it bigger until the next restart of Krita. + The amount of columns in this palette. This counts for all entries. If you accidentally make it smaller than the amount of entries that take up columns, you can still make it bigger until the next restart of Krita. Where is the palette stored: Whether to store said palette in the document or resource folder. Resource Folder The default, the palette will be stored in the resource folder. Document The palette will be removed from the resource folder and stored in the document upon save. It will be loaded into the resources upon loading the document. Add group Add a new group. On clicking you will be asked for a name and a set of rows. Group Settings Here you can configure the groups. The dropdown has a selection of groups. The default group is at top. Row Count The amount of rows in the group. If you want to add more colors to a group and there's no empty areas to click on anymore, increase the row count. Rename Group Rename the group. Delete Group Delete the group. It will ask whether you want to keep the colors. If so, it will merge the group's contents with the default group. The edit and new color dialogs ask for the following: Color The color of the swatch. Name The Name of the color in a human readable format. ID The ID is a number that can be used to index colors. Where Name can be something like "Pastel Peach", ID will probably be something like "RY75". Both names and ids can be used to search the color in the color entry dropdown at the bottom of the palette. Spot color Currently not used for anything within Krita itself, but spot colors are a toggle to keep track of colors that represent a real world paint that a printer can match. Keeping track of such colors is useful in a printing workflow, and it can also be used with python to recognize spot colors. Krita's native palette format is since 4.0 :ref:`file_kpl`. It also supports importing... * Gimp Palettes (.gpl) * Microsoft RIFF palette (.riff) * Photoshop Binary Palettes (.act) * PaintShop Pro palettes (.psp) * Photoshop Swatches (.aco) * Scribus XML (.xml) * Swatchbooker (.sbz). diff --git a/reference_manual/preferences/general_settings.rst b/reference_manual/preferences/general_settings.rst index 00ba2cd3c..771032c19 100644 --- a/reference_manual/preferences/general_settings.rst +++ b/reference_manual/preferences/general_settings.rst @@ -1,262 +1,262 @@ .. meta:: :description: General Preferences in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Greig :license: GNU free documentation license 1.3 or later. .. index:: Preferences, Settings, Cursor, Autosave, Tabbed Documents, Subwindow Documents, Pop up palette, File Dialog, Maximum Brush Size, Kinetic Scrolling, Sessions .. _general_settings: ================ General Settings ================ You can access the General Category of the preferences by first going to :menuselection:`Settings --> Configure Krita`. .. image:: /images/preferences/Krita_Preferences_General.png Cursor Settings --------------- Customize the drawing cursor here: Cursor Shape ~~~~~~~~~~~~ Select a cursor shape to use while the brush tools are used. This cursor will always be visible on the canvas. It is usually set to a type exactly where your pen nib is at. The available cursor types are shown below. Tool Icon Shows the currently selected tool icon, even for the freehand brush. .. image:: /images/preferences/Settings_cursor_tool_icon.png Arrow Shows a generic cursor. .. image:: /images/preferences/Settings_cursor_arrow.png Crosshair Shows a precision reticule. .. image:: /images/preferences/Settings_cursor_crosshair.png Small circle Shows a small white dot with a black outline. .. image:: /images/preferences/Settings_cursor_small_circle.png No Cursor Show no cursor, useful for tablet-monitors. .. image:: /images/preferences/Settings_cursor_no_cursor.png Triangle Right-Handed. Gives a small white triangle with a black border. .. image:: /images/preferences/Settings_cursor_triangle_righthanded.png Triangle Left-Handed. Same as above but mirrored. .. image:: /images/preferences/Settings_cursor_triangle_lefthanded.png Black Pixel Gives a single black pixel. .. image:: /images/preferences/Settings_cursor_black_pixel.png White Pixel Gives a single white pixel. .. image:: /images/preferences/Settings_cursor_white_pixel.png Outline Shape ~~~~~~~~~~~~~ Select an outline shape to use while the brush tools are used. This cursor shape will optionally show in the middle of a painting stroke as well. The available outline shape types are shown below.(pictures will come soon) No Outline No outline. Circle Outline Gives a circular outline approximating the brush size. Preview Outline Gives an outline based on the actual shape of the brush. Tilt Outline Gives a circular outline with a tilt-indicator. While Painting... ~~~~~~~~~~~~~~~~~ Show Outline This option when selected will show the brush outline while a stroke is being made. If unchecked the brush outline will not appear during stroke making, it will show up only after the brush stroke is finished. This option works only when Brush Outline is selected as the Cursor Shape. .. versionchanged:: 4.1 Used to be called "Show Outline When Painting" Use effective outline size .. versionadded:: 4.1 This makes sure that the outline size will always be the maximum possible brush diameter, and not the current one as affected by sensors such as pressure. This makes the cursor a little less noisy to use. Cursor Color: The default cursor color. This is mixed with the canvas image so that it will usually have a contrasting color, but sometimes this mixing does not work. This is usually due driver problems. When that happens, you can configure a more pleasant color here. .. _window_settings: Window Settings --------------- Multiple Document Mode This can be either tabbed like :program:`GIMP` or :program:`Painttool Sai`, or subwindows, like :program:`Photoshop`. Background image Allows you to set a picture background for subwindow mode. Window Background Set the color of the subwindow canvas area. Don't show contents when moving sub-windows This gives an outline when moving windows to work around ugly glitches with certain graphics-cards. Show on-canvas popup messages Whether or not you want to see the on-canvas pop-up messages that tell you whether you are in tabbed mode, rotating the canvas, or mirroring it. Enable Hi-DPI support Attempt to use the Hi-DPI support. It is an option because we are still experiencing bugs on windows. Allow only one instance of Krita An instance is a single entry in your system's task manager. Turning this option makes sure that Krita will check if there's an instance of Krita open already when you instruct it to open new documents, and then have your documents opened in that single instance. There's some obscure uses to allowing multiple instances, but if you can't think of any, just keep this option on. .. _tool_options_settings: Tools Settings -------------- In docker (default) Gives you the tool options in a docker. In toolbar Gives you the tool options in the toolbar, next to the brush settings. You can open it with :kbd:`\\`. Brush Flow Mode - In Krita 4.2 the behaviour of flow in combination with opacity was changed. This allows you to turn it back to the 4.1 behaviour. This will however be removed in future versions. + In Krita 4.2 the behavior of flow in combination with opacity was changed. This allows you to turn it back to the 4.1 behavior. This will however be removed in future versions. Switch Control/Alt Selection Modifiers This switches the function of the :kbd:`Ctrl` and :kbd:`Alt` buttons when modifying selections. Useful for those used to Gimp instead of Photoshop, or Lefties without a right-:kbd:`Alt` key on their keyboard. Enable Touchpainting This allows finger painting with capacitive screens. Some devices have both capacitive touch and a stylus, and then this can interfere. In that case, just toggle this. .. versionadded:: 4.2 Activate transform tool after pasting A convenience feature. When enabling this, the transform tool will activate after pasting for quick moving or rotating. Kinetic Scrolling (Needs Restart) This enables kinetic scrolling for scrollable areas. .. figure:: /images/preferences/Krita_4_0_kinetic_scrolling.gif :align: center Kinetic scrolling on the brush chooser drop-down with activation mode set to :guilabel:`On Click Drag`, with this disabled all of these clicks would lead to a brush being selected regardless of drag motion. Activation How it is activated. On Middle-Click Drag Will activate when using the middle mouse button. On Touch Drag Will activate if it can recognize a touch event. May not always work. On Click Drag Will activate when it can recognize a click event, will always work. Sensitivity How quickly the feature activates, this effective determines the length of the drag. Hide Scrollbar Whether to show scrollbars when doing this. .. _file_handling_settings: File Handling ------------- .. versionadded:: 4.2 Enable Autosaving Determines whether or not Krita should periodically autosave. Autosave Every Here the user can specify how often Krita should autosave the file, you can tick the checkbox to turn it off. For Windows these files are saved in the %TEMP% directory. If you are on Linux it is stored in /home/'username'. Unnamed autosave files are hidden by default This determines whether the filename of autosaves has a period prepended to the name. On Linux and Mac OS this is a technique to ensure the file is hidden by default. Create Backup File When selected Krita will, upon save, rename the original file as a backup file and save the current image to the original name. The result is that you will have saved the image, and there will be a copy of the image that is saved separately as a backup. This is useful in case of crashes during saves. Backup File Location The default location these backups should be stored. Same Folder as Original File Store the file in the same folder as the original file was stored. User Folder This is the main folder of your computer. On Linux and Mac OS this is the 'Home' folder, on Windows, the 'My Documents Folder'. Temporary File Folder This stored the file in the temp folder. Temp folders are special folders of which the contents are emptied when you shut down your computer. If you don't particularly care about your backup files and want them to be 'cleaned' automatically, this is the best place. If you want your backup files to be kept indefinitely, this is a wrong choice. Backup File Suffix The suffix that will be placed after the full filename. 'filename.kra' will then be saved as 'filename.kra~', ensuring the files won't show up in Krita's open file dialog. Number of Backup Files Kept Number of backup files Krita keeps, by default this is only one, but this can be up to 99. Krita will then number the backup files. Compress \*.kra files more. This increases the zip compression on the saved Krita files, which makes them lighter on disk, but this takes longer to load. Use Zip64 Kra files are zip files. Zip64 allows you to use .. _misc_settings: Miscellaneous ------------- When Krita starts This is the option for handling user sessions. It has the following options: Open Default Window This opens the regular empty window with the last used workspace. Load Previous Session Load the last opened session. If you have :guilabel:`Save session when Krita closes` toggled, this becomes the last files you had open and the like. Show Session Manager Show the session manager directly so you can pick a session. .. versionadded:: 4.1 Save session when Krita closes Save the current open windows, documents and the like into the current session when closing Krita so you can resume where you left off. .. versionadded:: 4.1 Upon importing Images as Layers, convert to the image color space. This makes sure that layers are the same color space as the image, necessary for saving to PSD. Undo Stack Size This is the number of undo commands Krita remembers. You can set the value to 0 for unlimited undos. Favorite Presets This determines the amount of presets that can be used in the pop-up palette. Hide splash screen on startup. This'll hide the splash screen automatically once Krita is fully loaded. .. deprecated:: 4.1 Deprecated because Krita now has a welcome widget when no canvas is open. Enable Native File Dialog This allows you to use the system file dialog. By default turned off because we cannot seem to get native file dialogues 100% bugfree. Maximum brush size This allows you to set the maximum brush size to a size of up to 10.000 pixels. Do be careful with using this, as a 10.000 pixel size can very quickly be a full gigabyte of data being manipulated, per dab. In other words, this might be slow. Recalculate animation cache in background. Krita will recalculate the cache when you're not doing anything. .. versionchanged:: 4.1 This is now in the :ref:`performance_settings` under :guilabel:`Animation Cache`. diff --git a/reference_manual/tools/contiguous_select.rst b/reference_manual/tools/contiguous_select.rst index 3650e98ba..5a33f709f 100644 --- a/reference_manual/tools/contiguous_select.rst +++ b/reference_manual/tools/contiguous_select.rst @@ -1,54 +1,54 @@ .. meta:: :description lang=en: Krita's contiguous selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Selection, ! Contiguous Selection, Magic Wand, Tools .. _contiguous_selection_tool: ========================= Contiguous Selection Tool ========================= |toolselectcontiguous| This tool, represented by a magic wand, allows you to make :ref:`selections_basics` by selecting a point of color. It will select any contiguous areas of a similar color to the one you selected. You can adjust the "fuzziness" of the tool in the tool options dock. A lower number will select colors closer to the color that you chose in the first place. Hotkeys and Sticky keys ----------------------- * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. * :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. * :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. * :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. * :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 * Hovering over a selection allows you to move it. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. .. note:: - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. Fuzziness This controls whether or not the contiguous selection sees another color as a border. Grow/Shrink selection. This value extends/contracts the shape beyond its initial size. Feathering This value will add a soft border to the selection-shape. Limit to Current Layer Activating this will prevent the fill tool from taking other layers into account. diff --git a/reference_manual/tools/elliptical_select.rst b/reference_manual/tools/elliptical_select.rst index 31b786f5b..4e952d3ad 100644 --- a/reference_manual/tools/elliptical_select.rst +++ b/reference_manual/tools/elliptical_select.rst @@ -1,62 +1,62 @@ .. meta:: :description: Krita's elliptical selector tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Tools, Ellipse, Circle, Elliptical Select, Selection .. _ellipse_selection_tool: ========================= Elliptical Selection Tool ========================= |toolselectellipse| This tool, represented by an ellipse with a dashed border, allows you to make :ref:`selections_basics` of a elliptical area. Simply click and drag around the section you wish to select. Hotkeys and Stickykeys ---------------------- * :kbd:`J` selects this tool. * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. * :kbd:`Shift` after starting the selection, constraints it to a perfect circle. * :kbd:`Ctrl` after starting the selection, makes the selection resize from center. * :kbd:`Alt` after starting the selection, allows you to move it. * :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. * :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. * :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. * :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 * Hovering over a selection allows you to move it. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. .. note:: So to subtract a perfect circle, you do :kbd:`Alt +` |mouseleft|, then release the :kbd:`Alt` key while dragging and press :kbd:`Shift` to constrain. .. note:: - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. Width Gives the current width. Use the lock to force the next selection made to this width. Height Gives the current height. Use the lock to force the next selection made to this height. Ratio Gives the current ratio. Use the lock to force the next selection made to this ratio. diff --git a/reference_manual/tools/outline_select.rst b/reference_manual/tools/outline_select.rst index bed2d48cb..436e76da0 100644 --- a/reference_manual/tools/outline_select.rst +++ b/reference_manual/tools/outline_select.rst @@ -1,48 +1,48 @@ .. meta:: :description: Krita's outline selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Radianart - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. index:: Tools, Selection, Freehand, Outline Select .. _outline_selection_tool: ====================== Outline Selection Tool ====================== |toolselectoutline| Make :ref:`selections_basics` by drawing freehand around the canvas. Click and drag to draw a border around the section you wish to select. Hotkeys and Sticky keys ----------------------- * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. * :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. * :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. * :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. * :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 * Hovering over a selection allows you to move it. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. .. note:: - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. diff --git a/reference_manual/tools/path_select.rst b/reference_manual/tools/path_select.rst index 30790718f..d2cd9724a 100644 --- a/reference_manual/tools/path_select.rst +++ b/reference_manual/tools/path_select.rst @@ -1,64 +1,64 @@ .. meta:: :description: Krita's bezier curve selection 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, Bezier Curve, Pen, Selection .. _path_selection_tool: .. _bezier_curve_selection_tool: =================== Path Selection Tool =================== |toolselectpath| This tool, represented by an ellipse with a dashed border and a curve control, allows you to make a :ref:`selections_basics` of an area by drawing a path around it. Click where you want each point of the path to be. Click and drag to curve the line between points. Finally click on the first point you created to close your path. Hotkeys and Sticky keys ----------------------- * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. * :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. * :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. * :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. * :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 * Hovering over a selection allows you to move it. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. .. note:: - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ .. versionadded:: 4.1.3 Autosmooth Curve Toggling this will have nodes initialize with smooth curves instead of angles. Untoggle this if you want to create sharp angles for a node. This will not affect curve sharpness from dragging after clicking. Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. .. versionadded:: 4.2 Autosmooth Curve Toggling this will have nodes initialize with smooth curves instead of angles. Untoggle this if you want to create sharp angles for a node. This will not affect curve sharpness from dragging after clicking. Angle Snapping Delta The angle to snap to. Activate Angle Snap Angle snap will make it easier to have the next line be at a specific angle of the current. The angle is determined by the :guilabel:`Angle Snapping Delta`. diff --git a/reference_manual/tools/polygonal_select.rst b/reference_manual/tools/polygonal_select.rst index db4d9551e..085117578 100644 --- a/reference_manual/tools/polygonal_select.rst +++ b/reference_manual/tools/polygonal_select.rst @@ -1,47 +1,47 @@ .. meta:: :description: Krita's polygonal selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Tools, Polygon, Selection, Polygonal Selection .. _polygonal_selection_tool: ======================== Polygonal Selection Tool ======================== |toolselectpolygon| This tool, represented by a polygon with a dashed border, allows you to make :ref:`selections_basics` of a polygonal area point by point. Click where you want each point of the Polygon to be. Double click to end your polygon and finalize your selection area. Hotkeys and Sticky keys ----------------------- * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. * :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. * :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. * :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. * :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 * Hovering over a selection allows you to move it. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. .. note:: - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. diff --git a/reference_manual/tools/rectangular_select.rst b/reference_manual/tools/rectangular_select.rst index 908ba8354..b097e087b 100644 --- a/reference_manual/tools/rectangular_select.rst +++ b/reference_manual/tools/rectangular_select.rst @@ -1,68 +1,68 @@ .. meta:: :description: Krita's rectangular selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Tools, Selection, Rectangle, Rectangular Selection .. _rectangle_selection_tool: ========================== Rectangular Selection Tool ========================== |toolselectrect| This tool, represented by a rectangle with a dashed border, allows you to make :ref:`selections_basics` of a rectangular area. Simply click and drag around the section you wish to select. Hotkeys and Stickykeys ---------------------- * :kbd:`J` selects this tool. * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. * :kbd:`Shift` after starting the selection, constraints it to a perfect square. * :kbd:`Ctrl` after starting the selection, makes the selection resize from center. * :kbd:`Alt` after starting the selection, allows you to move it. * :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. * :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. * :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. * :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 * Hovering over a selection allows you to move it. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. .. note:: So to subtract a perfect square, you do :kbd:`Alt +` |mouseleft|, then release the :kbd:`Alt` key while dragging and press :kbd:`Shift` to constrain. .. note:: - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. Width Gives the current width. Use the lock to force the next selection made to this width. Height Gives the current height. Use the lock to force the next selection made to this height. Ratio Gives the current ratio. Use the lock to force the next selection made to this ratio. .. versionadded:: 4.1.3 Round X The horizontal radius of the rectangle corners. Round Y The vertical radius of the rectangle corners. diff --git a/reference_manual/tools/shape_selection.rst b/reference_manual/tools/shape_selection.rst index d5778684a..bdf623b0e 100644 --- a/reference_manual/tools/shape_selection.rst +++ b/reference_manual/tools/shape_selection.rst @@ -1,163 +1,163 @@ .. meta:: :description: Krita's shape selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Raghavendra Kamath - Alberto Eleuterio Flores Guerrero :license: GNU free documentation license 1.3 or later. .. index:: Tools, Vector, Shape Selection .. _shape_selection_tool: ==================== Shape Selection Tool ==================== |toolshapeselection| The shape selection tool used to be called the "default" tool. This had to do with Krita being part of an office suite once upon a time. But this is no longer the case, so we renamed it to its purpose in Krita: Selecting shapes! This tool only works on vector layers, so trying to use it on a paint layer will give a notification. After you create vector shapes, you can use this tool to select, transform, and access the shape's options in the tool options docker. There are a lot of different properties and things you can do with each vector shape. Selection --------- Selecting shapes can be done by two types of actions: - |mouseleft| on a single shape to select it. - |mouseleft| and drag to select multiple shapes. - *Blue selection* (drag left to right): selects only shapes fully covered. - *Green selection* (drag right to left): selects all the touched shapes. .. figure:: /images/tools/blue-and-green-selections.png :align: center :alt: Left: Blue selection. Right: Green selection. Blue selection: left-to-right, selects fully covered images. -- Green selection: right-to-left, selects touched shapes. Placement, Scale, Angle and Distortion -------------------------------------- Once an object is selected, a dashed bounding box will appear around it. The box will also have square handles. You can use this bounding box to do adjust: placement, scale, angle and distortion of the selected object. .. figure:: /images/tools/shapes-selection-properties.png :align: center :alt: Left to right: Placement, Scale, Angle and Distortion. Left to right: Placement, Scale, Angle and Distortion. Placement |mouseleft| and hold inside the bounding box, while holding move the shape to the desired position. Scale |mouseleft| and hold inside any of the square handles, move to adjust the dimensions of the object. Angle Place the cursor slightly outside any of the corner handles. |mouseleft| and drag to adjust the angle of the shape. Distortion Place the cursor slightly outside any of the middle handles. |mouseleft| and drag to skew the shape. Tool Options ------------ The tool options of this menu are quite involved, and separated over 3 tabs. Geometry ~~~~~~~~ .. image:: /images/tools/shape-selection-menu-geometry.png :width: 400 :alt: Tool options: Geometry tool. Geometry is the first section in the tool options. This section allows you to set precisely the 'x' and 'y' coordinates, and also the width and height of the shape. Uniform scaling Enabled: when scaling, it will scale the stroke width with the shape. Not enabled: when scaling, the stroke width will stay the same. Global coordinates Determines whether the width and height bars use the width and height of the object, while taking transforms into account. Opacity The general opacity, or transparency, of the object. Opacity for stroke and fill are explained in the next two sections. .. warning:: Anchor Lock is not implemented at the moment. Stroke ~~~~~~ .. image:: /images/tools/shape-selection-menu-stroke.png :width: 400 :alt: Tool options: Stroke tool. The stroke tab determines how the stroke around the object should look. -The first set of buttons allows us to set the fill of the stroke: *None*, *Color* and *Gradient*; this same options exist for the fill of the shape, please refer to the following "**Fill**" section for more details on how to use both of them. +The first set of buttons allows us to set the fill of the stroke: *None*, *Color* and *Gradient*; the same options exist for the fill of the shape, please refer to the following "**Fill**" section for more details on how to use both of them. Then, there are the settings for the stroke style: Thickness Sets the width of the stroke. When creating a shape, Krita will use the current brush size to determine the width of the stroke. Cap and corner style Sets the stroke cap and stroke corner style, this can be accessed by pressing the three dots button next to the thickness entry. Line-style Sets the line style of the stroke: *solid*, *dashes*, *dots*, or mixes of *dashes and dots*. Markers Adds markers to the stroke. Markers are little figures that will appear at the start, end or all the nodes in between, depending on your configuration. Fill ~~~~ .. image:: /images/tools/shape-selection-menu-fill.png :width: 400 :alt: Tool options: Fill tool. This section is about the color that fills the shape. As mentioned above in the **Stroke** section, the features are the same for both the fill of the stroke and the fill of the shape. Here is the explanation for both: A fill can be: *solid color*, *gradient*, or *none* (transparent) None No fill. It's transparent. Color A flat color, you can select a new one by pressing the color button. Gradient As the name implies this type fills the shape with a gradient. It has the following options: Type A linear or radial gradient. Repeat How the gradient repeats itself. Preset A menu for selecting a base gradient from a set of predefined gradient presets, which can be edited as desired. Save Gradient A quick way for saving the current gradient as a preset. Stops Options Line A representation of how the gradient colors should look. The stops are represented by triangles. There are two stops by default one at the beginning and one at the end. You can create more stops just by clicking anywhere on the line. To select a stop |mouseleft| inside the triangle. To delete the stops, |mouseleft| drag them to left or right until the end of the line. Flip Gradient A quick way to invert the order of the gradient. Stop Choose a color for the current selected stop. Opacity Choose the opacity for the current selected stop. .. hint:: When a stop triangle is selected, it is highlighted with a slight blue outline. The selected stop triangle will change its color and opacity accordingly when these options are changed. .. hint:: You can edit the gradient in two ways. The first one is the actual gradient in the docker that you can manipulate. Vectors always use stop-gradients. The other way to edit gradients is editing their position on the canvas. Right-click menu ---------------- The shape selection tool has a nice right click menu that gives you several features. If you have an object selected, you can perform various functions like cutting, copying, or moving the object to the front or back. .. image:: /images/vector/Vector-right-click-menu.png If you have multiple objects selected you can perform "Logical Operators" on them, or boolean operations as they are commonly called. It will be the last item on the right-click menu. You can unite, intersect, subtract, or split the selected objects. diff --git a/reference_manual/tools/similar_select.rst b/reference_manual/tools/similar_select.rst index 5b75b8efc..eab10c174 100644 --- a/reference_manual/tools/similar_select.rst +++ b/reference_manual/tools/similar_select.rst @@ -1,46 +1,46 @@ .. meta:: :description: Krita's similar color selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Tools, Selection, Similar Selection .. _similar_selection_tool: ============================ Similar Color Selection Tool ============================ |toolselectsimilar| This tool, represented by a dropper over an area with a dashed border, allows you to make :ref:`selections_basics` by selecting a point of color. It will select any areas of a similar color to the one you selected. You can adjust the "fuzziness" of the tool in the tool options dock. A lower number will select colors closer to the color that you chose in the first place. Hotkeys and Sticky keys ----------------------- * :kbd:`R` sets the selection to 'replace' in the tool options, this is the default mode. * :kbd:`A` sets the selection to 'add' in the tool options. * :kbd:`S` sets the selection to 'subtract' in the tool options. * :kbd:`Shift` + |mouseleft| sets the subsequent selection to 'add'. You can release the :kbd:`Shift` key while dragging, but it will still be set to 'add'. Same for the others. * :kbd:`Alt` + |mouseleft| sets the subsequent selection to 'subtract'. * :kbd:`Ctrl` + |mouseleft| sets the subsequent selection to 'replace'. * :kbd:`Shift + Alt +` |mouseleft| sets the subsequent selection to 'intersect'. .. versionadded:: 4.2 * Hovering over a selection allows you to move it. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. .. note:: - You can switch the behaviour of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` + You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in the :ref:`general_settings` Tool Options ------------ Fuzziness This controls whether or not the contiguous selection sees another color as a border. diff --git a/reference_manual/tools/zoom.rst b/reference_manual/tools/zoom.rst index 8e6a1cf3a..5501f057f 100644 --- a/reference_manual/tools/zoom.rst +++ b/reference_manual/tools/zoom.rst @@ -1,36 +1,36 @@ .. meta:: :description: Krita's zoom tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Tools, Zoom .. _zoom_tool: ========= Zoom Tool ========= |toolzoom| The zoom tool allows you to zoom your canvas in and out discretely. It can be found at the bottom of the toolbox, and you just activate it by selecting the tool, and doing |mouseleft| on the canvas will zoom in, while |mouseright| will zoom out. -You can reverse this behaviour in the :guilabel:`Tool Options`. +You can reverse this behavior in the :guilabel:`Tool Options`. There's a number of hotkeys associated with this tool, which makes it easier to access from the other tools: * :kbd:`Ctrl + Space` + |mouseleft| + drag on the canvas will zoom in or out fluently. * :kbd:`Ctrl` + |mousemiddle| + drag on the canvas will zoom in or out fluently. * :kbd:`Ctrl + Alt + Space` + |mouseleft| + drag on the canvas will zoom in or out with discrete steps. * :kbd:`Ctrl + Alt +` |mousemiddle| + drag on the canvas will zoom in or out with discrete steps. * :kbd:`+` will zoom in with discrete steps. * :kbd:`-` will zoom out with discrete steps. * :kbd:`1` will set the zoom to 100%. * :kbd:`2` will set the zoom so that the document fits fully into the canvas area. * :kbd:`3` will set the zoom so that the document width fits fully into the canvas area. For more information on such hotkeys, check :ref:`navigation`. diff --git a/user_manual/getting_started/installation.rst b/user_manual/getting_started/installation.rst index 030370b82..fa5120bdc 100644 --- a/user_manual/getting_started/installation.rst +++ b/user_manual/getting_started/installation.rst @@ -1,185 +1,185 @@ .. meta:: :description: Detailed steps on how to install Krita .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Raghavendra Kamath - Scott Petrovic - Boudewijn Rempt - Dmitry Kazakov :license: GNU free documentation license 1.3 or later. .. index:: Installation .. _installation: Installation ============ Windows ------- Windows users can download Krita from the website, the Windows Store, or Steam. The versions on the Store and Steam cost money, but are `functionally identical `_ to the (free) website version. Unlike the website version, however, both paid versions get automatic updates when new versions of Krita comes out. After deduction of the Store fee, the purchase cost supports Krita development. Website: The latest version is always on our `website `_. The page will try to automatically recommend the correct architecture (64- or 32-bit), but you can select "All Download Versions" to get more choices. To determine your computer architecture manually, go to :menuselection:`Settings --> About`. Your architecture will be listed as the :guilabel:`System Type` in the :guilabel:`Device Specifications` section. Krita by default downloads an **installer EXE**, but you can also download a **portable zip-file** version instead. Unlike the installer version, this portable version does not show previews in Windows Explorer automatically. To get these previews with the portable version, also install Krita's **Windows Shell Extension** extension (available on the download page). These files are also available from the `KDE download directory `_. Windows Store: For a small fee, you can download Krita `from the Windows Store `_. This version requires Windows 10. Steam: For a small fee, you can also download Krita `from Steam `_. To download a portable version of Krita go to the `KDE `__ download directory and get the zip-file instead of the setup.exe installer. .. note:: Krita requires Windows 7 or newer. The Store version requires Windows 10. Linux ----- Many Linux distributions package the latest version of Krita. Sometimes you will have to enable an extra repository. Krita runs fine under most -desktop enviroments such as KDE, Gnome, LXDE, XFCE etc -- even though it +desktop enviroments such as KDE, Gnome, LXDE, Xfce etc. -- even though it is a KDE application and needs the KDE libraries. You might also want to install the KDE system settings module and tweak the gui theme and fonts used, depending on your distributions Nautilus/Nemo file extensions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Since April 2016, KDE's Dolphin file manager shows kra and ora thumbnails by default, but Nautilus and it's derivatives need an extension. `We recommend Moritz Molch's extensions for XCF, KRA, ORA and PSD thumbnails `__. Appimages ~~~~~~~~~ For Krita 3.0 and later, first try out the appimage from the website. **90% of the time this is by far the easiest way to get the latest Krita.** Just download the appimage, and then use the file properties or the bash command chmod to make the appimage executable. Double click it, and enjoy Krita. (Or run it in the terminal with ./appimagename.appimage) - Open the terminal into the folder you have the appimage. - Make it executable: :: chmod a+x krita-3.0-x86_64.appimage - Run Krita! :: ./krita-3.0-x86_64.appimage Appimages are ISOs with all the necessary libraries bundled inside, that means no fiddling with repositories and dependencies, at the cost of a slight bit more diskspace taken up (And this size would only be bigger if you were using Plasma to begin with). Ubuntu and Kubuntu ~~~~~~~~~~~~~~~~~~ It does not matter which version of Ubuntu you use, Krita will run just fine. However, by default, only a very old version of Krita is available. You should either use the appimage, flatpak or the snap available from Ubuntu's app store. We also maintain a ppa for getting latest builds of Krita, you can read more about the ppa and install instructions `here `_. OpenSUSE ~~~~~~~~ The latest stable builds are available from KDE:Extra repo: - https://download.opensuse.org/repositories/KDE:/Extra/ .. note:: Krita is also in the official repos, you can install it from Yast. Fedora ~~~~~~ Krita is in the official repos, you can install it by using packagekit (Add/Remove Software) or by writing the following command in terminal. ``dnf install krita`` You can also use the software center such as gnome software center or Discover to install Krita. Debian ~~~~~~ The latest version of Krita available in Debian is 3.1.1. To install Krita type the following line in terminal: ``apt install krita`` Arch ~~~~ Arch Linux provides krita package in the Extra repository. You can install Krita by using the following command: ``pacman -S krita`` You can also find Krita pkgbuild in arch user repositories but it is not guaranteed to contain the latest git version. OS X ---- You can download the latest binary from our `website `__. The binaries work only with Mac OSX version 10.12 and newer. Source ------ While it is certainly more difficult to compile Krita from source than it is to install from prebuilt packages, there are certain advantages that might make the effort worth it: - You can follow the development of Krita on the foot. If you compile Krita regularly from the development repository, you will be able to play with all the new features that the developers are working on. - You can compile it optimized for your processor. Most pre-built packages are built for the lowest-common denominator. - You will be getting all the bug fixes as soon as possible as well. - You can help the developers by giving us your feedback on features as they are being developed and you can test bug fixes for us. This is hugely important, which is why our regular testers get their name in the about box just like developers. Of course, there are also some disadvantages: when building from the current development source repository you also get all the unfinished features. It might mean less stability for a while, or things shown in the user interface that don't work. But in practice, there is seldom really bad instability, and if it is, it's easy for you to go back to a revision that does work. So... If you want to start compiling from source, begin with the latest build instructions from the guide :ref:`here `. If you encounter any problems, or if you are new to compiling software, don't hesitate to contact the Krita developers. There are three main communication channels: - irc: irc.freenode.net, channel #krita - `mailing list `__ - `forums `__