Click above to get retro games delivered to your door ever month!

  Name:     clock12() - display a 12 hour ampm format clock
            unclock12() - turn off the 12 hour format clock

  Usage:    <logical> = clock12([<row>,<col>],[<attrib>])
            unclock12()

  Params:   integer <row> - the row to display the clock at
            integer <col> - the column to display the clock at
            integer <attrib> - color to use when displaying the clock,
            optional, if left off, then Clipper's standard foreground
            color is used.

            If no parameters are passed to clock12(), you can get the
            display status of the clock.

  Returns:  a logical value, .T. if the clock is displayed and
            running, .F. if the clock is not active.

 ---------------------------------- Example ---------------------------------

                 clock12(0,70,23)
                 * displays a clock in the upper right hand corner
                 * in color white on blue, 12 hour format

                 ? clock12()
                 * prints .F.

                 clock12(0,0,23)
                 * displays a clock in the upper left hand corner
                 * in color white on blue, 12 hour format

                 ? clock12()
                 * prints .T.

                 unclock12()
                 * disable the clock

                 ? clock12()
                 * prints .F.

  Note:     FUNCky automatically saves and restores the timer
            interrupt vector for you so there is no need to
            un-hook the clocks before you quit. However, it is
            necessary to disable the clocks before quitting because
            they have a habit of reappearing after the final
            cls() before they get turned off.

            You can move the clock around by simply calling it again
            with the new row/col coordinates. Be aware that the
            clock is displayed on the video page that was defined
            at the time you issued the clockxx() call. If you
            setpage() or setscreen() after you install the clock,
            the clock will still be displayed on the video page
            that was defined at the time you installed the clock.

  Warning!: Un-hook your clocks before running external programs
            because the clock will continue to display during
            the program your running. Some programs like
            Relational Report Writer from Concentric Data require
            that the timer vector be free and clear before they
            will run. Also, do not install the clock from a
            procedure that is contained within an overlay. The
            code for the clock could be swapped out of memory
            when a new overlay is brought in thereby causing
            a system crash.