diff --git a/reference_manual/hdr_display.rst b/reference_manual/hdr_display.rst index d45646b4a..ff6495096 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. 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. +* Get a version of FFmpeg that supports H.265. * 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/tools/magnetic_select.rst b/reference_manual/tools/magnetic_select.rst index 3267ce921..bead95e89 100644 --- a/reference_manual/tools/magnetic_select.rst +++ b/reference_manual/tools/magnetic_select.rst @@ -1,109 +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:`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. 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. .. 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.