home *** CD-ROM | disk | FTP | other *** search
- Sun-Chart Version 1.2 by RejTech
- - - - - - - - - - - - - - - - - -
- Copyright(c) 1993, RejTech
- P.O. Box 721247
- Oklahoma City, Oklahoma 73172-1247
-
- OVERVIEW:
- ---------
- "SunChart" is an add-on report generator for the SUNTIME.EXE
- program from RejTech. It is a DOS command line utility which
- will produce a report of sunrise/sunset/twilight times for a
- user specified list of cities and dates. Headings and fields
- on the report may be adjusted by the user.
-
- OPERATION:
- ----------
- This program requires that the two data files (CITIES.DAT and
- TIMEZONE.DAT) reside in the same directory with SUNCHART.EXE.
-
- A driver file which lists the cities and dates to include on
- the report is also required. The report format is defined in
- the SUNCHART.CFG file. Program command line usage:
-
- C:>SUNCHART driverfile
-
- The program will read "driverfile" to determine cities and
- dates to print on each line. Output is directed to the DOS
- standard output device (your monitor) and can be redirected
- to a file or printer as desired.
-
- Assuming that your driver file is named "SUNCHART.DRV", the
- following command will redirect output to the printer:
-
- C:>SUNCHART SUNCHART.DRV >PRN
-
- DRIVER FILE:
- -----------
- The driver file is a standard ASCII text file which lists the
- cities and dates to print on the report:
-
- Columns 1-24 = City name to print
- Columns 25-26 = blank
- Columns 27-36 = Date to print for this city.
- Column 37 = blank
- Columns 38-40 = Time Zone Overide
-
- City Name - MUST BE SPELLED AND SPACED EXACTLY as it is in
- the "CITIES.DAT" file (case does not matter). If
- this field is left blank, the previous city will
- be computed for the new date specified, however
- the city name will not print on the report.
- Date - Must be the full 10 character date in the format
- specified in the "SUNCHART.CFG" file (including
- using the same delimiter character).
- Time Zone - Use this to overide the time zone specified in
- the CITIES.DAT file. This is useful for cities
- where the "AUTO-DST" flag is not set in the file
- (because they don't use the US standard) but are
- on daylight-savings time for the specified date.
-
- A sample driver file SUNCHART.DRV is supplied as an example.
-
- Sun-Chart Version 1.2 by RejTech
- - - - - - - - - - - - - - - - - -
-
- CONFIGURATION FILE:
- ------------------
- The report format is determined by the SUNCHART.CFG file. It
- is a simple ASCII text file which may be edited with any text
- editor to change the report appearance. It must contains 3
- seperate text lines:
- Line 1 = Report Parameters
- Line 2 = Report Fields
- Line 3 = Heading Line 1
- Line 4 = Heading Line 2
- Line 5 = Heading Line 3
- Line 6 = Heading Line 4
-
- The Parameter line must contain the following data:
- Columns 1-3 = Lines per Page (zero = continuous)
- Column 5 = Date Format: Y = YYYY/MM/DD,
- M = MM/DD/YYYY,
- D = DD/MM/YYYY
- Column 7 = Time Format: 2 = 12hr (HH:MM Am),
- 4 = 24hr (HH:MM)
- Column 9 = Twilight time to use:
- C = Civil Twilight,
- N = Nautical Twilight,
- A = Astronomical Twilight.
- Column 11 = Line spacing Between Cities (1-9)
- Column 13 = Line spacing for same City (1-9)
- Column 15 = Date Seperator Character (Default = '/')
- Column 17 = Time Seperator Character (Default = ':')
-
- Field definitions consist of a one byte "Field Code" which
- is immediately followed by the length of the field to print.
- The number of spaces between field definitions determines the
- number of spaces between fields on the report.
-
- Field Codes: C = City Name(max 24 bytes),
- Z = Time Zone(max 3 bytes),
- D = Date(max 8 bytes),
- R = Sunrise Time(max 8 bytes),
- S = Sunset Time(max 8 bytes),
- W = Dawn Time(max 8 bytes),
- K = Dusk Time(max 8 bytes),
- L = Sunlight Duration (max 5 bytes),
- T = Twilight Duration (max 5 bytes),
- B = Light Duration (Sunlight+Twilight) (max 5),
- N = Night(dark) Duration (max 5 bytes)
-
- Example: if line 1 contains: 055 M-2-C-2-1
- and line 2 contains: C24 D8 R8 S8 Z3
- - 55 lines will be printed on each page,
- - Dates will be displayed in mm/dd/yyyy format,
- - Times will be displayed in 12 hour format,
- - Twilight times will be computed using civil dawn and
- and dusk,
- - Lines will be double spaced between cities and single
- spaced for the same city,
- - Fields will print starting in column 1:
- CITY (for 24 bytes), 2 spaces, then the DATE (for
- 8 bytes), 2 spaces, then the SUNRISE-TIME (8 bytes),
- 2 spaces, then the SUNSET-TIME (8 bytes), 2 spaces,
- then the TIME-ZONE (3 bytes).
-
- Sun-Chart Version 1.2 by RejTech
- - - - - - - - - - - - - - - - - -
-
- SOFTWARE LICENSE REGISTRATION:
- ------------------------------
- This program is supplied as a free add-on to the SUNTIME/ANYTIME
- package by RejTech. It is copyrighted and may not be altered or
- sold except by RejTech.
-
-
- WARRANTY:
- ---------
- This program is provided on an AS-IS basis WITHOUT warranty of
- any kind. As with all computer software, it may contain logic
- errors which might give erroneous results. RejTech will not be
- held liable for any damages, whether direct or consequential,
- arising from the use of this software.
-
- Please direct any comments or report any bugs to the address at
- the top of this document. You may also leave me a message on
- CompuServe...
-
- - Rob Jordan
- CompuServe ID: 70515,722
-
-