
[-defdefine TermUsedForMap "map"-]
[-defdefine TermUsedForMap_InitialLettersUppercase "Map"-]
[-defdefine Note_AreaToDrawDifferentShapeNote_ExtraText-]
[-defdefine JPEG_ExampleOfWhenToUse " (for example, a &TermUsedForMap; with an aerial photograph for the background)"-]
[-defdefine JPEG_ExampleOfException-]
[-defdefine TrueColorExtraText-]
[-defdefine ExportToBitmapMenuCommandName 'Export to Bitmap'-]
[-defdefine InsureMapHasKeyboardFocusPhrase ''-]
<section id='WCGIS_ExportingMapsAsBitmaps_id'
webfilename='exportingasbitmap'>
    <title>
        Exporting &TermUsedForMap_InitialLettersUppercase;s as Bitmap
        Images
    </title>
    <para>
        Using &app_name;, you can create a bitmap image of a &TermUsedForMap;.
        The image can be stored in a file or copied onto the clipboard.
        More than a mere screen capture, the image can be created at a
        high resolution (for example, 600 pixels per inch), resulting
        in a publication-quality image. For low-resolution &TermUsedForMap;s
        that will be displayed on a computer monitor, you can use oversampling
        to improve the &TermUsedForMap;'s appearance.
    </para>
    <section id='WCGIS_ExportingMapsAsBitmaps_ToBitmapFile_id'>
        <title>
            Exporting a &TermUsedForMap_InitialLettersUppercase; to a Bitmap
            Image File
        </title>
        <para>
            To export a &TermUsedForMap; to a bitmap image file, choose <menutext>&ExportToBitmapMenuCommandName;</menutext>
            from the <menutext>File</menutext> menu. The Bitmap File Export
            Options dialog box appears.
        </para>
        <exhibit>
            <img
            src='WCGISxWCF_ExportingMapsAsBitmapImages_BitmapExportOptionsDialogBox_ScreenCap.png'/>
        </exhibit>
        <para>
            The Bitmap File Export Options dialog box is a Multiple Page dialog
            box. See <iref target='WCF_MultiplePageDialogBoxes_id'/> for more
            information.
        </para>
    </section>
    <section
    id='WCGIS_ExportingMapsAsBitmaps_CopyingMapsToClipboard_id'>
        <title>
            Copying a &TermUsedForMap_InitialLettersUppercase; to the Clipboard
        </title>
        <para>
            To copy a bitmap image of a &TermUsedForMap; onto the clipboard,
            &InsureMapHasKeyboardFocusPhrase; choose <menutext>Copy</menutext>
            from the <menutext>Edit</menutext> menu, or press <keytext>Ctrl
            + C</keytext>. The Clipboard Copy Options dialog box appears.
            This dialog box is identical to the <link
            target='#WCGIS_ExportingMapsAsBitmaps_ToBitmapFile_id'>Bitmap
            File Export Options dialog box</link>, with the exception that
            the page used to specify the destination file and format is not
            present.
        </para>
        <para>
            In this chapter, only the Bitmap File Export Options dialog box
            will be discussed. Keep in mind, however, that the options described
            also apply when a &TermUsedForMap; is copied to the clipboard.
        </para>
    </section>
    <section
    id='WCGIS_ExportingMapsAsBitmaps_Options_FileNameAndFormat_id'>
        <title>
            Destination File Name and Format
        </title>
        <para>
            Use the File page of the <link
            target='#WCGIS_ExportingMapsAsBitmaps_ToBitmapFile_id'>Bitmap
            File Export Options dialog box</link> to set the name and format
            of the file where the bitmap image is written.
        </para>
        <exhibit>
            <img
            src='WCGISxWCF_ExportingMapsAsBitmapImages_FileNameAndFormat_ScreenCap.png'/>
        </exhibit>
        <para>
            In the box provided, type the name of file where the bitmap image
            will be written. Press the Browse button <img
            src='WCF_ThreeDotsButton_Figure.png'/>, located to the right of
            the text box, to display the Open File dialog box, which allows
            you to browse for the file.
        </para>
        <para>
            Select the image format of the file. You have the following choices.
        </para>
        <unorderedlist>
            <listitem>
                <para>
                    BMP - Microsoft Windows Bitmap Format
                </para>
            </listitem>
            <listitem>
                <para>
                    GIF - GIF Format
                </para>
            </listitem>
            <listitem>
                <para>
                    JPG - JPEG Format
                </para>
            </listitem>
            <listitem>
                <para>
                    TIF - Tagged Image File Format (TIFF)
                </para>
            </listitem>
            <listitem>
                <para>
                    PNG - Portable Network Graphics Format
                </para>
            </listitem>
        </unorderedlist>
        <section>
            <title>
                JPEG Options
            </title>
            <para>
                If you select the JPEG format, the Options button will be available.
                Press it to display the JPEG Options dialog box.
            </para>
            <exhibit>
                <img src='WCIMGIOxWCF_SaveImageOptions_JPG_ScreenCap.png'/>
            </exhibit>
            <para>
                Type the image quality number, an integer between 1 and 100. The
                Image Quality number controls the tradeoff between compression
                and image quality in JPEG images. A value of 100 produces the
                highest quality image, but also results in the largest file size.
                Conversely, a value of 1 produces the smallest file size, but
                also results in a severely degraded image.
            </para>
        </section>
        <section>
            <title>
                Selecting an Image Format
            </title>
            <para>
                The JPEG format is intended for storing photographs. Most &TermUsedForMap;s
                are line images, so one of the other image formats will usually
                be a better choice. However, if your &TermUsedForMap; has areas
                of smoothly-changing color&JPEG_ExampleOfWhenToUse;, JPEG will
                be the best format.
            </para>
            <para>
                Neither the BMP nor the TIFF formats are compressed, so they will
                produce large files. However, both are very common formats. The
                BMP format, in particular, is very well supported on the Microsoft
                Windows platform. If you intend to import your image into another
                program, the BMP format is an excellent choice.
            </para>
            <para>
                If you intend to archive the image, or display it on the web,
                the PNG format is a good choice. It achieves high compression
                on most &TermUsedForMap;s&JPEG_ExampleOfException;. It is a newer
                format than the others, but most applications (and in particular,
                most web browsers) now support it.
            </para>
        </section>
    </section>
    <section
    id='WCGIS_ExportingMapsAsBitmaps_Options_ImageSize_id'>
        <title>
            Image Size
        </title>
        <para>
            Use the Image Size page of the <link
            target='#WCGIS_ExportingMapsAsBitmaps_ToBitmapFile_id'>Bitmap
            File Export Options dialog box</link> to select the size, resolution,
            and color depth of the bitmap image you will export your &TermUsedForMap;
            to.
        </para>
        <exhibit>
            <img
            src='WCGISxWCF_ExportingMapsAsBitmapImages_ImageSize_ScreenCap.png'/>
        </exhibit>
        <section
        id='WCGIS_ExportingMapsAsBitmaps_Options_ColorDepth_id'>
            <title>
                Image Color Depth
            </title>
            <para>
                Select the color depth of the bitmap image. This is the maximum
                number of colors in the bitmap. You have the following choices.
            </para>
            <unorderedlist>
                <listitem>
                    <para>
                        <italic>24-bit Color (True Color)</italic> - Each pixel in the
                        bitmap requires 24 bits (3 bytes) of memory. The bitmap can display
                        over 16,000,000 colors. &TrueColorExtraText;
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <italic>8-bit Color, Optimized Palette</italic> - Each pixel in
                        the bitmap requires 8 bits (1 byte) of memory. The bitmap can
                        display 256 colors. The 256 colors are selected so that they best
                        represent the colors in your &TermUsedForMap;. This color depth
                        requires one-third the memory of 24-bit color. Many &TermUsedForMap;s
                        can be reduced to 256 colors with little loss in quality.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <italic>8-bit Color, Web Palette</italic> - Each pixel in the
                        bitmap requires 8 bits (1 byte) of memory. The bitmap can display
                        256 colors. The 256 colors are those that all web browsers can
                        display without dithering. This color depth requires one-third
                        the memory of 24-bit color, but the image quality can be poor
                        unless you carefully select the colors in your &TermUsedForMap;.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <italic>8-bit Grayscale</italic> - Each pixel in the bitmap requires
                        8 bits (1 byte) of memory. The bitmap can display 256 shades of
                        gray. This color format is useful if the bitmap will be printed
                        on black-and-white laser printers.
                    </para>
                </listitem>
            </unorderedlist>
        </section>
        <section>
            <title>
                Image Size
            </title>
            <para>
                Select the method used to specify the dimensions of the bitmap
                image (i.e., the width and height of the bitmap, in pixels) that
                your &TermUsedForMap; will be exported to. You have two choices.
            </para>
            <unorderedlist>
                <listitem>
                    <para>
                        <italic>Image is the same size as the image on the screen</italic>
                        - The bitmap image has the same dimensions (in pixels) as the
                        portion of the screen currently used to display the &TermUsedForMap;.
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <italic>Image size is</italic> - Type the width and height of
                        the bitmap image, in pixels.
                    </para>
                </listitem>
            </unorderedlist>
            <note type='caution'>
                <para>
                    Your computer's memory limits the maximum size and color depth
                    of an export bitmap image. If your computer takes an exceptionally
                    long time to export a &TermUsedForMap; to a bitmap, you may not
                    have enough memory. This is especially true if your hard drive
                    light stays on constantly while creating the image. Try reducing
                    the image's size and/or color depth.
                </para>
                <para>
                    The image's resolution does not affect the amount of memory used.
                </para>
            </note>
        </section>
        <section>
            <title>
                Image Resolution
            </title>
            <para>
                The resolution of a bitmap measures the size of the pixels. It
                is typically expressed in pixels per inch or pixels per centimeter.
            </para>
            <para>
                As an example, assume that your &TermUsedForMap; has features
                that are drawn with 1-millimeter-wide lines. If you export this
                &TermUsedForMap; to a bitmap image with a resolution of 100 pixels
                per centimeter, these lines will be 10 pixels wide.
            </para>
            <para>
                Computer monitors typically have a resolution of 70 to 90 pixels
                per inch. Laser printers typically have a resolution of 600 to
                1200 pixels per inch.
            </para>
            <para>
                Select the method used to specify the image resolution. You have
                two choices.
            </para>
            <unorderedlist>
                <listitem>
                    <para>
                        <italic>Image has same resolution as the screen</italic>
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <italic>Image resolution is</italic> - Type the resolution, in
                        pixels per inch.
                    </para>
                </listitem>
            </unorderedlist>
        </section>
    </section>
    <section
    id='WCGIS_ExportingMapsAsBitmaps_Options_Oversampling_id'>
        <title>
            Oversampling
        </title>
        <para>
            &app_name; can use oversampling to improve the appearance of low-resolution
            &TermUsedForMap;s. Oversampling reduces jagged edges. In technical
            terms, it antialiases your entire &TermUsedForMap;.
        </para>
        <para>
            The amount of oversampling is controlled by the <termtext>oversampling
            factor</termtext>, an integer between one and eight. An oversampling
            factor of one means that oversampling is not performed. Higher
            factors result in smoother, higher-quality images, but also dramatically
            increase the amount of memory required to export a &TermUsedForMap;.
        </para>
        <exhibit>
            <img
            src='WCGISxWCF_ExportingMapsAsBitmapImages_Oversampling_Example_ScreenCap.png'
            standard_colors='true'/>
        </exhibit>
        <para>
            Use the Oversampling page of the <link
            target='#WCGIS_ExportingMapsAsBitmaps_ToBitmapFile_id'>Bitmap
            File Export Options dialog box</link> to set the oversampling
            factor used when exporting a &TermUsedForMap; to a bitmap image.
        </para>
        <exhibit>
            <img
            src='WCGISxWCF_ExportingMapsAsBitmapImages_Oversampling_ScreenCap.png'/>
        </exhibit>
        <para>
            Type the oversampling factor in the box provided.
        </para>
        <para>
            When using oversampling, you should choose 24-bit true color or
            8-bit grayscale color for your image. See <iref
            target='WCGIS_ExportingMapsAsBitmaps_Options_ColorDepth_id'/>.
        </para>
        <note type='caution'>
            <para>
                Oversampling dramatically increases the amount of memory needed
                to export a &TermUsedForMap; to a bitmap image. The amount of
                memory required is proportional to the square of the oversampling
                factor.
            </para>
            <para>
                Until you gain familiarity with your computer's capabilities,
                it is recommended that you initially export your &TermUsedForMap;
                with a low oversampling factor, and then attempt to export it
                with gradually increasing factors. If your computer takes an exceptionally
                long time to export a &TermUsedForMap;, you may not have enough
                memory. This is especially true if your hard drive light stays
                on constantly while exporting. Try reducing the oversampling factor.
            </para>
        </note>
    </section>
    <section
    id='WCGIS_ExportingMapsAsBitmaps_Options_AreaToDraw_id'>
        <title>
            Area to Draw
        </title>
        <para>
            Use the Area To Draw page of the <link
            target='#WCGIS_ExportingMapsAsBitmaps_ToBitmapFile_id'>Bitmap
            File Export Options dialog box</link> to select the portion of
            your &TermUsedForMap; that is drawn on the exported bitmap image.
        </para>
        <exhibit>
            <img
            src='WCGISxWCF_ExportingMapsAsBitmapImages_AreaToDraw_ScreenCap.png'/>
        </exhibit>
        <para>
            Select the area to draw. You have two choices.
        </para>
        <unorderedlist>
            <listitem>
                <para>
                    <italic>Draw the home view</italic> - The home view of the &TermUsedForMap;
                    is drawn. See <iref target='WCGISxWCF_HomeView_id'/> for more
                    information about the home view.
                </para>
            </listitem>
            <listitem>
                <para>
                    <italic>Draw the area currently displayed on the screen</italic>
                    - The portion of the &TermUsedForMap; currently displayed on your
                    computer's monitor is drawn. If you want to export only a small
                    portion of your &TermUsedForMap;, zoom in on that section, then
                    export the &TermUsedForMap;, choosing to draw the area currently
                    displayed on the screen.
                </para>
            </listitem>
        </unorderedlist>
        <note type='note'>
            <para>
                If the Area to Draw is not the same shape as the export bitmap
                image (i.e., if the aspect ratios are different), the area drawn
                will be larger that the area requested. &Note_AreaToDrawDifferentShapeNote_ExtraText;
            </para>
        </note>
        <note type='note'>
            <para>
                If you export a &TermUsedForMap; to scale, &app_name; attempts
                to display the Area To Draw at the requested scale. If the requested
                scale is too large, this area will not fit on the bitmap image.
                In this case, you have four options: 1) choose a smaller scale,
                2) choose a smaller Area To Draw, 3) increase the size of the
                bitmap image, or 4) decrease the resolution of the bitmap image.
            </para>
        </note>
    </section>
    <section id='WCGIS_ExportingMapsAsBitmaps_Options_Scale_id'>
        <title>
            Scale
        </title>
        <para>
            Use the Scale page of the <link
            target='#WCGIS_ExportingMapsAsBitmaps_ToBitmapFile_id'>Bitmap
            File Export Options dialog box</link> to set the scale at which
            your &TermUsedForMap; is drawn on the export bitmap image.
        </para>
        <exhibit>
            <img
            src='WCGISxWCF_ExportingMapsAsBitmapImages_Scale_ScreenCap.png'/>
        </exhibit>
        <para>
            Select how the scale is determined.
        </para>
        <unorderedlist>
            <listitem>
                <para>
                    <italic>Automatically select the scale at which the image is drawn</italic>
                    - &app_name; selects a scale so that the &TermUsedForMap;'s area
                    of interest just fills the export bitmap image. The area of interest
                    is specified on the Area To Draw page. See <iref
                    target='WCGIS_ExportingMapsAsBitmaps_Options_AreaToDraw_id'/>.
                </para>
            </listitem>
            <listitem>
                <para>
                    <italic>Draw the image at a scale of</italic> - Specify the scale
                    at which the &TermUsedForMap; is drawn on the export bitmap image.
                </para>
            </listitem>
        </unorderedlist>
    </section>
    <section
    id='WCGIS_ExportingMapsAsBitmaps_Options_LevelOfDetail_id'>
        <title>
            Level of Detail
        </title>
        <para>
            Use the Level Of Detail page of the <link
            target='#WCGIS_ExportingMapsAsBitmaps_ToBitmapFile_id'>Bitmap
            File Export Options dialog box</link> to control how much background
            map detail is displayed when you export your &TermUsedForMap;
            as a bitmap image.
        </para>
        <exhibit>
            <img
            src='WCGISxWCF_ExportingMapsAsBitmapImages_LevelOfDetail_ScreenCap.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 &TermUsedForMap; 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 &app_name; uses this
            recommended scale information when you export your &TermUsedForMap;
            as a bitmap image. You have four choices for how &app_name; determines
            how much detail to display.
        </para>
        <unorderedlist>
            <listitem>
                <para>
                    <italic>Draw the image with a level of detail appropriate for
                    the scale at which the image is drawn</italic> - Any recommended
                    scale information in the background map is used.
                </para>
            </listitem>
            <listitem>
                <para>
                    <italic>Draw the image with the level of detail currently displayed
                    on the screen</italic> - The level of detail is the same as that
                    currently displayed by the &TermUsedForMap; on your computer's
                    monitor.
                </para>
            </listitem>
            <listitem>
                <para>
                    <italic>Draw the image 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
                        exported image illegible.
                    </para>
                </note>
            </listitem>
            <listitem>
                <para>
                    <italic>Draw the image with a level of detail appropriate for
                    display at a scale of</italic> - The level of detail is the same
                    as if the &TermUsedForMap; was being exported at a scale you specify.
                </para>
            </listitem>
        </unorderedlist>
    </section>
</section>
