diff options
Diffstat (limited to 'help/C')
-rw-r--r-- | help/C/adf.page | 52 | ||||
-rw-r--r-- | help/C/crop.page | 45 | ||||
-rw-r--r-- | help/C/dpi.page | 57 | ||||
-rw-r--r-- | help/C/email.page | 24 | ||||
-rw-r--r-- | help/C/figures/icon.png | bin | 0 -> 1559 bytes | |||
-rw-r--r-- | help/C/figures/preferences.png | bin | 0 -> 14340 bytes | |||
-rw-r--r-- | help/C/figures/scan_toolbar.png | bin | 0 -> 11975 bytes | |||
-rw-r--r-- | help/C/index.page | 34 | ||||
-rw-r--r-- | help/C/legal.xml | 9 | ||||
-rw-r--r-- | help/C/print.page | 30 | ||||
-rw-r--r-- | help/C/reorder.page | 21 | ||||
-rw-r--r-- | help/C/rotate.page | 57 | ||||
-rw-r--r-- | help/C/save.page | 68 | ||||
-rw-r--r-- | help/C/scanner.page | 20 | ||||
-rw-r--r-- | help/C/scanning.page | 35 |
15 files changed, 452 insertions, 0 deletions
diff --git a/help/C/adf.page b/help/C/adf.page new file mode 100644 index 0000000..91886ce --- /dev/null +++ b/help/C/adf.page @@ -0,0 +1,52 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="adf"> + + <info> + <link type="guide" xref="index#acquire"/> + </info> + + <title>Using an Automatic Document Feeder</title> + + <p> + If your scanner features an Automatic Document Feeder (ADF) + you can scan all the pages from the feeder via one of following methods: + </p> + <steps> + <title></title> + <title>Use a Keyboard Shortcut</title> + <item> + <p>Press <keyseq><key>Ctrl</key><key>F</key></keyseq></p> + </item> + </steps> + + <steps> + <title>Use a Menu</title> + <item> + <p>Navigate to <guiseq><gui>Document</gui> + <gui>Scan</gui><gui>All Pages From Feeder</gui></guiseq>. + </p> + </item> + </steps> + + <steps> + <title>Use the Toolbar Buttons</title> + <item> + <p>Click on the arrow to the right of the "Scan" button.</p> + </item> + <item> + <p>Choose "All Pages From Feeder".</p> + <media type="image" src="figures/scan_toolbar.png"/> + </item> + </steps> + + + <note style="tip"> + <p> + By default, both sides of a sheet will scan if your scanner has this capability. + You can choose single side scanning from the <guiseq><gui>Document</gui><gui>Preferences</gui></guiseq> menu. + </p> + <media type="image" src="figures/preferences.png"/> + </note> + +</page> diff --git a/help/C/crop.page b/help/C/crop.page new file mode 100644 index 0000000..b65893e --- /dev/null +++ b/help/C/crop.page @@ -0,0 +1,45 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="crop"> + + <info> + <link type="guide" xref="index#modify"/> + </info> + + <title>Cropping</title> + + <p> + The cropping feature in <app>Simple Scan</app> allows you to use only a part of a scanned image. You can + enable crop either before or after scanning a page, and you can always change the dimensions of the crop + frame. When crop is enabled, a mask will apper over the current page with the area not being used shown + in gray. You can enable crop and choose the desired dimensions via one of the following methods: + </p> + + <steps> + <title>Use a Right Click</title> + <item><p>Right click anywhere on the image area and select "Crop".</p></item> + <item><p>Choose one of the fixed crop frames, or select "Custom" to manually + set the crop frame's dimensions by dragging its borders.</p></item> + <item><p>Click and hold the frame, then move it to the desired position.</p></item> + </steps> + + <steps> + <title>Use a Menu</title> + <item><p>Navigate to the <guiseq><gui>Page</gui><gui>Crop</gui></guiseq> menu.</p></item> + <item><p>Choose one of the fixed crop frames, or select "Custom" to manually adjust the frame's dimensions by dragging its borders.</p></item> + <item><p>Click and hold the frame, then move it to the desired position.</p></item> + </steps> + + <steps> + <title>Use the Toolbar</title> + <item><p>Click the "<gui>Crop</gui>" button in the toolbar.</p> + <note style="tip"><p>This is the same as choosing "Custom" in step 2 of the + aforementioned methods.</p></note></item> + <item><p>Drag the borders of the frame to set the desired dimensions and position.</p></item> + + </steps> + + <note><p> + Each new scanned page will use the previous crop. + </p></note> +</page> diff --git a/help/C/dpi.page b/help/C/dpi.page new file mode 100644 index 0000000..ea8deeb --- /dev/null +++ b/help/C/dpi.page @@ -0,0 +1,57 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="dpi"> + + <info> + <link type="guide" xref="index#acquire"/> + </info> + + <title>Setting the Scan Resolution</title> + + <p> + The default resolution for document type <gui><em>Text</em></gui> is 150 dpi (dots per inch) + and for document type <gui><em>Photo</em></gui> is 300 dpi. You can change these settings + from the <guiseq><gui>Document</gui><gui>Preferences</gui></guiseq> menu. + </p> + <media type="image" src="figures/preferences.png"/> + + <p>The available scanning resolutions for both document types (Text and Photo) are the same + and are listed in the following table:</p> + + <table frame="bottom left right" rules="rows cols" shade="rows"> + <tr> + <td><p><em>Text Resolution</em></p></td> + <td><p><em>Photo Resolution</em></p></td> + </tr> + <tr> + <td><p>75 dpi (draft)</p></td> + <td><p>75 dpi (draft)</p></td> + </tr> + <tr> + <td><p>150 dpi (default)</p></td> + <td><p>150 dpi</p></td> + </tr> + <tr> + <td><p>300 dpi</p></td> + <td><p>300 dpi (default)</p></td> + </tr> + <tr> + <td><p>600 dpi</p></td> + <td><p>600 dpi</p></td> + </tr> + <tr> + <td><p>1200 dpi (high resolution)</p></td> + <td><p>1200 dpi (high resolution)</p></td> + </tr> + <tr> + <td><p>2400 dpi</p></td> + <td><p>2400 dpi</p></td> + </tr> + </table> + + <note style="important"><p><gui><em>Text</em></gui> documents are always scanned in black + and white, while <gui><em>Photo</em></gui> documents are always scanned in color, at any + resolution!</p> + </note> + +</page> diff --git a/help/C/email.page b/help/C/email.page new file mode 100644 index 0000000..e918e84 --- /dev/null +++ b/help/C/email.page @@ -0,0 +1,24 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="email"> + + <info> + <link type="guide" xref="index#use"/> + </info> + + <title>Sending via Email</title> + + <p> + To email the current document use the <guiseq><gui>Document</gui><gui>Email</gui></guiseq> + menu (<keyseq><key>Ctrl</key><key>E</key></keyseq>). Your email program will be opened with + a new message containing the scanned document as an attachment. + </p> + <p> + If the document type was set to "Text" the email will have a PDF attachment for each page. + Conversely, if the document type was set to "Photo", the email will have a JPEG + attachment for each page. + </p> + <p> + See <link xref="save"/> for more information about file formats. + </p> +</page> diff --git a/help/C/figures/icon.png b/help/C/figures/icon.png Binary files differnew file mode 100644 index 0000000..8cfefc1 --- /dev/null +++ b/help/C/figures/icon.png diff --git a/help/C/figures/preferences.png b/help/C/figures/preferences.png Binary files differnew file mode 100644 index 0000000..fe3bbe1 --- /dev/null +++ b/help/C/figures/preferences.png diff --git a/help/C/figures/scan_toolbar.png b/help/C/figures/scan_toolbar.png Binary files differnew file mode 100644 index 0000000..7736d68 --- /dev/null +++ b/help/C/figures/scan_toolbar.png diff --git a/help/C/index.page b/help/C/index.page new file mode 100644 index 0000000..c9d8425 --- /dev/null +++ b/help/C/index.page @@ -0,0 +1,34 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="index"> + + <info> + <credit type="author"> + <name>Robert Ancell</name> + <email>robert.ancell@gmail.com</email> + </credit> + <credit type="author"> + <name>Ali Shtarbanov</name> + <email>ametedinov@gmail.com</email> + </credit> + <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude" /> + </info> + + <title><media type="image" src="figures/icon.png"/> Simple Scan Manual</title> + + <section id="acquire" style="2column"> + <title>Scanning Pages</title> + </section> + + <section id="modify" style="2column"> + <title>Modifying the Document</title> + </section> + + <section id="use" style="2column"> + <title>Using the Document</title> + </section> + + <section id="shortcuts" style="2column"> + <title>Simple Scan Shortcuts</title> + </section> +</page> diff --git a/help/C/legal.xml b/help/C/legal.xml new file mode 100644 index 0000000..86d6173 --- /dev/null +++ b/help/C/legal.xml @@ -0,0 +1,9 @@ +<license xmlns="http://projectmallard.org/1.0/" + href="http://creativecommons.org/licenses/by-sa/3.0/"> +<p>This work is licensed under a +<link href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons +Attribution-Share Alike 3.0 Unported License</link>.</p> +<p>As a special exception, the copyright holders give you permission to copy, +modify, and distribute the example code contained in this document under the +terms of your choosing, without restriction.</p> +</license> diff --git a/help/C/print.page b/help/C/print.page new file mode 100644 index 0000000..5c7794a --- /dev/null +++ b/help/C/print.page @@ -0,0 +1,30 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="print"> + + <info> + <link type="guide" xref="index#use"/> + </info> + + <title>Printing</title> + + <p> + <app>Simple Scan</app> allows you print a scanned document directly from the its + interface, without having to save the document first. This feature makes <app>Simple + Scan</app> a very convenient tool for making copies of documents or photos. + </p> + <steps> + <title>To Print a Document</title> + <item> + <p>Go to the <guiseq><gui>Document</gui><gui>Print</gui> + </guiseq> menu or use the keyboard shortcut <keyseq><key>Ctrl</key><key>P</key></keyseq>. + This will open the "Print" dialog box. + </p> + </item> + <item> + <p>From the "Print" dialog box choose your desired printing settings and/or Print Preview + the document, then press the "Print" button. + </p> + </item> + </steps> +</page> diff --git a/help/C/reorder.page b/help/C/reorder.page new file mode 100644 index 0000000..f816acb --- /dev/null +++ b/help/C/reorder.page @@ -0,0 +1,21 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="reorder"> + + <info> + <link type="guide" xref="index#modify"/> + </info> + + <title>Reordering Pages</title> + + <p> + To move a page, right click on it and choose <gui><em>Move Left</em></gui> or + <gui><em>Move Right</em></gui>. + </p> + + <p> + Alternatively, you can move a page by first selecting it and then choosing + <gui><em>Move Left</em></gui> or <gui><em>Move Right</em></gui> from the "Page" menu. + </p> + +</page> diff --git a/help/C/rotate.page b/help/C/rotate.page new file mode 100644 index 0000000..b64c69f --- /dev/null +++ b/help/C/rotate.page @@ -0,0 +1,57 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="rotate"> + + <info> + <link type="guide" xref="index#modify"/> + </info> + + <title>Rotating a Page</title> + + <p> + In <app>Simple Scan</app>, you can change the rotation of a page either before or after scanning the page. + Currently, there are four ways to rotate a page: + </p> + + <steps> + <title>Use Toolbar Buttons</title> + <item><p>Select the page you want to rotate by clicking on it once.</p></item> + <item><p>Press one of the arrows on the toolbar to rotate the page in the desired direction.</p></item> + </steps> + <steps> + <title>Use Right Click</title> + <item><p>Right click on the page you want to rotate.</p></item> + <item><p>From the context menu choose "Rotate Left" or "Rotate Right".</p></item> + </steps> + + <steps> + <title>Use a Menu</title> + <item><p>Select the page you want to rotate by clicking on it once.</p></item> + <item><p>Click the "Page" menu and select "Rotate Left" or "Rotate Right".</p></item> + </steps> + + <steps> + <title>Use Shortcuts</title> + <item><p>Select the page you want to rotate by clicking on it once.</p></item> + <item><p>Press one of the following shortcut keys:</p> + <table frame="bottom left right" rules="rows cols" shade="rows"> + <tr> + <td><p><em>Command</em></p></td> + <td><p><em>Shortcut Key</em></p></td> + </tr> + <tr> + <td><p>Rotate Left</p></td> + <td><p><key>[</key> (left bracket)</p></td> + </tr> + <tr> + <td><p>Rotate Right</p></td> + <td><p><key>]</key> (right bracket)</p></td> + </tr> + </table> + </item> + </steps> + + <note><p> + Each new scanned page will use the previous rotation. + </p></note> +</page> diff --git a/help/C/save.page b/help/C/save.page new file mode 100644 index 0000000..575c36a --- /dev/null +++ b/help/C/save.page @@ -0,0 +1,68 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="save"> + + <info> + <link type="guide" xref="index#use"/> + </info> + + <title>Saving to a File</title> + + <steps> + <item> + <p>Navigate to the <guiseq><gui>Document</gui><gui>Save As</gui></guiseq> menu + (or press <keyseq><key>Shift</key><key>Ctrl</key><key>S</key></keyseq>). + </p> + </item> + <item> + <p>From the "Save As" dialog box, choose one of the supported file + types, or simply change the extension in the "Name" field. + </p> + </item> + <item> + <p>Press the "Save" button.</p> + </item> + </steps> + + +<table frame="bottom left right top" rules="rows cols" shade="rows"> + <title>Supported File Types</title> + <tr> + <td><p><em>Type</em></p></td> + <td><p><em>Brief Description</em></p></td> + </tr> + <tr> + <td><p>PDF</p></td> + <td><p>A PDF can contain multiple pages, like a book, and is easy to distribute. Only a small number + of linux programs can modify PDF documents, so this format is recommended primarily for archiving. + See the <link href="http://en.wikipedia.org/wiki/pdf">PDF Wiki page</link> for more information. + </p></td> + </tr> + <tr> + <td><p>JPEG</p></td> + <td><p>JPEG is the file format used by digital cameras to save pictures. A JPEG file is relatively + small, very easy to distribute, and suitable for uploading to social networking sites. Most operating + systems come with a JPEG editor by default. If you have scanned multiple pages, a JPEG file will be + created for each page. Use this file type if you want to modify or upload the scanned images. + See the <link href="http://en.wikipedia.org/wiki/jpeg">JPEG Wiki page</link> for more information. + </p></td> + </tr> + <tr> + <td><p>PNG</p></td> + <td><p>PNG files contain the raw data from the scanner. This makes them very large and not suitable + for distributing. If you have scanned multiple pages, a PNG file will be created for each page. + See the <link href="http://en.wikipedia.org/wiki/Portable_Network_Graphics">PNG Wiki page</link> + for more information. + </p></td> + </tr> + <tr> + <td><p>TIFF</p></td> + <td><p>TIFF files contain the raw data from the scanner. This makes them very large and not suitable + for distributing. If you have scanned multipe pages, a TIFF file will be created for each page. + See the <link href="http://en.wikipedia.org/wiki/Tagged_Image_File_Format">TIFF Wiki page</link> + for more information. + </p></td> + </tr> + +</table> +</page> diff --git a/help/C/scanner.page b/help/C/scanner.page new file mode 100644 index 0000000..3762cc1 --- /dev/null +++ b/help/C/scanner.page @@ -0,0 +1,20 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="scanner"> + + <info> + <link type="guide" xref="index#acquire"/> + </info> + + <title>Selecting a Scanner</title> + + <p> + If you have multiple scanning devices you can change the selected device from the <guiseq><gui>Document</gui><gui>Preferences</gui></guiseq> menu. + </p> + <media type="image" src="figures/preferences.png"/> + <p> + Your local scanners are automatically detected each time you start <app>Simple Scan</app> + and each time you plug in a USB scanner. If you connect a network scanner while <app>Simple Scan</app> + is running, you will need to restart <app>Simple Scan</app> for the scanner to be detected. + </p> +</page> diff --git a/help/C/scanning.page b/help/C/scanning.page new file mode 100644 index 0000000..c48a99d --- /dev/null +++ b/help/C/scanning.page @@ -0,0 +1,35 @@ +<page xmlns="http://projectmallard.org/1.0/" + type="guide" + id="scanning"> + + <info> + <title type="sort">0</title> + <link type="guide" xref="index#acquire"/> + </info> + + <title>Scanning a Page</title> + + <p> + To scan a document from your scanner: + </p> + <steps> + <item><p>Connect the scanner to your computer and power it on.</p></item> + <item><p>Open <app>Simple Scan</app>.</p></item> + <item><p>Click the arrow to the right of the "Scan" button and choose the type + of document you are scanning: <em>Photo</em> or <em>Text</em>.</p> + <media type="image" src="figures/scan_toolbar.png"/></item> + <item><p>Click the "Scan" button on the toolbar (or press <keyseq><key>Ctrl</key><key>1</key></keyseq>).</p></item> + </steps> + + <note><p> + The page will be shown as it is scanned. To stop the scan at any time press the <key>Esc</key> + key on the keyboard. Each page you scan is placed at the end of the document. + </p></note> + + <p> + The document type can be also be changed from the <guiseq><gui>Document</gui> + <gui>Scan</gui></guiseq> menu. Choose <gui><em>Text</em></gui> if you want the document + to be quickly scanned in black and white; choose <gui><em>Photo</em></gui> for a high + resolution color scan. See <link xref="dpi"/> for more details and more options. + </p> +</page> |