diff options
author | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2020-07-11 03:14:39 +0000 |
---|---|---|
committer | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2020-07-11 03:14:39 +0000 |
commit | a87703a515ec08a0637c2b3b3e6cd0ef1a7e78ff (patch) | |
tree | 0e462a89e51e65b0d293104f437aa371d8e56ee1 /pnmmercator.html | |
parent | e4dbb262ce92440414dad7735f9b9264e47cffa0 (diff) | |
download | netpbm-mirror-a87703a515ec08a0637c2b3b3e6cd0ef1a7e78ff.tar.gz netpbm-mirror-a87703a515ec08a0637c2b3b3e6cd0ef1a7e78ff.tar.xz netpbm-mirror-a87703a515ec08a0637c2b3b3e6cd0ef1a7e78ff.zip |
cleanup
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@3893 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Diffstat (limited to 'pnmmercator.html')
-rw-r--r-- | pnmmercator.html | 61 |
1 files changed, 30 insertions, 31 deletions
diff --git a/pnmmercator.html b/pnmmercator.html index e9e7165e..713d396a 100644 --- a/pnmmercator.html +++ b/pnmmercator.html @@ -1,9 +1,5 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN"> -<html> -<head> -<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"> -<title>PnmMercator User Manual</title> -</head> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN"> +<html><head><title>PnmMercator User Manual</title></head> <body> <h1>pnmmercator</h1> Updated: October 2009 @@ -11,7 +7,6 @@ Updated: October 2009 <a href="#index">Table Of Contents</a> <h2>NAME</h2> - pnmmercator - transform a worldmap from rectangular projection to Mercator projection and vice-versa @@ -23,12 +18,11 @@ projection and vice-versa [<b><i>filename</i></b>] <p>Minimum unique abbreviation of option is acceptable. -You may use double hyphens instead of single hyphen to denote options.</p> +You may use double hyphens instead of single hyphen to denote options. <h2 id="description">DESCRIPTION</h2> -<p>This program is part of <a -href="http://netpbm.sourceforge.net/doc/index.html">Netpbm</a>.</p> +<p>This program is part of <a href="index.html">Netpbm</a>. <p>The <b>pnmmercator</b> utility, converts a rectangular projection worldmap to a Mercator projection format, as used for maps.google.com and many other @@ -37,34 +31,34 @@ online maps. The map used as input for <b>pnmmercator</b> must have rows for file will typically be twice as wide as high, but this is not a requirement. The output file will be using the <a href="http://en.wikipedia.org/wiki/Mercator_projection">Mercator -projection</a> and will get double the height of the input file.</p> +projection</a> and will get double the height of the input file. <p>Maps using the Mercator projection are stretched more the closer a row is to the North or South Pole. The last few degrees (> 85 or < -85 degrees) are not part of a Mercator map at all because they would be stretched too much and the rows close to the edge will show banding, because they originate from -the same row in the original map.</p> +the same row in the original map. <p>To overcome this, the program will by default do interpolation of pixel colors, which will eliminate the banding effect, but will cause some blurring of the output. With the -nomix option, this interpolation of colors isn't applied. You can obtain the highest quality output by starting with an input map of high resolution, so that you can follow the <b>pnmmercator</b> -transformation with a <b>pamscale</b> reduction in size.</p> +transformation with a <b>pamscale</b> reduction in size. <p>This program can also convert a Mercator projection map back to a rectangular projection based. As said, the Mercator map doesn't have information about the latitudes close to the poles. Therefore the top rows in the output image will be identical and copied from the row corresponding with -latitude of 85 degrees. The same at the bottom of the map.</p> +latitude of 85 degrees. The same at the bottom of the map. <p>Pnmmercator doesn't have any provision for scaling the image. You can scale by piping the output of the program through Netpbm programs such as -<b>pamscale</b>.</p> +<b>pamscale</b>. <p>You can find maps to be used as input at <a href="http://flatplanet.sourceforge.net/maps/natural.html">flatplanet.sourceforge.net</a> -or <a href="http://www.evl.uic.edu/pape/data/Earth/">uic.edu/pape</a>.</p> +or <a href="http://www.evl.uic.edu/pape/data/Earth/">uic.edu/pape</a>. <p>The point of a Mercator projection map is that compass directions work on it. If you draw a straight line northeast from some point on the Mercator @@ -84,55 +78,60 @@ proportional to angular longitude. <h2 id="parameters">PARAMETERS</h2> <p><b><i>filename</i></b> is the name of the input file. If you don't specify -this, <b>pnmmercator</b> reads the image from standard Input.</p> +this, <b>pnmmercator</b> reads the image from standard Input. <h2 id="options">OPTIONS</h2> + +<p>In addition to the options common to all programs based on libnetpbm +(most notably <b>-quiet</b>, see <a href="index.html#commonoptions"> +Common Options</a>), <b>pnmmercator</b> recognizes the following +command line options: <dl compact> <dt><b>-inverse</b></dt> <dd> <p>With this option a conversion from Mercator to degrees is applied.The -output image will have half the height of the input map.</p> +output image will have half the height of the input map. </dd> <dt><b>-nomix</b></dt> <dd> <p>Default behaviour is that color blending is applied in between two adjacent rows. If you specify the -nomix parameter there is no blending. The consequence is a banding at the top and bottom of the map. With this option, -the output map will also consist of exactly the same colors as the input.</p> +the output map will also consist of exactly the same colors as the input. </dd> <dt><b>-verbose</b> and <b>-vverbose</b></dt> <dd> <p>This parameter outputs some additional information. If you double the 'v', it will output debug data about the lat/long degree and Mercator -conversions.</p> +conversions. </dd> </dl> <h2 id="seealso">SEE ALSO</h2> -<b><a href="http://netpbm.sourceforge.net/doc/pnm.html">pnm</a></b> and -<b><a href="http://netpbm.sourceforge.net/doc/pamscale.html">pamscale</a></b> -<b><a href="http://netpbm.sourceforge.net/doc/ppmglobe.html">ppmglobe</a></b> +<b><a href="pnm.html">pnm</a></b> and +<b><a href="pamscale.html">pamscale</a></b> +<b><a href="ppmglobe.html">ppmglobe</a></b> <h2 id="history">HISTORY</h2> -<p><b>pnmmercator</b> was new in Netpbm 10.49 (December 2009).</p> +<p><b>pnmmercator</b> was new in Netpbm 10.49 (December 2009). <h2 id="authors">AUTHORS</h2> <p><a href="mailto:willem@schaik.com">Willem van Schaik</a> (of <b>pnmtopng</b>/<b>pngtopnm</b> fame) wrote this program in October 2009 and -suggested it for inclusion in Netpbm.</p> +suggested it for inclusion in Netpbm. <hr> <h2 id="index">Table Of Contents</h2> <ul> <li><a href="#synopsis">SYNOPSIS</a> -</li><li><a href="#description">DESCRIPTION</a> -</li><li><a href="#parameters">PARAMETERS</a> -</li><li><a href="#options">OPTIONS</a> -</li><li><a href="#seealso">SEE ALSO</a> -</li><li><a href="#authors">AUTHORS</a> -</li> +<li><a href="#description">DESCRIPTION</a> +<li><a href="#parameters">PARAMETERS</a> +<li><a href="#options">OPTIONS</a> +<li><a href="#seealso">SEE ALSO</a> +<li><a href="#history">HISTORY</a> +<li><a href="#authors">AUTHORS</a> </ul> </body> </html> |