diff --git a/general_concepts/file_formats/file_svg.rst b/general_concepts/file_formats/file_svg.rst index 383a565ab..fd742e061 100644 --- a/general_concepts/file_formats/file_svg.rst +++ b/general_concepts/file_formats/file_svg.rst @@ -1,25 +1,25 @@ .. meta:: :description: The Scalable Vector Graphics file format in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier :license: GNU free documentation license 1.3 or later. .. index:: *.svg, SVG, Scalable Vector Graphics Format .. _file_svg: ====== \*.svg ====== ``.svg``, or Scalable Vector Graphics, is the most modern vector graphics interchange file format out there. Being vector graphics, SVG is very light weight. This is because it usually only stores coordinates and parameters for the maths involved with vector graphics. It is maintained by the W3C SVG working group, who also maintain other open standards that make up our modern internet. -While you can open up SVG files with any text-editor to edit them, it is best to use a vector program like Inkscape. Krita 2.9 to 3.3 supports importing SVG via the add shape docker. Since Krita 4.0, SVGs can be properly imported, and you can export singlevector layers via :menuselection:`Layer --> Import/Export --> Save Vector Layer as SVG...`. For 4.0, Krita will also use SVG to save vector data into its :ref:`internal format `. +While you can open up SVG files with any text-editor to edit them, it is best to use a vector program like Inkscape. Krita 2.9 to 3.3 supports importing SVG via the add shape docker. Since Krita 4.0, SVGs can be properly imported, and you can export singlevector layers via :menuselection:`Layer --> Import/Export --> Save Vector Layer as SVG...` menu item. For 4.0, Krita will also use SVG to save vector data into its :ref:`internal format `. SVG is designed for the internet, though sadly, because vector graphics are considered a bit obscure compared to raster graphics, not a lot of websites accept them yet. Hosting them on your own webhost works just fine though. diff --git a/untranslatable_pages/reporting_bugs.rst b/untranslatable_pages/reporting_bugs.rst index bca194a08..afeed48f2 100644 --- a/untranslatable_pages/reporting_bugs.rst +++ b/untranslatable_pages/reporting_bugs.rst @@ -1,138 +1,138 @@ .. meta:: :description: Guide to Reporting Bugs. .. metadata-placeholder :authors: - Boudewijn Rempt :license: GNU free documentation license 1.3 or later. .. _bugs_reporting: ============== Reporting Bugs ============== Krita is, together with many other projects, part of the KDE community. Therefore, bugs for Krita are tracked in KDE's bug tracker: `KDE's bug tracker `_. The bug tracker is a tool for Krita's developers to help them manage bugs in the software, prioritize them and plan fixes. It is not a place to get user support! The bug tracker contains two kinds of reports: bugs and wishes. Bugs are errors in Krita's code that interrupt using Krita. Wishes are feature requests: the reporter thinks some functionality is missing or would be cool to have. Do not just create a feature request in the bug tracker: follow `Feature Requests `_ to learn how to create a good feature request. This guide will help you create a good bug report. If you take the time to create a good bug report, you have a much better chance of getting a developer to work on the issue. If there is not enough information to work with, or if the bug report is unreadable, a developer will not be able to understand and fix the issue. .. contents:: Only Report Bugs ---------------- A bug is a problem in Krita's code. - If you have problems with your drawing tablet, for instance no support for pressure, then that is unlikely to be a problem in Krita's code: it is almost certain to be a problem with your setup or the driver for your tablet. - If you've lost the toolbox, that's not a bug. - If you have deleted your work, that is not a bug. - If Krita works differently from another application, that's not a bug. - If Krita works differently than you expected, that's not a bug. - If Krita is slower than you expected, that's not a bug. - If Krita crashes, that's a bug. - If a file you save comes out garbled, that's a bug. - If Krita stops working, that's a bug. - If Krita stops displaying correctly, that's a bug. Check the FAQ ------------- If you've got a problem with Krita, first check the `FAQ `_. See whether your problem is mentioned there. If it is, apply the solution. If that doesn't work for you, do not report a bug. Ask for help on `Krita's Forum `_. Ask on Krita's Forum or IRC Chat Channel ------------------------------------------------------- If uncertain, ask on `Krita's IRC chat channel `_ or the `Krita Forum `_. Krita's chat channel is maintained on irc.freenode.net. Developers and users hang out to discuss Krita's development and help people who have questions. .. important:: Most Krita developers live in Europe, and the channel is very quiet when it's night in Europe. You also have to be patient: it may take some time for people to notice your question even if they are awake. .. admonition:: Also ... Krita does not have a paid support staff. You will chat with volunteers, users and developers. It is not a help desk. But you can still ask your question, and the people in the channel are a friendly and helpful lot. Use the Latest Version of Krita ------------------------------- Check Krita's website to see whether you are using the latest version of Krita. There are two "latest" versions: - Latest stable: check the `Download page `_. Always try to reproduce your bug with this version. - Stable and Unstable Nightly builds. The stable nightly build is built from the last release plus all bug fixes done since the last release. This is called **Krita Plus*** The unstable nightly build contains new features and is straight from the development branch of Krita. This is called **Krita Next**. You can download these builds from the `Download page `_. Check The Bug Tracker for Duplicates ------------------------------------ This can be tricky: many bug reports are very unclear, have misleading subjects or are assigned to the wrong component. The Krita team tries to triage incoming bugs, fixing the subject, the component and asking for more information in case the bug is not clear. But please do try to check whether a problem has already been reported. If it is, please add your report as a comment to that bug ticket. Be Complete and Be Completely Clear ----------------------------------- Give all information. That means that you should give information about your operating system, hardware, the version of Krita you're using and, of course about the problem. - Operating system: fill in the requisite field in the bug tracker's form - Version: fill in the requisite field in the bug tracker's form -- Hardware information: copy the information from the :menuselection:`Help --> System information` for Bug Reports window into your report. Note how many displays you have. +- Hardware information: copy the information from the :menuselection:`Help --> Show System Information for Bug Reports` or Bug Reports window into your report. Note how many displays you have. - If you are using a drawing tablet, tell us the brand and type. - Tell us what kind of image you were working on: the size, the resolution, the color model and channel depth. - If you are reporting a crash, attach a crash log. Follow `this link `_ to learn how to get a crash log on Windows. On Linux, follow your distribution's instructions to install debug symbols if you have installed Krita from a distribution package. It is not possible to create a useful crash log with Linux appimages. -- Attach the contents of the :menuselection:`Help --> Show system information for bug reports` dialog to the bug report. +- Attach the contents of the :menuselection:`Help --> Show System Information for Bug Reports` dialog to the bug report. The problem needs to be clearly stated: - what happened, - what had you expected to happen instead, - how the problem can be reproduced. Give a concise and short description, then enumerate the steps needed to reproduce the problem. If you cannot reproduce the problem, and it isn't a crash, think twice before making the report: the developers likely cannot reproduce it either. If at all possible, attach your original Krita file (the one that ends in ``.kra``) to the bug report, or if it's too big, add a link for download. If you do that, make sure the file will be there for **years** to come: do not remove it. If you think it would be useful, you can also attach or link to a video. Note that the Krita developers and bug triagers are extremely busy, and that it takes less time to read a good description and a set of steps to reproduce than it takes to watch a video for clues for what is going on. When making a video or a screenshot, include the whole Krita window, including the titlebar and the statusbar. You're Not Done After You Have Filed the Report ----------------------------------------------- After you have filed your bug, mail will be sent out to all Krita developers and bug triagers. You do not have to go to the chat channel and tell us you created a bug. When a developer decides to investigate your report, they will start adding comments to the bug. There might be additional questions: please answer them as soon as possible. When the developer has come to a conclusion, they will **resolve** the bug. That is done by changing the resolution status in the bug tracker. These statuses are phrased in developer speak, that is to say, they might sound quite rude to you. There's nothing that we can do about that, so do not take it personally. The bug reporter should *never* change the status after a developer changed it. These are the most used statuses: - Unconfirmed: your bug has not been investigated yet, or nobody can reproduce your bug. - Confirmed: your bug is a bug, but there is no solution yet. - Assigned: your bug is a bug, someone is going to work on it. There probably will be a corresponding task on the https://phabricator.kde.org/project/view/8/ developer workboard. - Resolved/Fixed: your bug was a genuine problem in Krita's code. The developer has fixed the issue and the solution will be in the next release. - Duplicate: your bug has been reported before. - Needinfo/WaitingForInfo. You need to provide more information. If you do not reply within a reasonable amount of time the bug will be closed. - Resolved/Invalid: your report was not about a bug. - Resolved/Upstream: the issue you observed is because of a bug in a library Krita uses, or a hardware driver, or your operating system. We cannot do anything about it. - Resolved/Downstream: Only on Linux. The issue you observed happens because your Linux distribution packages Krita in a way that causes problems. See also our chapter on `Bug Triaging `_ 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 1f1bf31f3..9ee5bb95c 100644 --- a/user_manual/introduction_from_other_software/introduction_from_sai.rst +++ b/user_manual/introduction_from_other_software/introduction_from_sai.rst @@ -1,218 +1,218 @@ .. 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` key to flip. Rotate There's a couple of possibilities here: either the :kbd:`4` and :kbd:`6` keys, or the :kbd:`Ctrl + [` and :kbd:`Ctrl + ]` shortcuts for basic 15 degrees rotation left and right. But you can also have more sophisticated rotation with the :kbd:`Shift + Space + drag` or :kbd:`Shift +` |mousemiddle| :kbd:`+ drag` shortcuts. To reset the rotation, press the :kbd:`5` key. Zoom You can use the :kbd:`+` and :kbd:`-` keys to zoom out and in, or use the :kbd:`Ctrl +` |mousemiddle| shortcut. Use the :kbd:`1`, :kbd:`2` or :kbd:`3` keys 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 Main Toolbar. +You can also put these commands on the toolbar, so it'll feel a little like Sai. Go to :menuselection:`Settings --> Configure Toolbars...` menu item. There are two toolbars, but we'll add to the Main 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 and Stuff 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| shortcut before :guilabel:`Pick Foreground Color from Merged 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 --> Image Background Color and Transparency...` menu item. If you export a PNG or JPG, make sure to uncheck :guilabel:`Store alpha channel (transparency)` and to make the background color white (it's black by default). .. image:: /images/filters/Krita-color-to-alpha.png :align: center Like Sai, you can quickly turn a black and white image to black and transparent with the :guilabel:`Filter: Color to Alpha` dialog under :menuselection:`Filters --> Colors --> Color to Alpha...` menu item. 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 the :kbd:`F5` key. 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`` or ``.kpp`` files. Erasing ~~~~~~~ Erasing is a blending mode in Krita, much like the transparency mode of Paint Tool Sai. It's activated with the :kbd:`E` key or you can select it from the :guilabel:`Blending Mode` drop-down box. 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 (called Shine in Sai2) is the same as Krita's *Luminosity/Shine (SAI)* mode, which is new in Krita 4.2.4. The Sai's Shade mode is the same as *Color Burn* and *Hard Mix* is the same as the Luminosity and Shade modes. 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 the :kbd:`Ctrl + Shift + G` shortcut. 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 the :kbd:`Del` key. 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... --> Color Selector Settings --> Color Selector tab`, select an option in the :guilabel:`Docker:` drop-down box, to change the shape and type of your main color selector. .. image:: /images/dockers/Krita_Color_Selector_Types.png :align: center You can call the color history with the :kbd:`H` key, common colors with the :kbd:`U` key and the two shade selectors with the :kbd:`Shift + N` and :kbd:`Shift + M` shortcuts. The big selector can be called with the :kbd:`Shift + I` shortcut 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/tools/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/assistants/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 the :kbd:`R` key 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/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/tools/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/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/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 a045ff8ad..c6e7e6ae0 100644 --- a/user_manual/loading_saving_brushes.rst +++ b/user_manual/loading_saving_brushes.rst @@ -1,487 +1,487 @@ .. 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 drop-down ---------------------------- To start, the Brush Settings Editor panel can be accessed in the toolbar, between the :guilabel:`Choose brush preset` button on the right and the :guilabel:`Fill Patterns` button on the left. Alternately, you can use the :kbd:`F5` key to open it. When you open Brush Settings Editor panel you will see something like this: Tour of the brush settings drop-down ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. image:: /images/brushes/Krita_4_0_Brush_Settings_Layout.svg :width: 800 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 the brush preset` 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` buttons. 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. 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 preset will call up the following window, with a mini scratch pad, and all sorts of options to change the preset icon: .. image:: /images/brushes/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 +The image on the left is a mini scratch pad, 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 Scratchpad Thumbnail +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/brushes/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 Brush 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 drop-down on the :kbd:`F6` key. 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 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 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 :guilabel:`Save New Brush Preset` dialog. The scratch pad has five buttons underneath it. These are in order for: #. Fill area with brush preset icon #. Fill area with current image #. Fill area with gradient (useful for smudge brushes) #. Fill area with background color #. Reset area to white 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 curve 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/brushes/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 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 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. Temporarily save tweaks to preset 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/brushes/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. 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 the :kbd:`F5` key. 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 Brush Preset...` button. 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 are 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 the :kbd:`F6` key 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 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! diff --git a/user_manual/templates.rst b/user_manual/templates.rst index f229b4560..3bd080627 100644 --- a/user_manual/templates.rst +++ b/user_manual/templates.rst @@ -1,68 +1,68 @@ .. meta:: :description: How to use document templates in Krita. .. metadata-placeholder :authors: - Scott Petrovic - Wolthera van Hövell tot Westerflier - AndreyGolovkin :license: GNU free documentation license 1.3 or later. .. index:: ! Template .. _templates: ========= Templates ========= .. image:: /images/Krita_New_File_Template_A.png Templates are just ``.kra`` files which are saved in a special location so it can be pulled up by Krita quickly. This is like the :guilabel:`Open Existing Document as Untitled Document...` but then with a nicer place in the UI. -You can make your own template file from any ``.kra`` file, by using :menuselection:`File --> Create Template from image...` menu item. This will add your current document as a new template, including all its properties along with the layers and layer contents. +You can make your own template file from any ``.kra`` file, by using :menuselection:`File --> Create Template from Image...` menu item. This will add your current document as a new template, including all its properties along with the layers and layer contents. We have the following defaults: Comic Templates ~~~~~~~~~~~~~~~ These templates are specifically designed for you to just get started with drawing comics. The comic template relies on a system of vectors and clones of those vector layers which automatically reflect any changes made to the vector layers. In between these two, you can draw your picture, and not fear them drawing over the panel. Use :guilabel:`Inherit Alpha` to clip the drawing by the panel. European Bande Desinée Template. This one is reminiscent of the system used by for example TinTin or Spirou et Fantasio. These panels focus on wide images, and horizontal cuts. US-style comics Template. This one is reminiscent of old DC and Marvel comics, such as Batman or Captain America. Nine images for quick story progression. Manga Template. This one is based on Japanese comics, and focuses on a thin vertical gutter and a thick horizontal gutter, ensuring that the reader finished the previous row before heading to the next. Waffle Iron Grid 12 little panels at your disposal. Design Templates ~~~~~~~~~~~~~~~~ These are templates for design and have various defaults with proper ppi at your disposal: * Cinema 16:10 * Cinema 2.93:1 * Presentation A3-landscape * Presentation A4 portrait * Screen 4:3 * Web Design DSLR templates ~~~~~~~~~~~~~~ These have some default size for photos: * Canon 55D * Canon 5DMK3 * Nikon D3000 * Nikon D5000 * Nikon D7000 Texture Templates ~~~~~~~~~~~~~~~~~ These are for making 3D textures, and are between 1024, to 4092. diff --git a/user_manual/working_with_images.rst b/user_manual/working_with_images.rst index 8d9c9616a..26bad6645 100644 --- a/user_manual/working_with_images.rst +++ b/user_manual/working_with_images.rst @@ -1,281 +1,281 @@ .. meta:: :description: Detailed steps on how images work 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:: Image, Document, Raster, Vector, Metadata .. _working_with_images: =================== Working with Images =================== Computers work with files and as a painting program, Krita works with images as the type of file it creates and manipulates. What do Images Contain? ----------------------- If you have a text document, it of course contains letters, strung in the right order, so the computer loads them as coherent sentences. Raster Data ~~~~~~~~~~~ This is the main data on the paint layers you make. So these are the strokes with the paint brush and look pixely up close. A multi-layer file will contain several of such layers, that get overlaid on top of each other so make the final image. A single layer file will usually only contain raster data. Vector Data ~~~~~~~~~~~ These are mathematical operations that tell the computer to draw pixels on a spot. This makes them much more scalable, because you just tell the operation to make the coordinates 4 times bigger to scale it up. Due to this vector data is much more editable, lighter, but at the same time it's also much more CPU intensive. Operation Data ~~~~~~~~~~~~~~ Stuff like the filter layers, that tells Krita to change the colors of a layer, but also transparency masks, group layer and transformation masks are saved to multi-layer files. Being able to load these depend on the software that initially made the file. So Krita can load and save groups, transparency masks and layer effects from PSD, but not load or save transform masks. Metadata -------- Metadata is information like the creation date, author, description and also information like DPI. Image size ---------- The image size is the dimension and resolution of the canvas. Image size has direct effect file size of the Krita document. The more pixels that need to be remembered and the higher the bit depth of the color, the heavier the resulting file will be. DPI/PPI ~~~~~~~ **DPI** stands for *Dots per Inch*, **PPI** stands for *Pixels per Inch*. In printing industry, suppose if your printer prints at 300 **DPI**. It means it is actually putting 300 dots of colors in an area equal to an Inch. This means the number of pixels your artwork has in a relative area of an inch. **DPI** is the concern of the printer, and artists while creating artwork should keep **PPI** in mind. According to the **PPI** you have set, the printers can decide how large your image should be on a piece of paper. Some standards: 72 PPI This is the default PPI of monitors as assumed by all programs. It is not fully correct, as most monitors these days have 125 PPI or even 300 PPI for the retina devices. None the less, when making an image for computer consumption, this is the default. 120 PPI This is often used as a standard for low-quality posters. 300 PPI This is the minimum you should use for quality prints. 600 PPI The quality used for line art for comics. Color depth ~~~~~~~~~~~ We went over color depth in the :ref:`Color Management page `. What you need to understand is that Krita has image color spaces, and layer color spaces, the latter which can save memory if used right. For example, having a line art layer in grayscale can half the memory costs. Image color space vs layer color space vs conversion. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Because there's a difference between image color space and layer color space, you can change only the image color space in :menuselection:`Image --> Properties...` which will leave the layers alone. But if you want to change the color space of the file including all the layers you can do it by going to :menuselection:`Image --> Convert Image Color Space...` this will convert all the layers color space as well. Author and Description ---------------------- .. image:: /images/document_information_screen.png Krita will automatically save who created the image into your image's metadata. Along with the other data such as time and date of creation and modification, Krita also shows editing time of a document in the document information dialog, useful for professional illustrators, speed-painters to keep track of the time they worked on artwork for billing purposes. It detects when you haven’t performed actions for a while, and has a precision of ±60 seconds. You can empty it in the document info dialog and of course by unzipping you ``.kra`` file and editing the metadata there. These things can be edited in :menuselection:`File --> Document Information`, and for the author's information :menuselection:`Settings --> Configure Krita... --> Author`. Profiles can be switched under :menuselection:`Settings --> Active Author Profile`. Setting the canvas background color ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can set the canvas background color via :menuselection:`Image --> Image Background Color and Transparency...` menu item. This allows you to turn the background color non-transparent and to change the color. This is also useful for certain file formats which force a background color instead of transparency. PNG and JPG export use this color as the default color to fill in transparency if you do not want to export transparency. If you come in from a program like :program:`Paint Tool Sai`, then using this option, or using :guilabel:`As canvas color` radio button at :guilabel:`Background:` -aection in the new file options, will allow you to work in a slightly more comfortable +section in the new file options, will allow you to work in a slightly more comfortable environment, where transparency isn't depicted with checkered boxes. Basic transforms ~~~~~~~~~~~~~~~~ There are some basic transforms available in the Image menu. Shear Image... This will allow you to skew the whole image and its layers. Rotate This show a submenu that will allow you to rotate the image and all its layers quickly. Mirror Image Horizontally/Vertically This will allow you to mirror the whole image with all its layers. But there are more options than that... Cropping and resizing the canvas -------------------------------- You can crop and image with the :ref:`crop_tool`, to cut away extra space and improve the composition. Trimming ~~~~~~~~ Using :menuselection:`Image --> Trim to Current Layer`, Krita resizes the image to the dimensions of the layer selected. Useful for when you paste a too large image into the layer and want to resize the canvas to the extent of this layer. :menuselection:`Image --> Trim to Selection` is a faster cousin to the crop tool. This helps us to resize the canvas to the dimension of any active selection. This is especially useful with right clicking the layer on the layer stack and choosing :guilabel:`Select Opaque`. :menuselection:`Image --> Trim to Selection` will then crop the canvas to the selection bounding box. :menuselection:`Image --> Trim to Image Size` is actually for layers, and will trim all layers to the size of the image, making your files lighter by getting rid of invisible data. Resizing the canvas ------------------- You can also resize the canvas via :menuselection:`Image --> Resize Canvas...` (or the :kbd:`Ctrl + Alt + C` shortcut). The dialog box is shown below. .. image:: /images/Resize_Canvas.png In this, :guilabel:`Constrain proportions` checkbox will make sure the height and width stay in proportion to each other as you change them. Offset indicates where the new canvas space is added around the current image. You basically decide where the current image goes (if you press the left-button, it'll go to the center left, and the new canvas space will be added to the right of the image). Another way to resize the canvas according to the need while drawing is when you scroll away from the end of the canvas, you can see a strip with an arrow appear. Clicking this will extend the canvas in that direction. You can see the arrow marked in red in the example below: .. image:: /images/Infinite-canvas.png :width: 700px Resizing the image ~~~~~~~~~~~~~~~~~~ :guilabel:`Scale Image to New Size...` allows you to resize the whole image. Also, importantly, this is where you can change the resolution or *upres* your image. So for instance, if you were initially working at 72 PPI to block in large shapes and colors, images, etc... And now you want to really get in and do some detail work at 300 or 400 PPI this is where you would make the change. Like all other dialogs where a chain link appears, when the chain is linked the aspect ratio is maintained. To disconnect the chain, just click on the link and the two halves will separate. .. image:: /images/Scale_Image_to_New_Size.png Separating Images ~~~~~~~~~~~~~~~~~ .. image:: /images/Separate_Image.png This powerful image manipulation feature lets you separate an image into its different components or channels. This is useful for people working in print, or people manipulating game textures. There's no combine functionality, but what you can do, if using colored output, is to set two of the channels to the addition :ref:`blending_modes`. For grayscale images in the RGB space, you can use the Copy Red, Copy Green and Copy Blue blending modes, with using the red one for the red channel image, etc. Saving, Exporting and Opening Files ----------------------------------- When Krita creates or opens a file, it has a copy of the file in memory, that it edits. This is part of the way how computers work: They make a copy of their file in the RAM. Thus, when saving, Krita takes its copy and copies it over the existing file. There's a couple of tricks you can do with saving. Save Krita saves the current image in its memory to a defined place on the hard-drive. If the image hadn't been saved before, Krita will ask you where to save it. Save As... Make a copy of your current file by saving it with a different name. Krita will switch to the newly made file as its active document. Open... Open a saved file. Fairly straightforward. Export... Save a file to a new location without actively opening it. Useful for when you are working on a layered file, but only need to save a flattened version of it to a certain location. Open Existing Document as Untitled Document... This is a bit of an odd one, but it opens a file, and forgets where you saved it to, so that when pressing 'save' it asks you where to save it. This is also called 'import' in other programs. Create Copy from Current Image Makes a new copy of the current image. Similar to :menuselection:`Open Existing Document as Untitled Document...`, but then with already opened files. Save Incremental Version Saves the current image as *'filename'\_XXX.kra* and switches the current document to it. Save Incremental Backup Copies and renames the last saved version of your file to a back-up file and saves your document under the original name. .. note:: Since Krita's file format is compressed data file, in case of a corrupt or broken file you can open it with archive managers and extract the contents of the layers. This will help you to recover as much as possible data from the file. On Windows, you will need to rename it to *filename.zip* to open it.