diff --git a/KritaFAQ.rst b/KritaFAQ.rst index 0720aa770..08cf4755d 100644 --- a/KritaFAQ.rst +++ b/KritaFAQ.rst @@ -1,621 +1,621 @@ .. .. meta:: :description: Frequently asked Krita Questions. .. metadata-placeholder :authors: - Scott Petrovic - Wolthera van Hövell tot Westerflier - Raghavendra Kamath - Boudewijn Rempt - Alvin Wong - Dmitry Kazakov - Timothée Giet - Tokiedian - Nmaghfurusman - RJ Quiralta - Tyson Tan :license: GNU free documentation license 1.3 or later. .. index:: FAQ, Frequently Asked Questions .. _faq: .. _KritaFAQ: ######### Krita FAQ ######### This page contains common problems people have with Krita. Note that we assume that you are using the latest version of Krita. Please verify that to make sure. .. contents:: General ======= General questions What is Krita? -------------- This is our vision for the development of Krita: Krita is a free and open source cross-platform application that offers an end-to-end solution for creating digital art files from scratch. Krita is optimized for frequent, prolonged and focused use. Explicitly supported fields of painting are illustrations, concept art, matte painting, textures, comics and animations. Developed together with users, Krita is an application that supports their actual needs and workflow. Krita supports open standards and interoperates with other applications. Is it possible to use Krita in my own language, not English? ------------------------------------------------------------ Krita should automatically use the system language. If that is not the case, please follow these steps: #. With :menuselection:`Settings --> Switch Application Language...` menu item will appear a small window. #. Click :guilabel:`Primary language` and select your language. #. Click :guilabel:`OK` to close the window. #. Restart krita and it will be displayed in your selected language! If this doesn't work, you might have to add a fall-back language as well. This is a bug, but we haven't found the solution yet. I have a problem, how to get support for Krita? ----------------------------------------------- -#. Ask your question on one of the user support forums. It can be `Krita Artists forum `_ (recommended), `Krita KDE forum `_ or alternatively `Krita subreddit `_ . +#. Ask your question on one of the user support forums. It can be `Krita Artists forum `_ (recommended), `Krita KDE forum `_ or alternatively `Krita subreddit `_ . #. Remember -- most probably the person you're interacting with is a volunteer, and even if not, it's not someone actually paid for doing user support. Treat them nicely and respect their time! They will for sure reciprocate that. #. Create a new thread or post for your issue and state the issue in the title. Even if you don't know how to describe it exactly, for example you title the post "Krita's text tool is acting weird", it is much better than simple "Help!". #. Describe your issue. You can add screenshots and videos, but even if you do that, write a few words what the video shows and what the issue is. -#. State all relevant details: most importantly your operating system (Windows, MacOS, Linux...), which version of Krita you use (go to :menuselection:`Help -> About Krita` to find out) and what kind of tablet you have (if your issue is related to a tablet driver). +#. State all relevant details: most importantly your operating system (Windows, MacOS, Linux...), which version of Krita you use (go to :menuselection:`Help --> About Krita` to find out) and what kind of tablet you have (if your issue is related to a tablet driver). #. Answer all questions your supporter asks, even if you don't think they're relevant. They probably have a reason to ask about that. #. If you don't know the answer or you don't know how to get the information your supporter asks for, don't hesitate to ask for clarification. #. If you mentioned an issue, please help with testing if you're asked to do that -- that will speed up the process of finding the cause and preparing a fix. Does Krita have layer clip or clipping mask? -------------------------------------------- Krita has no clipping mask, but it has a clipping feature called inherit alpha. Let's see :ref:`this page ` and learn how to do clipping in Krita! Where are the configuration files stored? ----------------------------------------- These are stored at the following places for the following operating systems: Linux :file:`$HOME/.config/kritarc` Windows :file:`%APPDATA%\\Local\\kritarc` MacOS X :file:`$HOME/Library/Preferences/kritarc` The kritarc file is the configuration file. Krita does not store settings in the Windows registry. .. _faq_reset_krita_configuration: Resetting Krita configuration ----------------------------- You can reset the Krita configuration in one of the following ways: - Press and hold :kbd:`Shift + Alt + Ctrl` while starting Krita. This should show a pop-up asking if you want to reset the configuration. Press :guilabel:`yes` to reset it. - For Krita 3.0 and later: Delete/rename the kritarc file, found here: Linux :file:`$HOME/.config/kritarc` Windows :file:`%LOCALAPPDATA%\\kritarc` MacOS X :file:`$HOME/Library/Preferences/kritarc` There can be two other files you might want to remove: kritaopenglrc and kritadisplayrc. If the configuration was causing a crash, don't delete the mentioned file, but instead rename and send it to us in order for us to figure what caused the crash. If you have installed Krita through the Windows store, the kritarc file will be in another location :file:`%LOCALAPPDATA%\\Packages\\49800Krita_{RANDOM STRING}\\LocalCache\\Local\\kritarc` The random string depends on your installation. Windows users have a habit of uninstalling and reinstalling applications to solve problems. Unless the problem is that the installation was corrupted by a virus scanner or drive failure, that will NOT work. Uninstalling Krita then reinstalling replaces the bytes on your drive with exactly the same bytes that were there before. It doesn't reset anything, least of all Krita's settings. Why my configuration resets on its own? --------------------------------------- There are two possible reasons: - You don't save your settings. This is most probable if you are on Windows and you have either a display with a small resolution (below fullHD) or if you have fullHD resolution with UI scaling in Windows settings (which is 150% by default). In those cases it might happen that you don't see the :guilabel:`OK` button in the :guilabel:`Configure Krita` dialog. You can use :kbd:`Alt + O` instead. (You can go to :menuselection:`Configure Krita... --> General --> Window` and make sure that :guilabel:`Enable HiDPI` checkbox is unchecked to disable scaling for Krita and get a smaller UI). - You close your computer using the power button. -If you are on Windows and you use power button instead of a standard procedure to close or restart your computer, it might happen that Krita's configuration file gets corrupted. To solve this, just use the correct way of closing your system: either :menuselection:`Start -> Restart` or :menuselection:`Start -> Shutdown`. +If you are on Windows and you use power button instead of a standard procedure to close or restart your computer, it might happen that Krita's configuration file gets corrupted. To solve this, just use the correct way of closing your system: either :menuselection:`Start --> Restart` or :menuselection:`Start --> Shutdown`. Where are my resources stored? ------------------------------ Linux :file:`$HOME/.local/share/krita/` Windows :file:`%APPDATA%\\krita\\` Mac OS X :file:`~/Library/Application Support/Krita/` If you installed Krita in the Windows Store, your custom resources will be in a location like: :file:`%LOCALAPPDATA%\\Packages\\49800Krita_{RANDOM STRING}\\LocalCache\Roaming\krita` Krita tells me it can't find some files and then closes, what should I do? -------------------------------------------------------------------------- Causes for this could be the following: - It might be that your download got corrupted and is missing files (common with bad wifi and bad internet connection in general), in that case, try to find a better internet connection before trying to download again. Krita should be around 80 to 100 MB in size when downloading. - It might be that something went wrong during installation. Check whether your harddrive is full and reinstall Krita with at least 120 MB of empty space. If not, and the problem still occurs, there might be something odd going on with your device and it's recommended to find a computer expert to diagnose what is the problem. - Some unzippers don't unpack our ZIP files correctly. The native ones on Windows, OSX and most Linux distributions should be just fine, and we recommend using them. - You manually, using a file manager deleted or moved resources around, and thus Krita cannot find them anymore. What Graphics Cards does Krita support? --------------------------------------- Krita can use OpenGL to accelerate painting and canvas zooming, rotation and panning. Nvidia and recent Intel GPUs give the best results. Make sure your OpenGL drivers support OpenGL 3.2 as the minimum. AMD/ATI GPU’s are known to be troublesome, especially with the proprietary drivers on Linux. However, it works perfectly with the Radeon free driver on Linux for supported AMD GPU. Try to get a graphics card that can support OpenGL 3.2 or above for the best results, some examples: .. Following graphics cards have been suggested by Tyson Tan on the basis that they all support 3.2 Intel Intel 3rd Generation HD Graphics, IvyBridge or Bay-Trail microarchitecture, released in 2012. Commonly available products: Celeron J1x00, N2x00, Celeron (G)1xx0, Pentium J2x00, N3500, Pentium (G)2xx0, Core i3/5/7-3xx0. AMD/ATI Radeon HD 2000 family, TeraScale 1 microarchitecture, Released in 2007. Commonly available products: Radeon HD 2400 PRO, Radeon HD 2600 PRO, etc. Nvidia GeForce 8 family, Tesla microarchitecture, released in 2006. Commonly available products: GeForce 8400 GS, GeForce 8800 GTS, 9800 GTX, GTS 250, etc. *For Krita 3.3 or later:* Krita on Windows can use Direct3D 11 for graphics acceleration (through ANGLE). This is enabled automatically on systems with an Intel GPU. I can't edit text from PSD files created by Photoshop ----------------------------------------------------- There is no text support for PSD file yet. The text will appear rasterized and converted into a paint layer. How much memory does my image take? ----------------------------------- For simple images, its easy to calculate: you multiply width \* height \* channels \* size of the channels (so, for a 1000×1000 16 bit integer rgba image: 1000 x 1000 x 4 x 2). You multiply this by the number of layers plus two (one for the image, one for the display). If you add masks, filter layers or clone layers, it gets more complicated. Why do I get a checkerboard pattern when I use the eraser? ---------------------------------------------------------- You’re probably used to Gimp or Photoshop. The default background or first layer in these applications doesn’t have an alpha channel by default. Thus, on their background layer, the eraser paints in the background color. In Krita, all layers have an alpha channel, if you want to paint in the background color, you should simply do it in a layer above the first one (Layer 1), that would prevent you from erasing the white background color, making the checkerboard visible. You get the same effect in, say, Gimp, if you create new image, add an alpha channel and then use the eraser tool. Most Krita users will actually start a sketch in Krita by adding a new blank layer first before doing anything else. (The :kbd:`Ins` key is a useful shortcut here). That doesn’t use extra memory, since a blank layer or a layer with a default color just takes one pixel worth of memory. Can krita work with 8 bit (indexed) images? ------------------------------------------- No. Krita has been designed from the ground up to use real colors, not indexed palettes. There are no plans to support indexed color images, although Krita can export to some indexed color image formats, such as GIF. However, it does not offer detailed control over pixel values. Where can I find older versions of Krita? ----------------------------------------- All the older versions of Krita that are still available can be found here: - `Very old builds `_. On Windows, the Krita User Interface is too big on my screen ------------------------------------------------------------ If you're using Windows, you can set the display scaling to 150% or 200%. Krita comes with HiDPI enabled by default, so if you do that, the Krita UI might be too big for your screen. You can turn it off using the following steps: - On the menu, select :menuselection:`Settings --> Configure Krita...` - On :guilabel:`General` page, switch to :guilabel:`Window` tab. - Uncheck :guilabel:`Enable Hi-DPI support` (or check if you wish to enable it) - Press :guilabel:`OK`, if the settings screen is too big, :kbd:`Alt + O` will trigger the OK button too. - Restart Krita You can also change the toolbox icon size by right-clicking on the toolbox and selecting a size. Windows: In fullscreen mode, why is there a thin gap at the bottom of the window? --------------------------------------------------------------------------------- When :ref:`Canvas Graphics Acceleration ` is set to OpenGL, you may see a thin gap at the bottom of the window which you can see through. This is done deliberately to work around a bug causing menus and dropdowns to be unusable. If you find it distracting, you can consider changing the Renderer to Direct3D 11 which doesn't require this workaround. Windows: OBS can't record the Krita OpenGL canvas ------------------------------------------------- The possible workarounds for this is to do either of the following: #. Turn off OpenGL in :menuselection:`Settings --> Configure Krita... --> Display`. #. Or don't use the hardware accelerated mode (game recording mode) in OBS, thus capturing the whole desktop instead of attempting to capture only Krita. You might also be able to work around the problem by using the ANGLE renderer instead of native OpenGL. Can krita work with 8 bit (indexed) images? ------------------------------------------- No. Krita has been designed from the ground up to use real colors, not indexed palettes. There are no plans to support indexed color images, although Krita can export to some indexed color image formats, such as GIF. However, it does not offer detailed control over pixel values. Where can I find older versions of Krita? ----------------------------------------- All the older versions of Krita that are still available can be found here: - `Very old builds `_ On Windows, the Krita User Interface is too big on my screen ------------------------------------------------------------ If you're using Windows, you can set the display scaling to 150% or 200%. Krita comes with HiDPI enabled by default, so if you do that, the Krita UI might be too big for your screen. You can turn it off using the following steps: - On the menu, select :menuselection:`Settings --> Configure Krita` - On :guilabel:`General` page, switch to :guilabel:`Window` tab. - Uncheck :guilabel:`Enable Hi-DPI support` (or check if you wish to enable it) - Press :guilabel:`OK`, if the settings screen is too big, :kbd:`Alt + O` will trigger the OK button too. - Restart Krita You can also change the toolbox icon size by right-clicking on the toolbox and selecting a size. Windows: In fullscreen mode, why is there a thin gap at the bottom of the window? --------------------------------------------------------------------------------- When :ref:`Canvas Graphics Acceleration ` is set to OpenGL, you may see a thin gap at the bottom of the window which you can see through. This is done deliberately to work around a bug causing menus and dropdowns to be unusable. If you find it distracting, you can consider changing the Renderer to Direct3D 11 which doesn't require this workaround. Windows: OBS can't record the Krita OpenGL canvas ------------------------------------------------- The possible workarounds for this is to do either of the following: #. Turn off OpenGL in :menuselection:`Settings --> Configure Krita --> Display`. #. Or don't use the hardware accelerated mode (game recording mode) in OBS, thus capturing the whole desktop instead of attempting to capture only Krita. You might also be able to work around the problem by using the ANGLE renderer instead of native OpenGL. Windows: Can I use Krita with Sandboxie? ---------------------------------------- No, this is not recommended. Sandboxie causes stuttering and freezes due to the way it intercepts calls for resources on disk. Windows: Krita cannot save -------------------------- If the message is "File not found. Check the file name and try again.", you probably have Controlled Folder Access enabled. - Select :menuselection:`Start --> Settings`. - Choose :menuselection:`Update & security --> Windows Defender`. - Select :guilabel:`Open Windows Defender Security Center`. - Select :guilabel:`Virus & threat protection`, and then choose :guilabel:`Virus & threat protection settings`. - Under :guilabel:`Controlled folder access`, turn it on or off. You can also whitelist Krita, following `these instructions `_. Windows: Krita cannot open my file anymore ------------------------------------------ Your file got corrupted. There are several things that might cause this: #. Windows was shutdown improperly, like by holding the power button. This prevents your harddrive from finishing up the things it is doing and file away your files incorrectly. Please always try to shutdown your computer via the proper shutdown procedure, and if you are in a situation where this is not possible (like frequent blackouts), make daily backups! This may lead to the file being filled with zeroes, so it cannot be recovered from. .. versionchanged:: 4.2.8 Krita version 4.2.8 introduced special safety measure for Windows that should help avoiding this situation. But in any case, unless something makes it impossible, always make sure to shutdown your system using the standard approach. On Windows that means going to Start menu and selecting "Shutdown". #. Badly programmed security software may attempt to rewrite KRA files, or prevent Krita from writing to the folder you wish to save to. These cases can be checked by trying to save in that location, and then, without shutting down Krita, checking in the folder to see if the file saved. Files lost due this cannot be recovered. #. Cloud services like dropbox and onedrive have been known to prevent Krita from saving. We've implemented fixes for this, but much like the above point it is worth checking that this isn't the cause of the issue. Files lost due this cannot be recovered. #. Occasionally the ZIPs that KRA files comprise of will have the last few bytes missing. We're doing everything in our power to prevent this kind of corruption, but it might be a file system issue. This particular bug can be fixed by renaming the extension (in windows you will need to enable the file extensions, which this FAQ will not cover) to ZIP, and then using a ZIP repairing utility to fix the ZIP file. Then rename it back to KRA. #. If Krita doesn't give an error message, but rather crashes, your file is too big, and Krita is not so much crashing as that the operating system is shutting it down. Try shutting down some other programs like webbrowsers or streaming services to free up working memory. You should be able to open the file in question. At this point the recommended course of action is to try and reduce the file size in some manner, such as merging layers, splitting up an animation or scaling the image down. How to recover my files? ------------------------- #. Check whether you have any backup file or autosave left: :ref:`autosave`. #. Check whether you can open the file as ZIP archive. #. Rename the extension of the file from ``.kra`` to ``.zip``. #. Try to open (your system should automatically select an archive opener tool). #. There is file called mergedimage.png inside that represents all layers merged that you can use for reference in case you can't restore anything else. #. Check whether ZIP repairer tool helps. #. Copy the file so you have a backup just in case. #. Rename the extension of the file from ``.kra`` to ``.zip``. #. Use ZIP repairer tool on the ``.zip`` file. .. code-block:: bash # On Linux: mv file.kra file_copy.zip zip -F file_copy.zip --out file_new1.zip unzip file_new1.zip # if it still doesn't work: zip -FF file_copy.zip --out file_new2.zip unzip file_new2.zip # if it still doesn't work, try to run it again on *file_new2.zip* file, or try on *file_new1.zip* file # On Windows: Copy the file, rename the extension. Use any graphical ZIP repairer on the new file. (Follow the instructions for that specific program). #. Try to open in Krita. #. If it cannot be opened in Krita, try the trick from 2.: open the archive and find mergedimage.png file. #. Open your file in Notepad or any other text editor. If the the content of the file is only a repeated *NUL* symbol, it means the file is most probably unrecoverable using the standard method. If it's of a very high importance for you, you can try to recover the previous save using methods that checks the hard drive directly. Krita crashes on Windows 7 on start-up -------------------------------------- Starting with Krita 4.2.0, Krita uses version 5.12 of the Qt toolkit. This needs to have access to Direct3D 11 or OpenGL ES 2.0 or higher. You might need to install drivers appropriate to your GPU (Nvidia, AMD/ATI, Intel). This also makes it hard to run Krita in a virtual environment: in Virtual Box you need to install the guest addition in safe mode, and enable the experimental Direct3D support. Windows: How can I produce a backtrace? ----------------------------------------- .. seealso:: :ref:`Dr. Mingw debugger ` If you experience a crash on Windows, and can reproduce the crash, the bug report will be much more valuable if you can create a backtrace. A backtrace is somewhat akin to an airplane's blackbox, in that they tell what set of instructions your computer was running when it was crashing (where the crash happened), making it very useful to figure out why the crash happened. The :ref:`Dr. Mingw debugger ` is bundled with Krita. Please visit the page :ref:`Dr. Mingw debugger ` for instructions on getting a backtrace with it. Windows: Krita's window is semi-transparent ------------------------------------------- Chances are you are using an NVidia GPU. Due to a bug in Nvidia's driver that we haven't been able to workaround yet, sometimes Krita's window will be transparent or semi-transparent. The solution is to enable the Angle renderer in Krita's Settings dialog. Open the :menuselection:`Settings` menu (Press Alt-N if the menubar is not visible and your system is in English), then open the :guilabel:`Configure Krita` dialog. In the dialog window select the :guilabel:`Display` page and select the Angle renderer in the :guilabel:`Preferred Renderer` combobox. Restart Krita. Tablets ======= What tablets does Krita support? -------------------------------- Krita isn’t much fun without a pressure sensitive tablet. If the tablet has been properly configured, Krita should work out of the box. On Windows, you need to either install the Wintab drivers for your tablet, or enable the :guilabel:`Windows 8+ Pointer Input` option in Krita's settings. You can find a community curated list of tablets supported by krita :ref:`here `. If you're looking for information about tablets like the iPad or Android tablets, look :ref:`here `. What if your tablet is not recognized by Krita? ----------------------------------------------- First, check if you have installed drivers and the like. The :ref:`drawing_tablets` page has some explanations and descriptions of common issues. If none of those work, we would like to have a bug report at bugs.kde.org, with a tablet log. Here's how you make a tablet log: #. You need to have something to output the log to. On 4.2 you can use the :ref:`log_viewer` docker for this. Just open the log viewer, and enable logging. .. versionchanged:: 4.2 The log viewer got added to Krita in 4.2, so for older versions of Krita, you will need to either run Krita in the terminal if you have Linux or MacOS, or for Windows install `DebugView `_ from the official Microsoft site, start DebugView and then start Krita. When using a terminal, make sure to enable 'unlimited scrollback'. #. Press the :kbd:`Ctrl + Shift + T` shortcut, you will see a message box telling the logging has started. #. Try to reproduce your problem, you will be able to see the log being created in the log viewer as you draw. #. Save the output from the log viewer into a txt file, and attach it to the bugreport. On Linux, it is also useful to have the following information: #. ``lsmod`` #. ``xinput`` #. ``xinput list-props`` (id can be fetched from the item 2) However, in 100\% of the cases where Windows users have reported that their tablet didn't work over the past five years, the problem has been either a buggy driver or a broken driver installation, but not a bug in Krita. How to fix a tablet offset on multiple screen setup on Windows -------------------------------------------------------------- If you see that your tablet pointer has an offset when working with Krita canvas, it might be highly likely that Krita got an incorrect screen resolution from the system. That problem happens mostly when an external monitor is present and when either a monitor or a tablet was connected after the system booted. You can configure this by going to the :ref:`tablet_settings`. Microsoft Surface Pro and N-Trig -------------------------------- Krita 3.3.0 and later supports the Windows Pointer API (Windows Ink) natively. Your Surface Pro or other N-Trig enabled pen tablet should work out of the box with Krita after you enable Windows Ink in :menuselection:`Settings --> Configure Krita... --> Tablet`. Tablet Pro and the Surface Pro ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Unlike Wacom's Companion, the Surface line of tablets doesn't have working hardware buttons. Tablet Pro is a (non-free) utility that puts virtual buttons on screen. Krita 3.1 and above will have predefined shortcut profiles to work with Tablet Pro. https://tabletpro.com/ See https://www.youtube.com/watch?v=WKXZgYqC3tI for instructions. Weird stuff happens on Windows, like ripples, rings, squiggles or poltergeists ------------------------------------------------------------------------------ Windows comes with a lot of settings to make it work with a pen. All these settings can be annoying. This tool can help you set the settings correctly when you're using a tablet: https://github.com/saveenr/Fix_My_Pen/releases Touch doesn't seem to work on Windows ------------------------------------- You might have to disable and enable the touch driver: go to the device manager. (Click the :guilabel:`Start` button and type device manager). Choose HID (User interface devices or something like that). Choose Intel(R) Precise Touch Device. Right click, Disable it. Right click, Enable it. Toolbox ======= Toolbox missing --------------- You can reset the Workspace by pressing the right most button on the toolbar, the Workspace switcher, and click on a desired Workspace from the list. Or you can right-click on any docker title bar or open space in any toolbar, and select Toolbox. It's the first option. Also, you can check the :guilabel:`Settings` menu, it has got a lot of interesting stuff, then go to the Dockers menu and select :guilabel:`Toolbox`. Tool icons size is too big -------------------------- Right click the toolbox to set the size. Krita can't get maximized ------------------------- This happens when your dockers are placed in such a way that the window cannot be made less high. Rearrange your Workspace. Resources ========= Is there a way to restore a default brush that I have mistakenly overwritten with new settings to default? ---------------------------------------------------------------------------------------------------------- Yes. First go to the resource folder, which is in Linux :file:`$HOME/.local/share/krita/` Windows :file:`user\\Appdata\\Roaming\\krita\\` or :file:`%APPDATA%\\Roaming\\krita\\` OSX :file:`~/Library/Application Support/Krita/` You can easily do this by going into :menuselection:`Settings --> Manage Resources... --> Open Resource Folder`. Then go into the *paintoppresets* folder and remove the latest created file that you made of your preset. After that go back to the resources folder and edit the blacklist file to remove the previous paintoppreset so Krita will load it. (Yes, it is a bit of a convoluted system, but at the least you don't lose your brushes) How do I set favorite presets? ------------------------------ Right-click a brush in the brush docker and assign it a tag. Then right-click on canvas to call popup palette, click the second right-most icon on the bottom-right of the palette, now you can pick the tag which contains the brush you assigned to it. Can Krita load Photoshop Brushes? --------------------------------- Yes, but there are limitations. You can load ABR files by using the :guilabel:`Import` button in the :guilabel:`Predefined brush` tab in the brush editor. Since Adobe hasn’t disclosed the file format specification, we depend on reverse-engineering to figure out what to load, and currently that’s limited to basic features. Krita is slow ============= There is a myriad of reasons why this might be. Below is a short checklist. - Something else is hogging the CPU or the memory: spotify and other electron apps have been known to do this. - You are running Windows, and have 3rdparty security software like Sandboxie or Total Defender installed - You are working on images that are too big for your hardware (dimensions, channel depth or number of layers) - You do not have canvas acceleration enabled - You have (NVidia) Vertical Sync enabled - On macOS, with some macs, you might need to disable canvas acceleration in Krita's settings. Please also check `this page `_. Slow start-up ------------- You probably have too many resources installed. Deactivate some bundles under the :menuselection:`Settings --> Manage Resources...` menu item. If you're using Windows with the portable ZIP file, Windows will scan all files every time you start Krita. That takes ages. Either use the installer or tell Microsoft Security Essentials to make an exception for Krita. Slow Brushes ------------ - Check if you accidentally turned on the stabilizer in the tool options docker. - Try another scaling mode like trilinear. :menuselection:`Settings --> Configure Krita... --> Display`. - Try a lower channel depth than 16-bit. - For NVidia, try a 16-bit floating point color space. - For older AMD CPU's (Krita 2.9.10 and above), turn off the vector optimizations that are broken on AMD CPUs. :menuselection:`Settings --> Configure Krita... --> Performance`. This isn't needed if you've got an AMD Threadripper™ CPU. - It's a fairly memory hungry program, so 2GB of RAM is the minimum, and 4GB is the preferable minimum. - Check that nothing else is hogging your CPU. - Check that Instant Preview is enabled if you're using bigger brushes (but for very small brushes, make sure is disabled). - Set brush precision to 3 or auto. - Use a larger value for brush spacing. - If all of this fails, record a video and post a link and description on the Krita forum. - Check whether OpenGL is enabled, and if it isn't, enable it. If it is enabled, and you are on Windows, try the Angle renderer. Or disable it. Slowdown after a been working for a while ----------------------------------------- Once you have the slowdown, click on the image-dimensions in the status bar. It will tell you how much RAM Krita is using, if it has hit the limit, or whether it has started swapping. Swapping can slow down a program a lot, so either work on smaller images or turn up the maximum amount of RAM in :menuselection:`Settings --> Configure Krita... --> Performance --> Advanced Tab`. Animation ========= Why is my animation black in my video player -------------------------------------------- You did not render the animation using the "baseline" option and you are using the default Windows media player. Re-render using the baseline option or use a better video player application, like VLC. Check `this useful diagram `_. Tools ===== Why does the Transform Tool give a good result and then get blurry upon finalizing? ----------------------------------------------------------------------------------- The transform tool makes a preview that you edit before computing the finalized version. As this preview is using the screen resolution rather than the image resolution, it may feel that the result is blurry compared to the preview. See `this page `__ for more info. License, rights and the Krita Foundation ======================================== Who owns Krita? --------------- The Stichting Krita Foundation owns the Krita trademark. The copyright on the source code is owned by everyone who has worked on the source code. Who and what is Kiki? --------------------- Kiki is a cybersquirrel. She’s our mascot and has been designed by Tyson Tan. We choose a squirrel when we discovered that ‘krita’ is the Albanian word for Squirrel. Why is Krita Free? ------------------ Krita is developed as `free software `_ within the KDE community. We believe that good tools should be available for all artists. You can also buy Krita on the Windows Store if you want to support Krita's development or want to have automatic updates to newer versions. Why isn't Krita on Steam and in the Windows Store Free? ------------------------------------------------------- Krita on Steam and in the Windows Store is still Free and Open Source software; the binaries are exactly the ones you can also download from krita.org. We've put a price tag on downloading Krita from either store to support Krita's development. Nobody is getting rich out of it, but the income from Steam and the Windows Store currently pays for the full-time involvement with Krita of four developers. See `Krita Available from the Windows Store `_ for more information. Can I use Krita commercially? ----------------------------- Yes. What you create with Krita is your sole property. You own your work and can license your art however you want. Krita’s GPL license applies to Krita’s source code. Krita can be used commercially by artists for any purpose, by studios to make concept art, textures, or vfx, by game artists to work on commercial games, by scientists for research, and by students in educational institutions. If you modify Krita itself, and distribute the result, you have to share your modifications with us. Krita’s GNU GPL license guarantees you this freedom. Nobody is ever permitted to take it away. .. _krita_android: .. _krita_ios: Can I get Krita for iPad? for Android? -------------------------------------- Not for iOS or iPadOS at this point in time. Android is being worked on, but it will not have a phone or tablet, but the same desktop ui as always. Who translates Krita -------------------- Krita is a `KDE application `_ — and proud of it! That means that Krita’s translations are done by `KDE localization teams `_. If you want to help out, join the team for your language! There is another way you can help out making Krita look good in any language, and that is join the development team and fix issues within the code that make Krita harder to translate. Reference ========= https://answers.launchpad.net/krita-ru/+faqs diff --git a/general_concepts/file_formats/file_gih.rst b/general_concepts/file_formats/file_gih.rst index 6569773d4..9a07284e5 100644 --- a/general_concepts/file_formats/file_gih.rst +++ b/general_concepts/file_formats/file_gih.rst @@ -1,59 +1,59 @@ .. meta:: :description: The GIMP Image Hose file format in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier :license: GNU free documentation license 1.3 or later. .. index:: *.gih, GIH, Image Hose, Gimp Image Hose .. _file_gih: ====== \*.gih ====== The GIMP image hose format. Krita can open and save these, as well as import via the :ref:`predefined brush tab `. Image Hose means that this file format allows you to store multiple images and then set some options to make it specify how to output the multiple images. .. figure:: /images/brushes/Gih-examples.png :figwidth: 640px :align: center From top to bottom: Incremental, Pressure and Random Dimension and ranks. -------------------- The GIMP image hose format allows multiple dimensions for a given brush. You could for example have a dimension that updates incrementally, and one that updates on pressure, or updates randomly. Upon export, Krita will use the ranks to subdivide the layers per dimension. If you have a 24 layer image and three ranks, and the first dimension is set to 2, the second to 4 and the third to 3, then Krita will divide 24 into 2 groups of 12, each of which have unique images for the 2 parts of the first dimension. Then those 2 groups of 12 get divided into 8 groups of 4, each of which have unique brush tips for the four parts of the second dimension, and finally, the grouped three images have each a unique brush for the final dimension. So, the following image has a table where dimension 1 is unique in one of 4 numbers, while dimension 2 is unique in one of 3 shapes. So our ranks for dimension 1 and dimension 2 need to be 4 and 3 respectively. Now, to order the layers, you need to subdivide the table first by the first dimension, and then by the second. So we end up with three layers each for a shape in the second dimension but for the first number, then another three layers, each for a shape, but then for the second number, and so forth. .. figure:: /images/category_filetypes/gih_multi_dimension_explaination.png :figwidth: 800px :align: center -See `the GIMP documentation `_ for a more thorough explaination. +See `the GIMP documentation `_ for a more thorough explanation. GIMP image hose format options: ------------------------------- Constant This'll use the first image, no matter what. Incremental This'll paint the image layers in sequence. This is good for images that can be strung together to create a pattern. Pressure This'll paint the images depending on pressure. This is good for brushes imitating the hairs of a natural brush. Random This'll draw the images randomly. This is good for image-collections used in speedpainting as well as images that generate texture. Or perhaps more graphical symbols. Angle This'll use the dragging angle to determine with image to draw. When exporting a Krita file as a ``.gih``, you will also get the option to set the default spacing, the option to set the name (very important for looking it up in the UI) and the ability to choose whether or not to generate the mask from the colors. Use Color as Mask This'll turn the darkest values of the image as the ones that paint, and the whitest as transparent. Untick this if you are using colored images for the brush. We have a :ref:`Krita Brush tip page ` on how to create your own GIH brush. diff --git a/reference_manual/dockers/timeline.rst b/reference_manual/dockers/timeline.rst index 3f221120a..1839be839 100644 --- a/reference_manual/dockers/timeline.rst +++ b/reference_manual/dockers/timeline.rst @@ -1,124 +1,124 @@ .. meta:: :description: Overview of the timeline docker. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Dmitry Kazakov - Emmet O'Neill :license: GNU free documentation license 1.3 or later. .. index:: Animation, Timeline, Frame .. _timeline_docker: =============== Timeline Docker =============== The **Timeline Docker** works in tandem with the :ref:`animation_docker` at the heart of :program:`Krita`'s animation tools. While the Animation Docker provides access to the fundamental controls for playing back and editing animations, the Timeline Docker contains the layered frames and specific timings that define your animation. In other words, the Timeline Docker is the digital equivalent to a traditional animator's "dope sheet". .. image:: /images/dockers/Timeline_docker.png :align: center Legend: ------- -**A. Layer List --** This area contains some subset of the layers of your current document. Similar to the Layers Docker, each layer has various properties that can also be toggled here (visibility, locking, onion skins, etc.). While the currently active layer is always shown here, layers can also be "pinned" to the timeline using the :guilabel:`Pin to Timeline` menu action or the :guilabel:`Pin Existing Layer` submenu so they will be visible even when inactive. Layers that are created via the Timeline are pinned automatically and by checking the :guilabel:`Automatically pin new layers to timeline` option in :guilabel:`Configure Krita > General > Miscellaneous` all new paint layers can be pinned automatically. +**A. Layer List --** This area contains some subset of the layers of your current document. Similar to the Layers Docker, each layer has various properties that can also be toggled here (visibility, locking, onion skins, etc.). While the currently active layer is always shown here, layers can also be "pinned" to the timeline using the :guilabel:`Pin to Timeline` menu action or the :guilabel:`Pin Existing Layer` submenu so they will be visible even when inactive. Layers that are created via the Timeline are pinned automatically and by checking the :guilabel:`Automatically pin new layers to timeline` option in :guilabel:`Settings --> Configure Krita... --> General --> Miscellaneous` all new paint layers can be pinned automatically. * **Active Layer** A highlighted row in the table shows the current active layer. One can change which layer is active by clicking on the layer's name within the left header. It is *not* possible to change the active layer by clicking inside the table in order to not disturb the user when scrubbing and editing frame positions on the timeline. **B. Frame Table --** The Frame Table is a large grid of cells which can either hold a single frame or be empty. Each row of the Frame Table represents an *animation layer* and each column represents a *frame timing*. Just like the Layer List, the active layer is highlighted across the entire Frame Table. It's important to understand that frame timings are not based on units of time like seconds, but are based on frames which can then be played back at any speed, depending on the :ref:`animation_docker`'s *frame rate* and *play speed* settings. Frames can be moved around the timeline by simply left-clicking and dragging from one frame to another slot, even across layers. Furthermore, holding the :kbd:`Ctrl` key while moving creates a copy. Right-clicking anywhere in the Frame Table will bring up a helpful context menu for adding, removing, copying, and pasting frames or adjusting timing with holds. * **Current Selection:** Frames highlighted in orange represent a selection or multiple selections, which can be created by mouse or keyboard. While multiple frames are selected, right-clicking anywhere in the Frame Table will bring up a context menu that will allow for adding or removing frames or holds within the current selection. Finally, it is also possible to have multiple non-contiguous/separate selections if needed. .. warning:: Painting always happens only in the *active frame* (represented by a small dot), which is not necessarily part of your current selection! * **Keys, Blanks, and Holds:** The Timeline Docker now shows us even more useful information about both what is there as well as what is not. **Key frames** which contain drawings are still displayed as *filled blocks* within a cell, while **blank** or empty key frames are shown as a *hollow outline*. In Krita, every drawn frame is automatically held until the next frame; these **holds** are now clearly shown with a *colored line* across all held frames. The color of frames can be set per-frame by the animator using the right-click menu, and is a matter of personal workflow. **C. Frame Timing Header --** The Frame Timing Header is a ruler at the top of the Frame Table. This header is divided into small notched sections which are based on the current *frame rate* (set in the :ref:`animation_docker`). Integer multiples of the frame rate have a subtle double-line mark, while smaller subdivisions have small single-line marks. Each major notch is marked with a helpful *frame number*. * **Cached Frames:** The Frame Timing Header also shows important information about which frames are currently *cached*. When something is said to be "cached", that means that it is stored in your device's working memory (RAM) for extra fast access. Cached frames are shown by the header with a small light-gray rectangle in each column. While this information isn't always critical for us artists, it's helpful to know that Krita is working behind the curtains to cache our animation frames for the smoothest possible experience when scrubbing through or playing back your animation. **D. Current Time Scrubber --** A highlighted column in the Frame Table which controls the current frame time and, as such, what is currently displayed in the viewport. * **Active Frame:** A frame of the *active layer* at the *current time* position. The active frame is always marked with a small circle inside. All drawing, painting, and image editing operations happen on this frame only! .. warning:: Don't mix the active frame up with the current selection! **E. Layer Menu --** A small menu for manipulating animation layers. You can create new layers, remove existing ones, as well as pin or unpin the active layer. (This menu also shows up when right-clicking on layer headers inside of the Layer List.) **F. Audio Menu:** Another small menu for animating along with audio sources. This is where you can open or close audio sources and control output volume/muting. **G. Zoom Handle:** This allows you to zoom in and out on the Frame Table, centered around the current frame time. Click-dragging starting on the zoom handle controls the zoom level. Usage: ------ How to use the Timeline Docker is not immediately obvious because :program:`Krita` doesn't automatically create a key frame out of your initial drawing. In fact, *until you make a key frame on a layer*, Krita assumes that there's no animation going on at all on that layer and it will keep the image static over the whole animation. So, to make our first *animated layer*, we need to make a key frame! |mouseright| any square on the timeline docker and select :guilabel:`Create Blank Frame`. A blank frame (one that you haven't yet drawn anything in) appears as a *hollow outline* instead of a solid box, making that frame active and drawing on the canvas will make it appear as a *solid, colored rectangle*. To move a frame around, you can drag and drop it into another empty frame slot. -While animating you may find that you want to keep a layer "pinned", making it visible in the Timeline Docker regardless of which layer is selected. There are a few ways to do this in Krita. By |mouseright| clicking on any layer in the Layers Docker, you can pin it by activating the :guilabel:`Pin to Timeline` menu item. This allows you to decide which layers are important to see in your timeline (i.e. those which contain keyframe drawings) and which layers are not (i.e. a static layout drawing or background painting). Alternatively, you can open the Timeline Docker's Layer Menu and select a layer from the :guilabel:`Pin Existing Layer` submenu. Finally, you can enable the :guilabel:`Automatically pin new layers to timeline` option from the :guilabel:`Configure Krita > General > Miscellaneous` dialog. +While animating you may find that you want to keep a layer "pinned", making it visible in the Timeline Docker regardless of which layer is selected. There are a few ways to do this in Krita. By |mouseright| clicking on any layer in the Layers Docker, you can pin it by activating the :guilabel:`Pin to Timeline` menu item. This allows you to decide which layers are important to see in your timeline (i.e. those which contain keyframe drawings) and which layers are not (i.e. a static layout drawing or background painting). Alternatively, you can open the Timeline Docker's Layer Menu and select a layer from the :guilabel:`Pin Existing Layer` submenu. Finally, you can enable the :guilabel:`Automatically pin new layers to timeline` option from the :guilabel:`Settings --> Configure Krita... --> General --> Miscellaneous` dialog. To add a new frame, either right-click on an empty frame slot and select :guilabel:`Create Blank Frame` to create a fresh blank frame, or select :guilabel:`Create Duplicate Frame` to create a new copy of the previous frame. It's also possible to add multiple key frames by right-clicking inside the Frame Table and selecting :menuselection:`Keyframes --> Insert Multiple Keyframes`. With this option you can specify a number of frames to add with the option of built in timing for quickly creating a series of 1s, 2s, 3s, etc. These settings are saved between uses. You can also change the color of frames so that you can easily identify important frames or distinguish between different sections of your animation. The current color selection is remembered for new frames so that you can easily make a set of colored frames and then switch to another color. Clicking with |mouseright| within the Frame Timing Header instead of the Frame Table gives you access to a few more options which allow you to add or remove entire columns of frames or holds at a time. For example, selecting :menuselection:`Keyframe Columns --> Insert Keyframe Column Left` will add new frames to each layer that's currently visible in the Timeline Docker. .. image:: /images/dockers/Timeline_insertkeys.png :align: center :program:`Krita` only tracks key frame changes. This is unlike :program:`Flash` where you have to manually indicate how long a key frame will hold. Instead, :program:`Krita` just assumes that the space between key frame 1 and key frame 2 is supposed to be filled with key frame 1. Frames that are held in this way (a.k.a. "holds") are displayed as a continuous line in the Frame Table. To delete frames, |mouseright| the frame and press :guilabel:`Remove Keyframe`. This will delete all selected frames. Similarly, selecting :guilabel:`Remove Frame and Pull` will delete the selected frames and pull or shift all subsequent frames back/left as much as possible. To manually play your animation back and forward using your mouse, an important technique that's known as *scrubbing*, click-drag within the Frame Timing Header. GUI Actions: ------------ #. **Layer List** * |mouseleft| : Select active layer. * |mouseright| : Layers Menu (add/remove/show layers, etc.). #. **Frame Timing Header** * |mouseleft| : Move to time and select frame of the active layer. * |mouseleft| :kbd:`+ drag` : Scrub through time and select frame of the active layer. * |mouseright| : Frame Columns Menu (insert/remove/copy/paste columns and hold columns). #. **Frames Table: all** * |mouseleft| : Selects a single frame or slot and switches time, but *does not switch active layer*. * :kbd:`Space +` |mouseleft| : Pan. * :kbd:`Space +` |mouseright| : Zoom. #. **Frames Table (On Empty Slot).** * |mouseright| : Frames menu (insert/copy/paste frames and insert/remove holds). * |mouseleft| :kbd:`+ drag` : Select multiple frames and switch time to the last selected, but *does not switch active layer*. * :kbd:`Shift +` |mouseleft| : Select all frames between the active and the clicked frame. * :kbd:`Ctrl +` |mouseleft| : Select individual frames together. :kbd:`click + drag` them into place. #. **Frames Table (On Existing Frame)** * |mouseright| : Frames menu (remove/copy/paste frames and insert/remove holds). * |mouseleft| :kbd:`+ drag` : *Move* a frame or multiple frames. * :kbd:`Ctrl +` |mouseleft| :kbd:`+ drag` : Copy a frame or multiple frames. * :kbd:`Alt + drag` : Move selected frame(s) and *all* the frames to the right of it. (This is useful for when you need to clear up some space in your animation, but don't want to select all the frames to the right of a particular frame!) diff --git a/reference_manual/filters/edge_detection.rst b/reference_manual/filters/edge_detection.rst index 814f43b2b..143cb3d61 100644 --- a/reference_manual/filters/edge_detection.rst +++ b/reference_manual/filters/edge_detection.rst @@ -1,120 +1,120 @@ .. meta:: :description: Overview of the edge detection filters. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. index:: Edge Detection, Sobel, Prewitt .. _edge_detection_filters: ============== Edge Detection ============== Edge detection filters focus on finding sharp contrast or border between colors in an image to create edges or lines. Since 4.0 there are only two edge detection filters. Edge Detection -------------- .. versionadded:: 4.0 A general edge detection filter that encapsulates all other filters. Edge detection filters that were separate before 4.0 have been folded into this one. It is also available for filter layers and filter brushes. .. figure:: /images/filters/Krita_4_0_edge_detection.png :align: center :figwidth: 800 From left to right: Original, with Prewitt edge detection applied, with Prewitt edge detection applied and result applied to alpha channel, and finally the original with an edge detection filter layer with the same settings as 3, and the filter layer blending mode set to multiply. Formula The convolution kernel formula for the edge detection. The difference between these is subtle, but still worth experimenting with. Simple A Kernel that is not square unlike the other two, and while this makes it fast, it doesn't take diagonal pixels into account. Prewitt A square kernel that includes the diagonal pixels just as strongly as the orthogonal pixels. Gives a very strong effect. Sobel A square kernel that includes the diagonal pixels slightly less strong than the orthogonal pixels. Gives a more subtle effect than Prewitt. Output The output. All sides Convolves the edge detection into all directions and combines the result with the Pythagorean theorem. This will be good for most uses. Top Edge This only detects changes going from top to bottom and thus only has top lines. Bottom Edge This only detects changes going from bottom to top and thus only has bottom lines. Right Edge This only detects changes going from right to left and thus only has right lines. Left Edge This only detects changes going from left to right and thus only has left lines. Direction in Radians This convolves into all directions and then tries to output the direction of the line in radians. Horizontal/Vertical radius The radius of the edge detection. Default is 1 and going higher will increase the thickness of the lines. Apply result to Alpha Channel. The edge detection will be used on a grayscale copy of the image, and the output will be onto the alpha channel of the image, meaning it will output lines only. .. index:: High Pass Gaussian High Pass ------------------ A High Pass filter is a type of edge detection filter. It is usually used to enhance contrasts, much like a sharpen filter, but within a texture editing workflow it is also used to remove local gradients. Radius The radius within the Gaussian High Pass filter is similar to the radius in the Edge Detection filter. To use this as a sharpen filter, create a filter layer with this filter, and then set the blending mode to modes like 'soft light', 'overlay', 'hard light', 'linear light'. Different blending modes give different results. .. figure:: /images/filters/highpass_filter_sharpen.png :align: center :figwidth: 377 **Top left**: Original, **top right**: Gaussian Highpass Result with radius 3, **bottom left**: Gaussian High Pass Result with radius 3 blended over the original with to Linear Light, **bottom right**: Gaussian High Pass result with radius 3 blended over the original with Soft Light. -To remove local gradients from a texture, create a clone layer, and apply this filter as a filter mask. Then, put a filter layer with gaussian blur set to the full amount in between the clone layer and the original. Finally, set the clone layer to luminosity or multiply(in this case an extra filter mask needs to be added to reduce the levels so that the multiplication result will not be as strong). +To remove local gradients from a texture, create a clone layer, and apply this filter as a filter mask. Then, put a filter layer with gaussian blur set to the full amount in between the clone layer and the original. Finally, set the clone layer to luminosity or multiply (in this case an extra filter mask needs to be added to reduce the levels so that the multiplication result will not be as strong). .. figure:: /images/filters/highpass_filter_local_gradient_removal.png :align: center :figwidth: 513 **Left**: Original, **top right**: Gaussian High Pass Result blended with luminosity to remove the local gradients but keep the sharp details. In this specific example the lack of local gradients removes some character, but the gaussian high pass result could also be used to create a heightmap. .. index:: Height Map, Normal Map Height to Normal Map -------------------- .. versionadded:: 4.0 .. image:: /images/filters/Krita_4_0_height_to_normal_map.png :align: center A filter that converts Height maps to Normal maps through the power of edge detection. It is also available for the filter layer or filter brush. Formula The convolution kernel formula for the edge detection. The difference between these is subtle, but still worth experimenting with. Simple A Kernel that is not square unlike the other two, and while this makes it fast, it doesn't take diagonal pixels into account. Prewitt A square kernel that includes the diagonal pixels just as strongly as the orthogonal pixels. Gives a very strong effect. Sobel A square kernel that includes the diagonal pixels slightly less strong than the orthogonal pixels. Gives a more subtle effect than Prewitt. Channel Which channel of the layer should be interpreted as the grayscale heightmap. Horizontal/Vertical radius The radius of the edge detection. Default is 1 and going higher will increase the strength of the normal map. Adjust this if the effect of the resulting normal map is too weak. XYZ An XYZ swizzle, that allows you to map Red, Green and Blue to different 3d normal vector coordinates. This is necessary mostly for the difference between MikkT-space normal maps (+X, +Y, +Z) and the OpenGL standard normal map (+X, -Y, +Z). diff --git a/reference_manual/preferences/color_management_settings.rst b/reference_manual/preferences/color_management_settings.rst index 55bfaef97..5067d3f10 100644 --- a/reference_manual/preferences/color_management_settings.rst +++ b/reference_manual/preferences/color_management_settings.rst @@ -1,83 +1,83 @@ .. meta:: :description: The color management settings in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - David Revoy :license: GNU free documentation license 1.3 or later. .. index:: Preferences, Settings, Color Management, Color, Softproofing .. _color_management_settings: ========================= Color Management Settings ========================= .. image:: /images/preferences/Krita_Preferences_Color_Management.png Krita offers extensive functionality for color management, utilising `Little CMS `_ We describe Color Management in a more overall level here: :ref:`color_managed_workflow`. General ------- Default Color Model For New Images ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Choose the default model you prefer for all your images. When Pasting Into Krita From Other Applications ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The user can define what kind of conversion, if any, Krita will do to an image that is copied from other applications i.e. Browser, GIMP, etc. Assume sRGB This option will show the pasted image in the default Krita ICC profile of sRGB. Assume monitor profile This option will show the pasted image in the monitor profile selected in system preferences. Ask each time Krita will ask the user each time an image is pasted, what to do with it. This is the default. .. note:: When copying and pasting in Krita color information is always preserved. Use Blackpoint Compensation ~~~~~~~~~~~~~~~~~~~~~~~~~~~ This option will turn on Blackpoint Compensation for the conversion. BPC is explained by the maintainer of LCMS as following: | BPC is a sort of "poor man's" gamut mapping. It basically adjust contrast of images in a way that darkest tone of source device gets mapped to darkest tone of destination device. If you have an image that is adjusted to be displayed on a monitor, and want to print it on a large format printer, you should realize printer can render black significantly darker that the screen. So BPC can do the adjustment for you. It only makes sense on Relative colorimetric intent. Perceptual and Saturation does have an implicit BPC. Allow LittleCMS optimizations ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Uncheck this option when using Linear Light RGB or XYZ. Enforce palette colors: always select the nearest color from the active palette ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -By default, palette selection widgets take the current foreground color, compare it to the swatches in it’s active palette and highlight the swatch that is nearest to the current foreground color. +By default, palette selection widgets take the current foreground color, compare it to the swatches in its active palette and highlight the swatch that is nearest to the current foreground color. -When ‘Enforce palette colors’ option is checked, it switches the internal color selector into a mode in which, instead of just highlighting the swatch, the current foreground color is replaced with the color of the nearest swatch. +When :guilabel:`Enforce palette colors` option is checked, it switches the internal color selector into a mode in which, instead of just highlighting the swatch, the current foreground color is replaced with the color of the nearest swatch. Display ------- Use System Monitor Profile This option when selected will tell Krita to use the ICC profile selected in your system preferences. Screen Profiles There are as many of these as you have screens connected. The user can select an ICC profile which Krita will use independent of the monitor profile set in system preferences. The default is sRGB built-in. On Unix systems, profile stored in $/usr/share/color/icc (system location) or $~/.local/share/color/icc (local location) will be proposed. Profile stored in Krita preference folder, $~/.local/share/krita/profiles will be visible only in Krita. Rendering Intent Your choice of rendering intents is a way of telling Littlecms how you want colors mapped from one color space to another. There are four options available, all are explained on the :ref:`icc_profiles` manual page. Softproofing options -------------------- These allow you to configure the *default* softproofing options. To configure the actual softproofing for the current image, go to :menuselection:`Image --> Image Properties --> Softproofing` . For indepth details about how to use softproofing, check out :ref:`the page on softproofing `. diff --git a/reference_manual/tools/elliptical_select.rst b/reference_manual/tools/elliptical_select.rst index ec0ab5f0a..4156dd54b 100644 --- a/reference_manual/tools/elliptical_select.rst +++ b/reference_manual/tools/elliptical_select.rst @@ -1,103 +1,103 @@ .. meta:: :description: Krita's elliptical selector tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Alberto Eleuterio Flores Guerrero :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 |mouseleft| and drag around the section you wish to select. .. important:: Most of the behavior of the Elliptical Selection Tool is common to all other selection tools, please make sure to read :ref:`selections_basics` to learn more about this tool. 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. * |mouseleft| + :kbd:`Shift` constrains the selection to a perfect circle. (Make sure to press |mouseleft| before :kbd:`Shift`) * |mouseleft| + :kbd:`Ctrl` makes the selection resize from the center. (Make sure to press |mouseleft| before :kbd:`Ctrl`) * |mouseleft| + :kbd:`Alt` allows you to move the selection. (Make sure to press |mouseleft| before :kbd:`Alt`) * :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 your cursor over the dashed line of the selection, or marching ants as it is commonly called, turns the cursor into the move tool icon, which you |mouseleft| and drag to move the selection. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. .. image:: /images/tools/selections-right-click-menu.png :width: 200 :alt: Menu of elliptical selection .. hint:: To subtract a perfect circle, you can follow two different methods: - 1. Press :kbd:`S` to substract then |mouseleft| to select and press :kbd:`Shift` while dragging to constrain to a perfect circle. + 1. Press :kbd:`S` to subtract then |mouseleft| to select and press :kbd:`Shift` while dragging to constrain to a perfect circle. 2. Press :kbd:`Alt +` |mouseleft|, then release the :kbd:`Alt` key while dragging and press :kbd:`Shift` to constrain. .. tip:: You can switch the behavior of the :kbd:`Alt` key to use the :kbd:`Ctrl` key instead by toggling the switch in the :ref:`general_settings`. Tool Options ------------ .. image:: /images/tools/selections-elliptical-selection-options.png :width: 300 :alt: Elliptical selection options Mode This option is explained in the :ref:`pixel_vector_selection` section. Action This option is explained in the :ref:`pixel_vector_selection` section. Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. .. note:: Anti-aliasing is only available on Pixel Selection Mode. Width Shows you the current width while you are creating the selection. You can manually type the value and use the 'Lock Width' for your next selection to have the selected value. Lock Width Forces the next selection to have the current width. Height Shows you the current height while you are creating the selection. You can manually type the value and use the 'Lock Height' for your next selection to have the selected value. Lock Height Forces the next selection to have the current height. Ratio Shows the ratio between height and width of the selection. Similar to Height, and Width, you can manually type the value and use the 'Lock Ratio' for your next selection to have the selected value. Lock Ratio Forces the next selection to have the current ratio. .. hint:: If you want your selection to be of specific size: 1. Type the width and height. 2. Press the Lock Width and Lock Height buttons. 3. |mouseleft| where you want your selection to be. diff --git a/reference_manual/tools/magnetic_select.rst b/reference_manual/tools/magnetic_select.rst index bead95e89..1cb52e8df 100644 --- a/reference_manual/tools/magnetic_select.rst +++ b/reference_manual/tools/magnetic_select.rst @@ -1,110 +1,110 @@ .. meta:: :description: Krita's Magnetic Selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Kuntal Majumder :license: GNU free documentation license 1.3 or later. .. index:: Tools, Magnet, Selection, Magnetic Selection .. _magnetic_selection_tool: ======================= Magnetic Selection Tool ======================= |toolselectmagnetic| This tool, represented by a magnet over a selection border, allows you to make freeform :ref:`selections_basics`, but unlike the :ref:`polygonal_selection_tool` or the :ref:`outline_selection_tool`, it will try to magnetically snap to sharp contrasts in your image, simplifying the creation of selection drastically. There are two ways to make a magnetic selection: .. figure:: /images/tools/magnetic_selection_mode_1.gif :width: 320 :align: center Animation showing the first mode of creating a magnetic selection. The first is to use |mouseleft| and place points or nodes of the magnetic selection. To finalize your selection area you can do either |mouseleft| on the first created point to complete the loop and click on it again to create a selection, or press :kbd:`Enter` to end the magnetic selection. .. figure:: /images/tools/magnetic_selection_mode_2.gif :width: 320 :align: center Animation showing the second (interactive) mode of creating a magnetic selection. The second, interactive mode, is to |mouseleft| :kbd:`+ drag` over a portion of an image. .. figure:: /images/tools/magnetic_selection_mode_mixed.gif :width: 320 :align: center The first and second mode can be mixed. You can edit previous points by |mouseleft| dragging them. You can remove points by double |mouseleft| the point, or dragging it out of the canvas area. After a path is closed, you can add points by clicking on nearby empty space. Points can be undone with :kbd:`Shift + Z`. A halfway done magnetic selection can be canceled with :kbd:`Esc`. .. important:: Most of the behavior of the Magnetic Selection Tool is common to all other selection tools, please make sure to read :ref:`selections_basics` to learn more about this tool. 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 your cursor over the dashed line of the selection, or marching ants as it is commonly called, turns the cursor into the move tool icon, which you |mouseleft| and drag to move the selection. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. .. image:: /images/tools/selections-right-click-menu.png :width: 200 :alt: Menu of magnetic selection .. tip:: You can switch the behavior of the :kbd:`Alt` key to use :kbd:`Ctrl` instead by toggling the switch in Tool Settings in the :ref:`general_settings`. .. tip:: This tool is not bound to any Hotkey, if you want to define one, go to :menuselection:`Settings --> Configure Krita --> Keyboard Shortcuts` and search for 'Magnetic Selection Tool', there you can select the shortcut you want. Check :ref:`shortcut_settings` for more info. Tool Options ------------ Mode This option is explained in the :ref:`pixel_vector_selection` section. Action This option is explained in the :ref:`pixel_vector_selection` section. Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. Filter Radius: - Determine the radius of the edge detection kernel. This determines how agressively the tool will interpret contrasts. Low values mean only the sharpest of contrast will be a seen as an edge. High values will pick up on subtle contrasts. The range of which is from 2.5 to 100. + Determine the radius of the edge detection kernel. This determines how aggressively the tool will interpret contrasts. Low values mean only the sharpest of contrast will be a seen as an edge. High values will pick up on subtle contrasts. The range of which is from 2.5 to 100. Threshold: From 0 to 255, how sharp your edge is, 0 is least while 255 is the most. Used in the interactive mode only. Search Radius: The area in which the tool will search for a sharp contrast within an image. More pixels means less precision is needed when placing the points, but this will require Krita to do more work, and thus slows down the tool. Anchor Gap: - When using |mouseleft| :kbd:`+ drag` to place points automatically, this value determines the average gap between 2 anchors. Low values give high precision by placing many nodes, but this is also harder to edit afterwards. The pixels are in screen dimensions and not image dimensions, meaning it is affect by zoom. + When using |mouseleft| :kbd:`+ drag` to place points automatically, this value determines the average gap between 2 anchors. Low values give high precision by placing many nodes, but this is also harder to edit afterwards. The pixels are in screen dimensions and not image dimensions, meaning it is affected by zoom. .. figure:: /images/tools/magnetic_selection_anchor_gap.png :width: 640 :align: center To the **left**: 20 px anchor gap, to the **right**: 40px anchor gap. .. note:: Anti-aliasing is only available on Pixel Selection Mode. diff --git a/reference_manual/tools/rectangular_select.rst b/reference_manual/tools/rectangular_select.rst index dfe347af1..2b39c5c75 100644 --- a/reference_manual/tools/rectangular_select.rst +++ b/reference_manual/tools/rectangular_select.rst @@ -1,112 +1,112 @@ .. meta:: :description: Krita's rectangular selection tool reference. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Alberto Eleuterio Flores Guerrero :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` in a rectangular shape. To create a rectangular selection simply |mouseleft| and drag on the area of the canvas that you wish to select. .. important:: Most of the behavior of the Rectangular Selection Tool is common to all other selection tools, please make sure to read :ref:`selections_basics` to learn more about this tool. Hotkeys and Stickykeys ---------------------- * :kbd:`Ctrl + R` 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. * |mouseleft| + :kbd:`Shift` constrains the selection to a perfect square. (Make sure to press |mouseleft| before :kbd:`Shift`) * |mouseleft| + :kbd:`Ctrl` makes the selection resize from the center. (Make sure to press |mouseleft| before :kbd:`Ctrl`) * |mouseleft| + :kbd:`Alt` allows you to move the selection. (Make sure to press |mouseleft| before :kbd:`Alt`) * :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 your cursor over the dashed line of the selection, or marching ants as it is commonly called, turns the cursor into the move tool icon, which you |mouseleft| and drag to move the selection. * |mouseright| will open up a selection quick menu with amongst others the ability to edit the selection. .. image:: /images/tools/selections-right-click-menu.png :width: 200 :alt: Menu of rectangular selection .. hint:: To subtract a perfect square, you can follow two different methods: - 1. Press :kbd:`S` to substract then |mouseleft| to select and press :kbd:`Shift` while dragging to constrain to a perfect square. + 1. Press :kbd:`S` to subtract then |mouseleft| to select and press :kbd:`Shift` while dragging to constrain to a perfect square. 2. Press :kbd:`Alt +` |mouseleft|, then release the :kbd:`Alt` key while dragging and press :kbd:`Shift` to constrain. .. tip:: 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 ------------ .. image:: /images/tools/selections-rectangular-selection-options.png :width: 300 :alt: Rectangular selection options Mode This option is explained in the :ref:`pixel_vector_selection` section. Action This option is explained in the :ref:`pixel_vector_selection` section. Anti-aliasing This toggles whether or not to give selections feathered edges. Some people prefer hard-jagged edges for their selections. .. note:: Anti-aliasing is only available on Pixel Selection Mode. Width Shows you the current width while you are creating the selection. You can manually type the value and use the 'Lock Width' for your next selection to have the selected value. Lock Width Forces the next selection to have the current width. Height Shows you the current height while you are creating the selection. You can manually type the value and use the 'Lock Height' for your next selection to have the selected value. Lock Height Forces the next selection to have the current height. Ratio Shows the ratio between height and width of the selection. Similar to Height, and Width, you can manually type the value and use the 'Lock Ratio' for your next selection to have the selected value. Lock Ratio Forces the next selection to have the current ratio. .. hint:: If you want your selection to be of specific size: 1. Type the width and height. 2. Press the Lock Width and Lock Height buttons. 3. |mouseleft| where you want your selection to be. .. versionadded:: 4.1.3 Round X The horizontal radius of the rectangle corners. Round Y The vertical radius of the rectangle corners. Chain Link When linked the aspect ratio between the roundness of X and Y coordinates will be locked. To disconnect the chain just click in the links and it will separate in two parts. diff --git a/reference_manual/tools/reference_images_tool.rst b/reference_manual/tools/reference_images_tool.rst index 040929ab0..45f179c77 100644 --- a/reference_manual/tools/reference_images_tool.rst +++ b/reference_manual/tools/reference_images_tool.rst @@ -1,52 +1,52 @@ .. meta:: :description: The reference images tool. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier :license: GNU free documentation license 1.3 or later. .. index:: Tools, Reference .. _reference_images_tool: ===================== Reference Images Tool ===================== |toolreference| .. versionadded:: 4.1 The reference images tool is a replacement for the reference images docker. You can use it to load images from your disk as reference, which can then be moved around freely on the canvas and placed wherever. Tool Options ------------ Add Reference Image Load a single image to display on the canvas. -Paste Reference Image +Paste as Reference Image Load an image from the system clipboard and add it as a reference image. Load Set Load a set of reference images. Save Set Save a set of reference images. Delete all reference images Delete all the reference images. Keep aspect ratio When toggled this will force the image to not get distorted. Opacity Lower the opacity. Saturation Desaturate the image. This is useful if you only want to focus on the light/shadow instead of getting distracted by the colors. Storage mode How is the reference image stored. Embed to \*.kra Store this reference image into the KRA file. This is recommended for small vital files you'd easily lose track of otherwise. Link to external file. Only link to the reference image, krita will open it from the disk everytime it loads this file. This is recommended for big files, or files that change a lot. This option is only available when reference images are loaded from a local path. You can move around reference images by selecting them with |mouseleft|, and dragging them. You can rotate reference images by holding the cursor close to the outside of the corners till the rotate cursor appears, while tilting is done by holding the cursor close to the outside of the middle nodes. Resizing can be done by dragging the nodes. You can delete a single reference image by clicking it and pressing :kbd:`Del`. You can select multiple reference images with :kbd:`Shift` and perform all of these actions. To hide all reference images temporarily use :menuselection:`View --> Show Reference Images`. diff --git a/tutorials/saving-for-the-web.rst b/tutorials/saving-for-the-web.rst index 13b2fbe5b..1f7aab1ad 100644 --- a/tutorials/saving-for-the-web.rst +++ b/tutorials/saving-for-the-web.rst @@ -1,53 +1,53 @@ .. meta:: :description lang=en: Tutorial for saving images for the web. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier :license: GNU free documentation license 1.3 or later. .. _saving_for_the_web: ================== Saving For The Web ================== Krita's default saving format is the :ref:`file_kra` format. This format saves everything Krita can manipulate about an image: Layers, Filters, Assistants, Masks, Color spaces, etc. However, that's a lot of data, so ``*.kra`` files are pretty big. This doesn't make them very good for uploading to the internet. Imagine how many people's data-plans hit the limit if they only could look at ``*.kra`` files! So instead, we optimise our images for the web. There are a few steps involved: 1. Save as a ``.kra``. This is your working file and serves as a backup if you make any mistakes. 2. Flatten all layers. This turns all your layers into a single one. Just go to :menuselection:`Layer --> Flatten Image` or press the :kbd:`Ctrl + Shift + E` shortcut. Flattening can take a while, so if you have a big image, don't be scared if Krita freezes for a few seconds. It'll become responsive soon enough. 3. Convert the color space to 8bit sRGB (if it isn't yet). This is important to lower the filesize, and PNG for example can't take higher than 16bit. :menuselection:`Image --> Convert Image Color Space...` and set the options to **RGB**, **8bit** and **sRGB-elle-v2-srgbtrc.icc** respectively. If you are coming from a linear space, uncheck **little CMS** optimisations 4. Resize! Go to :menuselection:`Image --> Scale Image To New Size...` or use the :kbd:`Ctrl + Alt + I` shortcut. This calls up the resize menu. A good rule of thumb for resizing is that you try to get both sizes to be less than 1200 pixels. (This being the size of HD formats). You can easily get there by setting the **Resolution** under **Print Size** to **72** dots per inch. Then press **OK** to have everything resized. -5. Sharpen the image a little. This is especially necessary for social media. Social media websites often scale and convert your image in such a way that it gets a little blurry, because they optimize towards photos and not paintings. To have your images stay sharp, it is worth it to run a sharpen filter beforehand. Because the sharpen filter is quite powerful, you are best off adding a sharpen filter mask on top of the stack and lowering it's opacity till you feel the sharpness is appropriate. +5. Sharpen the image a little. This is especially necessary for social media. Social media websites often scale and convert your image in such a way that it gets a little blurry, because they optimize towards photos and not paintings. To have your images stay sharp, it is worth it to run a sharpen filter beforehand. Because the sharpen filter is quite powerful, you are best off adding a sharpen filter mask on top of the stack and lowering its opacity till you feel the sharpness is appropriate. 6. Save as a web-safe image format. There's three that are especially recommended: JPG """ Use this for images with a lot of different colors, like paintings. PNG """ Use this for images with few colors or which are black and white, like comics and pixel-art. Select :guilabel:`Save as indexed PNG, if possible` to optimise even more. GIF """ Only use this for animation (will be supported this year) or images with a super low color count, because they will get indexed. Saving with Transparency ------------------------ .. image:: /images/Save_with_transparency.png Saving with transparency is only possible with GIF and PNG. First, make sure you see the transparency checkers (this can be done by simply hiding the bottom layers, changing the projection color in :menuselection:`Image --> Image Background Color and Transparency...`, or by using :menuselection:`Filters --> Colors --> Color to Alpha...`). Then, save as PNG and tick **Store alpha channel (transparency)** Save your image, upload, and show it off!