annotate doc/docbook/GuidePrinting.xml @ 1734:b92fc3c922ac

scripts for converting wiki documentation to docbook

<?xml version="1.0" encoding="utf-8"?>
<chapter id="GuidePrinting">
    <title>
      Printing
    </title>
    <para>
      To print an image press Shift + P or select Print from the File menu.
    </para>
    <para>
      The print dialog includes tabs that group related printing options, a preview pane, and a Print and Cancel button.
    </para>
    <para/><section id="Layouttab"><title>
      Layout tab
    </title>
    <variablelist><varlistentry><term>
        Source
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      This selects the group of images to use for print output.
    </para>
    <variablelist><varlistentry><term>
        Image
      </term><listitem><para>
        The file with the focus.
      </para></listitem></varlistentry><varlistentry><term>
        Selection
      </term><listitem><para>
        The files selected in the main window.
      </para></listitem></varlistentry><varlistentry><term>
        All
      </term><listitem><para>
        All files listed in the main window.
      </para></listitem></varlistentry></variablelist>
    <variablelist><varlistentry><term>
        Layout
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Select one image per page, or a Proof sheet that will print multiple images per page.
    </para>
    <variablelist><varlistentry><term>
        Image size
      </term><listitem><para>
        When print one image per page, the size of the image in relation to the available print area.
      </para></listitem></varlistentry><varlistentry><term>
        Proof size
      </term><listitem><para>
        When printing a Proof sheet, the size of each image in Units (see Paper tab).
      </para></listitem></varlistentry></variablelist>
    <para/></section><section id="Texttab"><title>
      Text tab
    </title>
    <variablelist><varlistentry><term>
        Name
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Include the file name below each image.
    </para>
    <variablelist><varlistentry><term>
        Path
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Include the full path of the file below each image.
    </para>
    <variablelist><varlistentry><term>
        Date
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Include the file date below each image.
    </para>
    <variablelist><varlistentry><term>
        Size
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Include the file size below each image.
    </para>
    <variablelist><varlistentry><term>
        Dimensions
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Include the source image's pixel width and height below each image.
    </para>
    <variablelist><varlistentry><term>
        Font size
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      The font size to use for the text description of each image, in points.
    </para>
    <para/></section><section id="Papertab"><title>
      Paper tab
    </title>
    <variablelist><varlistentry><term>
        Format
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      The size of the paper in the printer's paper tray. Many common sizes are provided, however if the paper size is not listed selected the Custom format and enter the paper size in Size below.
    </para>
    <variablelist><varlistentry><term>
        Size
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      The size of the selected paper format, in Units (below). These numbers can be changed when the paper Format is Custom.
    </para>
    <variablelist><varlistentry><term>
        Units
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Select the units for Geeqie to use when conveying measurements of length for paper size, margins, and images sizes to the user.
    </para>
    <variablelist><varlistentry><term>
        Orientation
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Select portrait or landscape print output.
    </para>
    <variablelist><varlistentry><term>
        Margins
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      These values specify the size of the paper edges not to be included in the print region, in Units (above).
    </para>
    <para/></section><section id="Printertab"><title>
      Printer tab
    </title>
    <variablelist><varlistentry><term>
        Destination
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Use this to select the destination of the print output.
    </para>
    <variablelist><varlistentry><term>
        Default printer
      </term><listitem><para>
        Prints to the system default printer.
      </para></listitem></varlistentry><varlistentry><term>
        Custom printer
      </term><listitem><para>
        Prints to the printer using the command defined in Custom printer (below).
      </para></listitem></varlistentry><varlistentry><term>
        Postscript file
      </term><listitem><para>
        Writes using the postscript format to named File (below).
      </para></listitem></varlistentry><varlistentry><term>
        Image file
      </term><listitem><para>
        Writes using the selected File format (below) to named File (below).
      </para></listitem></varlistentry></variablelist>
    <variablelist><varlistentry><term>
        Custom printer
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      The command to use when Destination is selected as Custom printer. For convenience, the drop down list includes printers available for use by the printing subsystem.
    </para>
    <variablelist><varlistentry><term>
        File
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      The file to use for output when Destination is Postscript file or Image file.
    </para>
    <variablelist><varlistentry><term>
        File format
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      The image format to use when Destination is Image file.
    </para>
    <variablelist><varlistentry><term>
        DPI
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Abbreviation for Dots Per Inch. When the Destination is a printer or postscript file, this defines the maximum DPI to use when outputting image data. For example if the Destination printer is only capable of 600 DPI, but the resulting image to print is 1200 DPI, Geeqie will scale the image down to 600 DPI before sending it to the printer. This can greatly reduce the size of a print job when printing Proof Sheets or very large images.
    </para>
    <para/></section><section id="Preview"><title>
      Preview
    </title>
    <para>
      The preview displays a small version of the output that will result with the current settings. The preview will update whenever a setting is changed that will effect the print output.
    </para>
    <para>
      The preview will indicate the number of pages that will be printed, to see a preview of a specific page change to that page by activating the left or right arrow buttons located below the preview.
    </para>
    <para>
      The size of the preview can be changed using the three zoom buttons located below the preview.
    </para>
    <para>
      The preview includes several reference lines that are <emphasis role="i">not included</emphasis> in the final print:
    </para>
    <variablelist><varlistentry><term>
        Reference grid
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Light gray lines that form a grid over the entire page, the spacing between these lines is dependent on the current measurement unit:
    </para>
    <variablelist><varlistentry><term>
        Inch
      </term><listitem><para>
        1 inch.
      </para></listitem></varlistentry><varlistentry><term>
        Points
      </term><listitem><para>
        72 points.
      </para></listitem></varlistentry><varlistentry><term>
        Centimeters or Millimeters
      </term><listitem><para>
        1 centimeter.
      </para></listitem></varlistentry></variablelist>
    <variablelist><varlistentry><term>
        Margins
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      Blue lines along each edge of the page represent the location of the print margins, the non-printable area of the page is also gray.
    </para>
    <variablelist><varlistentry><term>
        Proof sheet grid
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      When the layout is set to Proof sheet, each proof location is indicated with a red rectangle.
    </para>
    <para/></section><section id="Rememberprintsettings"><title>
      Remember print settings
    </title>
    <para>
      Enable this check box to retain the current settings as the default for the print dialog. This option only retains the settings when a print operation is started by activating the print button. In addition, only the settings relevant to the current print operation will be retained.
    </para>
    <para/></section><section id="Printbutton"><title>
      Print button
    </title>
    <para>
      Activate the print button to start the print job, the dialog will change to display the progress as images are sent to the selected print destination.
    </para>
    <para/></section><section id="Cancelbutton"><title>
      Cancel button
    </title>
    <para>
      Activate this button to close the print dialog, no printing will be performed.
    </para>
  <para/></section></chapter>