
<section id='NMPlot_PrintingPlots_id' webfilename='print'>
    <title>
        Printing Plots
    </title>
    <para>
        NMPlot lets you print any plot. You can choose a scale to print
        the plot at, and add a detailed legend.
    </para>
    <section>
        <title>
            Print Dialog Box
        </title>
        <para>
            To print a plot, you can:
        </para>
        <unorderedlist>
            <listitem>
                <para>
                    Choose <menutext>Print</menutext> from the <menutext>File</menutext>
                    menu
                </para>
            </listitem>
            <listitem>
                <para>
                    Press the Print toolbar button <img
                    src='intres:WCF_PrintToolbarButtonBitmap'/>
                </para>
            </listitem>
            <listitem>
                <para>
                    Press <keytext>Ctrl + P</keytext>
                </para>
            </listitem>
        </unorderedlist>
        <para>
            The standard Microsoft Windows Print dialog box appears.
        </para>
        <exhibit>
            <img src='WC_PrintDialogBox_ScreenCap.png'/>
        </exhibit>
        <para>
            The exact appearance of this dialog box will vary, depending on
            the version of Windows you are using. However, all versions let
            you choose a printer. Familiarity with this dialog box is assumed.
            Choose a printer, and press OK. Your plot is sent to the selected
            printer.
        </para>
    </section>
    [-include "WC_PageSetupDialogBox_Section.rxl"-]
    <section id='NMPlot_PrintOptionsDialogBox_id'>
        <title>
            Print Options
        </title>
        <para>
            Choose <menutext>Print Options</menutext> from the <menutext>File</menutext>
            menu to display the Print Options dialog box. Use it to control
            how plots are printed.
        </para>
        <exhibit>
            <img src='NMPlot_ScreenCap_PrintOptionsDialogBox.png'/>
        </exhibit>
        <para>
            The Print Options dialog box is a Multiple Page dialog box. See
            <iref target='WCF_MultiplePageDialogBoxes_id'/> for more information.
        </para>
        <section id='NMPlot_PrintOptionsDialogBox_Scale_id'>
            <title>
                Scale
            </title>
            <para>
                Use the Scale page of the <link
                target='#NMPlot_PrintOptionsDialogBox_id'>Print Options dialog
                box</link> to set the scale at which a plot is printed.
            </para>
            <exhibit>
                <img src='NMPlot_ScreenCap_PrintOptions_Scale.png'/>
            </exhibit>
            <para>
                Select how the scale is determined.
            </para>
            <unorderedlist>
                <listitem>
                    <para>
                        <italic>Automatically select the scale at which the plot is printed</italic>
                        - NMPlot selects a scale so that the plot's area of interest just
                        fills the paper's margins when printed. The area of interest is
                        specified on the Area To Print page. See <iref
                        target='NMPlot_PrintOptionsDialogBox_AreaToPrint_id'/>.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <italic>Print the plot at a scale of</italic> - Specify the scale
                        at which the plot is printed.
                    </para>
                </listitem>
            </unorderedlist>
        </section>
        <section id='NMPlot_PrintOptionsDialogBox_AreaToPrint_id'>
            <title>
                Area to Print
            </title>
            <para>
                Use the Area To Print page of the <link
                target='#NMPlot_PrintOptionsDialogBox_id'>Print Options dialog
                box</link> to select the portion of your plot that is printed.
            </para>
            <exhibit>
                <img src='NMPlot_ScreenCap_PrintOptions_AreaToPrint.png'/>
            </exhibit>
            <para>
                Select the area to print. You have two choices.
            </para>
            <unorderedlist>
                <listitem>
                    <para>
                        <italic>Print the home view</italic> - The home view of the plot
                        is printed. See <iref target='WCGISxWCF_HomeView_id'/> for more
                        information about the home view.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <italic>Print the area currently displayed on the screen</italic>
                        - The portion of the plot currently displayed on your computer's
                        monitor is printed. If you want to print only a small portion
                        of your plot, zoom in on that section, then print the plot, choosing
                        to print the area currently displayed on the screen.
                    </para>
                </listitem>
            </unorderedlist>
            <note
            id='NMPlot_PrintOptionsDialogBox_AreaToPrint_AspectRatioNote_id'
            type='note'>
                <para>
                    If the Area to Print is not the same shape as the paper on which
                    a plot is printed (i.e., if the aspect ratios are different),
                    the area printed will be larger that the area requested. For example,
                    if you select an Area to Print that is square, and then print
                    on paper that is tall and narrow, the requested square area will
                    fill the paper to the left and right margins. In addition, a portion
                    of the plot beyond the area requested will appear at the top and
                    bottom of the paper.
                </para>
                <exhibit>
                    <img src='NMPlot_Figure_AreaToPrintVersesPaperShape.png'
                    standard_colors='true'/>
                </exhibit>
            </note>
            <note type='note'>
                <para>
                    If you print a plot to scale, NMPlot attempts to display the Area
                    To Print at the requested scale. If the requested scale is too
                    large, this area will not fit on the paper. In this case, you
                    have three options: 1) choose a smaller scale, 2) choose a smaller
                    Area To Print, or 3) print to a larger sheet of paper.
                </para>
            </note>
        </section>
        <section id='NMPlot_PrintOptionsDialogBox_LevelOfDetail_id'>
            <title>
                Level of Detail
            </title>
            <para>
                Use the Level Of Detail page of the <link
                target='#NMPlot_PrintOptionsDialogBox_id'>Print Options dialog
                box</link> to control how much background map detail is displayed
                when you print a plot.
            </para>
            <exhibit>
                <img src='NMPlot_ScreenCap_PrintOptions_LevelOfDetail.png'/>
            </exhibit>
            <para>
                Many background maps specify a minimum scale at which various
                features should be displayed. As you zoom in on such a map, additional
                detail is displayed. The intent is to prevent excessive detail
                from cluttering a plot when it is displayed at a small scale.
                See <iref target='WCGIS_BackgroundMapFormats_id'/>.
            </para>
            <para>
                Use the Level of Detail page to control how NMPlot uses this recommended
                scale information when you print a plot. You have four choices
                for how NMPlot determines how much detail to display.
            </para>
            <unorderedlist>
                <listitem>
                    <para>
                        <italic>Print the plot with a level of detail appropriate for
                        the scale at which the plot is printed</italic> - Any recommended
                        scale information in the background map is used.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <italic>Print the plot with the level of detail currently displayed
                        on the screen</italic> - The level of detail is the same as that
                        currently displayed by the plot on your computer's monitor.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <italic>Print the plot with all details displayed</italic> - Any
                        recommended scale information in the background map is ignored.
                    </para>
                    <note type='caution'>
                        <para>
                            This may display so much background map detail as to make the
                            plot illegible.
                        </para>
                    </note>
                </listitem>
                <listitem>
                    <para>
                        <italic>Print the plot with a level of detail appropriate for
                        display at a scale of</italic> - The level of detail is the same
                        as if the plot was being printed at a scale you specify.
                    </para>
                </listitem>
            </unorderedlist>
        </section>
    </section>
    <section id='NMPlot_PlotOptions_Legend_id'>
        <title>
            Legends
        </title>
        <para>
            When printing a plot, you can add a legend that displays information
            about the plot.
        </para>
        <exhibit>
            <img src='NMPlot_PlotOptions_Legend_Figure.png'
            standard_colors='true'/>
        </exhibit>
        <para>
            You have full control over the appearance and content of the legend.
            The legend can have multiple fonts, colors, and borders. Text
            can be segregated into outlined rectangular areas, much like an
            architectural blueprint legend. A graphical scale and north arrow
            are supported.
        </para>
        <para>
            To change the legend, display the Legend page of the <link
            target='#NMPlot_PlotOptionsDialogBox_id'>Plot Options dialog box</link>.
        </para>
        <exhibit>
            <img src='NMPlot_PlotOptions_Legend_ScreenCap.png'/>
        </exhibit>
        <para>
            A sample of the current legend is displayed.
        </para>
        <para>
            Press the Edit Legend button to edit the legend. The Edit Legend
            dialog box is displayed. See <iref
            target='WCFORM_EditingForms_id'/> for information on editing legends.
        </para>
        <para>
            Creating a legend from scratch involves a significant amount of
            work. Therefore, NMPlot gives you the ability to save and load
            legends to and from files. The intent is that you will create
            a small number of legends, and then reuse them as needed.
        </para>
        <para>
            Press the Save Legend To File button to write the current legend
            to a file. Press the Load Legend From File button to read a previously
            saved legend.  In both cases, you will be asked for the file's name.
        </para>
        <para>
            NMPlot is distributed with several ready-to-use legends. These
            legends are stored in files that have the extension <filetext>.nmplot_legend</filetext>,
            and are located in the same directory as the NMPlot program file,
            <filetext>NMPlot.exe</filetext>. If you do not wish to go to the
            trouble of learning how to edit legends, you can simply use one
            of these ready-to-use legends.
        </para>
        <note type='tip'>
            <para>
                If you intend to create your own legend, you may wish to start
                with one of the ready-to-use legends included with NMPlot, and
                then edit it incrementally. You will likely find this easier than
                creating a new legend from scratch.
            </para>
        </note>
    </section>
    [-include "WCFORM_EditDialogBox_Section.rxl"
      EditFormDialogBoxScreenCapImg="<img src='NMPlot_EditFormDialogBox_ScreenCap.png'/>"
      EditFormDialogBox_Text_SymbolsIntroduction="[-include 'NMPlot_EditFormDialogBox_Text_SymbolsIntroduction.rxl'-]"
  -]
</section>
