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

 

Funzione di pagina e relative opzioni

 
function Pagina123() {
  ...
}

Ogni pagina è descritta da una funzione JavaScript, che sta tipicamente nel file gioco.js; il nome della funzione, che deve iniziare con una lettera maiuscola, verrà usato per riferirsi alla pagina, ad esempio per richiamarla con la funzione vai(). Le righe sottostanti mostrano un esempio completo: 

function Aeroporto() {
titolo("All'aeroporto")
testo("Tutto va bene, siamo pronti al decollo.")
continua(Decollo)
}

function OpzioniPagina(pagina) {
  ...
}

Opzionale. Imposta le caratteristiche generali della pagina, come il colore o disegno di fondo e il colore dei link. Se è presente, essa viene chiamata da Idra subito prima di mostrare una pagina, con l'argomento pagina che indica la pagina in questione; deve ritornare una stringa che sarebbe valida all'interno di un'istruzione HTML (tag) <body>, come in questo esempio completo: 

function OpzioniPagina(pag) {
  if (pag == Tempesta) {
    return 'background="fulmini.jpg"'
  } else {
    return 'bgcolor="#ffffcc"'
  }
}
 
function Intestazione(pagina) {
  ...
}

Opzionale. Consente di inserire elementi all'inizio di ciascuna pagina. Se è presente, essa viene chiamata da Idra subito prima di chiamare la funzione di pagina vera e propria, con l'argomento pagina che indica la pagina in questione; può essere usata per mettere un'intestazione generica o un semplice stacco o decorazione, come in questo esempio completo che (poiché ignora l'argomento pagina) varrà per tutte le pagine: 

function Intestazione(pag) {
  testo('<img src="decoro.jpg">')
}
 
function PiePagina(pagina) {
  ...
}

Opzionale. Consente di inserire elementi alla fine di ciascuna pagina. Se è presente, essa viene chiamata da Idra subito dopo aver chiamato la funzione di pagina vera e propria, con l'argomento pagina che indica la pagina in questione; può essere usata per mettere un piè di pagina generico, come in questo esempio completo che (poiché ignora l'argomento pagina) varrà per tutte le pagine: 

function PiePagina(pag) {
  testo("<hr>")
  MostraInventario()
  testo("Hai raggiunto finora ", v.punti, " punti.")
}