WMAP2PS

Section: User Commands (1)
Index Return to Main Contents
 

NAME

wmap2ps - convert a worldmap file to PostScript  

SYNOPSIS

wmap2ps [ -u unit ]
                                [ -o x y ] 
                                [ -w width ] 
                                [ -h height ] 
                                [ -nomercat ]
                                [ -unconnect ]
                                [ -drawsegs ]
                                [ -showbox ]
                                [ -debug ]

 

DESCRIPTION

wmap2ps converts map files (MP1 format) from the Digitized World package by John B. Allison to an EPSF 2.0 conforming PostScript file. This is done by reading map data from stdin and piping the resulting PostScript code to stdout, taking user desired scaling and change of origin into account. The problem of mapping a three-dimensional surface to a two-dimensional plane is handled using the mercator projection, if this is desired. Using this transformation, distortions at extreme latitudes are avoided.  

OPTIONS

-u unit
defines the unit in which the other scalar values will be given. The default is cm , other possible values are pt or in
-o x y
Sets the origin of the figure. The values are given in the current unit, default is the lower left corner of the page.
-w width
Specify the desired width of the figure using the current unit.
-h height
Specify the desired height of the figure using the current unit. Only one of -h and -w may be used so that the original image ratio is preserved. If neither -w nor -h is given, the image is left in its original size.
-nomercat
Don't use mercator projection. You may still achieve nice pictures if your favourite country is close to the equator.
-unconnect
The MP1 files include comments, usually to give some information about the area that is described by the following data. If one concatenates several maps to form a bigger one, this may result in lines that interconnect the previously separate maps. If the maps are described by comments, wmap2ps is able to detect such interconnection points and, if you specify this option, unconnects them.
-drawsegs
Usually the lines drawn are stroked when the map is completed. But if your PostScript device is not able to handle all the line segments at once, i.e. you get an error message like
%%[ Error: limitcheck; OffendingCommand: lineto ]%%
%%[ Flushing: rest of job (to end-of-file) will be ignored ]%%
you can force the program to stroke every single segment 
immediately after it is drawn by giving it this option.
-showbox
The bounding box of the figure is drawn too.
-debug
Write some additional information to stderr.
 

EXAMPLES

cat AU?.MP1 | wmap2ps -unconnect -o 1 1 -w 6 > au.ps

This would create a PostScript file that draws the map of Australia, its seas and its islands with an origin that lies 1 cm to the right and 1 cm above the lower left corner of the page. The mercator projection will be used and the resulting picture is scaled so that it's exactly 6 cm wide.

 

BUGS

If, like in the above example, several map files are concatenated, the resulting PostScript file may include visible lines that connect the partial maps. To fix this bug, simply add a separator line (blank line) at the end of the map files. If possible, wmap2ps detects such problems and offers help through the '-unconnect' option.  

FILES

wmap2ps.tmp - temporary, needed as wmap2ps acts as a pipe  

AUTHOR

Patrick Dockhorn (dockhorn@fzi.de).
Forschungszentrum Informatik, Karlsruhe, Germany.
(Address is subject to change, do a 'finger dockhorn@keemun.fzi.de'
to find out about the author's present address)



 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
BUGS
FILES
AUTHOR

This document was created by man2html, using the manual pages.
Time: 06:51:44 GMT, December 12, 2024