Ppmglobe User Manual
Ppmglobe User Manual
NAMESYNOPSIS
DESCRIPTION
PARAMETERS
OPTIONS
SEE ALSO
HISTORY
AUTHORS
NAME
ppmglobe - generate strips to glue onto a sphere
SYNOPSIS
ppmglobe [-background=colorname] [-closeok] stripcount [filename]
Minimum unique abbreviation of option is acceptable. You may use double hyphens instead of single hyphen to denote options. You may use white space in place of the equals sign to separate an option name from its value.
DESCRIPTION
This program is part of Netpbm(1)
ppmglobe does the inverse of a cylindrical projection of a sphere. Starting with a cylindrical projection, it produces an image you can cut up and glue onto a sphere to obtain the spherical image of which it is the cylindrical projection.
What is a cylindrical projection? Imagine a map of the Earth on flat paper. There are lots of different ways cartographers show the three dimensional information in such a two dimensional map. The cylindrical projection is one. You could make a cylindrical projection by tracing as folows: wrap a rectangular sheet of paper around the globe, touching the globe at the Equator. For each point of color on the globe, run a horizontal line from the axis of the globe through that point and out to the paper. Mark the same color on the paper there. Lay the paper out flat and you have a cylindrical projection.
Here’s where ppmglobe comes in: Pass the image on that paper through ppmglobe and what comes out the other side looks something like this:
Example of map of the earth run through ppmglobe
You could cut out the strips and glue it onto a sphere and you’d have a copy of the original globe.
Note that cylindrical projections are not what you normally see as maps of the Earth. You’re more likely to see a Mercator projection. In the Mercator projection, the Earth gets stretched North-South as well as East-West as you move away from the Equator. It was invented for use in navigation, because you can draw straight compass courses on it, but is used today because it is pretty.
You can find maps of planets at ("http://maps.jpl.nasa.gov") maps.jpl.nasa.gov .
PARAMETERS
stripcount is the number of strips ppmglobe is to generate in the output. More strips makes it easier to fit onto a sphere (less stretching, tearing, and crumpling of paper), but makes you do more cutting out of the strips.
The strips are all the same width. If the number of columns of pixels in the image doesn’t evenly divide by the number of strips, ppmglobe truncates the image on the right to create nothing but whole strips. In the pathological case that there are fewer columns of pixels than the number of strips you asked for, ppmglobe fails.
Before Netpbm 10.32 (February 2006), instead of truncating the image on the right, ppmglobe produces a fractional strip on the right.
filename is the name of the input file. If you don’t specify this, ppmglobe reads the image from Standard Input.
OPTIONS
-background=colorname
This specifies the color that goes between the strips.
Specify the color (color) as described for the ("libppm.html#colorname") argument of the ppm_parsecolor() library routine .
The default is black.
This option was new in Netpbm 10.31 (December 2005). Before that, the background is always black.
-closeok
This means it is OK if the background isn’t exactly the color you specify. Sometimes, it is impossible to represent a named color exactly because of the precision (i.e. maxval) of the image’s color space. If you specify -closeok and ppmglobe can’t represent the color you name exactly, it will use instead the closest color to it that is possible. If you don’t specify closeok, ppmglobe fails in that situation.
This option was new in Netpbm 10.31 (December 2005).
SEE ALSO
HISTORY
ppmglobe was new in Netpbm 10.16 (June 2003).
It is derived from Max Gensthaler’s ppmglobemap.
AUTHORS
Max Gensthaler wrote a program he called ppmglobemap in June 2003 and suggested it for inclusion in Netpbm. Bryan Henderson modified the code slightly and included it in Netpbm as ppmglobe.
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
