MayaDate 0.95
By Taper Wickel <twickel@waxwolf.com>
http://www.waxwolf.com/palm/mayadate.html

Program copyright (c) 2001 Taper Wickel; portions of the code
copyright (c) Sean Dwyer <ewe2@cvis.com.au> and Ivan Van Laningham
<ivanlan@callware.com>.  See AUTHORS for details.

This program is free software, released under the GNU General Public
License.  See the file COPYING for details.

(Short form: If you want to redistribute MayaDate, you are required to
either distribute it with the source or maintain a pointer to my
webpage, http://www.waxwolf.com/palm/ , where the end user may
download the source.)



About MayaDate
==============

MayaDate is a simple program which will display the date given it on
the different Mayan calendar systems.  

Install
=======

Install mayadate.prc in the usual way you install Palm applications.
If you have a HandEra 330, also install md-he300.prc ; it contains the
higher-resolution graphics and icons for that device.

Usage
=====
Navigation

The display starts on the current date.  Any of the underlined fields
is tappable.

Note that the Gregorian date displayed can be beore the adoption of
the Gregorian calendar.  This is called the Gregorian proleptic
calendar, which essentially means that we pretend it's always applied.
There is a zero year, and years before that are considered
negative. You can choose to display these in BC/AD notation instead of
negative/positive.

Tap on the date field to bring up a date selector.  This is much like
Palm's deefault date selector, extended to support dates between
3114BC and 4772AD.  The arrows to each side of the year in this form
will move (starting from the furthest) 100, 10, and 1 years in the
direction indicated.  Tap a date to select it, or 'cancel' to cancel
and return to the previous display.

Tapping the Julian Day will bing up a form where you may enter a
Julian Day.  If you go outside the bounds of the program, it will snap
to the firstt or last day supported, depending on which you went
beyond.

Tapping the Long Count date allows you to select a Long Count date
between 0.0.0.0.0 and 19.19.19.17.19 inclusive.  (Arguably dates
higher than 13.0.0.0.0 do not exist, but it's more useful to support
them.) Use the arrow buttons to increment or decrement each part.

Tapping on the bitmap for the Tzolkin date allows you to select a
Tzolkin date.  Since the Tzoklin is cyclic, it will move to the
nearest occurance of the selected date either forwards or backwards,
depending on which of "Prev/Next" is selected.  If you leave the date
the same as the currently displayed date on the main form, you will
jump forwards or backwards one cycle (260 days).  You may also use the
"Tools" menu to do this, or the Command-T menu shoortcut to move ahead
one cycle.

Tapping on the bitmap for the Haab date does much the same thing.  The
Haab is a 365-day cycle, so leaving the day as it is when the form
first pops up and "OK"ing will move 365 days forwards or backwards.

Menus 
    Tools

Shortcuts to move forward or backwards once cycle on either the Haab
or the Tzolkin.

    Edit
      Copy Date to Clipboard

This will copy the current Mayan date to the clipboard, in the
standard form of "Longcount Tzolkin Haab".  For example: 

	 12.19.8.0.9 9 Muluc 12 Kayab

    Options
      Preferences

If you are used to working with the older 584283 correlation, or if
you need interoperability with older mayan date calculator programs,
you can set the option to use 584283 instead of 584285 here.  

(In other words, if you think the date given is off by two days, check
the box.  A more extensive explanation is in the popup (i)nfo screen.)

You may also to have the date displayed in BC/AD here.

      About

There is some information about the date systems and their
relationships in the {i)nfo on the About window.  



BUILDING
========

The source is included in the distribution.  

If you have prc-tools and pilrc on a unix system, with the PalmOS 3.5
SDK, you should be able to just type 'make' in the directory you've
decompressed into. (I am using prc-tools 2.0.90 and pilrc 2.5C under
Debian GNU/Linux.)

If you are compiling on a Microsoft Windows system, and you have gcc
and pilrc, you should be able to compile after converting the .pbm and
.ppm files to Windows BMP files.  I'm not sure what tools you would
need for that.  (You'd also need to edit the mayadate.rcp file to
change the references to "bitmaps/*.pbm" into "bitmap\*.bmp".)
 
If you're using CodeWarrior, I can't help you much.

BUGS
====

* The new date selector may have a few flaky bits.  I'm still working
  on it.

CONTACT INFORMATION
===================

I can be reached at twickel@waxwolf.com; I'd love to hear comments and
suggestions for this app.

