first commit - moved from local dev to git

tools/phclock/CF_Pack1/ReadMe.txt

@@ -0,0 +1,111 @@
+
+
+                      Clock Face Extension Pack
+
+                                  by
+
+                            AtFaCT Factory
+
+                                 for
+
+                          WongCK's PH Clock
+
+
+                       Last Updated 30/11/2012
+
+
+
+Introduction
+------------
+
+For some time now, WongCK has been again producing software for 
+classic Atari TOS machines. He is totally open-minded to suggestions 
+by users. It is awesome what he has done so far, and this package is 
+supposed to support this fantastic work.
+
+
+What is it?
+-----------
+
+This extension pack contains about 24 clock faces for the great PH 
+Clock by WongCK. All of them are clippings and/or scaled versions of 
+existing pictures. I tried to find the best ones and to make them 
+into perfect clock faces.
+
+Only Atari machines (Falcon with CT60) and software were used to 
+create this package.
+
+
+Some Info on the Clock Faces
+----------------------------
+
+01     White Atari logo on orange background. The picture resembles 
+       the modern Apple look.
+02     Clipping of the cool red Atari logo on black background from a 
+       picture by Enhanced Buzz.
+03     Clipping of an awesome Atari wallpaper by tominosik1.
+04     Wonderful artistic Atari logo by SikkinDiVigil.
+05     Clipping of an Atari poster.
+06     Clipping of the nice Atari wallpaper mATARIx. An Atari logo 
+       designed like the one of the science fiction movie The Matrix.
+07     Cool Atari logo by Kamorek called Atari Air Show.
+08     Clipping of a well-designed Atari wallpaper by GameScanner.
+09     Clipping of a great Atari wallpaper by InvertedInferno.
+10     Logo of the famous Atari ST game company Thalion. They 
+       released games like Wings of Death or No Second Prize.
+11-14  Four different Motorola logos. This company produced the 68k 
+       processor family (Atari ST, TT, Falcon, clones and accelerator 
+       boards).
+15-24  Ten clocks by the German clock manufacturer Vaerst. The 
+       pictures have been kindly provided by them. Their fine clocks 
+       are made from natural state. If you like them, please visit 
+       www.vaerst.de.
+
+All images have a size of 120x120 pixels, so PH Clock do not have to 
+scale the pictures.
+
+
+Installation
+------------
+
+In the folder 'TC', you find the clock faces in true colour PNG 
+format (16 million colours). For resolutions with just 256 colours (8-
+bit screen modes), you can use special 256-colour PNG versions of the 
+pictures that can be found in folder '256C'. They were adapted in a 
+way they look as good as possible with the conversion routine of the 
+LDG plugin that PH Clock makes use of.
+
+Some rough in-depth information on colour reduction: Pictures with 
+sharp contrasts were dithered with the nearest-colour algorithm of a 
+converter and modified manually with a pixel painter since the LDG 
+system still dithered some colours. I replaced most of the dithered 
+colours with the best-matching non-dithered one. In order to know 
+which ones are not dithered by the LDG routine, in an 8-bit 
+resolution, I displayed a picture with all 256 screen colours with 
+zView (also uses LDG system). Finally, I converted the pictures with 
+zView. As continuous-tone images look good with the LDG routine, they 
+were converted only with it.
+
+You just have to replace the original clock faces in PH Clock's clock 
+face directory by the true- or 256-colour clock faces of this package.
+
+As all 256-colour pictures are converted for the NVDI 5 colour 
+palette, your desktop has to set this palette or you must install the 
+Atari VDI replacement NVDI 5, else the clock faces will not look 
+as intended.
+
+
+Disclaimer
+----------
+
+If any of the clock faces images/logo used infringe on any copyright 
+laws, please inform us at the e-mail address below and we will 
+promptly remove those images from the download package.
+
+
+Contact
+-------
+If you have any questions or comments regarding the clock faces, or 
+any other Atari related stuff, or you want me to add further clock 
+faces to this package, you can contact me via e-mail at 
+atfact@arcor.de.

tools/phclock/doc/phclock.htm

@@ -0,0 +1,216 @@
+<html>
+<head>
+<title>
+Probe House Software: PH Clock app
+</title>
+</head>
+<body text="Black" bgcolor="#F7D358">
+<center>
+<h1>PH Clock</h1>
+<i><a href="https://sites.google.com/site/probehouse/">Probe House Software</a></i><br>
+<i>by Wong CK</i><br>
+&#169; Copyright 2012-2017<br>
+<br>
+Version 1.4
+</center>
+<hr size=5>
+
+<h2>What is this?</h2>
+PH Clock is a simple program that displays the time on the desktop with a nice 
+    graphical clock face; rather than a plain black &amp; white or solid colour pattern 
+    clock. It also has hourly chime and an alarm.</br>
+PH Clock can also play sample by dropping on to it a sample file.    </br>
+PH Clock is freeware.<br>
+<br>
+
+<h2>Requirements</h2>
+<ol>
+<li>This runs on MINT and MagiC. Development was done on Mint 1,18.<br>While lower MINT versions are not fully verified/tested on, it should still run on Mint 1.16.</li>
+<li>You also need to have zView's codec, by Zoro, correctly installed (the codecs and mem.ldg only). All these are available from the 
+<a href="http://sourceforge.net/projects/z-tools/files/zview-beta8-1.zip/download">zView package</a> (latest release 8) or the latest <a href="http://ge.tt/8F3hScO/v/0?c">MintList build</a> by Mikro which fixes some bugs and support MagiC. zView codecs requires a VDI with a valid EDDI (like NovaVDI, NVDI &gt; 2.5 and fVDI, etc...).</li>
+    <li>Screen colours of 256 colours, but you can still use it if you have 16 colours 
+        only.</li>
+</ol>
+    <h2>Installation</h2>
+<ol>
+<li>Extract and copy all the files into a folder of your choice. For example 
+    d:\phclock.</li>
+<li>Make sure that the IMG subfolder is created inside the folder. For example d:\phclock\img. The filenames must be in
+either uppercase or lowercase. Do not mix uppercase and lowercase in the filename.</li>
+<li>Make sure that the PNG images are inside this IMG folder.</li>
+<li>The 68020-60 version is named as phclock.prg, the Firebee version as phclkcf.prg and M68000 version as phclk00.prg.</li>
+<li>Copy all zView codecs into C:\GEMSYS\LDG\CODECS folder. Create that folder if you do not already have it.</li>
+<li>Double click phclock.prg to run it !!</li>
+</ol>
+You could make PH Clock run everytime you reboot by using the <b>run</b> command in your Xaaes.cnf file.
+
+<h2>The App Window</h2>
+<table>
+<tr>
+<td><ul>
+<li>The app window shows the time of the computer in a clock face.</li>
+<li>The clock face graphics is a PNG file that can be changed</li>
+<li>Options to display clock face markings &amp; seconds hand. Colours of the hands.</li>
+</ul></td>
+<td><img src="clock1.jpg" style="height: 108px; width: 109px" /></td>
+</tr>
+</table>
+
+<h2>Moving the Window</h2>
+<table>
+<tr>
+<td><img src="clock2.jpg" style="height: 126px; width: 143px" /></td>
+<td><ul>
+<li>You can move the clock around your desktop.</li>
+<li>Click on any part of the clock and press until the mouse changes to a hand</li>
+<li>Now you can simple move the rubber band box to the new desktop location and 
+    release the mouse</li>
+    <li>The app window will be moved there</li>
+</ul>
+</td>
+</tr>
+</table>
+
+<h2>Usage - options</h2>
+<table>
+<tr>
+<td valign="top" width="50%" ><ul>
+<li><u>Right click</u> on the clock app window for a popup menu</li>
+<li>Click on <b>Next Picture</b> to cycle to the next clock face picture</li>
+<li>Click on <b>Prev Picture</b> to cycle back to the previous clock face picture</li>
+<li>Select <b>configuration</b> to get into the configuration window (see next section)</li>
+<li>Select <b>Smart Audio</b> so that PH Clock does not interrupt another player playing audio</li>
+<li>Select <b>Quit</b> to exit PH Clock</li>
+<li>The <b>About</b> displays.... well, the about of the app</li>
+<li>The left &amp; right arrow keys also changes the clock face picture.</li>
+</ul>
+</td>
+<td><img src="clock3.jpg" valign="top" style="height: 149px; width: 143px" /></td>
+</tr>
+</table>
+
+<h2>Configuration Window</h2>
+<table>
+<tr>
+<td ><img src="clock4.jpg" valign="top" style="height: 254px; width: 205px"/></td>
+<td valign="top">
+    <p>
+&nbsp;&nbsp;&nbsp; Here you can make changes to the look of the clock and set the chime and alarm.</p>
+<ul>
+<li>Toggle <b>Show seconds</b> to show the second hand ticking around the clock.</li>
+<li>Toggle <b>Show markings</b> to show hours markings on the clock.</li>
+<li>Toggle <b>Thin hands</b> for the clock hands. Sometimes due to resolution, you 
+ may need thinner clock hands to get it to display. I don&#39;t know why, but I 
+ stumbled on to this solution.</li>
+<li>Toggle <b>Use Bios time</b> force using BIOS to get the time rather than localtime function. The seconds are
+incremented by 2 in this mode. This is a feature of BIOS time.</li>
+<li>Colours - click on the colour bar to change the colour for the following objects
+<ul>
+<li>Hour hand, Minutes hand, Seconds hand and the face markings.</li>
+</ul>
+</li>
+<li>Toggle the hourly <b>Chime</b> on and off.</li>
+<li>Toggle the <b>Alarm</b> on and off and enter the time for the alarm. The time is in 24 hours format.</li>
+</ul>
+    </td>
+</tr>
+</table>
+
+<h2>Alarm mode, alarm sound and chime</h2>
+<table>
+<tr>
+<td>
+The alarm and alarm time is set in the configuration window. When the alarm rings, to turn off the alarm, <b>double click</b> on the clock face window. The alarm will also turn off automatically after one minute.<br>The hourly chime is also set in the configuration window.<br><br>
+The default alarm and chime samples are located in the same folder of PH Clock. The alarm & chime sound samples can be changed easily by following these procedures:
+<ol>
+<li>While pressing the ALT key, drag & drop the sample file you want to use onto PH Clock window.</li>
+<li>Select Alarm or Chime from the popup selection. The sample will be used for the selected function.</li>
+</ol>
+Note: PH Clock does not make a copy of the selected sample but remembers the location of it, so please do not move or delete your selected sample.
+</td>
+<td><img src="clock5.jpg"  /></td>
+</tr>
+</table>
+
+
+
+<h2>Integrated Sample player</h2>
+Integrated into PH Clock is a DMA sample player. This gives PH Clock the ability to play the following sound sample format:<br />
+<ul>
+<li>Wav (PCM, ADPCM, A-law, <20>-Law, IMA ), AU ( SUN ), SND ( Mac), AVR, AIF, VOC ( sound blaster), AIFF (Amiga) and raw.</li>
+<li>8 bit and 16 bits samples, signed/unsigned samples.</li>
+<li>Stereo/Mono supported.</li>
+<li>Playback speed of 5500, 6258, 7333, 8000, 11025, 12516, 16000, 18900, 22150, 25033, 32000, 37800, 44056, 44100, 48000 & 50066 Hz.</li>
+</ul>
+Note that the newer Wave files found in MS Windows are of MPEG format, which is not supported.<br><br>
+PH Clock can be configured to play sample file by simply configurating the desktop SET APPLICATIONS for PH Clock for a sample type or simply by drag and dropping a sample file onto PH Clock window. To listen again to a sample, double click on PH Clock window. 
+
+<ul>
+<li>Double click on PH Clock window to listen to a previously loaded sample.</li>
+<li>Press ALT and double click on PH Clock window to listen to the alarm sample.</li>
+<li>Press CTRL and double click on PH Clock window to listen to the chime sample.</li>
+</ul>
+<br>
+
+<h2>Config and Clock face graphic files</h2>
+The config file is called <i>phclock.cfg</i> located at the same folder of the 
+    app. It is created by the app itself on exit. it contains settings information 
+    as set in the configuration window. If something goes wrong and you need to 
+    reset the settings, just delete the phclock.cfg file.<br />
+<br />
+    The clock face graphics files are located inside the IMG subfolder. The filename 
+    of the graphics files must be <b>CF<i>nn</i>.PNG</b>.
+    <ol>
+        <li>You can use your own graphics for the clock face. Just add to the graphics files 
+            in the IMG folder, and follow the rules below.</li>
+    <li>The file type must be PNG. Any amount of colours can be used. The clock size is 
+        small at 120 x 120 pixel. Graphics file will be scaled down to this size.</li>
+    <li>Scaling of the graphics file may take several seconds. The included small 
+        graphic files already takes 2-3 seconds on my TT. So larger ones will take 
+        longer.</li>
+    <li>The filename must begin with CF followed by a numeric increasing sequence. CF 
+        stands for Clock Face in this case.</li>
+    <li>The numeric sequence must be continuous, if a number is skipped, it will stop 
+        loading at the skipped number.</li>
+</ol>
+ 
+<h2>Limitations</h2>
+<ul>
+<li>Only 2 Atari themed clock face is available. Please make your own. </li>
+<li>Time zone information must be setup in your system (zic &amp; tzinit) othewise the system will show UTC time.</li>
+<li>Clock face images filename cannot have mixed case, it will crash the application.</li>
+</ul>
+
+<h2>Version history</h2>
+Version 1.4  : Fixed NAES GUI issues.<br />
+Version 1.33 : Smart audio and re-order the options menu.<br />
+Version 1.31 : Real per minute redraw.<br />
+Version 1.31 : Simulated every sec redraw for MagiC in non-bios time mode.<br />
+Version 1.31 : Removal of red square in config window.<br />
+Version 1.30 : MagiC compatible.<br />
+Version 1.30 : Make PH Clock into a DMA sample player.<br />
+Version 1.30 : Configurable alarm and chime sounds.<br />
+Version 1.21 : Briefly tested on Mint 1.16, removed required Mint version.<br />
+Version 1.20 : Added choime and alarm function.<br />
+Version 1.20 : Fixed mouse cursor blinking<br />
+Version 1.01 : Silently exiting if RSC cannot be loaded when running off ext2 fs (or any fs which allows upper and lowercase).<br />
+Version 1.01 : Memory violation when exiting from a Memory Protected Mint.<br />
+Version 1.01 : Error getting object tree in MyAES.<br />
+
+<h2>Thanks</h2>
+Thanks to the gang at Atari-Forums.com and OL and jfl for the support. Latz for German translation. AtFact for icons.
+
+<h2>Future developements</h2>
+None planned so far.
+<br />
+<br />
+<br />
+<hr>
+<center>
+<font size=-1>Questions, comments, or error reports?  Please leave a post at
+<a href="http://www.atari-forun.com">Atari-Forum.com</a><br>
+Visit my web site at <a href="https://sites.google.com/site/probehouse/">https://sites.google.com/site/probehouse/</a>
+</font>
+</center>
+</body>
+</html>

tools/phclock/doc/phclockd.htm

@@ -0,0 +1,225 @@
+<html>
+<head>
+<title>
+Probe House Software: PH Clock
+</title>
+</head>
+<body text="Black" bgcolor="#F7D358">
+<center>
+<h1>PH Clock</h1>
+<i><a href="https://sites.google.com/site/probehouse/">Probe House Software</a></i><br>
+<i>by Wong CK</i><br>
+&#169; Copyright 2012-2017<br>
+<br>
+Version 1.4<br>
+<i>Deutsche &Uuml;bersetzung von Latz</i>
+</center>
+<hr size=5>
+
+<h2>&Uuml;bersicht</h2>
+PH Clock ist ein kleines Uhren-Programm f&uuml;r Atari-Computer. Es bietet eine h&uuml;bsche Analog-Anzeige 
+mit w&auml;hlbaren Hintergrundmotiven und Farben f&uuml;r alle Uhren-Elemente. Zus&auml;tzlich verf&uuml;gt PH Clock 
+&uuml;ber eine Alarm- und Stundensignal-Funktion. Als Besonderheit kann PH Clock per Drag and Drop Musiksamples abspielen.
+<br>
+PH Clock ist <b>Freeware.</b><br>
+<br>
+
+<h2>Systemvoraussetzungen</h2>
+<ol>
+<li>Atari-Computer (Original, Emulator oder Klon).</li>
+<li>PH Clock l&auml;uft mit MiNT oder MagiC. Es wurde auf MiNT 1.18 entwickelt, funktioniert aber auch mit MiNT 1.16.</li><br>
+<li>Es m&uuml;ssen ebenfalls die Codecs und die Datei "mem.ldg" vom Programm "zView" (von Zorro) installiert sein. 
+Alle Codecs finden sich hier: <a href="http://sourceforge.net/projects/z-tools/files/zview-beta8-1.zip/download">zView (Beta-Release 8)</a><br>
+Oder man verwendet den neuesten <a href="http://ge.tt/8F3hScO/v/0?c">MintList-Build</a> von Mikro; dieser behebt ein paar Fehler und bietet 
+zudem korrekte Funktionen auch f&uuml;r MagiC.</li>
+<li>Die zView-Codecs ben&ouml;tigen ein VDI mit EdDI-Unterst&uuml;tzung wie z.B. NVDI &gt; 2.5, NovaVDI, fVDI etc.</li>
+<li>Eine Bildschirmaufl&ouml;sung mit mindestens 16 Farben, besser jedoch 256 Farben oder mehr.</li>
+</ol>
+<i>Anmerkung d. &Uuml;bersetzers:</i> Die Bilder in dieser Anleitung zeigen die englische Version.
+<br><br>
+
+<h2>Installation</h2>
+<ol>
+<li>Archiv entpacken und den Inhalt in einen selbstgew&auml;hlten Ordner kopieren, z.B. C:\phclock.</li>
+<li>Bitte pr&uuml;fen, ob der Unterordner "IMG" mit den Bilddateien korrekt entpackt wurde (z.B. C:\phclock\img\). Die Namen des Ordners und der 
+Bilddateien d&uuml;rfen keine gemischte Gro&szlig;/Kleinschreibung enthalten, also entweder alles GROSS oder alles klein.
+<li>Die 68020-60 Version hei&szlig;t PHCLOCK.PRG, die Firebee-Version hei&szlig;t PHCLKCF.PRG und die M68000er Version hei&szlig;t PHCLK00.PRG.</li>
+<li> Aus dem zView-Archiv die Datei "mem.ldg" in den Ordner C:\GEMSYS\LDG und alle zView-Codecs in den Ordner C:\GEMSYS\LDG\CODECS kopieren 
+(Ordner bitte selbst erstellen falls nicht vorhanden).</li>
+<li>Zum Starten auf das entsprechende PRG doppelklicken.</li>
+</ol>
+Man kann PH Clock beim Systemstart automatisch starten lassen; entweder durch den Befehl <b>run &lt;Pfad/zu/phclock.prg&gt;</b> 
+in der Datei xaaes.cnf oder durch den jeweils verwendeten Desktop.<br>
+
+<h2>Das Hauptfenster</h2>
+<table>
+<tr>
+<td>
+<ul>
+<li>Im Hauptfenster wird die Zeit auf einer Analog-Uhr angezeigt.</li>
+<li>Der Uhren-Hintergrund ist eine frei w&auml;hlbare Bilddatei.</li>
+<li>Die Farben f&uuml;r alle Uhren-Elemente sind getrennt einstellbar.</li>
+</ul>
+</td>
+<td><img src="clock1.jpg" style="height: 108px; width: 109px" /></td>
+</tr>
+</table>
+
+<h2>Das Hauptfenster verschieben</h2>
+<table>
+<tr>
+<td><img src="clock2.jpg" style="height: 126px; width: 143px" /></td>
+<td>
+<ul>
+<li>Die Uhr kann auf dem Desktop frei verschoben werden.</li>
+<li>Dazu klickt man auf das Fenster und h&auml;lt die linke Maustaste gedr&uuml;ckt, bis der Mauszeiger sich in eine Hand verwandelt.</li>
+<li>Jetzt kann man (mit gedr&uuml;ckter Maustaste) die "Gummibandbox" an die neue Position verschieben und dann die Maustaste loslassen.</li>
+<li>Die Fensterposition wird in der Konfigurationsdatei gespeichert.</li>
+</ul>
+</td>
+</tr>
+</table>
+
+<h2>Benutzung</h2>
+<table>
+<tr>
+<td valign="top" width="50%" ><ul>
+<li>Mit einem <b>Rechtsklick</b> im Hauptfenster &ouml;ffnet sich ein Popupmen&uuml; mit folgenden Optionen:</li>
+<li><b>N&auml;chstes Bild</b> wechselt zum n&auml;chsten (im Ordner "IMG") verf&uuml;gbaren Hintergrundbild.</li>
+<li><b>Vorh. Bild</b> wechselt zum vorherigen Hintergrundbild.</li>
+<li><b>Konfiguration</b> &ouml;ffnet den Konfigurations-Dialog.</li>
+<li>Die Option <b>Smart Audio</b> blockiert die Audioausgabe von PH Clock wenn ein anderer Sound-Player aktiv ist. Somit wird 
+Euer Lieblingslied nicht vom Stunden- oder Alarmsignal unterbrochen.</li>
+<li><b>Beenden</b> beendet das Programm, die Einstellungen werden gespeichert.</li>
+<li><b>&Uuml;ber PH Clock</b> erkl&auml;rt sich selbst.</li>
+<li>Mit den Tasten PFEIL RECHTS und PFEIL LINKS kann man ebenfalls zwischen den Hintergrundbildern wechseln.</li>
+</ul>
+</td>
+<td><img src="clock3.jpg" valign="top" style="height: 149px; width: 143px" /></td>
+</tr>
+</table>
+
+<h2>Konfiguration</h2>
+<table>
+<tr>
+<td><img src="clock4.jpg" valign="top" style="height: 254px; width: 205px"/></td>
+<td valign="top">
+<p>&nbsp;&nbsp;&nbsp; Hier stellt man PH Clock nach seinen pers&ouml;nlichen W&uuml;nschen ein.</p>
+<ul>
+<li><b>Sekunden anzeigen</b>: Der Sekundenzeiger wird angezeigt/nicht angezeigt.</li>
+<li><b>Stundenmarkierungen zeigen</b>: Es werden farbige Markierungen f&uuml;r die Stunden angezeigt.</li>
+<li><b>D&uuml;nne Zeiger</b>: Je nach Bildschirmaufl&ouml;sung sind zur korrekten Darstellung d&uuml;nnere Zeiger notwendig. Den 
+genauen Grund daf&uuml;r weiss ich nicht; diese Einstellung l&ouml;st jedoch das Problem.</li>
+<li><b>BIOS-Zeit verwenden</b>: Hiermit wird nicht die localtime-Funktion von MiNT verwendet, sondern die BIOS-Zeit. In diesem Fall 
+springen immer 2 Sekunden auf einmal weiter, dies ist eine Besonderheit der BIOS-Uhr.</li>
+<li><b>Farben</b> - Mit einem Klick auf die farbigen Balken kann man die Farben folgender Objekte ver&auml;ndern:</li>
+<ul>
+<li>Stundenzeiger, Minutenzeiger, Sekundenzeiger und Stundenmarkierungen.</li>
+</ul>
+<li><b>Alarm &amp; Stundensignal</b> - Hier kann man:</li>
+<ul>
+<li>das <b>Stundensignal</b> an/ausschalten.</li>
+<li>den <b>Alarm</b> an/ausschalten und die Alarmzeit eingeben. Es wird das 24-Stunden Format verwendet.</li>
+</ul>
+</ul>
+</td>
+</tr>
+</table>
+
+<h2>Alarm-Modus, Alarm-Sound und Stundensignal</h2>
+<table>
+<tr>
+<td>
+Wenn der Alarm ert&ouml;nt kann dieser mit einem <b>Doppelklick auf die Uhr</b> ausgeschaltet werden. 
+Ansonsten beendet sich der Alarm nach 1 Minute von selbst.<br><br>
+Die Standard-Sounds f&uuml;r Alarm und Stundensignal befinden sich im selben Ordner wie PH Clock. Die Sounds k&ouml;nnen einfach durch andere Sounddateien 
+ersetzt werden:
+<ol>
+<li>Mit gedr&uuml;ckter ALT-Taste die gew&uuml;nschte Sounddatei auf das PH Clock Hauptfenster ziehen.</li>
+<li>Im daraufhin erscheinenden Popupmen&uuml; "Alarm" oder "Std.-Signal" ausw&auml;hlen und schon wird der Sound f&uuml;r die gew&auml;hlte Funktion verwendet.</li>
+</ol>
+<b>WICHTIG:</b> PH Clock erzeugt (und benutzt) <u>keine Kopie</u> dieses Sounds, sondern merkt sich lediglich den <u>Pfad zur Sounddatei</u>. Wenn man die Datei(en) 
+also l&ouml;scht oder verschiebt, so kann PH Clock diese nicht mehr abspielen.
+</td>
+<td><img src="clock5.jpg"  /></td>
+</tr>
+</table>
+
+
+<h2>Integrierter Sample-Player</h2>
+PH Clock beinhaltet ausserdem einen DMA Sample-Player. Das macht PH Clock zum universellen Player f&uuml;r folgende Soundformate:<br />
+<ul>
+<li>WAV (PCM, ADPCM, A-law, <20>-Law, IMA), AU (SUN), SND (Mac), AVR, AIF, VOC (Sound Blaster), AIFF (Amiga) und RAW.</li>
+<li>8-Bit und 16-Bit Samples, signed oder unsigned.</li>
+<li>Stereo/Mono.</li>
+<li>Samplefrequenzen 5500, 6258, 7333, 8000, 11025, 12516, 16000, 18900, 22150, 25033, 32000, 37800, 44056, 44100, 48000 & 50066 Hz.</li>
+<li>Achtung: Neuere .WAV-Dateien von MS Windows sind komprimiert (MPEG-Format), dieses wird <b>nicht</b> unterst&uuml;tzt.</li>
+</ul>
+<br><br>
+Man kann also einfach eine Sounddatei auf das PH Clock Hauptfenster ziehen und diese wird sofort abgespielt. Oder man meldet <b>phclock.prg</b> 
+beim jeweils verwendeten Desktop als ausf&uuml;hrendes Programm f&uuml;r die o.a. Soundformate an, dann werden solche Sounds auch durch Doppelklick 
+auf die Datei abgespielt.
+<ul>
+<li>Ein Doppelklick auf das PH Clock Hauptfenster spielt ein Sample erneut ab.</li>
+<li>Mit ALT+Doppelklick auf das PH Clock Hauptfenster kann man sich den Alarmsound anh&ouml;ren.</li>
+<li>Mit CTRL+Doppelklick auf das PH Clock Hauptfenster kann man sich das Stundensignal anh&ouml;ren.</li>
+</ul>
+<br>
+
+
+<h2>Konfigurationsdatei und Hintergrundbilder</h2>
+Die Konfiguration wird in der Datei <i>phclock.cfg</i> im Programmordner gespeichert. Diese wird bei Programmende automatisch gesichert 
+und enth&auml;lt alle Einstellungen. Wenn die Datei gel&ouml;scht wird startet das Programm das n&auml;chste Mal mit den Standardeinstellungen.<br>
+<br>
+Die Hintergrundbilder f&uuml;r die Uhr befinden sich im Ordner "IMG". Die Dateien m&uuml;ssen nach dem Muster <b>CF<i>nn</i>.PNG</b> benannt sein.<br>
+Man kann eigene Bilder als Hintergrund f&uuml;r PH Clock verwenden, dazu kopiert man einfach die Bilddatei(en) in den Ordner "IMG". 
+Hierbei sind folgende Regeln zu beachten:
+<ol>
+<li>Die Bilddatei mu&szlig; im PNG-Fomat vorliegen, die Farbanzahl ist hierbei egal. Die Gr&ouml;sse des Hauptfensters ist 120 x 120 Pixel, 
+gr&ouml;ssere Bilder werden auf dieses Ma&szlig; herunterskaliert.</li>
+<li>Die Skalierung der Bilddateien kann ein paar Sekunden dauern. Mein TT ben&ouml;tigt zum Skalieren der beiliegenden kleinen Bilder 2-3 
+Sekunden, gr&ouml;ssere Bilder brauchen also l&auml;nger.</li>
+<li>Der Dateiname mu&szlig; mit "CF" beginnen, gefolgt von einer ansteigenden Nummerierung. CF steht hier f&uuml;r "Clock Face".</li>
+<li>Die Nummerierung mu&szlig; <b>durchgehend</b> sein. Wenn die Reihenfolge unterbrochen ist, so werden die nachfolgenden Bilder nicht geladen.</li>
+</ol>
+ 
+<h2>Einschr&auml;nkungen</h2>
+<ul>
+<li>Es liegen bisher nur 6 Hintergrundbilder bei, also "Selbst ist der Atarianer" :-) Oder man l&auml;dt sich das "CF_PACK1.ZIP" herunter, das 
+enth&auml;lt 24 Hintergrundbilder f&uuml;r alle Gelegenheiten, erstellt von AtFaCT.</li>
+<li>Die MiNT-Zeitzoneneinstellungen (zic &amp; tzinit) m&uuml;ssen korrekt sein, ansonsten wird die UTC-Zeit angezeigt.</li>
+<li>Die Dateinamen der Bilddateien d&uuml;rfen <b>keine gemischte Gro&szlig;/Kleinschreibung</b> enthalten, sonst st&uuml;rzt PH Clock ab.</li>
+</ul>
+
+<h2>Versions-Updates</h2>
+Version 1.4  : Fixed NAES GUI issues.<br />
+Version 1.33 : Smart audio and re-order the options menu.<br />
+Version 1.31 : Real per minute redraw.<br />
+Version 1.31 : Simulated every sec redraw for MagiC in non-bios time mode.<br />
+Version 1.31 : Removal of red square in config window.<br />
+Version 1.30 : MagiC compatible.<br>
+Version 1.30 : Make PH Clock into a DMA sample player.<br>
+Version 1.30 : Configurable alarm and chime sounds.<br>
+Version 1.21 : Briefly tested on Mint 1.16, removed required Mint version.<br>
+Version 1.20 : Added choime and alarm function.<br>
+Version 1.20 : Fixed mouse cursor blinking<br>
+Version 1.01 : Silently exiting if RSC cannot be loaded when running off ext2 fs (or any fs which allows upper and lowercase).<br>
+Version 1.01 : Memory violation when exiting from a Memory Protected Mint.<br>
+Version 1.01 : Error getting object tree in MyAES.<br>
+
+
+<h2>Danksagung</h2>
+Thanks to the gang at Atari-Forums.com and OL and jfl for the support. Latz for German translation. AtFact for icons.
+
+<h2>Zuk&uuml;nftig geplante Erweiterungen</h2>
+Bisher keine.<br>
+<br>
+<hr>
+<center>
+<font size=-1>Fragen, Kommentare oder Fehlermeldungen? Bitte eine Nachricht bei
+<a href="http://www.atari-forun.com">Atari-Forum.com</a>schreiben.<br>
+Besucht meine Web site: <a href="https://sites.google.com/site/probehouse/">https://sites.google.com/site/probehouse/</a>
+</font>
+</center>
+</body>
+</html>

tools/phclock/readme.txt

@@ -0,0 +1,14 @@
+
+
+PH Clock is a simple program that displays the time. 
+It features changable graphical clock face, coloured hands, chime and alarm.
+The sound of the alarm and chime can be any sound file of your choice.
+Integrated to it is a sample player playing Wave, Au, SND etc.
+
+Please see the short documentation inside the DOC folder for installation.
+
+Thanks to Latz for Geman translation, AtFaCT for icons.
+Thanks !!
+
+Wongck
+May 2017