Cyclocke                     Copyright (c) 1999
            Ver 2.10            By  Anthmi Ent.

  Cyclocke is a Cycle Clock,
      using the Gregorian calendar method. 
The Gregorian Calendar started  Thursday, Oct. 15, 1582.
 (But Cyclocke will go back or forward 5 million years)
Cyclocke will give you the correct day of week, moon
phase etc., for the duration of the Gregorian Calendar.
 The Julian Calendar before that was just a feeble
approximation of the Gregorian one. So longer cycles
should be fairly  represented for Julian dates as well.                    
     Cyclocke sometimes uses a 'Hard Right',
a right click will sometimes do more than a left.
      This seems more intuitive to me, but
       is different than the common practice.

  Read Tutor.txt, For a quick look into Cyclocke.

 Read FareWare.txt For a description of the "FareWare"
  concept, and contact/ upgrade ordering information.

 Revision.txt changes made to the various versions.

 By Using Cyclocke you are bound by the
        information in Legal.txt.

  The Helpfile CycHelp.Hlp Contains most of the 
information in all these text files,(and more),
and is probly more convenient.
And is proof read better. (it's getting late)

  Feel free to experiment with Cyclocke, click anything
left and right. {the most drastic thing Cyclocke will do
  (((except launch the files you choose as alarms))),
is  change your system's clock time (right click [Now]),
 and this gives you an 'Are You Sure' dialog first .

     The Cycles are represented by the little 
  'orbiting' circles/icons on the 'Cycle Screen'
 If an Alarm is set, it will go off when the
   Cycle Orb is straight up from the Center.
  


  Contents

1.    The  buttons  (just push em)
     
2.    Editing Cycles 
   You can create your own custom Cycles,
     almost anything you can think of.

3.    Alarms
   You Launch almost anything at the Cycle Event
 
 Media  Player files (.wav s , .mid s, movies),
      executables, batch files, what not.
   (with Windows 95 or + you can launch any
     associated file with it's application)   

4.   Saving / Loading 
   You can save all your custom cycles
        

5.     Options    Display preferences Etc.

      Contact Info (complete contact info)
                    (is in FareWare.txt)

ONE           Buttons 
  
 (Basically just push the buttons, to see what they do)

   The Counter buttons
The Counter buttons, [Hour], [:], [Minute], [am/pm],
 [Weekday], [Month], [Day], [Year]  Display their
 particular piece of the time and Date. And along with
 the [Decade], [Century], and, [Millennia] buttons,
 when clicked will Increment / Decrement,  the clock by
 that time unit. (the [;] does 5 min changes).
   The Left Mouse button will  cause Cyclocke to step
forward. The Right Mouse button will cause Cyclocke to
 step backward.

 The [Increment] button (to the right of the moon phase)
displays the chosen increment or now mode, and when
right/left clicked (while not in now mode), will change
the increment from minutes through 10,000 years.
 In  Auto Mode, the clock will Auto step
      with the chosen increment.
  
     Forward / Backward Buttons
  The [Forward]/[Backward] buttons Determine the
 direction of 'Auto'movement, In stop mode, they will
 step the clock  that direction.

         The Now button
   A Left click on the [Now] button Will  set Cyclocke
to your Computer's internal Clock.  A Right button click
will allow you the option of setting the computer clock
 to Cyclockes Time and Date.
    In AUTO MODE [Now] will cause Cyclocke to be updated 
(from the   computers clock) a  few times a minute.

        The Auto/Stop button
  The [Auto/Stop] button, Says 'Stop' when in Auto Mode,
 and 'Auto' when in Stop Mode.  Left Clicking it toggles
 the  mode.  (the mode is displayed as is, in  the Moon
 phase box)

    In 'Stop' Mode Cyclocke will stay at  the same time
 until you click a Counter,   Date, Time, or Now. button
 , then stop  again.
     In 'Auto' Mode Cyclocke will keep  stepping with
 the Increment or updating 'Now' until you Left click
 [Stop].
    Right clicking [Auto/Stop] toggles the Auto Stop
 display in the lower left corner of the 'Moon phase
 box'.
    When in Now Auto mode, Cyclocke  changes to stop 
mode, when you click a 'Counter' button. So you don't
go auto  incrementing off to eternity unprepared.

      Jump to Time or Date
  To Jump to a [Time] or [Date], click , and then enter
 your choice from the  keyboard

                  Drop Box
  The Drop Box, is a drop down list box, from which you
can select cycles, or parameters of cycles, to edit.
  You click the little down arrow to drop the box.
Selecting a cycle, will drop a list of cycle Parameters.
Selecting a parameter opens Pop Up, to edit the parameter.
Selecting "Back to Cycle Menu" takes you back to cycle list.
To edit the Cycle Set Name, and Icon, select the cycle set.
       Moment  Clock 
   The little clock next to the 'Drop Box'.
 {ON} When you see the little clock the [Moment Display]
 shows your computer's clock time.
 {OFF}  When you see the gray square cover the clock the
 time one this display is frozen 'Saved'.
   Clicking the clock or Square turns this 
 'Moment  Clock'  ON / OFF .

       Moment Display
   (The Time Display Ubove the 'Cycle Box' ) 
   This is a seperate Time Keeper, and Save Register.
 So you can step around with Cyclocke and still see the
 present time, or save one of Cyclockes moments to jump
 back to later. When the 'Moment  Clock'  is ON this
 display shows your computer's clock time. When the 
'Moment  Clock'  is OFF this display is frozen 'Saved'.
 Left clicking this display will set 'Cyclockes Time' to
 this displayed time. Right clicking will toggle back
 and forth from 'Stop Alarms'  mode

        Save Moment
   Clicking [Save] (left of Moment Display) Will  Save
 Cyclocke's Current  Moment 'Moment Memory'. It will
 then be displayed on the [Moment] button.  (this also
 turns the 'Moment Clock' off)

  {Remember  not to confuse this displayed Saved Moment
 with Cyclockes  Current Time displayed on the Counter
 Buttons}
    Clicking The Saved Moment Will  cause Cyclocke to
 jump to that moment.   Right clicking either will
 toggle the buttons to Stop .WAV file mode.

            Cycle  Pages
    Clicking the [Page #] button will change the 'Page'
 of Cycles that are displayed  there are  3 Pages  and
 7 Cycles in each Page.
 ( left click forward , right click backward )

             Cycles
 Left Clicking one of  the [Cycle] buttons
   Toggles a little square around the Orb
  Right Clicking will drop the 'Drop Box' to show you
 a list of the Cycle Parameters.
  (and allow you to edit them)
The Cycles

 Have as parameters;
 1. a Name  (you know what a name is)  
 2.  Period {periodic}, {Monthly}date,
      {Yearly}date, or absolute{Date}.
 3. an epoch angle {periodic}, or
     time of day{monthly}{yearly}{date}.
 4.      May have an alarm filename
    (goes off at the event time if set)
 5. an  (Orb) Circle Color , or Icon
 6. a  Radius (distance from center of the cycle box)
 7. an (Orb) Width

  You can Customize the Cycles to be whatever you want,
 Birthdays, Shuttle Orbits, Moon Phase, Sun Spot Cycles,
 Daily Alarms , Whatever.

 There is one 'Biorythm' that is worthy of note,
and Cyclocke shines in its  ability to track it,
that is the menstrual cycle.
 The natural cycle has the same length as the
Full Moon cycle.
(you need only change the epoch angle(event time))
When'The Pill'is involved the period would be 28 days.

   With Cyclocke, you can know a year ahead of time,
 the best time to take that vacation, etc.


.

         Cycle Event Time       
The'Event Time' is  indicated in the Label across from
 the Cycle Name button. Left clicking this will change
  the format of the Event Display.
It will toggle the display mode.(Date/Time, Time Until,
Decimal Days Until)  Right clicking will cause Cyclocke
 to jump to this Event
  


TWO       Editing

   Edit	Menu

      Copy Date and Time	
  Copies Cyclockes date and time to the clipboard

 'Canned Edits'

 Since these edits default to Cyclocke's current time
 it makes it easyer if you stop Cyclocke and set it to
 the time you want your event to 'happen'.

1. Select the cycle you want to edit.
 (click the 'Orb',  right click the Cycle Button,
   or select it from the 'Drop Down'
2. Choose the 'canned edit' from the edit menu and
 follow the prompts

3. To Set the   Alarm or  'Orb' appearance,
   select Alarm or Orb from the edit menu
    and follow prompts

      Daily
             24 hour   Cycle    e.g. 8:00 am wake up

      Weekly
             7 day e.g. Sunday 6.45 pm Simpsons reminder

      Monthly
               Day of month   e.g.   15th Club meeting

      Annual
             Month / Day   e.g.    Birthday, Anniversary

      Date
             Absolute Date,   Month / Day / Year
                 e.g Year 2000 Jan 1st 2000
(the cycle length defaults to 365 days, if you want to
type in a different period, change the cycle type to
Periodic, change period, then back to Date type)
    [see Edit Drop Box ]

      Leap years
                   Febuary 29th (every four years)


      Alarms	
             Use almost any file to announce your Event

      Orb  
            Change Orb color or Icon


      Alarms Past	
                   Brings up a list of Alarms that have
 'gone off'or 'passed' since you last loaded Cyclocke.
 (Cyclocke has to have been set for the same minute as
 the alarm for this to have happened)
 
     

     Edit Drop Box 
                     The nasty details

     As allways it's easyest to just push the buttons, 
         and see what happens

      You can Customize the Cycles to be whatever you
 want, Birthdays, Shuttle Orbits, Moon Phase, Sun Spot
 Cycles, Daily Alarms , Whatever.

 
    To Edit a Cycle ;    (Enter 'Stop' Mode)

  1. Choose The Cycle , By displaying  the Page of the
 Cycle you want to edit and Right click the 'Cycle Name'
 button, or click the littledown arrow on the 'Drop Box'
 & click the 'Cycle Name'there, or click the Cycle 'Orb'
 .       Then ,

  2. Choose the parameter that you  want to edit from 
the 'Drop Box', or Choose a 'canned' edit on Edit Menu

     Selecting a Parameter from the Drop Box
                will bring up the Edit Pop Up
      Pressing the help button there will put
       help text in the cycle screen, clicking
        the help text there, will remove it.

  3. First make sure your desired Option is selected.
      (the little circle with the dot in it)
        Cycle Type/ Orb Type/ Alarm Type

     Cycle Type
 The Cycle Type (Periodic, Annual, Date) can be changed
 in 'Name', or 'Period/Date' parameter of a Cycle with
 the option buttons.

   Periodic, 
     You can enter Days/Hours/Mins or Days.decimal
{to make your cycle orbit in the opposite direction
     follow the period with an "r" (retrograde orbit)}
     (entering a negative period will do the same.)
{To Indicate that the Value is approximate, follow
   it with 'ap'  (limits the 'Event Time' Display),
 as in Cyclockes full Moon cycle}

{{because of tidal/gravitational forces the Moon's
 orbit is not exactly periodic (but close), while
 Cyclocke is. I think Cyclocke should stay within
 5 degrees of the Moon's actual position}}}
 
    Up to 16 didgits will be used. (double precision)
 {any nonnumeric characters will be interpreted
       as seperators , unless placed at the end}

    The [Auto Bar] will set the period to the interval
          between Cyclocke's Time and the Saved Moment.
 
  
  Annual Date  
               Enter Month/Day, or 
 Click the [Displayed Clock Date]  (Auto Bar)
 to set the Cycles Date to Cyclockes month and day
   Period is set to 365 days

 Absolute Date
                Enter Month/Day/Year
    (the cycle period will will be that between
    Cyclocke's current time, and the entered date)
 or,
     Click the 'Displayed Clock Date' bar
      to set the Cycles Date to Cyclockes.
(the cycle period will will be that between
  Cyclocke's current time, and the Saved Moment)
{If you havn't saved moment (or stopped moment clock)
   the saved moment will be the computer clock time.}

    Day of month
      Enter   Day  of month 1-28 ,   or  Click the
 [Displayed Clock Date] bar  to set the Cycles Date
   to Cyclockes. Period is set to a month

 When setting hours and minutes for these date cycles,
an "A" or a "P" will overide your option button choice
of am/pm/24.
[Auto Bar] will set the cycle to Cyclockes time of day.



    " Epoch Angle "          (When it 'Happens') 
                    Click the  'Straight Up Now' bar
to set the Cycle to 'Happen' at Cyclockes current time.
  You can also set the angle with the Radius(see below).
Or you can even type numbers in the box in a trial and 
error manner. (angles are in radians)

...The Epoch angle is the angle that the 'Orb' has with
   respect to the center of the Cycle Screen at the
   arbitrary 'Epoch Date'. This date is used by Cyclock
    to count forward or backwards from. Cyclockes Epoch 
   is Febuary 28th of the year 1992 if I remember
   correctly. (the year I started writing
               Cyclocke for the Tandy 1000 GW Basic)...


        'Orb' Type
  The Cycle 'Orb' Type  Circle, Graphic, or None. 
  Can be changed in the Color/Icon, Radius, Size,
  Parameter of a Cycle with  the option buttons.

      The Cycle 'Orb'  Circle Color 
 Click [Display Color Options] and click on the color
 you want., or type in the color name , or the number,
 This imput will accept most simple color names, and
 the modifiers Dark, Light, and Bright.
 If you get an error message, Try a different choice.

    The Cycle 'Orb'   Image Icon
  Push the [Browse]  button  and point to a standard
  Icon (*.ico) file. (when you select a file, you can
  see its image before needing to [Keep] it. Or type
  in the path and filename to the icon of your choice. 
{If you move or delete an .ico file, that is
  referenced in a save, then that save wont load.}
 You can use any standard (32x32 non animated)
                  "*.ico" file as a cycle icon.
  To switch from a circle to graphic Icon,
   start from the circles Color parameter.

      Orb  Radius 
    The [Auto Bar] will let you left click on
 the cycle screen to set the cycle radius, or
 right click , to set the  radius and angle at
 the same time. Or type in your radius(100-1200)

       Orb  Width
    The [Auto Bar] will let you left click on
 the cycle screen to set the Orb Width.  Or
   type in your width (Recomend 100-500)
 





THREE         Alarms

     What you can do with Cyclockes Launcher Seems
 unlimited. It could Disk Jocky for a party, Pop up
 Notes to remind, could even make coffee, or feed
 the dog, if you had the right setup.

                Alarms
  You can set a Cycle Alarm to happen once, or
 to repeat the number of times of your choice.
   Choose Alarm from the Edit menu (the cycle
 must be selected first), or the Alarm parameter in the
 'Drop Box', and then click the appropriate option
 button.  If an Alarm is set it will  go off when the
 Orb's straight up from the Center. (at the 'Event Time'
 displayed)
    Cyclocke must be at the same minute as the Event
 Time for the Alarm to start. Cyclocke updates a few 
 times a minute when in Auto Now mode so the alarms will
 work fine in that mode. When Stepping or Auto Stepping,
 you must use minutes, if you want the alarms to go off.

    You can choose a specific Alarm for each Cycle.

        To pick an Alarm file,
 1. Choose Alarm from the Edit menu
      (the cycle must be selected first),
   or the Alarm parameter in the  'Drop Box', and
 then enter the path and filename of your choice,
   or Click the [Browse Bar] to browse for files.
 
Categories of Alarm   Files

     '.WAV' files  
Cyclocke will play .wav files itself and can stop them.

     Medias  ".MID",".RMI",".AVI",".MOV",".PIC",".IPC" 
Cyclocke will play these in Media Player, and will close 
the player, when it has "Stopped" (must be in Auto Mode)
{Medias that have played or been stopped will be closed
 when Cyclocke 'Updates' the screen (every Time Change)}
  You can cause an Update by clicking 'Moon Phase Box'.
 (in Win 3.1 Cyc will try to play
      ".FLC" and ".FLI" files in Media Player too)     

(You can also control 'Medias' from media player itself.
 If you 'Pause'a Media, Cyclocke will assume you want it
 left up, stacking any pending Medias until you 'Play',
 'Stop', or 'Close'it.)

     Executables ".PIF", ".EXE", ".COM", ".BAT"  
   Will Launch in any Windows environment 3.1 or +
 (95,98,NT)  (I havn't tested NT)

     Any Other Associated Files
(ones that launch when you doubleclick them in Windows)
 Will Launch in any Windows environment 95 or +
                  with their associated application.

          Stopping Alarms
 Clicking  [HUSH !], will stop WAVes that are playing.
 Clicking [STOP  Alarms !] will stop  WAVes,  and
further repetitions or any Alarms that have been cued.
 Right clicking [STOP Alarms!],[Hush],or[Save][Moment],
will toggle the Stop Alarms / Save Moment functionality
of the buttons.

        Alarms Past
  Choosing 'Edit' menu / 'Alarms Past' will display
all the Alarms that have gone off. You can then play
the Alarms again or delete items from this list.
    If you have the Fast Auto Edit option checked
Clicking 'Planet box' toggles the Alarms Past display
                                            on and off



FOUR    Save/Load File
  
  File Menu
       
         You can save your customized Cycles to disk
  That way you can have different CycleSets to  Load
 for different occasions. You can also save individual
 Cycles to Load into different Cycle Sets and pages.
 
   Load Cycle Set (All 21 Cycles, 3 Pages, and Options)
 
1. Click File / Load Cycle Set., and select the Cycle
 file you want to Load.  It is recommended that you
 save and load your cycles to and from the Cycles
 subdirectory of your Cyclocke Installation.

      Load Page	(7 Cycle Page)

1.  Choose the Page of Cycles to load over, right/left
    click the [Page] Button till the page you want is 
    displayed.
2.  Click File / Load Page, and select the Cycle file
    you want to Load.

      Load Cycle	   
 
 1.  Choose the Cycle You want to Load it over,
    Right  click the Cycle Button, click the 'Orb',
    or select it from the 'Drop Down'.
 2.  Click  File / Load Cycle and select the Cycle file
     you want to Load.

 
    Save Cycle Set (All 21 Cycles, 3 Pages, and Options)
 
 Options (from option menu) are saved with Cycle Sets. 
 
1. Click File/Save Cycle Set. (use 8 letters or less for
   the filename, I also recommend the default extentions)
   If you type just the filename the default extention                                        will be appended.

       Save Page        (7 Cycle Page)

1.  Choose the Page of Cycles to save, right/left click
   the [Page] Button till the page you want to save is                                                displayed

2.  Click File/SavePage. (use 8 letters or less)
	
      Save Cycle    To Save an individual Cycle;    	
1.  Choose the Cycle to save, Right  click the Cycle
   Button, click the 'Orb', or select it from the 
                                           'Drop Down'
2.  Click File/Save Cycle.

      Save Startup Set
                                   
 If you have the upgrade Then You can save a custom
Start Up Set that Cyclocke Loads as it starts up, and
your custom cycle set will be active whenever you run 
Cyclocke.  This is  saved in you Cyclocke instalation
directory as "default.ycs". If this file gets screwed
up some how you can delete it and Cyclocke will start
up with the default configuration.  (the free version
 will not try to load this file)
 
    Exit
	This option in the file menu will exit Cyclocke

          
 *    (when I can afford later versions of
 Visual Basic you will have long filenames)



FIVE     Options
   
      Daylight Savings
          (another stupid idea society has swallowed)

  Cyclocke has nothing to do with your systems clock as
far as daylight savings is concerned. It only addresses
this issue so that your Sun Orb will be over head at
1:00 pm as the real Sun is during daylight savings time.
(and the other Cycles and planets will also be in their
 proper place).
   You must set your computors clock to daylight savings
if you wish, and should make sure your cycles are doing
what  you want them to.
(e.g. you could load Dltsvclk.ycp so the page 2 cycles
 will look right, and should reset your alarms)

         Standard Time
  Cyclocke ignores daylight savings times in this mode.

         Daylight Savings time	
  Cyclocke sets the planets and cycles back an hour to
 compensate for  your clock being set ahead an hour.

         Auto Daylight Detection
  Automatically   detects daylight savings time, but
 makes the switch on Sunday at 12 pm, instead of the
 standard at 2 am .

      Planet Graphics
            I still have not found decent planet icons

      Flip Viewpoint	
  It's all relative, if you are looking down or up at
 our solar system , this option flips the view.
   Cyclock starts out with the view looking 'down' /
 facing 'South'. "Flip" if you want to see the Sun    
 rise in the 'map East'.

      Big Time	
  This option displays the time in Big format in the
 Planet Box.

      Fast Auto Edit	 
   This option presses the '[Keep] Changes' button
   for you somtimes after using the [Auto Bar] 
   (when editing the drop Box), and lets a click
 of the planet box toggle the Alarms Past display.

      Colors ,  Etc.
 You can change the Cycle Center
Icon, and the background colors for
the Cycle, and Planet screens, from
this menu.
	  
         Cycle Center Icon  Browse for new Icon

(the cycle center can be toggled to/from circle
    by clicking on it in the cycle box)
  	
         Cycle Box Background	Click color choice

         Planet Box Background	 Click color choice 





Contact Info   Email Address  Anithmi@Compuserve.com

      http://ourworld.compuserve.com/homepages/anithmi

        You can download the latest Cyclocke freeware,
        or Link to Upgrade Sales Sites, or contact me,
 At:
http://ourworld.compuserve.com/homepages/anithmi/cyclocke.htm
