Changeset View
Changeset View
Standalone View
Standalone View
doc/index.docbook
Show First 20 Lines • Show All 140 Lines • ▼ Show 20 Line(s) | 140 | <listitem> | |||
---|---|---|---|---|---|
141 | <para>The <guilabel>Current Screen</guilabel> option takes a screenshot of the output that currently contains the mouse pointer.</para> | 141 | <para>The <guilabel>Current Screen</guilabel> option takes a screenshot of the output that currently contains the mouse pointer.</para> | ||
142 | </listitem> | 142 | </listitem> | ||
143 | <listitem> | 143 | <listitem> | ||
144 | <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> | 144 | <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> | ||
145 | </listitem> | 145 | </listitem> | ||
146 | <listitem> | 146 | <listitem> | ||
147 | <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> | 147 | <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> | ||
148 | 148 | | |||
149 | <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>Content Options</guilabel></para> | 149 | <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> | ||
150 | </listitem> | 150 | </listitem> | ||
151 | <listitem> | 151 | <listitem> | ||
152 | <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> | 152 | <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> | ||
153 | 153 | | |||
154 | <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> | 154 | <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> | ||
155 | </listitem> | 155 | </listitem> | ||
156 | </itemizedlist> | 156 | </itemizedlist> | ||
157 | 157 | | |||
158 | <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> | 158 | <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> | ||
159 | 159 | | |||
160 | <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> | 160 | <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> | ||
161 | </sect2> | 161 | </sect2> | ||
162 | 162 | | |||
163 | <sect2> | 163 | <sect2> | ||
164 | <title>Content Options</title> | 164 | <title>Options</title> | ||
165 | 165 | | |||
166 | <para>The content 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.</para> | 166 | <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> | ||
rkflx: "will quit": prepend "option" or remove "The"
Save or Copy → save or copy
Quit → Close? | |||||
167 | 167 | | |||
168 | <itemizedlist> | 168 | <itemizedlist> | ||
169 | <listitem> | 169 | <listitem> | ||
170 | <para>Enabling the <guilabel>Include mouse pointer</guilabel> checkbox includes an image of the mouse pointer in the screenshot.</para> | 170 | <para>Enabling the <guilabel>Include mouse pointer</guilabel> checkbox includes an image of the mouse pointer in the screenshot.</para> | ||
171 | </listitem> | 171 | </listitem> | ||
172 | <listitem> | 172 | <listitem> | ||
173 | <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> | 173 | <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> | ||
174 | </listitem> | 174 | </listitem> | ||
175 | <listitem> | 175 | <listitem> | ||
176 | <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> | 176 | <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> | ||
177 | </listitem> | 177 | </listitem> | ||
178 | <listitem> | ||||
179 | <para>The <guilabel>Quit after Save or Copy</guilabel> option will quit Spectacle after any saving or copying operations.</para> | ||||
"No context available", but please make sure to also replace all references to "Save & Exit" with the new option. rkflx: "No context available", but please make sure to also replace all references to "Save &… | |||||
Save or Copy → saving or copying? Quit → Close? (would help those not knowing what quitting is) rkflx: Save or Copy → saving or copying?
Quit → Close? (would help those not knowing what quitting is) | |||||
180 | </listitem> | ||||
178 | </itemizedlist> | 181 | </itemizedlist> | ||
179 | </sect2> | 182 | </sect2> | ||
180 | </sect1> | 183 | </sect1> | ||
181 | </chapter> | 184 | </chapter> | ||
182 | 185 | | |||
183 | <chapter id="additional-functionality"> | 186 | <chapter id="additional-functionality"> | ||
184 | <title>Additional Functionality</title> | 187 | <title>Additional Functionality</title> | ||
185 | 188 | | |||
Show All 31 Lines | 194 | <variablelist> | |||
217 | </varlistentry> | 220 | </varlistentry> | ||
218 | <varlistentry> | 221 | <varlistentry> | ||
219 | <term><guibutton>Copy To Clipboard</guibutton></term> | 222 | <term><guibutton>Copy To Clipboard</guibutton></term> | ||
220 | <listitem> | 223 | <listitem> | ||
221 | <para>This button copies the current screenshot to the clipboard. You can also use the <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> keyboard shortcut for this.</para> | 224 | <para>This button copies the current screenshot to the clipboard. You can also use the <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> keyboard shortcut for this.</para> | ||
222 | </listitem> | 225 | </listitem> | ||
223 | </varlistentry> | 226 | </varlistentry> | ||
224 | <varlistentry> | 227 | <varlistentry> | ||
225 | <term><guibutton>Save & Exit</guibutton></term> | 228 | <term><guibutton>Save & Exit</guibutton></term> | ||
rkflx: Instead of removing, adapt to {nav Save / Save As}. | |||||
226 | <listitem> | 229 | <listitem> | ||
227 | <para>Clicking this button saves the screenshot as a PNG image in your default Pictures folder and immediately exits the application.</para> | 230 | <para>Clicking this button saves the screenshot as a PNG image in your default Pictures folder and immediately exits the application.</para> | ||
228 | </listitem> | 231 | </listitem> | ||
229 | </varlistentry> | 232 | </varlistentry> | ||
230 | </variablelist> | 233 | </variablelist> | ||
231 | </sect1> | 234 | </sect1> | ||
232 | 235 | | |||
233 | <sect1> | 236 | <sect1> | ||
▲ Show 20 Lines • Show All 124 Lines • Show Last 20 Lines |
"will quit": prepend "option" or remove "The"
Save or Copy → save or copy
Quit → Close? (would help those not knowing what quitting is)