diff --git a/reference_manual/hdr_display.rst b/reference_manual/hdr_display.rst index 4e7169d3c..e1d47db39 100644 --- a/reference_manual/hdr_display.rst +++ b/reference_manual/hdr_display.rst @@ -1,87 +1,87 @@ .. meta:: :description: How to configure Krita for HDR displays. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier :license: GNU free documentation license 1.3 or later. .. index:: HDR, High Dynamic Range, HDR display .. _hdr_display: HDR Display ----------- .. versionadded:: 4.2 .. Note:: Currently only available on Windows. Since 4.2 Krita can not just edit high bitdepths images, but also render them on screen in a way that an HDR capable setup can show them as HDR images. HDR images, to put it simply, are images with really bright colors. They do this by having a very large range of colors available, 16 bit and higher, and to understand the upper range of the available colors as brighter than the brightest white most screens can show. HDR screens, in turn, are screens which can show brighter colors than most screens can show, and can thus show the super-bright colors in these HDR images. This allows for images where bright things, like fire, sunsets, magic, look really spectacular! It also shows more subtle shadows and has a better contrast in lower color values, but this requires a sharper eye. Configuring HDR ~~~~~~~~~~~~~~~ Krita cannot show HDR with any given monitor, you will need an HDR capable setup. HDR capable setups are screens which can show more than 100 nits, preferably a value like 1000 and can show the rec 2020 PQ space. You will need to have the appropriate display cable(otherwise the values are just turned into regular SDR) and a graphics card which supports HDR, as well as suitable drivers. You then also need to configure the system settings for HDR. If you can confirm that the system understands your setup as an HDR setup, you can continue your :ref:`configuration in Krita`, in :menuselection:`Settings --> Configure Krita --> Display`. There, you need to select the preferred surface, which should be as close to the display format as possible. Then restart Krita. Painting in HDR ~~~~~~~~~~~~~~~ -To create a proper HDR image, you will need to make a canvas using a profile with rec 2020 gamut and a linear trc. :guilabel:`Rec2020-elle-V4-g10.icc` is the one we ship by default. +To create a proper HDR image, you will need to make a canvas using a profile with rec 2020 gamut and a linear TRC. :guilabel:`Rec2020-elle-V4-g10.icc` is the one we ship by default. -HDR images are standardized to use the Rec2020 gamut, and the PQ trc. However, a linear TRC is easier to edit images in, so we don't convert to PQ until we're satisfied with our image. +HDR images are standardized to use the Rec2020 gamut, and the PQ TRC. However, a linear TRC is easier to edit images in, so we don't convert to PQ until we're satisfied with our image. For painting in this new exciting color space, check the :ref:`scene_linear_painting` page, which covers things like selecting colors, gotchas, which filters work and cool workflows. Exporting HDR ~~~~~~~~~~~~~ Now for saving and loading. The kra file format can save the floating point image just fine, and is thus a good working file format. For sharing with other image editors, :ref:`file_exr` is recommended. For sharing with the web we currently only have :ref:`HDR png export `, but there's currently very little support for this standard. In the future we hope to see heif and avif support. For exporting HDR animations, we support saving HDR to the new codec for mp4 and mkv: H.265. To use these options... * Get a version of FFMpeg that supports H.256 * Have an animation open. * :menuselection:`File --> Render Animation` * Select :guilabel:`Video` * Select for :guilabel:`Render as`, 'MPEG-4 video' or 'Matroska'. * Press the configure button next to the file format dropdown. * Select at the top 'H.265, MPEG-H Part 2 (HEVC)' * Select for the :guilabel:`Profile`, 'main10'. * :guilabel:`HDR Mode` should now enable. Toggle it. * click :guilabel:`HDR Metadata` to configure the HDR metadata (options described below). * finally, when done, click 'render'. HDR Metadata ~~~~~~~~~~~~ This is in the render animation screen. It configures the SMPTE ST.2086 or Master Display Color Volumes metadata and is required for the HDR video to be transferred properly to the screen by video players and the cable. Master Display The colorspace characteristics of the display on for which your image was made, typically also the display that you used to paint the image with. There are two default values for common display color spaces, and a custom value, which will enable the :guilabel:`Display` options. Display The precise colorspace characteristics for the display for which your image was made. If you do not have custom selected for :guilabel:`Master Display`, these are disabled as we can use predetermined values. Red/Green/Blue Primary The xyY x and xyY y value of the three chromacities of your screen. These define the gamut. White Point The xyY x and xyY y value of the white point of your screen, this defines what is considered 'neutral grey'. Min Luminance The darkest value your screen can show in nits. Max Luminance The brightest value your screen can show in nits. MaxCLL The value of the brightest pixel of your animation in nits. MaxFALL The average 'brightest value' of the whole animation. diff --git a/reference_manual/popup-palette.rst b/reference_manual/popup-palette.rst index 03565ea8e..e7b3342b4 100644 --- a/reference_manual/popup-palette.rst +++ b/reference_manual/popup-palette.rst @@ -1,32 +1,32 @@ .. meta:: :description: The Pop-up Palette in Krita .. metadata-placeholder :authors: - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. index:: Pop-up Palette .. _pop-up_palette: Pop-up Palette ============== The Pop-up Palette is a feature unique to Krita amongst the digital painting applications. It is designed to increase productivity and save time of the artists by providing quick access to some of the most frequently used tools and features in Krita. The Pop-up palette can be accessed by |mouseright| on the canvas. A circular palette similar to what is shown in the image below will spawn at the position your mouse cursor. .. image:: /images/popup-palette-detail.svg As shown in the image above, the pop-up palette has the following tools and quick access shortcuts integrated into it -- Foreground Color Indicator and Background color Indicators on the top right of the palette. +- Foreground color and Background color indicators on the top right of the palette. - A canvas rotation slider, which can help the artist quickly rotate the canvas while painting. - A group of brush presets, based on the tag selected by the artist. By default the **My Favorite** tag is selected. By default only first 10 presets from the tag are shown, however you can change the number of brush presets shown by changing the value in the :ref:`Miscellaneous Settings Section ` of the dialog box. - Color Selector with which you can select the hue from the circular ring and lightness and saturation from the triangular area in the middle. - Color history area shows the most recent color swatches that you have used while painting. -- The tag list for brush preset will show you the list of both and default tags to choose from, selecting a tag from this list will show the corresponding brush presets in the palette. +- The tag list for brush preset will show you the list of both custom and default tags to choose from, selecting a tag from this list will show the corresponding brush presets in the palette. - The common brush options such as size, opacity, angle et cetera will be shown when you click the **>** icon. A dialog box will appear which will have the sliders to adjust the brush options. You can choose which options are shown in this dialog box by clicking on the settings icon. - The zoom slider allows you to quickly zoom the canvas. - The 100% button sets the zoom to the 100% of the image size - The button with the canvas icon switches to the canvas only mode, where the toolbar and dockers are hidden. - The button with the mirror icon mirrors the canvas to help you spot the errors in the painting. diff --git a/user_manual/autosave.rst b/user_manual/autosave.rst index fa9bb1027..863738d60 100644 --- a/user_manual/autosave.rst +++ b/user_manual/autosave.rst @@ -1,142 +1,142 @@ .. meta:: :description: How AutoSave and Backup Files Work in Krita .. metadata-placeholder :authors: - Boudewijn Rempt :license: GNU free documentation license 1.3 or later. .. index:: ! Saving, Autosave, Backup .. _autosave: ================================= Saving, AutoSave and Backup Files ================================= Krita does its best to keep your work safe. But if you want to make sure that you won't lose work, you will need to understand how Saving, AutoSave and Backup Files work in Krita. Saving ------ Krita does not store your images somewhere without your intervention. You need to save your work, or it will be lost, irretrievably. Krita can save your images in many formats. You should always save your work in Krita's native format, ``.kra`` because that supports all Krita's features. Additionally, you can export your work to other formats, for compatibility with other applications or publication on the Web or on paper. Krita will warn which aspects of your work are going to be lost when you save to another format than ``.kra`` and offers to make a ``.kra`` file for you as well. If you save your work, Krita will ask you where it should save on your computer. By default, this is the Pictures folder in your User folder: this is true for all operating systems. If you use "Save As" your image will be saved under a new name. The original file under its own name will not be deleted. From now on, your file will be saved under the new name. If you use "Export" using a new filename, a new file will be created with a new name. The file you have open will keep the new name, and the next time you save it, it will be saved under the old name. You can Save, Save As and Export to any file format. See also :ref:`Saving for the Web ` AutoSave -------- -AutoSave is what happens when you've worked for a bit and not saved your work yourself: Krita will save your work for you. Autosave files are by default visible in your file manager. You can configure Krita 4.2 and up to create autosave files that are visible in your file manager. By default, Krita autosaves every fifteen minutes; you can configure that in the File tab of the General Settings page of the Configure Krita dialog, which is in the Settings menu (Linux, Windows) or in the Application menu (macOS). +AutoSave is what happens when you've worked for a bit and not saved your work yourself: Krita will save your work for you. Autosave files are by default hidden in your file manager. You can configure Krita 4.2 and up to create autosave files that are visible in your file manager. By default, Krita autosaves every fifteen minutes; you can configure that in the File tab of the General Settings page of the Configure Krita dialog, which is in the Settings menu (Linux, Windows) or in the Application menu (macOS). If you close Krita without saving, your unsaved work is lost and cannot be retrieved. Closing Krita normally also means that autosave files are removed. .. image:: /images/file_config_page.png There are two possibilities: - You hadn't saved your work at all - You had saved your work already AutoSave for Unsaved Files ~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you had not yet saved your work, Krita will create an unnamed AutoSave file. If you're using Linux or macOS, the AutoSave file will be a hidden file in your home directory. If you're using Windows, the AutoSave file will be a file in your user's ``%TEMP%`` folder. In Krita 4.2 and up, you can configure Krita to make the AutoSave files visible by default. A hidden autosave file will be named like ``.krita-12549-document_1-autosave.kra`` If Krita crashes before you had saved your file, then the next time you start Krita, you will see the file in a dialog that shows up as soon as Krita starts. You can select to restore the files, or to delete them. .. image:: /images/autosave_unnamed_restore.png If Krita crashed, and you're on Windows and your ``%TEMP%`` folder gets cleared, you will have lost your work. Windows does not clear the ``%TEMP%`` folder by default, but you can enable this feature in Settings. Applications like Disk Cleanup or cCleaner will also clear the ``%TEMP%`` folder. Again, if Krita crashes, and you haven't saved your work, and you have something enabled that clear your ``%TEMP%`` folder, you will have lost your work. If Krita doesn't crash, and you close Krita without saving your work, Krita will remove the AutoSave file: your work will be gone and cannot be retrieved. If you save your work and continue, or close Krita and do save your work, the AutoSave file will be removed. AutoSave for Saved Files ~~~~~~~~~~~~~~~~~~~~~~~~ If you had already saved your work, Krita will create a named AutoSave file. A hidden named autosave file will look like ``.myimage.kra-autosave.kra``. By default, named AutoSave files are hidden. Named AutoSave files are placed in the same folder as the file you were working on. If you start Krita again after it crashed and try to open your original file, Krita will ask you whether to open the AutoSave file instead: .. image:: /images/autosave_named_restore.png If you choose "no", the AutoSave file will be removed. The work that has been done since the last time you saved your file yourself will be lost and cannot be retrieved. If you choose "yes", the AutoSave file will be opened, then removed. The file you have open will have the name of your original file. The file will be set to Modified, so the next time you try to close Krita, Krita will ask you whether you want to save the file. If you choose No, your work is irretrievably gone. It cannot be restored. If you use "Save As" your image will be saved under a new name. The original file under its own name and its AutoSave file are not deleted. From now on, your file will be saved under the new name; if you save again, an AutoSave file will be created using the new filename. If you use "Export" using a new filename, a new file will be created with a new name. The file you have open will keep the new name, and the next time you save it, the AutoSave file will be created from the last file saved with the current name, that is, not the name you choose for "Export". Backup Files ------------ There are three kinds of Backup files - Ordinary Backup files that are created when you save a file that has been opened from disk - Incremental Backup files that are copies of the file as it is on disk to a numbered backup, and while your file is saved under the current name - Incremental Version files that are saves of the file you are working on with a new number, leaving alone the existing files on disk. Ordinary Backup Files ~~~~~~~~~~~~~~~~~~~~~ If you have opened a file, made changes, then save it, or save a new file after the first time you've saved it, Krita will save a backup of your file. You can disable this mechanism in the File tab of the General Settings page of the Configure Krita dialog, which is in the Settings menu (Linux, Windows) or in the Application menu (macOS). By default, Backup files are enabled. .. image:: /images/file_config_page.png By default, a Backup file will be in the same folder as your original file. You can also choose to save Backup files in the User folder or the ``%TEMP%`` folder; this is not as safe because if you edit two files with the same name in two different folders, their backups will overwrite each other. By default, a Backup file will have ``~`` as a suffix, to distinguish it from an ordinary file. If you are using Windows, you will have to enable "show file extensions" in Windows Explorer to see the extension. .. image:: /images/file_and_backup_file.png If you want to open the Backup file, you will have to rename it in your file manager. Make sure the extension ends with ``.kra``. Every time you save your file, the last version without a ``~`` suffix will be copied to the version with the ``~`` suffix. The contents of the original file will be gone: it will not be possible to restore that version. Incremental Backup Files ~~~~~~~~~~~~~~~~~~~~~~~~ Incremental Backup files are similar to ordinary Backup files: the last saved state is copied to another file just before saving. However, instead of overwriting the Backup file, the Backup files are numbered: .. image:: /images/save_incremental_backup.png Use this when you want to keep various known good states of your image throughout your painting process. This takes more disk space, of course. Do not be confused: Krita does not save the current state of your work to the latest Incremental file, but copies the last saved file to the Backup file and then saves your image under the original filename. Incremental Version Files ~~~~~~~~~~~~~~~~~~~~~~~~~ Incremental Version works a bit like Incremental Backup, but it leaves the original files alone. Instead, it will save a new file with a file number: .. image:: /images/save_incremental_version.png