Short:        Italian clock with transparency
Author:       clockita@essemmeeerre.mailshell.com (Stefano Maria Regattin)
Uploader:     clockita esseemmeerre mailshell com (Stefano Maria Regattin)
Type:         util/time
Version:      3.3
Replaces:     dev/basic/clockita.lha
Architecture: m68k-amigaos
Distribution: OK

Date: Wednesday, 5th May 2010
Name of the program: Orologio (clock)
This is an italian evolution of the example program "Clock.bb" supplied with
Blitz2; On AMINET you can find AmiBlitz2, a freeware evolution of this BASIC
programming language, made by Bernd Roesch.
I type all this because who does not have a copy of Blitz2 can tries AmiBlitz2
and examines my source code; modifying it he/she can create, for example, a
version of the clock in his/her language!
The reason for this upload is the correption of the missing colour squares in
the colours selection window.
You can change the clock font by activating the window and clicking the LEFT
MOUSE BUTTON; in this case you will see a new window containing some string
gadgets: the top-left gadget must be used to type the alarm's hour and mins; the
next gadget at the right must be used to activate or to deactivate the alarm;
the below gadget must be used to select the font: type the name of the font
(with or without the ".font" suffix) that you know it resides in your FONTS:
drawer; pressing RIGHTAMIGA-X keys you will clean the gadget; pressing
subsequently the ENTER key you be able to see all fonts that resides in your
FONTS: drawer and you  can select one of these.
In this case the last gadget at top-right will show the height of the font you
have selected and always you can modify it.
The following two gadgets are for type into the coordinates of the top-left
corner of the clock window.
The four arrows box named "Angolo fisso" is for select the fixed angle: this
angle (normally the top-left angle) will be ever locked on screen, giving the
other three to change their position depending on the settings; the coordinates
you type and save are related to this one; remember this when you change the
coordinates and/or the angle by tooltypes (see below).
The following two gadgets are to type into the coordinates of the bottom-right
corner of the clock window; the possible combinations of the four gadgets for
the top-left and for the bottom-right coordinates are shown as four arrows in
the gadget previously described and are: TOP-LEFT (standard), TOP-RIGHT,
BOTTOM-RIGHT and BOTTOM-LEFT.
The "Colori" gadget opens a new window to select the text colour and background
colour for the clock: point with the mouse pointer on a colour, and click the
LEFT MOUSE BUTTON to choose it as text colour, or click the RIGHT MOUSE BUTTON
to choose it as background colour.
Note that you cannot select the same colour as text colour and background
colour.
The following button enables to see the date, the hours or both.
The following button substitutes the RIGHT MOUSE BUTTON click no longer needed
to select the clock window either Normale (NORMAL)  or Ridotta (LITE); THERE IS
A NEW OPTION FROM THIS BUTTON (Fines invisib) THAT ALLOW TO HAVE THE CLOCK
INVISIBLE!
The "*** Salva ***" gadget permits to save any change.
You can specify the font name, the font size, the coordinates of the position of
the main window, the related angle, the text colour, the background colour, the
clock window mode and the clock time displacement mode by tooltypes; when the
program is launched if there are the tooltypes the informations are taken from
these, otherwise the parameters are set to default.
For who don't know, tooltypes are those parameters shown in the icon
information window that is shown if you select the voice INFORMATION of the
ICON menu.
If there is no tooltype DONOTWAIT, when you save the changes it will be added.
If you have activated the alarm, in the clock window will be shown a growing
bubble; you can deactivated it pointing with the pointer on the bubble and
clicking with the LEFT MOUSE BUTTON.
Enclosed in the archive there is a font made by me named "Data70.font"; I think
that this font is better than the font "2001.font" supplied with AMOS Pro.
This font is suited for italian language, for which the character "è" capital is
obtainable with the "§" character; however it have all the chars from (ASCII) 32
to 255 now!
Use it for games in low resolution, it is better! How to install the "Data70"
font: copy in your drawer "FONTS:" the file named "Data70.font".
Create in your drawer "FONTS:" the drawer "Data70" and copy into it the file
"13"; however there is a font installation script that runs using IconX from
Workbench or that you can run using the AmigaDOS Execute command from CLI.
If you have Blitz2 There is the source code (Orologio.bb2) for free
modifications; if you don't have it, you can however analyze the source code by
a text viewer like MultiView reading the file named "Orologio.text"; if you
load the source code in Blitz2 and you see some "?????" instead of keywords, you
cannot compile the program because your "deflibs" file do not have all the
keywords needed: you can find a sufficiently updated deflibs file in the
package "Blitz Support Suite", that was sold alone on three diskettes ("BSS1",
"BSS2" and  "BSS3"), that now are part of the "Ultimate Blitz Basic" CD, that
you can find for free as cd image into the BackToRoots site
(http://www.back2roots.org).
If you want to install by yourself the keywords needed, you must have all
the libs in BlitzLibs: and the command for AmigaDOS "MakeDefLibs" from Blitz
Support Suite; after this you can run from shell the command MakeDefLibs with no
parameters, that it will build up a new deflibs file from your libs in
BlitzLibs:, backing up the previously one.
The executable icon is a glowicon taken from my OS3.9 Workbench.
I have removed a previous version bug of gadget garbages in the settings window
that it occurred after the font was changed and then the settings window was
recalled; now there are problems no more.
I have corrected an error of a previous version that it happens if you have
deactivated the alarm clicking on the bubble: the alarm gadget in the settings
window did not deselect automatically; now the problem is solved.
Now The clock use your workbench presetted sound not only for the alarm, but
also to count the hours when these change.
I have corrected the program to allow correct window positioning on startup when
the screen height override the 512 pixel limit of the standard workbench; this
has been tested on a 800x600 True Colours WinUAE screen.
I have in mind to give a bigger colours palette choose for the owners of AMIGAs
(emulated or true) that have a graphics card but, at the moment, I don't know
how to do it.
Now the clock's window appears just above the screen bar, with or without the
font prefs; I have also enlarged the colour boxes when your workbench uses less
than sixteen colours.
Corrected today a minor bug in the clock's window angles related numeric gadgets
disabling.
Now are stated the color numbers.
There was a mistake into the year counting: now the problem is solved.
I have updated my font Data70, specifically I have lowered the Data70 font
underscore char.
I have stated one of the adresses of my homepage instead of one of my e-mails in
the Workbench titlebar.
I have updated my font Data70, specifically I have lowered the Data70 font
underscore char.
I have updated my font Data70, specifically I have raised the Data70 font tilde
char.
I have improved the program giving it an optional slim look by clicking the
RIGHT MOUSE BUTTON.
Now the clock is bottom border sensitive, it will resize its window properly.
Now all the windows should be border size sensitive.
Now you have the choice to see only the date or only the hours.
Now the day of the week is correct.
Now all the icons in the archive are ok.
Updated my site statement.
Now the clock window type can be choosed into the parameter window, the RIGHT
MOUSE BUTTON is no longer used to change the window type; there is also the best
colours searching for windows and gadgets.
Create a constant for the buttons height plus one line of separation.
Corrected some wrong things into the parameters procedure.
Now it seems that the time functions of my current Blitz2 environment work fine,
so I have disabled my debug time function routine.
NOW I HAVE ADDED THE OPTION TO MAKE THE CLOCK WINDOW INVISIBLE!
Now the invisible clock appearing is delayed to allow the workbench backdrop
loading.
Now the clock should appear correctly.
Added the invisible clock window update by RIGHT MOUSE CLICK after activating
the window and added the tooltype GRABDELAY for custom delay time for the
invisible clock window again appearing after the clock is launched.
Now the invisible clock window update is made by the program.
Now the clock appear correctly on a windowed Workbench if it the invisible
window clock mode is selected.
Now the colours of the colours window should be squared at any workbench screen
height.
Now there is a custom window instead of the requester for the credits to allow
the clock use on AMIGAs that have a Workbench version before of 3.0.
Now the date if alone does not flicker; clicking with the right mouse button
after exiting preferences window does pop up the credits window correctly now.
Now the date in the credits window is corrept.
I am not responsible of any damage this program can occurs to your system; you
use it at your own risk!
At end see my homepage to the following Internet address:
http://xoomer.virgilio.it/aregat/
or visit my commercial site to the following Internet address:
http://www.esseemmeerre.altervista.org/
The following is the same text in italian.

Data: mercoledì, 5 maggio 2010

Nome del programma: Orologio
Questa è un'evoluzione italiana del programma d'esempio "Clock.bb" fornito con
Blitz2; Potete trovare su Aminet AmiBlitz2, un'evoluzione gratuita di questo
linguaggio di programmazione BASIC, fatta da Bernd Roesch.
Dico tutto ciò perché chi non avesse una copia di Blitz2 può provare AmiBlitz2
ed esaminare il mio codice sorgente; apportando delle modifiche potrebbe, per
esempio, creare una versione dell'orologio nella sua lingua!
La ragione di questo caricamento è nella correzione della mancanza dei quadrati
dei colori nella finestra di selezione dei colori.
finestra dei crediti che compare se lasciate l'orologio e cliccate con il tasto
destro del mouse.
Potete cambiare il font dell'orologio attivando la finestra e cliccando con il
TASTO SINISTRO DEL MOUSE; in questo caso vedrete una nuova finestra contenente
alcuni campi per l'immissione di testo: il campo in alto a sinistra deve essere
usato per digitare l'ora ed i minuti dell'allarme; il campo successivo a destra
deve essere usato per attivare o disattivare l'allarme; il campo seguente in
basso deve essere usato per selezionare il font; digitate il nome del font (con
o senza il suffisso ".font") che sapete che si trova nel vostro cassetto FONTS:;
premendo i tasti AMIGA DESTRO e X pulirete il campo; premendo successivamente il
tasto ENTER sarete in grado di vedere tutti i font che si trovano nel vostro
cassetto FONTS: e potrete selezionarne uno; in questo caso il campo in alto a
destra mosterà l'altezza del font selezionato che potrete sempre modificare.
I seguenti due campi in basso servono per impostare le coordinate dell'angolo in
alto a sinistra della finestra dell'orologio.
Il quadrato con dentro quattro freccie serve per la selezione dell'angolo fisso:
questo angolo (solitamente l'angolo in alto a sinistra) rimarrà fisso sullo
schermo, lasciando liberi gli altri tre di cambiare la loro posizione a seconda
dei parametri; le coordinate che digitate e che salvate sono relative a questo
angolo; ricordavetelo quando cambiate le coordinate e/o l'angolo dai tooltype
(vedi di seguito).
I seguenti due campi in basso servono per impostare le coordinate dell'angolo in
basso a destra della finestra dell'orologio; le combinazioni possibili dei campi
per le coordinate dell'angolo in alto a sinistra e per quello in basso a destra
sono mostrate come freccie nel quadrato prcedentemente descritto e sono
rispettivamente: l'angolo in alto a sinistra (TOP-LEFT), che è la condizione
normale, l'angolo in alto a destra (TOP-RIGHT), l'angolo in basso a destra
(BOTTOM-RIGHT) e l'angolo in basso a sinistra (BOTTOM-LEFT).
Il bottone "Colori" apre una nuova finestra per la selezione dei colori del
testo e dello sfondo: puntate con il puntatore del mouse su un colore, e
cliccate il TASTO SINISTRO DEL MOUSE per sceglierlo come colore del testo, o
cliccate con il TASTO DESTRO DEL MOUSE per sceglierlo come colore di sfondo;
notate che non potete selezionare lo stesso colore per il testo e per lo sfondo.
Il bottone seguente serve per vedere solo la data, l'ora od entrambi.
Il bottone seguente sostituisce il clic del TASTO DESTRO DEL MOUSE che non è più
necesario per selezionare la finestra dell'orologio o normale (NORMAL) oppure
ridotta (LITE); C'E' UNA NUOVA OPZIONE DI QUESTO BOTTONE (Fines invisib) CHE
CONSENTE DI AVERE L'OROLOGIO INVISIBILE!
Il bottone "*** Salva ***" permette di salvare ogni cambiamento.
Potete specificare il nome del font, l'altezza del font, le coordinate della
posizione della finestra principale, l'angolo relativo, il colore del testo, il
colore dello sfondo, il tipo di finestra dell'orologio ed il tipo di
visualizzazione del tempo con i tooltype; quando lanciate il programma se ci
sono i tooltype le informazioni vengono prese da questi, altrimenti i parametri
sono impostati ai valori preimpostati.
Per chi non lo sapesse, i tooltype sono quei parametri mostrati nella finestra
delle informazioni dell'icona che esce se selezionate la voce INFORMAZIONI dal
menù ICONE.
Se non c'è il tooltype DONOTWAIT, verrà aggiunto quando salverete i cambiamenti.
Se avete attivato l'allarme, nella finestra dell'orologio comparirà una bolla;
potete disattivarlo in qualsiasi momento portando il puntatore del mouse sulla
stessa e cliccando con il TASTO SINISTRO DEL MOUSE.
Nell'archivio è incluso un font fatto da me che si chiama "Data70.font"; Io
credo che questo font sia migliore del font "2001.font" fornito con AMOS Pro.
Il mio font è adattato per la lingua italiana, per la quale il carattere "è"
maiuscolo è ottenibile con il carattere "§"; comunque ha tutti i caratteri dal
(ASCII) 32 al 255; usatelo in giochi a bassa risoluzione, rende meglio!
Come installare il font "Data70": copiate nel vostro cassetto "FONTS:" il file
"Data70.font". Create nel vostro cassetto "FONTS:" il cassetto "Data70" e
copiatevi il file "13"; comunque c'è uno script d'installazione per il font che
può essere eseguito usando IconX dal Workbench oppure che potete eseguire da CLI
usando il comando AmigaDOS Execute.
Se avete Blitz2 c'è il codice sorgente (Orlogio.bb2) per libere modifiche; se
non lo avete, potete lo stesso analizzare il codice sorgente leggendo con un
visualizzatore di testi come MultiView il file "Orologio.text"; se voi caricate
il codice sorgente in Blitz2 e vedete dei "?????" al posto dei comandi, non
potete compilare il programma perché il vostro file "deflibs" non ha tutti i
comandi richiesti; potrete trovare un file deflibs aggiornato nel pacchetto
"Blitz Support Suite", che era venduto a parte su tre dischetti ("BSS1", "BSS2"
e "BSS3"), che ora sono parte del CD "Ultimate Blitz Basic", che potete trovare
gratuitamente come immagine cd nel sito BackToRoots (http://www,back2roots.org).
Se volete installare da soli i comandi necessari, dovete avere tutte le librerie
in BlitzLibs ed il comando per AmigaDOS "MakeDefLibs" dal pacchetto Blitz
Support Suite; dopo di ciò potete eseguire il comando MakeDefLibs senza
parametri da shell, che creerà un nuovo file deflibs usando le vostre librerie
in BlitzLibs:, conservando il file deflibs precedente.
L'icona dell'eseguiblie è un'icona presa dal mio Workbench 3.9.
Ho rimosso il problema di una precedente versione che creava dei campi sbagliati
nella finestra dei parametri, il che avveniva dopo che il font veniva cambiato e
veniva richiamata la finestra stessa; ora non ci sono più problemi.
Ho corretto il difetto di una precedente versione che si verificava se si
disattivava l'allarme cliccando sulla bolla: il bottone per la selezione
dell'allarme nella finestra delle impostazioni non si deselezionava
automaticamente; ora il problema è risolto.
Ora l'orologio usa il suono preimpostato del workbench non solo per l'allarme,
ma anche per contare le ore quando cambiano.
Ho corretto il programma per avere un posizionamento corretto della finestra
all'avvio l'altezza dello schermo supera il limite del workbench standard dei
512 pixel; ciò è stato testato su uno schermo 800x600 in veri colori di WinUAE.
Ho in mente di dare una scelta di colori della tavolozza piu ampia per i
possessori di Amiga (emulati o no) che hanno una shceda grafica ma, al momento,
non so come fare.
Ora la finestra dell'orologio compare giusto sotto la barra dello schermo, con o
senza le preferenze delle fonti di carattere; ho anche allargato i quadrati dei
colori quando il vostro workbench usa meno di sedici colori.
Corretto oggi un piccolo baco nella disattivazione dei campi numerici relativi
agli angoli della finestra dell'orologio.
Ora vengono indicati i numeri dei colori.
C'era un errore nel conteggio dell'anno: ora il problema è risolto.
Ho aggiornato il mio font Data70, specificamente ho abbassato il carattere
trattino basso nel font Data70.
Ho indicato uno degli indirizzi dellla mia pagina invece di una dei miei
indirizzi di posta elettronica nella barra dello schermo del Workbench.
Ho aggiornato il mio font Data70, specificamente ho abbassato il carattere
trattino basso.
Ho aggiornato il mio font Data70, specificamente ho alzato il carattere tilde.
Ho migliorato il programma dandogli un'aspetto più semplice opzionale che si
ottiene cliccando il TASTO DESTRO DEL MOUSE.
Ora l'orologio dovrebbe essere sensibile allo spessore bordo in basso, si
ridimensionerà appropriatamente.
Ora tutte le finestre dovrebbero essere sensibili agli spessori dei loro bordi.
Ora avete la possibilità di vedere solo la data o solo l'ora.
Ora il giorno della settimana è corretto.
Ora le icone nell'archivio sono a posto.
Aggiornata l'indicazione del mio sito.
Ora il tipo di finestra può essere scelto nella finestra dei parametri, il TASTO
DESTRO DEL MOUSE non è più usato per cambiare il tipo di finestra; c'è anche la
ricerca dei migliori colori per le finestre e per i bottoni.
Creata una costante per l'altezza dei bottoni più una linea separatrice.
Corrette alcune cose sbagliate nella procedura dei parametri.
Ora sembra che le funzioni del tempo del mio attuale ambiente di Blitz2 vanno
bene, così ho disattivato la mia routine debacatrice per le funzioni del tempo.
ORA HO AGGIUNTO UN'OPZIONE PER AVERE LA FINESTRA DELL'OROLOGIO INVISIBILE!
Ora la comparsa dell'orologio invisibile è ritardata per consentire il
caricamento dello sfondo del workbench.
Ora l'orologio dovrebbe apparire correttamente.
Aggiunto il ridisegno della finestra invisibile dell'orologio col TASTO DESTRO
DEL MOUSE dopo aver attivato la finestra ed aggiunto il tooltype GRABDELAY per
tempi d'attesa personalizzati dell'attesa della comparsa dell'orologio quando
lanciato ancora per la finestra invisibile dell'orologio.
Ora l'aggiornamento della finestra dell'orologio se invisibile viene gestita dal
programma.
Ora l'orologio compare correttamente nella finestra del Workbench se è
selezionato il modo finestra invisibile.
Ora i quadretti dei colori della finestra dei colori dovrebbero essere quadrati
ad ogni altezza dello schermo del workbench.
Ora c'è una finestra proprietaria al posto del pannello di richiesta per i
per consentire l'uso dell'orologio sugli AMIGA che hanno il Workbench di una
versione precedente alla 3.0.
Ora la data se da sola non sfarfalla più; ora cliccando con il tasto destro
uscendo dalla finestra delle preferenze dovrebbe far comparire correttamente la
finestra dei crediti.
Ora il mese della data nella finestra dei crediti è corretto.
Non sono responsabile dei danni che questo programma può arrecare al vostro
sistema, lo usate a vostro esclusivo rischio!
Per finire guardate la mia pagina su Internet al seguente indirizzo:
http://xoomer.virgilio.it/aregat/
oppure guardate il mio sito commerciale su Internet al seguente indirizzo:
http://www.esseemmeerre.altervista.org/

Ciao!