DESCRIPTION

    Utility to create an image file of spatial data on a MetVue map window.

USAGE

    ImageSnapshot -projectFile projectfile
                                 -session session
                                 -mapWindow mapWindow
                                 [-tinFile tinFile] [-tinPath tinPath]
                                 [-shapeFile shapefile] [-prjFile file]
                                 [-showMapScale] [-mapScaleLocation location]
                                 [-showNorthArrow] [-northArrowLocation location]
                                 [-zoomExtents "minlat,maxlat,minlon,maxlon"] [-outputResolution "width,height"]
                                 [-noLegend] [-legendLocation location]
                                 [-format outputFormat] -outputFile outputFile

OPTIONS

    -projectFile projectFile

        Specifies the project file containing the desired map settings.

    -session session

        Specifies the name of the session containing the desired map settings.

    -mapWindow mapWindow

        Specifies the name of the map window containing the desired map settings.

    -tinFile tinFile

        Specifies the input file that holds the tin or grid data. The default is
        to use the settings specified by the projectfile/session/mapwindow.

   -tinPath tinPath

        Specifies the pathname of TIN or grid data, if the file is DSS. The default
        is to use the settings specified by the projectfile/session/mapwindow.

    -shapeFile shapefile

        Specifies the input shapefile to be drawn. The default is to use the
        settings specified by the projectfile/session/mapwindow.

    -prjFile file

        name of the file containing a wkt that defines the image projection

   -showMapScale

       Setting this flag will make the Map Scale show up in the image.

   -mapScaleLocation location

       Sets the location of the Map Scale. Location options are
       UpperRight, UpperLeft, LowerRight, LowerLeft.

   -showNorthArrow

       Setting this flag will make the North Arrow show up in the image.

   -northArrowLocation location

       Sets the location of the North Arrow. Location options are
       UpperRight, UpperLeft, LowerRight, LowerLeft.

    -zoomExtents "minlat,maxlat,minlon,maxlon"

        Specifies the bounding points of the desired image extents in decimal degrees. 
        The default is to use the settings specified by the projectfile/session/mapwindow.

    -outputResolution "width,height"

        Output size of the image in pixels. The default is to use the settings specified by
         the projectfile/session/mapwindow.

    -noLegend

        removes the legend from the output image

   -legendLocation location

       Sets the location of the Legend. Location options are
       UpperRight, UpperLeft, LowerRight, LowerLeft.

    -format outputFormat

        Specifies the format of the output file. Valid values are gif, jpg and png.
        Default is jpg.

    -outputFile outputFile

        Specifies the output file for the image

SAMPLE COMMAND LINE ARGUMENTS

    Create jpg image for a specific map window
        -projectFile C:\project.metvue -session session1 -mapWindow mapWindow1
        -outputFile C:\image.jpg

    Create a png image with a specific projection shapefile and TIN
        -projectFile C:\project.metvue -session session1 -mapWindow mapWindow1
        -tinFile C:\data.nc -shapeFile C:\basin.shp -prjFile -shapeFile
        C:\basin.prj -format png -outputFile E:\image.png

    Set custom zoom and resolution
        -projectFile C:\project.metvue -session session1 -mapWindow mapWindow1
        -zoomExtents "32,40,-104,-86" -resolution "640,480" -outputFile C:\image.jpg

NOTE ON PERFORMANCE

   This program may utilize a significant amount of memory depending on datasets specified.
   For extra intensive data operations, it may be necessary to increase the memory allocated
   to the jvm. This can be performed by setting the -Xmx argument, which can be altered
   easily in the "memory_setting" variable in the GridReader.cmd example file provided.