Files
FireBee_Setup/tools/phclock/doc/phclockd.htm
2022-10-02 10:09:40 +02:00

226 lines
12 KiB
HTML
Raw Blame History

<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>