diff --git a/reference_manual/preferences/general_settings.rst b/reference_manual/preferences/general_settings.rst index 713f472ab..50219f390 100644 --- a/reference_manual/preferences/general_settings.rst +++ b/reference_manual/preferences/general_settings.rst @@ -1,213 +1,216 @@ .. 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/en/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/en/Settings_cursor_tool_icon.png Arrow Shows a generic cursor. .. image:: /images/en/Settings_cursor_arrow.png Crosshair Shows a precision reticule. .. image:: /images/en/Settings_cursor_crosshair.png Small circle Shows a small white dot with a black outline. .. image:: /images/en/Settings_cursor_small_circle.png No Cursor Show no cursor, useful for tablet-monitors. .. image:: /images/en/Settings_cursor_no_cursor.png Triangle Right-Handed. Gives a small white triangle with a black border. .. image:: /images/en/Settings_cursor_triangle_righthanded.png Triangle Left-Handed. Same as above but mirrored. .. image:: /images/en/Settings_cursor_triangle_lefthanded.png Black Pixel Gives a single black pixel. .. image:: /images/en/Settings_cursor_black_pixel.png White Pixel Gives a single white pixel. .. image:: /images/en/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. .. _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 colour of the subwindow canvas area. Don't show contents when moving subwindows. 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 once 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 ------------- +.. _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:`\\`. Switch ctrl/alt modifiers This switches the function of the ctrl and alt buttons when modifying selections. Useful for those used to Gimp instead of photoshop, or Lefties without a right-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. Kinetic Scrolling (Needs Restart) This enables kinetic scrolling for scrollable areas. .. figure:: /images/en/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. Disabled Will never activated. On Touch Drag Will activate if it can recognise a touch event. May not always work. On Click Drag Will activate when it can recognise a click event, will always work. Sensitivity How quickly the feature activates, this effective determines the length of the drag. Show Scrollbar Whether to show scrollbars when doing this. .. _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 cuurrent session when closing Krita so you can resume where you left off. .. versionadded:: 4.1 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'. 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. 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. Create Backup File When selected Krita will try to save a backup file in case of a crash. Hide splash screen on startup. This'll hide the splash screen automatically once Krita is fully loaded. 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 size pixel 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/user_manual/selections.rst b/user_manual/selections.rst index 9de8b2c7b..8a9c2c890 100644 --- a/user_manual/selections.rst +++ b/user_manual/selections.rst @@ -1,131 +1,135 @@ .. meta:: :description: How selections work in Krita. .. metadata-placeholder :authors: - Scott Petrovic - Wolthera van Hövell tot Westerflier - Hulmanen :license: GNU free documentation license 1.3 or later. .. index:: Selection .. _selections_basics: ========== Selections ========== -Selections allow you to pick a specific area of your artwork to change. There are many selection tools available that select in different ways. Once an area is selected, most tools will stay inside that area. On that area you can draw or use gradients to quickly get colored and/or shaded shapes with hard edges. +Selections allow you to pick a specific area of your artwork to change. This is useful for when you want to move a section, transform it, or paint on it without affecting the other sections. There are many selection tools available that select in different ways. Once an area is selected, most tools will stay inside that area. On that area you can draw or use gradients to quickly get colored and/or shaded shapes with hard edges. Creating Selections ------------------- The most common selection tools all exist at the bottom of the toolbox. Each tool selects things slightly differently. The links for each tool go into a more detailed description with how to use it. .. csv-table:: :ref:`rectangle_selection_tool` , |toolselectrect|, Select the shape of a square. :ref:`ellipse_selection_tool` , |toolselectellipse|, Select the shape of a circle. :ref:`polygonal_selection_tool` , |toolselectpolygon|, Click where you want each point of the Polygon to be. Double click to end your polygon and finalize your selection area. Use Shift + Z to undo last point. :ref:`outline_selection_tool` , |toolselectoutline|, Outline/Lasso tool is used for a rough selection by drawing the outline. :ref:`similar_selection_tool` , |toolselectsimilar|, Similar Color Selection Tool :ref:`contiguous_selection_tool` , |toolselectcontiguous|, "Contiguous or “Magic Wand” selects a field of color, Adjust the fuzziness to allow more changes in the field of color, by default limited to the current layer." :ref:`path_selection_tool` , |toolselectpath|, "Path select an area based on a vector path, click to get sharp corners or drag to get flowing lines and close the path with enter or connecting back to the first point." .. note:: You can also use the transform tools on your selection, a great way to try different proportions on parts of your image. Editing Selections ------------------ The tool options for each selection tool gives you the ability to modify your selection. +-------------+---------------+------------+ | Action | Modifier | Shortcut | +-------------+---------------+------------+ | Replace | Ctrl | -- | +-------------+---------------+------------+ | Intersect | Shift + Alt | -- | +-------------+---------------+------------+ | Add | Shift | A | +-------------+---------------+------------+ | Subtract | Alt | S | +-------------+---------------+------------+ +You can change this in :ref:`tool_options_settings`. + Removing Selections ------------------- If you want to delete the entire selection, the easiest way is to deselect everything. :menuselection:`Select --> Deselect`. Shortcut :kbd:`Ctrl + Shift + A`. Display Modes ------------- In the bottom left-hand corner of the status bar there is a button to toggle how the selection is displayed. The two display modes are the following: (Marching) Ants and Mask. The red color with Mask can be changed in the preferences. You can edit the color under :menuselection:`Settings --> Configure Krita --> Display --> Selection Overlay`. If there is no selection, this button will not do anything. .. image:: /images/en/Ants-displayMode.jpg Ants display mode (default) is best if you want to see the areas that are not selected. .. image:: /images/en/Mask-displayMode.jpg -Mask display mode is good if you are interested in seeing the various transparency levels for your selection. For example, you can create a selection with a gradient. +Mask display mode is good if you are interested in seeing the various transparency levels for your selection. For example, when you have a selection with very soft edges due using feathering. + +.. versionchanged:: 4.2 + + Mask mode is activated as well when a selection mask is the active layer so you can see the different selection levels. Global Selection Mask (Painting a Selection) -------------------------------------------- The global Selection Mask is your selection that appears on the layers docker. By default, this is hidden, so you will need to make it visible via :menuselection:`Select --> Show Global Selection Mask`. .. image:: /images/en/Global-selection-mask.jpg -Once the global Selection Mask is shown, you will need to create a -selection. The benefit of using this is that you can paint your -selection using any of the normal painting tools. The information is -saved as grayscale. You might want to switch to the Mask display mode if it is difficult to see the results. +Once the global Selection Mask is shown, you will need to create a selection. The benefit of using this is that you can paint your +selection using any of the normal painting tools, inlcuding the transform and move. The information is saved as grayscale. Selection from layer transparency --------------------------------- -You can create a selection based on a layer's transparency by right-clicking on the layer in the layer docker and selecting “Select Opaque” from the context menu. +You can create a selection based on a layer's transparency by right-clicking on the layer in the layer docker and selecting :menuselection:`Select Opaque` from the context menu. + +.. versionadded:: 4.2 + + You can also do this for adding, subtracting and intersecting by going to :menuselection:`Select --> Select Opaque`, where you can find sepcific actions for each. + + If you want to quickly select parts of layers, you can hold :kbd:`Ctrl +` |mouseleft| on the layer *thumbnail*. To add a selection do :kbd:`Ctrl + Shift+` |mouseleft| and to remove :kbd:`Ctrl + Alt +` |mouseleft|. This works with any mask that has pixel or vector data (so everything but transform masks). + Pixel and Vector Selection Types -------------------------------- Vector selections allow you to modify your selection with vector anchor tools. Pixel selections allow you to modify selections with pixel information. They both have their benefits and disadvantages. You can convert one type of selection to another. .. image:: /images/en/Vector-pixel-selections.jpg -When creating a selection, you can select what type of selection you -want from the Mode in the selection tool options: Pixel or Vector. +When creating a selection, you can select what type of selection you want from the Mode in the selection tool options: Pixel or Vector. By default this will be a vector. -Vector selections can modify as any other vector shape with the -“Shape Handle” tool, if you try to paint on a vector selection it will be converted into a pixel selection. Pixel selections can be painted with any tool. You can also convert vector shapes to selection. In turn, vector selections can be made from vector shapes, and vector shapes can be converted to vector selections using the options in the selections menu. Krita will add a new vector layer for this shape. +Vector selections can be modified as any other :ref:`vector shape ` with the :ref:`shape_selection_tool`, if you try to paint on a vector selection mask it will be converted into a pixel selection. You can also convert vector shapes to selection. In turn, vector selections can be made from vector shapes, and vector shapes can be converted to vector selections using the options in the selections menu. Krita will add a new vector layer for this shape. -One of -the most common reasons to use vector selections is that they give you -the ability to move and transform a selection. Moving the selection with -a pixel selection will move the content on the layer. Moving the -selection on a vector selection will only move the selection. You can -also use the path editing tool to change the anchor points in the -selection +One of the most common reasons to use vector selections is that they give you the ability to move and transform a selection without the kind of resize artifacts you get with a pixel selection. You can also use the :ref:`shape_edit_tool` to change the anchor points in the selection, allowing you to precisely adjust bezier curves or add corners to rectangular selections. -If you started with a pixel selection, you can still convert it to a -vector selection to get these benefits. Go to Select > Convert to Vector -Selection. +If you started with a pixel selection, you can still convert it to a vector selection to get these benefits. Go to :menuselection:`Select --> Convert to Vector Selection`. .. note:: - If you have multiple levels of transparency when you convert a selection to vector, you will lose the gray values. + If you have multiple levels of transparency when you convert a selection to vector, you will lose the semi-transparent values. Common Shortcuts while Using Selections --------------------------------------- -- Copy -- :kbd:`Ctrl + C` or :kbd:`Ctrl + Ins` -- Paste -- :kbd:`Ctrl + V` or :kbd:`Shift + Ins` -- Cut -- :kbd:`Ctrl + X`, :kbd:`Shift + Del` -- Copy From All Layers -- :kbd:`Ctrl + Shift + C` -- Copy Selection to New Layer -- :kbd:`Ctrl + Alt + J` -- Cut Selection to New Layer -- :kbd:`Ctrl + Shift + J` -- Display or hide selection with :kbd:`Ctrl + H` +- Copy -- :kbd:`Ctrl + C` or :kbd:`Ctrl + Ins` +- Paste -- :kbd:`Ctrl + V` or :kbd:`Shift + Ins` +- Cut -- :kbd:`Ctrl + X`, :kbd:`Shift + Del` +- Copy From All Layers -- :kbd:`Ctrl + Shift + C` +- Copy Selection to New Layer -- :kbd:`Ctrl + Alt + J` +- Cut Selection to New Layer -- :kbd:`Ctrl + Shift + J` +- Display or hide selection with :kbd:`Ctrl + H` +- Select Opaque -- :kbd:`Ctrl +` |mouseleft| on layer thumbnail. +- Select Opaque (Add) -- :kbd:`Ctrl + Shift` |mouseleft| on layer thumbnail. +- Select Opaque (Subtract)-- :kbd:`Ctrl + Alt` |mouseleft| on layer thumbnail.