Warning, /graphics/spectacle/doc/index.docbook is written in an unsupported language. File is not indexed.
0001 <?xml version="1.0" ?> 0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [ 0003 <!ENTITY spectacle "<application>Spectacle</application>"> 0004 <!ENTITY % addindex "IGNORE"> 0005 <!ENTITY % English "INCLUDE" > <!-- change language only here --> 0006 ]> 0007 0008 <book id="spectacle" lang="&language;"> 0009 <bookinfo> 0010 <title>The &spectacle; Handbook</title> 0011 0012 <authorgroup> 0013 <author> 0014 &Boudhayan.Gupta; 0015 &Boudhayan.Gupta.mail; 0016 </author> 0017 0018 <othercredit role="developer"> 0019 &Boudhayan.Gupta; 0020 &Boudhayan.Gupta.mail; 0021 </othercredit> 0022 0023 <!-- TRANS:ROLES_OF_TRANSLATORS --> 0024 </authorgroup> 0025 0026 <copyright><year>1997-2000</year><holder>&Richard.J.Moore;</holder></copyright> 0027 <copyright><year>2000</year><holder>&Matthias.Ettrich;</holder></copyright> 0028 <copyright><year>2015</year><holder>&Boudhayan.Gupta;</holder></copyright> 0029 0030 <legalnotice>&FDLNotice;</legalnotice> 0031 0032 <date>2021-04-25</date> 0033 <releaseinfo>Applications 21.08</releaseinfo> 0034 0035 <abstract> 0036 <para>&spectacle; is an application for capturing and editing desktop screenshots. It can capture images of the entire desktop, a single monitor, the currently active window, the window currently under the mouse, or a rectangular region of the screen. The images can then be annotated, printed, sent to other applications for manipulation, or quickly be saved as-is.</para> 0037 </abstract> 0038 0039 <keywordset> 0040 <keyword>KDE</keyword> 0041 <keyword>spectacle</keyword> 0042 <keyword>kdegraphics</keyword> 0043 <keyword>screenshot</keyword> 0044 <keyword>screen capture</keyword> 0045 <keyword>screen grab</keyword> 0046 </keywordset> 0047 </bookinfo> 0048 0049 <chapter id="introduction"> 0050 <title>Introduction</title> 0051 0052 <para>&spectacle; is an application for capturing and editing desktop screenshots. It can capture images of the entire desktop, a single monitor, the currently active window, the window currently under the mouse, or a rectangular region of the screen. The images can then be annotated, printed, sent to other applications for manipulation, or quickly be saved as-is.</para> 0053 0054 <para>Please report any problems or feature requests to the <ulink url="https://bugs.kde.org/">&kde; Bug Tracking System</ulink>.</para> 0055 </chapter> 0056 0057 <chapter id="starting"> 0058 <title>Starting &spectacle;</title> 0059 0060 <para>&spectacle; can be started in a variety of ways, as described below:</para> 0061 0062 <itemizedlist> 0063 <listitem> 0064 <para>In the application launcher menu, &spectacle; can be found at <menuchoice><guisubmenu>Applications</guisubmenu><guisubmenu>Utilities</guisubmenu><guimenuitem>Screenshot Capture Utility &spectacle;</guimenuitem></menuchoice></para> 0065 </listitem> 0066 <listitem> 0067 <para>Pressing the <keysym>Print Screen</keysym> button on the keyboard (often labeled <keycap>PrtSc</keycap>, <keycap>PrtScn</keycap> or similar) will immediately launch &spectacle;. Additionally, three more keyboard shortcuts are available to take screenshots and save them in your default save folder without showing the &GUI;:</para> 0068 <itemizedlist> 0069 <listitem><para><keycombo action="simul"><keycap>Meta</keycap><keysym>Print Screen</keysym></keycombo> will take a screenshot of the active window</para></listitem> 0070 <listitem><para><keycombo action="simul">&Shift;<keysym>Print Screen</keysym></keycombo> will take a screenshot of your entire desktop, &ie; all monitors</para></listitem> 0071 <listitem><para><keycombo action="simul"><keycap>Meta</keycap>&Shift;<keysym>Print Screen</keysym></keycombo> will take a rectangular region screenshot</para></listitem> 0072 </itemizedlist> 0073 <para>You can configure the default save location and filename by starting &spectacle; normally and clicking on the <guibutton>Configure...</guibutton> button, then navigating to the Save section.</para> 0074 </listitem> 0075 <listitem> 0076 <para>The mini command line &krunner; (invoked with <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>) may also be used to start &spectacle;.</para> 0077 </listitem> 0078 <listitem> 0079 <para> &spectacle; can be started from the command-line. &spectacle; has an extensive set of command-line options, including a background mode which can be used to script the capture of screenshots without showing the &GUI; or requiring user interaction.</para> 0080 0081 <para>To start &spectacle; from the command prompt, type in:</para> 0082 <screen width="40"> 0083 <prompt>%</prompt> <command>spectacle &</command> 0084 </screen> 0085 0086 <para>To view the full list of command-line options and their explanation, type in:</para> 0087 <screen width="40"> 0088 <prompt>%</prompt> <command>spectacle --help</command> 0089 </screen> 0090 </listitem> 0091 </itemizedlist> 0092 </chapter> 0093 0094 <chapter id="using"> 0095 <title>Using &spectacle;</title> 0096 0097 <para>Once &spectacle; starts, you will see a window like the following: 0098 <mediaobject> 0099 <imageobject> 0100 <imagedata fileref="MainWindow.png" format="PNG"/> 0101 </imageobject> 0102 <textobject> 0103 <phrase>&spectacle; Main Window</phrase> 0104 </textobject> 0105 </mediaobject> 0106 </para> 0107 0108 <para>&spectacle; grabs an image of your entire desktop immediately after it is started, but before it displays itself on screen. This allows you to quickly create full-desktop screenshot images.</para> 0109 0110 <para>The snapshot taken by &spectacle; is displayed in the preview window, which is located on the left-hand side of the &spectacle; application window.</para> 0111 0112 <para>The image can be saved to a location of your choice by clicking on the <guibutton>Save As</guibutton> button or typing <keycombo action="simul">&Ctrl;&Shift;<keycap>S</keycap></keycombo>. This opens the standard save dialog, where you can choose the filename, the folder location, and the format that your screenshot will be saved in. You may edit the filename to anything you wish, including the name of a previously saved screenshot.</para> 0113 0114 <para>To save a screenshot to the default location, click on the arrow portion of the <guibutton>Save As...</guibutton> button and press the <guimenuitem>Save </guimenuitem> (<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>) button. The new save mode will be remembered for next time. The default save location and filename can be configured, as described later.</para> 0115 0116 <para>To quickly save the image and quit &spectacle;, click on the checkbox beside <guilabel>Quit after manual Save or Copy</guilabel>, then click the arrow portion of the <guibutton>Save As...</guibutton> button and press the <guimenuitem>Save</guimenuitem> (<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>) item. This saves the image as a PNG file in your default <filename class="directory">Pictures</filename> folder, and exits the application immediately. As above, this new save mode will be remembered.</para> 0117 0118 <sect1 id="taking-screenshot"> 0119 <title>Taking A Screenshot</title> 0120 0121 <para>When you open &spectacle;, it immediately takes a screenshot, unless otherwise set in the general options, of the whole screen as a convenience and shows a preview of it in the main window. You can save this screenshot using the buttons on the bottom of the window, or take a new one using the controls to the right of the preview.</para> 0122 0123 <para>To discard the current screenshot and take another screenshot, press the <guibutton>Take a New Screenshot</guibutton> (<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>) button.</para> 0124 0125 <para>After capturing a screenshot, &spectacle; will show you an info panel with a link to the screenshot file and propose you to <guibutton>Open Containing Folder</guibutton> of this file.</para> 0126 0127 <para>You may configure certain options on the right hand side of the application window before taking a new screenshot. These options allow you to select the area of the screen that is to be captured, set a delay before capturing the image, and configure whether the mouse cursor and/or the window decorations should be captured along with the screenshot.</para> 0128 0129 <sect2> 0130 <title>Capture Mode</title> 0131 0132 <para>The capture mode settings allow you to set the area of the screen that should be captured, and whether there should be a delay between pressing the <guibutton>Take a New Screenshot</guibutton> (<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>) button and taking the screenshot. You may also enable the <guilabel>On Click</guilabel> checkbox, which disables the delay function and only takes the screenshot after you click anywhere on the screen after clicking the <guibutton>Take a New Screenshot</guibutton> (<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>) button.</para> 0133 0134 <para>The <guilabel>Area</guilabel> combo-box allows you to set the area of the screen that should be captured. There are five options to select from, as described below.</para> 0135 0136 <itemizedlist> 0137 <listitem> 0138 <para>The <guilabel>Full Screen (All Monitors)</guilabel> option takes a screenshot of your entire desktop, spread across all the outputs, including all the monitors, projectors etc.</para> 0139 </listitem> 0140 <listitem> 0141 <para>The <guilabel>Current Screen</guilabel> option takes a screenshot of the output that currently contains the mouse pointer.</para> 0142 </listitem> 0143 <listitem> 0144 <para>The <guilabel>Rectangular Region</guilabel> option allows you to select a rectangular region of your desktop with your mouse. This region may be spread across different outputs.</para> 0145 0146 <para>This mode does not immediately take a screenshot but allows you to draw a rectangle on your screen, which can be moved and resized as needed. Once the desired selection rectangle has been drawn, double-clicking anywhere on the screen, or pressing the &Enter; button on the keyboard will capture the screenshot.</para> 0147 0148 <para>You can use the arrow keys to move and adjust the rectangle. Pressing the arrow keys will move the rectangle. Holding the &Shift; key while pressing the arrow keys will move the rectangle slowly, for fine-tuning your selection. Holding the &Alt; key while pressing the arrow keys will adjust the size of the rectangle.</para> 0149 0150 </listitem> 0151 <listitem> 0152 <para>The <guilabel>Active Window</guilabel> option takes a screenshot of the window that currently has focus. It is advisable to use a delay with this mode, to give you time to select and activate a window before the screenshot is taken.</para> 0153 </listitem> 0154 <listitem> 0155 <para>The <guilabel>Window Under Cursor</guilabel> option takes a screenshot of the window that is under the mouse cursor. If the cursor is on top of a popup menu, &spectacle; tries to take a screenshot of the menu as well as its parent window.</para> 0156 0157 <para>While this works most of the time, in certain cases it may fail to obtain information about the parent window. In this case, &spectacle; falls back to old way of capturing the image automatically, and captures an image of only the popup menu. You can also force the old way of capturing the image by checking the <guilabel>Capture the current pop-up only</guilabel> checkbox under <guilabel>Options</guilabel></para> 0158 </listitem> 0159 </itemizedlist> 0160 0161 <para>The <guilabel>Delay</guilabel> spin-box allows you to set the delay between pressing the <guibutton>Take a New Screenshot</guibutton> (<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>) button and taking the screenshot. This delay can be set in increments of 1 seconds using the spinbox buttons or the keyboard.</para> 0162 0163 <para>When taking a time-delayed screenshot, &spectacle; displays the remaining time before the screenshot is taken in its window title, and makes it visible in its Task Manager item. &spectacle;'s Task Manager button also shows a progress bar, so you can keep track of when the snap will be taken.</para> 0164 0165 <para>While waiting for the delayed screenshot, you can un-minimize &spectacle; and the <guibutton>Take a New Screenshot</guibutton> button will turn into a <guibutton>Cancel</guibutton> button. The progress bar will also be shown here, giving you the chance to stop the countdown.</para> 0166 0167 <para>Enabling the <guilabel>On Click</guilabel> checkbox overrides the delay. When this checkbox is enabled, pressing the <guibutton>Take a New Screenshot</guibutton> (<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>) button hides the &spectacle; window and changes the mouse cursor to a crosshair. The screenshot is captured when the mouse is left-clicked, or aborted if any other mouse buttons are clicked. Note that you cannot interact with the desktop using the mouse while the cursor is a crosshair, but you can use the keyboard.</para> 0168 </sect2> 0169 0170 <sect2> 0171 <title>Options</title> 0172 0173 <para>The Options settings allow you to select whether the mouse cursor should be included in the screenshots, and whether to capture window decorations along with the image of a single application window. In <guilabel>Window Under Cursor</guilabel> mode, it also allows you to select if &spectacle; shall only capture the image of the current popup menu under the cursor, or also include the parent window. Finally, <guilabel>Quit after Save or Copy</guilabel> will quit &spectacle; after any save or copy operations.</para> 0174 0175 <itemizedlist> 0176 <listitem> 0177 <para>Enabling the <guilabel>Include mouse pointer</guilabel> checkbox includes an image of the mouse pointer in the screenshot.</para> 0178 </listitem> 0179 <listitem> 0180 <para>The <guilabel>Include window titlebar and borders</guilabel> option is only enabled when either the <guilabel>Active Window</guilabel> mode or the <guilabel>Window Under Cursor</guilabel> mode is selected in the <guilabel>Area</guilabel> combo-box. Checking this option includes the window borders and decoration in the screenshot, while unchecking it gives an image of only the window contents.</para> 0181 </listitem> 0182 <listitem> 0183 <para>The <guilabel>Include window shadow</guilabel> option is only enabled when either the <guilabel>Active Window</guilabel> mode or the <guilabel>Window Under Cursor</guilabel> mode is selected in the <guilabel>Area</guilabel> combo-box. Checking this option includes the window shadow in the screenshot, while unchecking it gives an image of the window without the shadow.</para> 0184 </listitem> 0185 <listitem> 0186 <para>The <guilabel>Capture the current pop-up only</guilabel> option is only enabled when the <guilabel>Window Under Cursor</guilabel> mode is selected in the <guilabel>Area</guilabel> combo-box. Checking this option captures only the popup menu under the cursor, without its parent window.</para> 0187 </listitem> 0188 <listitem> 0189 <para>The <guilabel>Quit after manual Save or Copy</guilabel> option will quit &spectacle; after any saving or copying operations. Note that a copied screenshot will only be retained if you are running a clipboard manager that accepts images. KDE Klipper can be configured in this manner by right-clicking on its icon, selecting <guilabel>Configure Clipboard...</guilabel>, and unchecking <guilabel>Ignore images</guilabel>.</para> 0190 </listitem> 0191 </itemizedlist> 0192 </sect2> 0193 </sect1> 0194 </chapter> 0195 0196 <chapter id="additional-functionality"> 0197 <title>Additional Functionality</title> 0198 0199 <sect1> 0200 <title>Buttons</title> 0201 0202 <para>There are some buttons located at the bottom of the &spectacle; window. Their functions are described below:</para> 0203 0204 <variablelist> 0205 <varlistentry> 0206 <term><guibutton>Help</guibutton></term> 0207 <listitem> 0208 <para>Gives you the common menu items described in the <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink> of the &kde; Fundamentals.</para> 0209 </listitem> 0210 </varlistentry> 0211 <varlistentry> 0212 <term><guibutton>Configure...</guibutton></term> 0213 <listitem> 0214 <para>Gives you access to &spectacle;'s Configure window where you can change the capture settings and default save location and filename.</para> 0215 </listitem> 0216 </varlistentry> 0217 <varlistentry> 0218 <term><guibutton>Annotate</guibutton></term> 0219 <listitem> 0220 <para>Opens an annotation editor window that offers various annotating tools:</para> 0221 <mediaobject> 0222 <imageobject> 0223 <imagedata fileref="Annotate.png" format="PNG"/> 0224 </imageobject> 0225 <textobject> 0226 <phrase>Annotation editor</phrase> 0227 </textobject> 0228 </mediaobject> 0229 <para> 0230 Give a try to the annotating tools. You might find everything that is needed to explain your screenshots there: arrows, pen, markers, text boxes, numbers, even smileys. It is possible to change the tool parameters and add effects (shadow, grayscale, and border). 0231 </para> 0232 <para> 0233 When you think that annotating is finished press the <guibutton>Annotation Done</guibutton> button. 0234 </para> 0235 </listitem> 0236 </varlistentry> 0237 <varlistentry> 0238 <term><guibutton>Tools</guibutton></term> 0239 <listitem> 0240 <para>Opens a drop-down menu which offers various tools:</para> 0241 <itemizedlist> 0242 <listitem> 0243 <para><guimenuitem>Open Default Screenshots Folder</guimenuitem> will highlight the last saved screenshot in the default file manager</para> 0244 </listitem> 0245 <listitem> 0246 <para>Access to the <guimenuitem>Print</guimenuitem> dialog</para> 0247 </listitem> 0248 <listitem> 0249 <para>A range of external programs for Screen Recording</para> 0250 </listitem> 0251 </itemizedlist> 0252 </listitem> 0253 </varlistentry> 0254 <varlistentry> 0255 <term><guibutton>Export</guibutton></term> 0256 <listitem> 0257 <para>Opens a drop-down menu that will allow you to directly open the screenshot with all programs that are associated with the PNG (Portable Network Graphics) &MIME; type. Depending on what programs are installed, you will be able to open and edit the snapshot in your graphics applications or viewers.</para> 0258 0259 </listitem> 0260 </varlistentry> 0261 <varlistentry> 0262 <term><guibutton>Copy Image to Clipboard/Copy Location to Clipboard</guibutton></term> 0263 <listitem> 0264 <para>Copies the current screenshot or its location to the clipboard. You can also use the <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> keyboard shortcut for this.</para> 0265 </listitem> 0266 </varlistentry> 0267 <varlistentry> 0268 <term><guibutton>Save As</guibutton></term> 0269 <listitem> 0270 <para>Saves the screenshot as a PNG image in your default Pictures folder and immediately exits the application.</para> 0271 </listitem> 0272 </varlistentry> 0273 </variablelist> 0274 </sect1> 0275 0276 <sect1> 0277 <title>Configure</title> 0278 <para>Use the <guibutton>Configure...</guibutton> button to open the configuration dialog.</para> 0279 <sect2> 0280 <title>General</title> 0281 <mediaobject> 0282 <imageobject> 0283 <imagedata fileref="ApplicationPreferences.png" format="PNG"/> 0284 </imageobject> 0285 <textobject> 0286 <phrase>General</phrase> 0287 </textobject> 0288 </mediaobject> 0289 <variablelist> 0290 <varlistentry> 0291 <term><guilabel>When launching Spectacle</guilabel></term> 0292 <listitem> 0293 <para>Allows to <guilabel>Take full screen screenshot</guilabel>, use last-used capture mode, or do not take a screenshot automatically. The last-used capture mode is the one set in Capture Mode</para> 0294 </listitem> 0295 </varlistentry> 0296 <varlistentry> 0297 <term><guilabel>After taking a screenshot</guilabel></term> 0298 <listitem> 0299 <para>Allows <guilabel>Save file to default folder</guilabel>, switching off any clipboard actions, copying the image to clipboard, or copying screenshot path to the clipboard. The default location can be configured using the <link linkend="save-page">Save</link> configuration page. It is possible to <guilabel>Copy file location to clipboard</guilabel>. You can then paste it anywhere that accepts text input. Note that you must be running a clipboard manager in order to keep the path in the clipboard after &spectacle; quits.</para> 0300 </listitem> 0301 </varlistentry> 0302 <varlistentry> 0303 <term><guilabel>Press screenshot key to</guilabel></term> 0304 <listitem> 0305 <para>When a shortcut to make screenshot is pressed and &spectacle; is already running it is possible to configure the behavior of the screenshoting system. You can choose between taking a new screenshot, opening of a new &spectacle; window, and returning focus to the existing &spectacle; window.</para> 0306 </listitem> 0307 </varlistentry> 0308 <varlistentry> 0309 <term><guilabel>Use light background</guilabel></term> 0310 <listitem> 0311 <para>Use a light background color to mask the cropped-out area in the rectangular region selector. This may make dark cursors easier to see.</para> 0312 </listitem> 0313 </varlistentry> 0314 <varlistentry> 0315 <term><guilabel>Show magnifier</guilabel></term> 0316 <listitem> 0317 <para>When a screenshot is saved, copy the location at which the file was saved to the clipboard. You can then paste it anywhere that accepts 0318 text input. Note that you must be running a clipboard manager in order to keep the path in the clipboard after &spectacle; quits.</para> 0319 </listitem> 0320 </varlistentry> 0321 <varlistentry> 0322 <term><guilabel>Accept on click-and-release</guilabel></term> 0323 <listitem> 0324 <para>If checked, accept the selected region as soon as the mouse button is released in the <guilabel>Rectangular Region</guilabel> mode.</para> 0325 <para>When selecting a new region, without a previously saved region available, clicking, dragging, and releasing the mouse button should immediately capture the selected region. When a previously saved region is shown, the saved region can be manipulated further and saving this region requires manual confirmation (&Enter; or double click with the &LMB;). Clicking and dragging outside of the previously saved region captures the newly selected region immediately.</para> 0326 </listitem> 0327 </varlistentry> 0328 <varlistentry> 0329 <term><guilabel>Remember selected area</guilabel></term> 0330 <listitem> 0331 <para>By default, &spectacle; remembers an initial selection when you take a screenshot of a rectangular region until you close the &spectacle; window. You can also choose to make &spectacle; never remember selected area or remember it between the screenshoting sessions.</para> 0332 </listitem> 0333 </varlistentry> 0334 </variablelist> 0335 </sect2> 0336 <sect2 id="save-page"> 0337 <title>Save</title> 0338 <para>When you use the <guilabel>Save</guilabel> function, &spectacle; saves the image with a default filename, in your Pictures folder (which is inside your home folder). The default filename includes the date and time when the image was taken.</para> 0339 0340 <para>The <guilabel>Save</guilabel> page allows you to set the default save location and filename. Clicking this option brings up a dialog box like the following: 0341 <mediaobject> 0342 <imageobject> 0343 <imagedata fileref="SaveOptions.png" format="PNG"/> 0344 </imageobject> 0345 <textobject> 0346 <phrase>Save</phrase> 0347 </textobject> 0348 </mediaobject> 0349 </para> 0350 <variablelist> 0351 <varlistentry> 0352 <term><guilabel>Save Location</guilabel></term> 0353 <listitem> 0354 <para>In the location text box set the folder where you'd like to save your screenshots when you press <guibutton>Save</guibutton>.</para> 0355 </listitem> 0356 </varlistentry> 0357 <varlistentry> 0358 <term><guilabel>Compression Quality</guilabel></term> 0359 <listitem> 0360 <para>Choose the image quality when saving with lossy image formats like JPEG. The higher values give better quality but increase the file size. See <ulink url="https://en.wikipedia.org/wiki/Image_file_formats">Wikipedia page</ulink> for the details on the image formats that are used in &spectacle;.</para> 0361 </listitem> 0362 </varlistentry> 0363 <varlistentry> 0364 <term><guilabel>Filename</guilabel></term> 0365 <listitem> 0366 <para>Set a default filename for saved screenshots.</para> 0367 <para>You can use the following placeholders in the filename, which will be replaced with actual text when the file is saved:</para> 0368 <itemizedlist> 0369 <listitem><para><userinput><dd></userinput>: Day</para></listitem> 0370 <listitem><para><userinput><hh></userinput>: Hour</para></listitem> 0371 <listitem><para><userinput><MM></userinput>: Month</para></listitem> 0372 <listitem><para><userinput><ss></userinput>: Second</para></listitem> 0373 <listitem><para><userinput><title></userinput>: Window title</para></listitem> 0374 <listitem><para><userinput><yyyy></userinput>: Year (4 digit)</para></listitem> 0375 <listitem><para><userinput><#></userinput>: Sequential number</para></listitem> 0376 <listitem><para><userinput><mm></userinput>: Minute</para></listitem> 0377 <listitem><para><userinput><yy></userinput>: Year (2 digit)</para></listitem> 0378 </itemizedlist> 0379 <para>You can click on placeholders in the reference list below to insert them into the <guilabel>Filename</guilabel> line.</para> 0380 <para>If a file with this name already exists, a serial number will be appended to the filename. For example, if the filename is <filename>Screenshot</filename>, and <filename>Screenshot.png</filename> already exists, the image will be saved as <filename>Screenshot-1.png</filename>.</para> 0381 <para>Use the drop-down box next to the text field to select the default image format for screenshots. See <ulink url="https://en.wikipedia.org/wiki/Image_file_formats">Wikipedia page</ulink> for the details on the image formats that are used in &spectacle;.</para> 0382 </listitem> 0383 </varlistentry> 0384 </variablelist> 0385 </sect2> 0386 <sect2> 0387 <title>Shortcuts</title> 0388 <para> 0389 This configuration page can be used to change the default shortcuts of &spectacle;. It is possible to configure shortcuts for starting &spectacle; and capturing different parts of your desktop. 0390 </para> 0391 </sect2> 0392 </sect1> 0393 0394 <sect1> 0395 <title>Drag and Drop</title> 0396 <para>A captured image can be dragged to another application or document. If the application is able to handle images, a copy of the full image is inserted there.</para> 0397 0398 <para>If you drag a screenshot into a file manager window, a dialog pops up where you can edit the filename and select the image format and the file will be inserted into the actual folder.</para> 0399 0400 <para>If you drag the screenshot to a text box, the path to the temporary saved file is inserted. This is useful for example to upload a screenshot through web forms or to attach screenshots into bug reports on the <ulink url="https://bugs.kde.org/">&kde; bugtracker</ulink>.</para> 0401 0402 <para>This works with all clients that do not pick up the image data, but only look for a &URL; in the dragged mimedata.</para> 0403 </sect1> 0404 </chapter> 0405 0406 <chapter id="credits"> 0407 <title>Credits and License</title> 0408 0409 <para>Program copyright © 2015 &Boudhayan.Gupta; &Boudhayan.Gupta.mail;.</para> 0410 0411 <para>Portions of the code are based directly on code from the &ksnapshot; project. Copyright © 1997-2011 The &ksnapshot; Developers. Detailed copyright assignment notices are available in the headers in the source code.</para> 0412 0413 <para>Portions of the code are based directly on code from the &kwin; project. Copyright © 2008, 2013 The &kwin; Developers. Detailed copyright assignment notices are available in the headers in the source code.</para> 0414 0415 <para>Documentation based on the original &ksnapshot; documentation:</para> 0416 0417 <itemizedlist> 0418 <listitem> 0419 <para>Copyright © 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;</para> 0420 </listitem> 0421 <listitem> 0422 <para>Copyright © 2000 &Matthias.Ettrich; &Matthias.Ettrich.mail;</para> 0423 </listitem> 0424 </itemizedlist> 0425 0426 <!-- TRANS:CREDIT_FOR_TRANSLATORS --> 0427 0428 &underFDL; 0429 &underGPL; 0430 </chapter> 0431 0432 &documentation.index; 0433 </book>