I D R A
Ipertesto Dinamico per Racconti d'Avventura

Manuale dell'autore
rev 1.0, © 2000 Enrico Colombini

 

qui puoi scaricare IDRA con il manuale

qui puoi visitare il sito ufficiale dell'autore Enrico Colombini con esempi e giochi scaricabili

Guida di riferimento

Appendice A

1

Legenda

5

Pagina di Informazioni

2

Variabili

6

Funzioni di Idra

Funzioni di creazione pagina

3

Funzioni chiamate da Idra

Funzione di avvio

7

Funzioni di cambio pagina

4

Funzione di pagina e relative opzioni

8

Funzioni varie

 

Funzioni di cambio pagina

 
vai(pagina)

pagina : un nome di pagina (senza parentesi).

Presenta la pagina indicata, che diventa la pagina corrente. Prima di mostrarla viene chiamata la funzione OpzioniPagina(), se esiste; durante la presentazione vengono chiamate nell'ordine la funzione Intestazione(), se esiste, poi la funzione di pagina indicata, infine la funzione PiePagina(), se esiste. Non va chiamata direttamente da una funzione di pagina, ma solo come effetto di una scelta (o rinvio). 

vai(Pagina112)
vai(Vulcano)
 
mostra(pagina)
mostra(pagina, opzioni)

pagina : un nome di pagina (senza parentesi).
opzioni : una stringa contenente opzioni valide per un'istruzione HTML (tag) <body>.

Presenta la pagina indicata senza marcarla come pagina corrente; non viene chiamata la funzione OpzioniPagina() ma, allo stesso scopo, si può fornire direttamente una stringa di opzioni. Non vengono chiamate né Intestazione() né PiePagina(); non va chiamata direttamente da una funzione di pagina, ma solo come effetto di una scelta (o rinvio). La funzione mostra() si usa per pagine provvisorie, in cui non si devono modificare i valori delle variabili. Una successiva chiamata alla funzione ridisegna() ripristinerà la pagina corrente memorizzata dall'ultima vai() eseguita in precedenza. 

mostra(Mappa)
 
aggiorna()

Ridisegna la pagina corrente, ossia l'ultima che è stata presentata con una chiamata alla funzione vai(), rieseguendo le istruzioni contenute nella pagina.

È normalmente usata per mostrare il nuovo aspetto della pagina dopo il cambiamento del contenuto di una o più variabili. 

scelta(! v.luce, "Accendi la torcia", "v.luce = 1; aggiorna()")
 
ridisegna()

Ridisegna la pagina corrente, ossia l'ultima che è stata presentata con una chiamata alla funzione vai(), senza eseguire le istruzioni contenute nella pagina. È normalmente usata per uscire da pagine provvisorie o informative richiamate con la funzione mostra() senza rischiare di modificare qualcosa rieseguendo la pagina corrente. 

scelta("Torna al gioco", "ridisegna()")
 
apriPagina()
apriPagina(opzioni)
chiudiPagina()

opzioni : una stringa contenente opzioni valide per un'istruzione HTML (tag) <body>.

L'uso combinato di apriPagina() e chiudiPagina(), con in mezzo le istruzioni di presentazione testo, è del tutto equivalente alla funzione mostra(). Questa coppia di funzioni può essere utile ai programmatori esperti per realizzare una versione personalizzata di mostra(), come in questo esempio completo (che non va chiamato da una funzione di pagina, ma ad esempio da un link in ctrl.html):

apriPagina('background="drago.jpg"')
testo("Hai trovato finora ", v.tesori, " tesori.")
continua("ridisegna()")
chiudiPagina()