diff --git a/reference_manual/linux_command_line.rst b/reference_manual/linux_command_line.rst index d6884cf0f..cf39fbfc5 100644 --- a/reference_manual/linux_command_line.rst +++ b/reference_manual/linux_command_line.rst @@ -1,128 +1,140 @@ .. meta:: :description: Overview of Krita's command line options. .. metadata-placeholder :authors: - Scott Petrovic - Wolthera van Hövell tot Westerflier :license: GNU free documentation license 1.3 or later. .. index:: Command Line .. _linux_cmd: ================== Linux Command Line ================== As a native Linux program, Krita allows you to do operations on images without opening the program when using the Terminal. This option was disabled on Windows and OSX, but with 3.3 it is enabled for them! This is primarily used in bash or shell scripts, for example, to mass convert kra files into pngs. Export ------ This allows you to quickly convert files via the terminal: ``krita importfilename --export --export-filename exportfilename`` .. program:: krita importfilename Replace this with the filename of the file you want to manipulate. .. option:: --export Export a file selects the export option. -.. option:: --exportfilename +.. option:: --export-filename - Exportfilename says that the following word is the filename it should be exported to. + Export filename says that the following word is the filename it should be exported to. Replace this with the name of the output file. Use a different extension to change the fileformat. Example: ``krita final.png --export --export-filename final.jpg`` -This piece of code takes the file ``file.png`` and saves it as ``file.jpg``. +This line takes the file ``file.png`` and saves it as ``file.jpg``. + +.. option:: --export-sequence + + .. versionadded:: 4.2 + + Export animation to the given filename and exit + + If a KRA file has no animation, then this command prints "This file has no animation." error and does nothing. + + ``krita --export-sequence --export-filename file.png test.kra`` + + This line takes the animation in test.kra, and uses the value of --export-filename (file.png), to determine the sequence fileformat('png') and the frame prefix ('file'). PDF export ---------- Pdf export looks a bit different, using the ``--export-pdf`` option. ``krita final.png --export-pdf --export-filename final.pdf`` export-pdf exports the file ``file.png`` as a pdf file. .. warning:: This has been removed from 3.1 because the results were incorrect. Open with Custom Screen DPI --------------------------- Open Krita with specified Screen DPI. .. program:: krita .. option:: --dpi Open Krita with specified Screen DPI. For example: ``krita --dpi <72,72>`` Open template ------------- Open krita and automatically open the given template(s). This allows you to, for example, create a shortcut to Krita that opens a given template, so you can get to work immediately! ``krita --template templatename.desktop`` .. program:: krita .. option:: --template templatename.desktop Selects the template option All templates are saved with the .desktop extension. You can find templates in the .kde/share/apps/krita/template or in the install folder of Krita. ``krita --template BD-EuroTemplate.desktop`` This opens the European BD comic template with Krita. ``krita --template BD-EuroTemplate.desktop BD-EuroTemplate.desktop`` This opens the European BD template twice, in separate documents. Start up -------- .. versionadded:: 3.3 .. program:: krita .. option:: --nosplash starts krita without showing the splash screen. .. option:: --canvasonly starts krita in canvasonly mode. .. option:: --fullscreen starts krita in fullscreen mode. .. option:: --workspace Workspace starts krita with the given workspace. So for example... `` krita --workspace Animation`` Starts Krita in the Animation workspace.