mapwriter(1) USER COMMANDS mapwriter(1) NAME mapwriter - convert vector map data to raster images SYNOPSIS mapwriter [ -map_dir directory ] [ -map_profile file ] [ -map_local_profile file ] [ -map_profentry 'profile entry' ] [ -margin pixels ] [ -gridlines nLines ] [ -nogrid ] [ -rect | -ellipse | -sine ] [ -image_extent width height ] [ -type typeName | -alltypes ] [ -preload ] [ -ll_center long lat ] [ -ll_extent long lat ] [ -fb device ] [ -noerase ] [ -color | -bw ] [ -rast | -crast ] [ -jump x y ] [ ] [ -mark lon lat type size ] [ ] [ -shortmap ] [ -map_maxopen N ] [ -map_maxmaps N ] [ -map_maxtypes N ] [ -map_maxscales N ] [ -map_maxcolors N ] DESCRIPTION mapwriter creates raster images from vector map data. The resulting image is either displayed directly on the screen frame buffer or written to standard output as a Sun raster file or both. By default it displays on the default frame buffer the coastlines from a world map set that includes coastlines, rivers, and borders. EXAMPLES The following displays the central portion of California directly on the frame buffer: mapwriter -ll_center -121.5 37.5 -ll_extent 5 5 -type coastlines -type borders -type rivers The following creates a color raster file of southern Florida and the western Bahamas: mapwriter -ll_center -79.5 26.2 -ll_extent 5.5 3.2 -image_extent 800 600 -alltypes -nogrid -crast -color > florida.crast OPTIONS -map_dir directory Directory containing map profile and map files. Default: MAPBROWSER_DIR or /import/mapbrowser/data. -map_profile file File containing map profile (in map_dir if relative path name). Default: MAPBROWSER_PROFILE or default.mapset. -map_local_profile file File containing map profile (but map files are taken from map_dir). -map_profentry 'profile entry' Allows individual map profile entries to be inserted from the command line. PARC mapbrowser Last change: 5 November 1993 1 mapwriter(1) USER COMMANDS mapwriter(1) -margin pixels Specifies the margin around map. Default: 8. -gridlines nLines Specifies the approximate number of meridian graticule lines to display. Default: 12. -nogrid Supresses displaying the map graticule (except for the world outline). -rect -ellipse -sine Specifies the type of map projection. Default: -ellipse. -image_extent width height Specifies the raster image size. Default: frame buffer size or 512 x 256. -type typeName -alltypes Specifies one or more map types to draw from the map profile. Default: first map type in profile. -preload Compute the maximum map region based on the maps and map types in the profile. Otherwise the entire world is assumed. -ll_center long lat Specifies the center longitude and latitude of the map image. Default: 0 0 or center of map region. -ll_extent long lat Specifies the longitude and latitude extent of the map image. Default: entire world or entire map region. -fb device Specifies the frame buffer device on which to draw the map. Default: /dev/fb. -noerase Do not erase the frame buffer before drawing the map. -color -bw Specify a color or black-and-white map image. Default: black-and-white unless drawing on a color frame buffer. -rast Write a standard Sun raster file instead of drawing on PARC mapbrowser Last change: 5 November 1993 2 mapwriter(1) USER COMMANDS mapwriter(1) the frame buffer. -crast Write a run-encoded Sun raster file instead of drawing on the frame buffer. -jump x y Instead of creating an image, write the longitude and latitude values (in degrees) corresponding to the image coordinates (x,y). -mark lon lat type size Place a mark on the image at the specified longitude/latitude position (in degrees). type is an integer from 1 to 7. size is the radius of the mark in pixels. The highlight color is used. -shortmap When writing a raster file, include a color map with entries for only the colors used rather than a full 256 entry color map (most applications require a full color map). -map_maxopen N -map_maxmaps N -map_maxtypes N -map_maxscales N -map_maxcolors N These options override the maximum number of open files, total map files, map types, resolutions or colors supported by the program. The default for -map_maxopen is to open as many files at a time as allowed by the operating system. The other defaults are described in the ENVIRONMENT section. ENVIRONMENT MAPBROWSER_DIR Changes default map directory. MAPBROWSER_PROFILE Changes default map profile (in map directory). MAPBROWSER_MAXMAPS Maximum number of map files. Default: 1000. MAPBROWSER_MAXTYPES Maximum number of map types. Default: 50. MAPBROWSER_MAXSCALES Maximum number of map resolutions. Default: 25. MAPBROWSER_MAXCOLORS PARC mapbrowser Last change: 5 November 1993 3 mapwriter(1) USER COMMANDS mapwriter(1) Maximum number of colors. Default: 256. FILES /import/mapbrowser/data/ Default map directory. default.mapset Default map profile (in map directory). /import/mapbrowser/data/*/*.cbd Map files referenced by default.mapset. BUGS Certain options (like suppressing and enabling some map features) can only be controlled via map profile entries. Format errors in the map profile will likely crash the pro- gram. HISTORY June 1983: Al Paeth wrote a world map browser for the Smalltalk-76 system. August 1989: Steve Putz ported it to Smalltalk-80. October 1989: ported it to SunView (svmap- browser). October 1990: factored out the user interface, created the separate mapwriter program, and partially imple- mented an X-windows browser. March 1991: got an X-windows map browser working (xmapbrowser). March 1991: obtained newer map data (with Brian Reid's help) and changed the map file format and programs to handle the higher resolution data and multiple map features. April 1991: Changed default map directory to /import/misc/mapbrowser-3/data/. March 1992: Minor changes to support larger map databases (e.g. us.mapset). November 1993: added -jump and -mark options. Changed default map directory to /import/mapbrowser/data/. SEE ALSO mapbrowser(1), mapset(5) PARC mapbrowser Last change: 5 November 1993 4