diff --git a/reference_manual/main_menu/edit_menu.rst b/reference_manual/main_menu/edit_menu.rst index 1eb34dcd2..863781497 100644 --- a/reference_manual/main_menu/edit_menu.rst +++ b/reference_manual/main_menu/edit_menu.rst @@ -1,63 +1,66 @@ .. meta:: :description: The edit menu in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Edit, Undo, Redo, Cut, Copy, Paste .. _edit_menu: ==== Edit ==== .. glossary:: Undo Undoes the last action. :kbd:`Ctrl + Z` Redo Redoes the last undone action. :kbd:`Ctrl + shift+ Z` Cut Cuts the selection or layer. :kbd:`Ctrl + X` Copy Copies the selection or layer. :kbd:`Ctrl + C` Cut(Sharp) This prevents semi-transparent areas from appearing on your cut pixels, making them either fully opaque or fully transparent. Copy(Sharp) Same as :term:`Cut(Sharp)` but then copying instead. Copy Merged Copies the selection over all layers. :kbd:`Ctrl + Shift + C` Paste Pastes the copied buffer into the image as a new layer. :kbd:`Ctrl + V` + Paste at Cursor + Same as :term:`paste`, but aligns the image to the cursor. + Paste into new image Pastes the copied buffer into a new image. Clear Clear the current layer. :kbd:`Del` Fill with Foreground Colour Fills the layer or selection with the foreground color. :kbd:`Shift + Backspace` Fill with Background Colour Fills the layer or selection with the background color. :kbd:`Backspace` Fill with pattern Fills the layer or selection with the active pattern. - + Stroke Selected Shapes Strokes the selected vector shape with the selected brush, will create a new layer. Stroke Selection Strokes the active selection using the menu. diff --git a/reference_manual/main_menu/file_menu.rst b/reference_manual/main_menu/file_menu.rst index 3b5d3c0da..c2fcce0a9 100644 --- a/reference_manual/main_menu/file_menu.rst +++ b/reference_manual/main_menu/file_menu.rst @@ -1,70 +1,70 @@ .. meta:: :description: The file menu in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Boudewijn Rempt :license: GNU free documentation license 1.3 or later. .. index:: New File, Open, Save, Export, Import, Close, Template .. _file_menu: ========= File Menu ========= .. glossary:: New Make a new file. Open Open a previous File. Open Recent Open the recently opened document. Save File formats that Krita can save to. These formats can later be opened back up in Krita. Save As Save as a new file. Open Existing Document As New document Similar to import in other programs. Export Additional formats that can be saved. Some of these formats may not be later imported or opened by Krita - Export as PDF - PDF export. Doesn't support multiple pages. - - Import Animation Frames(3.0+) + Import Animation Frames Import frames for animation. + + Render Animation + Render an animation with FFMPEG. This is explained on the :ref:`render_animation` page. Save incremental version Save as a new version of the same file with a number attached. Save incremental Backup Make a backup file without leaving the working file. Create Template from image The \*.kra file will be saved into the template folder for future use. All you layers and guides will be saved along! Create Copy From Current Image Makes a new document from the current image, so you can easily reiterate on a single image. Useful for areas where the template system is too powerful. Document Information Look at the document information. Contains all sorts of interesting information about image, such as technical information or metadata. Close Close the view or document. Close All Close all views and documents. Quit Close Krita diff --git a/reference_manual/main_menu/help_menu.rst b/reference_manual/main_menu/help_menu.rst index 9131ec8dc..044b5d0f5 100644 --- a/reference_manual/main_menu/help_menu.rst +++ b/reference_manual/main_menu/help_menu.rst @@ -1,25 +1,27 @@ .. meta:: :description: The help menu in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: About, Handbook, Bug .. _help_menu: ========= Help Menu ========= Krita Handbook Opens a browser and sents you to the index of this manual. Report Bug Sents you to the bugtracker. +Show system information for bugreports. + This is a selection of all the difficult to figure out technical information of your computer. This includes things like, which version of Krita you have, which version your operating system is, and most prudently, what kind of OpenGL functionality your computer is able to provide. The latter varies a lot between computers and due that it is one of the most difficult things to debug. Providing such information can help us figure out what is causing a bug. About Krita Shows you the credits. About KDE Tells you about the KDE community that Krita is part of. diff --git a/reference_manual/main_menu/image_menu.rst b/reference_manual/main_menu/image_menu.rst index c67b6c5e5..c5a87646f 100644 --- a/reference_manual/main_menu/image_menu.rst +++ b/reference_manual/main_menu/image_menu.rst @@ -1,47 +1,49 @@ .. meta:: :description: The image menu in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Image, Canvas Projection Color, Trim, Resize, Scale, Mirror, Transform, Convert Color Space, Offset, Split Channels .. _image_menu: ========== Image Menu ========== Properties Gives you the image properties. Image Background Color and Transparency Change the background canvas color. Convert Current Image Color Space. Converts the current image to a new colorspace. Trim to image size Trims all layers to the image size. Useful for reducing filesize at the loss of information. Trim to Current Layer A lazy cropping function. Krita will use the size of the current layer to determine where to crop. Trim to Selection A lazy cropping function. Krita will crop the canvas to the selected area. Rotate Image Rotate the image Shear Image Shear the image Mirror Image Horizontally Mirror the image on the horizontal axis. Mirror Image Vertically Mirror the image on the vertical axis. Scale to New Size The resize function in any other program :kbd:`Ctrl + Alt + I` Offset Image Offset all layers. -Size Canvas +Resize Canvas Change the canvas size. Don't confuse this with Scale to new size. Image Split Splits the image. +Wavelet Decompose + Does :ref:`wavelet_decompose` on the current layer. Separate Image Seperates the image into channels diff --git a/reference_manual/main_menu/layers_menu.rst b/reference_manual/main_menu/layers_menu.rst index 6107ac075..274f12a42 100644 --- a/reference_manual/main_menu/layers_menu.rst +++ b/reference_manual/main_menu/layers_menu.rst @@ -1,140 +1,140 @@ .. meta:: :description: The layers menu in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Layers, Cut Layer, Copy Layer, Paste Layer, Convert, Import, Export, Transform, Metadata, Histogram, Flatten, Layer Style .. _layers_menu: ====== Layers ====== These are the topmenu options are related to Layer Management, check out that page first, if you haven't. Cut Layer(3.0+) Cuts the whole layer rather than just the pixels. Copy Layer(3.0+) Copy the whole layer rather than just the pixels. Paste Layer(3.0+) Pastes the whole layer if any of the top two actions have been taken. New Organizes the following actions: Paint Layer Add a new paint layer New layer from visible(3.0.2+) Add a new layer with the visible pixels. Duplicate Layer or Mask Duplicates the layer. Cut Selection to New Layer Single action for cut+paste Copy Selection to New Layer Single action for copy+paste Import/Export Organizes the following actions: Save Layer or Mask Saves the Layer or Mask as a separate image. + Save Vector Layer as SVG + Save the currently selected vector layer as an SVG. Save Group Layers Saves the top-level group layers as single-layer images. Import Layer Import an image as a layer into the current file. Import as... Import an image as a specific layer type. The following layer types are supported: * Paint layer * Transparency Mask * Filter Mask * Selection Mask Convert Organizes the following actions: Convert a layer to... Convert to Paint Layer Convert a mask or vector layer to a paint layer. Transparency Mask Convert a layer to a transparency mask. The image will be converted to grayscale first, and these grayscale values are used to drive the transparency. Filter Mask Convert a layer to a filter mask. The image will be converted to grayscale first, and these grayscale values are used to drive the filter effect area. Selection Mask Convert a layer to a selection mask. The image will be converted to grayscale first, and these grayscale values are used to drive the selected area. Convert Group to Animated Layer This takes the images in the group layer and makes them into frames of an animated layer. Convert Layer Color Space This only converts the color space of the layer, not the image. Select(3.0+): Organizes the following actions: All layers Select all layers. Visible Layers Select all visible layers. Invisible Layers Select all invisible layers, useful for cleaning up a sketch. Locked Layers Select all locked layers. Unlocked Layers Select all unlocked layers. Group Organizes the following actions: Quick Group(3.0+) Adds all selected layers to a group. Quick Clipping Group(3.0+) Adds all selected layers to a group and adds a alpha-inherited layer above it. Quick Ungroup Ungroups the activated layer. Transform Organizes the following actions: Mirror Layer Horizontally Mirror the layer horizontally using the image center. Mirror Layer Vertically Mirror the layer vertically using the image center. Rotate Rotate the layer around the image center. Scale Layer Scale the layer by the given amounts using the given interpolation filter. Shear Layer Shear the layer pixels by the given X and Y angles. Offset Layer Offset the layer pixels by a given amount. Split... Organizes the following actions: Split Alpha Split the image transparency into a mask. This is useful when you wish to edit the transparency seperately. Split Layer Split the layer into given color fields. Clones Array A complex bit of functionality to generate clone-layers for quick sprite making. Edit Metadata Each layer can have it's own meta-data. Histogram Shows a histogram. Merge With Layer Below Merge a layer down. Flatten Layer Flatten a Group Layer or flatten the masks into any other layer. Rasterize Layer For making vectors into raster layers. Flatten Image Flatten all layers into one. -Merge Selected Layers - Merge the layers that were selected with multi-selection in the Layer Docker. Layerstyle(2.9.5+) Set the PS-style layerstyle diff --git a/reference_manual/main_menu/settings_menu.rst b/reference_manual/main_menu/settings_menu.rst index 763dfeb52..9a97ecc00 100644 --- a/reference_manual/main_menu/settings_menu.rst +++ b/reference_manual/main_menu/settings_menu.rst @@ -1,123 +1,123 @@ .. meta:: :description: The settings menu in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic - Micheal Abrahams - Raghavendra Kamath :license: GNU free documentation license 1.3 or later. .. _settings_menu: ============ Setting Menu ============ The Settings Menu houses the configurable options in Krita and where you determine most of the "look and feel" of the application. .. index:: Dockers Show Dockers ------------ Show Dockers Determines whether or not the dockers are visible. This is a nice aid to cleaning up the interface and removing unnecessary "eye-ball clutter" when you are painting. If you've got your brush and you know you're just going to be painting for awhile why not flip the dockers off? You'd be amazed what a difference it makes while you're working. However, if you know you're swapping out tools or working with layer or any of the other myriad things Krita lets you do then there's no point getting caught up in flipping the docks on and off. Use you time wisely! - .. note:: + .. tip:: This is a great candidate to add to the toolbar so you can just click the dockers on and off and don't even have to open the menu to do it. See :ref:`configure_toolbars` below for more. Dockers ------- Krita subdivides the access of many of it's features into functional panels called Dockers. Dockers are small windows that can contain, for example, things like the Layer Stack, Color Palette or Brush Presets. Think of them as the painter's palette, or his water, or his brushkit. Learning to use dockers effectively is a key concept to maximizing your time using Krita. .. index:: Themes, Theme, Look and Feel Themes ------ Krita provides a number of color-themed interfaces or "looks". The current set of themes are the following: * Dark (Default) * Blender * Bright * Neutral There is no easy way to create and share themes. The color themes are defined in the Share > Color Schemes folder where Krita is downloaded. Configure Shortcuts ------------------- Configuring shortcuts is another way to customize the application to fit you. Whether you are transitioning from another app, like Photoshop or MyPaint, or you think your own shortcut keys make more sense for you then Krita has got you covered. You get to the shortcuts interface through :menuselection:`Settings --> Configure Krita` and by choosing the :menuselection:`Keyboard Shortcuts` tab. To use, just type the :guilabel:`Action` into the Search box you want to assign/reassign the shortcut for. Suppose we wanted to assign the shortcut :kbd:`Ctrl + G` to the :guilabel:`Action` of Group Layers so that every time we pressed :kbd:`Ctrl + G` a new Layer Group would be created. Use the following steps to do this: #. Type "Group Layer" #. Click on Group Layer and a small inset box will open. #. Click the Custom radio button #. Click on the first button and type the :kbd:`Control + G` key combination. #. Click OK From this point on, whenever you press :kbd:`Ctrl + G` you'll get a new :guilabel:`Group Layer`. -.. note:: +.. tip:: Smart use of shortcuts can save you significant time and further streamline your workflow. Manage Resources ---------------- Manage the resources.You can read more about it :ref:`here `. .. index:: Language Switch Application Language --------------------------- If you wish to use Krita in a different translation. .. index:: ! Toolbar .. _configure_toolbars: Configure Toolbars ------------------ Krita allows you to highly customize the Toolbar interface. You can add, remove and change the order of nearly everything to fit your style of work. To get started, choose :menuselection:`Settings --> Configure Toolbars` .. image:: /images/en/Configure_Toolbars_Krita.png :align: center The dialog is broken down into three main sections: The Toolbar Choose to either modify the "File" or "Brushes and Stuff" toolbars Available Actions: All the options that can be added to a toolbar Current Actions: All the actions currently assigned and the order they are in. Use the arrows between the *Available* and *Current* actions sections to move items back and forth and up and and down in the hierarchy. This type of inclusion/exclusion interface has been around on PCs for decades so we don't need to go into great detail regarding its use. What is important though is selecting the correct Toolbar to work on. The :guilabel:`File` Toolbar allows you to add items between the :menuselection:`New` , :menuselection:`Open` and :menuselection:`Save` buttons as well as to the right of the :menuselection:`Save` button. The :guilabel:`Brushes and Stuff` Toolbar,lets you modify anything from the Gradients button over to the right. This is probably where you'll do most of your editing. Here we've added :menuselection:`Select Opaque` , :menuselection:`Local Selection` , :menuselection:`Transparency Mask` , :guilabel:`Isolate Layer` , :menuselection:`Show Assistant Previews` . This is just an example of a couple of options that are used frequently and might trim your workflow. This is what it looks like in the configuration tool: .. image:: /images/en/Configure_Toolbars_Brushes_and_Stuff_Custom.png :align: center You'll notice that some of the items are text only and some only icons. This is determined by whether the particular item has an associated icon in Krita. You can select anything from the *Available* section and move it to the *Current* one and rearrange to fit your own workflow. If you add so many that they won't all fit on your screen at once, you will see a small chevron icon appear. Click it and the toolbar expands to show the remaining items. Toolbars shown. Gives a list of toolbars that can be shown. At this time Krita does not support the ability to create additional toolbars. The ones available are: .. image:: /images/en/Toolbars_Shown.png :align: center Although not really advisable, you can turn them off (but why would you..really?) diff --git a/reference_manual/main_menu/tools_menu.rst b/reference_manual/main_menu/tools_menu.rst index 26cc0c318..837bd4c9e 100644 --- a/reference_manual/main_menu/tools_menu.rst +++ b/reference_manual/main_menu/tools_menu.rst @@ -1,18 +1,37 @@ .. meta:: :description: The tools menu in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Macro, Scripts .. _tools_menu: ========== Tools Menu ========== -Contains recording and macro. +This contains three things. + +Scripting +--------- + +When you have python scripting enabled and have scripts toggled, this is where most scripts are stored by default. + +Recording +--------- + +.. caution:: + + The recording and macro features are unmaintained and buggy. + +Record a macro. You do this by pressing start, drawing something and then pressing stop. This feature can only record brush strokes. The resulting file is stored as a *.kritarec file. + +Macros +------ + +Play back or edit a krita rec file. The edit can only change the brush preset on strokes or add and remove filters. diff --git a/reference_manual/main_menu/view_menu.rst b/reference_manual/main_menu/view_menu.rst index df02e046d..8b2ff72cb 100644 --- a/reference_manual/main_menu/view_menu.rst +++ b/reference_manual/main_menu/view_menu.rst @@ -1,43 +1,55 @@ .. meta:: :description: The view menu in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: ! View, Wrap around mode .. _view_menu: ========= View Menu ========= Show Canvas Only Only shows the canvas and what you have configured to show in Canvas Only Settings Fullscreen mode This will hide the system bar. -Mirror View - This will mirror the view. Hit :kbd:`M` to quickly activate it. Very useful during painting. Wrap Around Mode This will show the image as if tiled orthographically. Very useful for tiling 3d textures. Hit :kbd:`W` to quickly activate it. +Instant Preview + Toggle :ref:`instant_preview` globally. +Soft Proofing + Activate :ref:`soft_proofing`. +Out of Gamut Warnings + See the :ref:`soft_proofing` page for details. Canvas Contains view manipulation actions. + + Mirror View + This will mirror the view. Hit :kbd:`M` to quickly activate it. Very useful during painting. + Show Rulers This will display a set of rulers. |mouseright| the rulers after showing them, to change the units. +Rulers track pointer + This adds a little marker to the ruler to show where the mouse is in relation to them. +Show Guides + Show or hide the guides. +Lock Guides + Prevent the guides from being able to be moved by the cursor. Show Status Bar This will show the status bar. The status bar contains a lot of important information, a zoom widget, and the button to switch Selection Display Mode. Show Grid Shows and hides the grid. :kbd:`Ctrl + Shift + '` -Grid spacing - A quick way to change the Grid Settings -Show Perspective Grid - Shows the Perspective Grids -Clear Perspective Grid - Clear all Perspective Grids +Show Pixel Grid + Show the pixel grid as configured in the :ref:`display_settings`. +Snapping + Toggle the :ref:`snapping` types. Show Painting Assistants Shows or hides the Assistants Show Painting Previews Shows or hides the Assistants diff --git a/reference_manual/main_menu/window_menu.rst b/reference_manual/main_menu/window_menu.rst index 677733f34..c2a92f49c 100644 --- a/reference_manual/main_menu/window_menu.rst +++ b/reference_manual/main_menu/window_menu.rst @@ -1,37 +1,39 @@ .. meta:: :description: The window menu in Krita. .. metadata-placeholder :authors: - Wolthera van Hövell tot Westerflier - Scott Petrovic :license: GNU free documentation license 1.3 or later. .. index:: Window, View .. _window_menu: =========== Window Menu =========== A menu completely dedicated to to window management in Krita. New Window Creates a new window for Krita. Useful with multiple screens. New View Make a new view of the given document. You can have different zoom or rotation on these. +Workspace + A convenient acces panel to the :ref:`resource_workspaces`. Close Close the current view. Close All Close all documents Tile Tiles all open documents into a little sub-window. Cascade Cascades the sub-windows. Next Selects the next view. Previous Selects the previous view. List of open documents. Use this to switch between documents.