File	Date	Author	Commit
Equirectangular_projection_SW.jpg	2025-03-02	prasad	[efb451] add fallback grid and other minor fixes
Makefile.in	2025-03-02	prasad	[efb451] add fallback grid and other minor fixes
README	2025-03-02	prasad	[efb451] add fallback grid and other minor fixes
configure	2025-03-02	prasad	[efb451] add fallback grid and other minor fixes
equirectangular.c	2025-03-02	prasad	[efb451] add fallback grid and other minor fixes
globe._man	2025-03-02	prasad	[efb451] add fallback grid and other minor fixes
main.c	2025-03-02	prasad	[efb451] add fallback grid and other minor fixes
orthographic.c	2025-03-02	prasad	[efb451] add fallback grid and other minor fixes

Read Me

==================================
globe - A simple interactive globe
==================================

-------------------------------------
License - GNU General Public License
-------------------------------------

globe is a free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.

globe is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

The license can be obtained by writing to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,
USA, or by accessing http://www.gnu.org/copyleft/gpl.html.

--------------------
About this software
--------------------

globe is simply a transformation of equirectangular map projection
to orthographic map projection. It was inspired by many wonderful
softwares which use framebuffer to display images and work great
in a simple text console based Linux systems, like w3m.

The equations for transforming the projection from equirectangular to
orthographic were shamelessly copied from following wikipedia links :)

https://en.wikipedia.org/wiki/Equirectangular_projection
https://en.wikipedia.org/wiki/Orthographic_map_projection

The default Equirectangular projection map image is available in wikimedia,
licensed under the Creative Commons Attribution-Share Alike 3.0 Unported license.

https://en.wikipedia.org/wiki/File:Equirectangular_projection_SW.jpg

-----------------------
Installation procedure
-----------------------

After extracting the contents, go into the directory.

Run ./configure to create the Makefile

Type make to compile

Then type make install with superuser privileges
to install the executable

The globe command is then ready to go.
Press 'q' to exit the program.
Arrow keys can be used to rotate the globe in either direction.

-----
TODO
-----

To check if some device other than /dev/fb0 is being used as frame buffer.

The program can also be made to work with other projections of map.
It currently only works with equirectangular projection.

Support for common image formats like JPEG and PNG needs to be added for
reading the map file, directly, using libraries like imlib2 and gdk-pixbuf.
Presently, the map file is converted to portable pixmap format using netpbm
or ImageMagick, which is then read by the program.