Merge branch 'master' of ssh://svjatoslav.eu:10006/home/n0/git/qbasicapps
[qbasicapps.git] / automation / school clock / kell / juhend.org
1
2 Kooli Kell programmi kasutusjuhend
3
4 - 2002.10
5 - Svjatoslav Agejenko
6
7
8 * Kasutajaliides
9 Programm Kooli Kell on mõldud kella laskmiseks koolis, tundi sisse ja
10 välja.  Samuti juhib programm arvuti küljes olevat liidest,
11 kahekohaliste numbrite näitamiseks (minutid / tunnid), 3 klahvilist
12 klaviatuuri ja releed.  Tundi sisse minev kell on 1 pikk ning 1 l”em
13 helin. Väljaminev kell on 1 tavaline pikk helin. Programm loeb aega
14 arvuti süsteemsest kellast.  Kella laskmis ajad on organiseeritud
15 failidesse *.PP .  Aasta või päevaplaani muutmiseks tuleb redakteerida
16 vastavaid faile. Programm valib sobiva päevaplaani lähtudes
17 aastaplaanist, mis asub failis "aasta.ap" . Programmi saab kasutada
18 arvutil millele on printeri pesasse (LPT1) ”endatud spetsiaalne
19 liides, liidese skeem on failis "skeem.bmp". Liides omab kolme
20 nummerdatud nuppu paigutusega:
21
22 #+BEGIN_VERSE
23         <1>   <2>
24            <3>
25 #+END_VERSE
26
27 Programm on ettenähtud iseseisvalt töötama, kuid on ka võimalus
28 erandkorras kгitsi kella lasta, aega muuta jne.. Programm eristab
29 tavalisi nupuvajutusi ja topeltklõpse. Eesmärgiga suurendada
30 funktsionaalsust väheste nuppudega.
31
32 ** Nuppude funktsioonid peamenüüs:
33
34 + <1> klõps :: laseb kella tundi sisse
35 + <1> topeltklõps :: laseb kella tunnist välja
36
37 + <2> klõps :: läheb aja muutmis menüüsse
38 + <3> topeltklõps :: hakkab tööle uuendatud graafikuga, vajalik pвast
39      sisendfailide redigeerimist.
40
41 + <3> klõps :: ümardab süsteemse aja täistunnini, vajalik aja
42                sünkroniseerimiseks.
43 + <3> topeltklõps :: laeb süsteemse: aasta, kuu, päeva, tunnid,
44      minutid failist "sync.txt"
45
46 ** Nuppude funktsioonid aja muutmis menüüs:
47
48 + <1> klõps :: vähendab süsteemsed tunnid/minutid 1. võrra
49
50 + <2> klõps :: suurendab süsteemsed tunnid/minutid 1. võrra
51
52 + <3> klõps :: valib näitamiseks ja redigeerimiseks tunnid või minutid.
53 + <3> topeltklõps :: läheb tagasi peamenüüsse.
54
55 Aja muutmis menüüd tunneb ära selle järgi et indikaator tunnid või
56 minutid vilgub, mitte ei põle nagu peamenüüs.
57
58
59 * Faili AASTA.AP formaat: (aastaplaan)
60 : v       <kuu>-<päev>     <kuu>-<päev>     <päevaplaan>
61
62 Sõnast aja vahemik. Paneb paika päevaplaani antud
63 ajavahemikus. Esimene daatum peab kindlasti olema väiksem kui
64 teine. St. kui on tõesti vaja:
65
66 : v       10-4    2-1     eri
67
68 tuleb kirjutada:
69
70 : v       10-4    12-31   eri
71 : v       1-1     2-1     eri
72
73 Päevaplaan kehtib vahemiku esimesest päevast kuni vahemiku viimase
74 päevani.
75
76
77 : n       <kuu>-<päev>     <kuu>-<päev>     <nädalapäev>      <päevaplaan>
78
79 Sõnast nädalapäv. sama mis "v" kuid: paneb paika päevaplaani antud
80 ajavahemikus, antud nädalapäeval. Nädalapäeva kirjeldatakse numbriga.
81 nädala esimene päev on esmaspäev, talle vastab number 1.
82
83
84 : e       <kuu>-<päev> <päevaplaan>
85
86 Sõnast eriline. Paneb paika antud kuupävale antud pävaplaani. Sobib
87 hästi erakorraliste lüendatud või muul moel muudetud päevaplaanide
88 kehtestamiseks. Näiteks riigipühad, spordipäev jne.
89
90 Kui teatud päeva kohta ei käinud ühtegi kirjet siis toimib vaikimisi
91 "tuhi" päevaplaan. Kui teatud päeva kohta käis mitu kirjet siis jääb
92 peale viimane.
93
94
95
96 * Failide *.PP formaat: (päevaplaanid)
97 : # <tund>:<minut>  <kell>
98
99 Laseb antud ajal antud kella. Võimalikud kella helinad on:
100
101 | kella kood | vastav helin       |
102 |------------+--------------------|
103 | sis        | kell tundi sisse   |
104 | val        | kell tunnist välja |
105
106 * Faili SYNC.TXT formaat:
107 faili esimesel kahel real peab olema järgnev:
108
109 : KK-PP-AAAA
110 : TT:MM
111
112 kus:
113 | kood | tähendus |
114 |------+----------|
115 | KK   | kuu      |
116 | PP   | päev     |
117 | AAAA | aasta    |
118 | TT   | tunnid   |
119 | MM   | minutid  |