Come generare la documentazione java
In questo articolo tratteremo come creare commenti sulla documentazione
Java sdk contiene uno strumento che genera la documentazione html dai file sorgente.
Il comando da digitare per generare il codice è
javadoc -d doc *.java
dove doc è il nome della cartella dove si creeranno i documenti
*.java prende tutti i file java
I commenti iniziano con /** e finiscono con */.
Possiamo estrarre la documentazione da
package
classi
metodi
campi
Un commento a un metodo di una classe potrebbe essere
/**
stampa la stringa hello world
*/
public void stampa()
{
System.out.println(”hello world”);
}
Oltre ai commenti si possono inserire altri campi
@param variabile descrizione
@return descrizione
@throws classe descrizione
@author nome
@version testo
@since testo
@deprecated testo
@see collegamento
@param indica un parametro del metodo
@return indica cosa ritorna il metodo
@throws indica che il metodo puo generare eccezioni
@author nome dell’autore
@version versione del software
@since versione che ha introdotto questa funzione
@deprecated metodo o var che non dovrebbero essere piu usati
@see indica un collegamneto ipertestuale
Vediamo un esempio
/**
Questa classe fa qualche cosa
*/
public class Esempio
{
public static void main(String[] args)
{
new Esempio().stampa(”ciao”);
}
/**
stampa una stringa
@param nome stringa da stampare
@return non ritorna niente
*/
public void stampa(String nome)
{
System.out.println(nome);
}
}
digitiamo dal prompt
javadoc -d doc *.java
Creare un preloader con loader circolare
Obiettivo
In questo articolo tratteremo come creare un preloader con un loader circolare.
Il preloader
Con la parola preloader, identifichiamo una animazione che viene eseguita prima dell’animazione principale
Articolo
In flash, le funzioni che ci vengono d’aiuto per la costruzione del nostro preloader sono due:
getBytesLoaded()
che restituisce il numero di byte caricati fino a quel momento
e
getBytesTotal()
che ci da la dimesione dei byte da caricare.
La cosa che dobbiamo fare e’ un ciclo che finisce quando i bytes caricati sono uguali a quelli totali.
Per far cio’, dobbiamo mettere nei primi due frame, il ciclo e a partire dal terzo frame il filmato vero e proprio.
Nel primo e nel secondo frame mettiamo il seguente codice:
bytes_loaded = Math.round(getBytesLoaded());
bytes_total = Math.round(getBytesTotal());
getPercent = bytes_loaded/bytes_total;
if (bytes_loaded == bytes_total) {
gotoAndStop(3);
}
angolo= getPercent*100;
_root.loadText = Math.round(getPercent*100)+"%";
_root.circvel.gui_needle._rotation = angolo*3.6; //fa ruotare di max
360 gradi la lancetta
Nel secondo frame mettiamo come action in aggiunta:
_root.gotoAndPlay(1);
il loader circolare
Creiamo un nuovo movieclip come in figura

in cui mettiamo un cerchio con le barrette e poi mettiamo dentro questo
movieclip un altro movieclip che rappresenta la lancetta e gli diamo come nome
d’istanza "gui_needle".

Creiamo un nuovo layer nella scena principale e mettiamo il movieclip appena
creato dandogli come nome dìistanza "circvel" sia nel primo che nel secondo frame. La lancetta girera’ grazie a
_root.circvel.gui_needle._rotation = angolo*3.6;
Creare un preloader con loader circolare con flash
Obiettivo
In questo articolo tratteremo come creare un preloader che ci da tutte le
possibli informazioni in merito al filmato.
Il preloader
Con la parola preloader, identifichiamo una animazione che viene eseguita prima dell’animazione principale
Articolo
In flash, le funzioni che ci vengono d’aiuto per la costruzione del nostro preloader sono due:
getBytesLoaded()
che restituisce il numero di byte caricati fino a quel momento
e
getBytesTotal()
che ci da la dimesione dei byte da caricare.
La cosa che dobbiamo fare e’ un ciclo che finisce quando i bytes caricati sono uguali a quelli totali.
Per far cio’, dobbiamo mettere nei primi due frame, il ciclo e a partire dal terzo frame il filmato vero e proprio.
Nel primo e nel secondo frame mettiamo il seguente codice:
loading = getBytesLoaded();
Total = getBytesTotal();
_root.loaded = Math.round(loading/1024);
_root.totalk = Math.round(Total/1024);
_root.perccaric = Math.round((_root.loaded/Total)*100);
_root.banda=Math.round(((_root.getBytesLoaded()/1024)/)*10)/10;
_root.temporim=(Total-_root.loaded)/_root.banda;
if (loading >= Total) gotoandstop(3);
dove:
“_root.loaded” indica i byte caricati in quel momento
“_root.totalk” indica i byte totali
“_root.perccaric” indica la percentuale di caricamento
“_root.banda” indica la velocita’ di caricamento
“_root.temporim” indica i kb rimanenti
Per visulizzare wquesti valori possiamo mettere delle dynamic text,una per ogni valore
Nel secondo frame mettiamo come action:
_root.gotoAndPlay(1);
Creare un preloader con barra di avanzamento
Obiettivo
In questo articolo tratteremo come creare un preloader con barra di avanzamento.
Il preloader
Con la parola preloader, identifichiamo una animazione che viene eseguita prima dell’animazione principale
Articolo
In flash, le funzioni che ci vengono d’aiuto per la costruzione del nostro preloader sono due:
getBytesLoaded()
che restituisce il numero di byte caricati fino a quel momento
e
getBytesTotal()
che ci da la dimesione dei byte da caricare.
La cosa che dobbiamo fare e’ un ciclo che finisce quando i bytes caricati sono uguali a quelli totali.
Per far cio’, dobbiamo mettere nei primi due frame, il ciclo e a partire dal terzo frame il filmato vero e proprio.
Nel primo e nel secondo frame mettiamo il seguente codice:
bytes_loaded = _root.getBytesLoaded();
bytes_total = _root.getBytesTotal();
getPercent = Math.floor((bytes_loaded*100)/bytes_total);
if (bytes_loaded == bytes_total) {
gotoAndStop(3);
}
framenum= getPercent;
_root.barra.gotoAndStop(framenum); //va al frame della barra
corrispondente alla percentuale caricata (tra 0 e 100)
Nel secondo frame pero’ dobbiamo aggiungere
_root.gotoAndPlay(1);
affinche’ possa avvenire il ciclo.
La barra
Adesso creiamo la barra che ci rappresenta la percentuale di bitys caricati.
Creiamo un nuovo movieclip e lo mettiamo nello stage in un layer “barracaric” con nome d’istanza “barra” in corrispondenza del primo e del secondo frame dello stage.
Il movieclip sarà bene o male cosi:


Cioè una animazione di 100 frame che corrispondono alla percentuale che va da 1 a 100.
Creare un semplice preloader in flash
Obiettivo
In questo articolo tratteremo come creare un semplice preloader.
Il preloader
Con la parola preloader, identifichiamo una animazione che viene eseguita prima dell’animazione principale
Articolo
In flash, le funzioni che ci vengono d’aiuto per la costruzione del nostro preloader sono due:
getBytesLoaded()
che restituisce il numero di byte caricati fino a quel momento
e
getBytesTotal()
che ci da la dimesione dei byte da caricare.
La cosa che dobbiamo fare e’ un ciclo che finisce quando i bytes caricati sono uguali a quelli totali.
Per far cio’, dobbiamo mettere nei primi due frame, il ciclo e a partire dal terzo frame il filmato vero e proprio.
Nel primo e nel secondo frame mettiamo il seguente codice:
loading = Math.round(getBytesLoaded());
total = Math.round(getBytesTotal());
getPercent = Loading/Total;
if (Loading == Total) {
gotoAndStop(3);
}
e una animazione che viene visualizzata nel frattempo che il filmato sta caricando e tre input text, uno
che indica il totale a cui assegnamo la variabile “total” , uno che dice lo stato
corrente a cui assegniamo la variabile “loading” e uno che ci dice la percentuale “getPercent”
Nel secondo frame pero’ dobbiamo aggiungere
_root.gotoAndPlay(1);
affinche’ possa avvenire il ciclo.

Nella terza animazione, metteremo il nostro filmato e chiaramente un bel
stop();
Riprodurre un filmato al contrario in flash
Obiettivo
In questo articolo tratteremo come riprodurre un filmato al contrario.
Articolo
Supponiamo di voler riprodurre dal frame 40 al frame 20.
Supponendo di trovarci al frame 40 il codice è:
this.onEnterFrame = function() {
this.prevFrame();
if (this._currentframe == 20) {
delete this.onEnterFrame;
}
};

























