Editing Portal:InItalian/Formati dei file di Blood Omen

{{TOCRIGHT}}
Questa pagina è dedicata alle specifiche per i formati dei file usati in Blood Omen. Include il lavoro di esplorazione fatto dalla community da quando Blood Omen è uscito. 

La maggior parte dei formati semplici (come la struttura del file BIG, le specifiche del TIM) sono stati resi esplorabili anni fa, ma altri (il formato della mappa, gli sprite) soltanto di recente, durante lo sviluppo di [[Portal:InItalian/Blood Pill|Blood Pill]].

==File BIG==
Questo è un file generale che contiene tutte le risorse di gioco. La sua struttura è molto semplice:

 '''uint32''' - numero di entries
 <span style="color:green">Array delle entries:</span>
   '''uint32''' - Nome hash del file
   '''uint32''' - Dimensione del file
   '''uint32''' - Offset del file
 <span style="color:green">Array dei dati della entry:</span>
   '''bytes''' - Contenuti del file

{{tip|Può esserci dello spazio tra i file}}

==Immagine TIM==
Immagini per PlayStation. Usate per contenere gli elementi grafici e i componenti della mappa. Le specifiche dei TIM sono ben conosciute, quindi non verranno elencate qui. Riferimenti per decodificare e codificare sono disponibili nel codice sorgente di [[Portal:InItalian/Blood Pill|Blood Pill]].

'''Consigli''':
* Alcune entries del pill.big possono contenere più file TIM fusi insieme.
* Alcuni file TIM di Blood Omen possono terminare con dei null.

==Suoni==

===VAG===
I file "Very-Audio-Good" per PlayStation (variazione ADPCM di 4-bit) usati nella versione PlayStation di Blood Omen e dal preview di gioco. Non sono usati nella versione PC. Riferimenti per decodificare e codificare sono disponibili nel codice sorgente di [[Portal:InItalian/Blood Pill|Blood Pill]].

'''Consigli''':
* Molti file VAG sono senza header (il loro header è confuso, non c'è neppure il fourCC "VAGb", dunque possono essere individuati solo con un'analisi sintattica).
* Normalmente andrebbero eseguiti a 11025hz, ma alcuni (le musiche e alcuni effetti sonori) a 22050hz.

===IMA ADPCM grezzi===
Dei file senza header che contengono flussi grezzi IMA ADPCM che servono a sostituire i file VAG nella versione PC. Usano esattamente gli stessi nomi dei file VAG per la PlayStation.

{{tip|I file non hanno alcun header}}

===File audio WAV===
Blood Omen per PC ha alcuni effetti sonori in formato WAV (La PlayStation li ha in VAG). Questo formato è largamente conosciuto e non c'è bisogno di spiegarlo.

{{tip|Sembra che il gioco non usi gli header dei WAV; alcuni file hanno un play rate alterato e devono essere aggiustati manualmente per poterli eseguire come si sentono in gioco}}

==Video==

===STR della PSX===
Usato nella versione PlayStation di Blood Omen. L'STR è un flusso video MJPEG con l'audio aggiunto come interleave. Si può usare il tool [http://kenai.com/projects/jpsxdec/pages/Home jPsxDec] per estrarre e decodificare questo formato dall'immagine del cd per PlayStation del gioco.

===Video JAM===
JAM è un formato di compressione video scadente sviluppato da Semilogic Entertainment e usato nella versione PC di Blood Omen. Il formato usa una tavolozza in comune con più frame e un tipo di compressione dinamica. La specifica e la decodifica dei JAM sono state scoperte nel 2011 da MisterGrim. Il JAM può solo contenere video, l'audio era contenuto in un file VAG separato (che era, in effetti, un IMA ADPCM grezzo).

I video JAM hanno molte più alterazioni dei STR, e la traccia audio è in mono (gli STR hanno una stereo).

Il codice per decomprimere i JAM è disponibile nel codice sorgente di [[Portal:InItalian/Blood Pill|Blood Pill]].

==Gli sprite==

Gli sprite sono immagini di personaggi o altre cose animate. Ci sono tre estensioni e altrettanti nomi dei file: SHA, SDR, SHD. Tuttavia quando Blood Pill è stato sviluppato non erano noti i veri nomi dei file, quindi questa specifica viene definita "Tipi di sprite" e copre la decompressione di tutti gli sprite, inclusi quelli non utilizzati.

===Sprite di tipo 1 - Carte degli oggetti===
Ha sempre 1 frame e nessuna compressione. 

 '''uint32''' - sempre 0x01 0x00 0x00 0x00 
 '''uint32''' - dimensione del file
 '''768 bytes''' - dati della mappa dei colori a 24 bit (256 colori)
 '''int16''' - posizione su x
 '''int16''' - posizione su y
 '''byte''' - larghezza
 '''byte''' - altezza
 '''byte''' - x
 '''byte''' - y
 '''larghezza*altezza bytes''' - contenuto dell'immagine (gli indici nella mappa dei colori)

{{tip|In realtà è una versione semplificata dello sprite di tipo 3}}

===Sprite di tipo 2 - Insieme di immagini===
Sprite a più frame con tavolozza dedicata ad ogni frame. Usato per le raccolte di immagini dell'interfaccia (come le immagini degli incantesimi e degli oggetti).

 '''uint32''' - numero di frame
 '''uint32''' - dimensione del file
 '''768 bytes''' - dati della mappa dei colori a 24 bit (inutilizzato)
 <span style="color:green">Array degli header del frame:</span>
   '''768 bytes''' - dati della mappa dei colri a 24 bit
   '''uint32''' - offset dei dati dell'immagine dalla fine degli header
   '''ubyte''' - larghezza
   '''ubyte''' - altezza
   '''byte''' - x
   '''byte''' - y
 <span style="color:green">Array dei dati dell'immagine del frame:</span>
   '''larghezza*altezza bytes''' - contenuto dell'immagine (gli indici nella mappa dei colori)

{{tip|In alcuni file la larghezza e l'altezza reali potrebbero essere doppie di quelle scritte nell'header}}

===Sprite di tipo 3 - Sprite degli oggetti===
Sprite a più frame con tavolozza condivisa.

 '''uint32''' - numero di frame
 '''uint32''' - dimensione del file
 '''768 bytes''' - dati della mappa dei colori a 24 bit
 '''int16''' - offset in x per tutti i frame
 '''int16''' - offset in y per tutti i frame
 <span style="color:green">Array degli header del frame:</span>
   '''uint32''' - offset dei dati dell'immagine dalla fine degli header
   '''ubyte''' - larghezza
   '''ubyte''' - altezza
   '''byte''' - x
   '''byte''' - y
 <span style="color:green">Array dei dati dell'immagine del frame:</span>
   '''bytes''' - contenuti dell'immagine compressa (gli indici nella mappa dei colori) usando un run-length encoding; alcuni file usando colori a 4 bit (vedi [[#Metodi di compressione]])

'''Consigli''':
* Non si sa come scoprire quale compressione del file sia usata (RLE a 0x00, o 0xFF o entrambe), sembra che l'engine dia questa informazione quando il file viene caricato
* Alcuni file usano colori a 4 bit invece che RLE

===Sprite di tipo 4 - Sprite dei personaggi===
Sprite a più frame con tavolozza condivisa, con header dei frame aggiuntivi. Usato dai personaggi. Molto simile al tipo 3.

 '''uint32''' - numero di frame
 '''uint32''' - dimensione del file
 <span style="color:green">Array degli header aggiuntivi del frame (arrotondati per eccesso al multiplo di 4 più vicino):</span>
    '''byte''' - informazioni ignote
 '''768 bytes''' - dati della mappa dei colori a 24 bit
 '''int16''' - offset in x per tutti i frame
 '''int16''' - offset in y per tutti i frame
 <span style="color:green">Array dehli header del frame:</span>
   '''uint32''' - offset dei dati dell'immagine dalla fine degli header
   '''ubyte''' - larghezza
   '''ubyte''' - altezza
   '''byte''' - x
   '''byte''' - y
 <span style="color:green">Array dei dati dell'immagine del frame:</span>
   '''bytes''' - contenuti dell'immagine compressa (gli indici nella mappa dei colori) usando un run-length encoding; alcuni file usando colori a 4 bit (vedi [[#Metodi di compressione]])

'''Consigli''':
* Non si sa come scoprire quale compressione del file sia usata (RLE a 0x00, o 0xFF o entrambe), sembra che l'engine dia questa informazione quando il file viene caricato
* Alcuni file usano colori a 4 bit invece che RLE

===Sprite di tipo 5===
Un'altra variante del tipo 3 senza informazioni sull'offset e (a volte) con larghezza e altezza non valide, da mettere a posto con un particolare trucco.

 '''uint32''' - numero di frame
 '''uint32''' - dimensione del file
 '''768 bytes''' - dati della mappa dei colori a 24 bit
 <span style="color:green">Array degli header del frame:</span>
   '''uint32''' - offset dei dati dell'immagine dalla fine degli header
   '''ubyte''' - larghezza
   '''ubyte''' - altezza
   '''byte''' - x
   '''byte''' - y
 <span style="color:green">Array dei dati dell'immagine del frame:</span>
   '''bytes''' - contenuti dell'immagine compressa (gli indici nella mappa dei colori) che usano RLE  (vedi [[#Metodi di compressione]])

'''Consigli''':
* Alcuni frame hanno larghezza e altezza non valide perché la loro larghezza è maggiore di 255 e il formato usa 1 bit per codificarle. Per correggere il problema va usato 255 + [larghezza]
* Non si sa come scoprire quale compressione del file sia usata (RLE a 0x00, o 0xFF o entrambe), sembra che l'engine dia questa informazione quando il file viene caricato

==Mappe==

Le mappe sono un elemento centrale che mette insieme tutte le risorse (immagini, suoni, mattonelle, sprite). Circa l'80% della struttura della mappa è stata scoperta e questo permette di estrarre una serie di cose, incluse: le texture usate, l'immagine della mappa, posizione di mostri/effetti/oggetti, attivatori, informazioni scritte, porte e bottoni...

Ogni mappa ha un mapnum (numero della mappa) e una sezione inclusa nel nome del file. Quell'informazione viene usata per piazzare la mappa nella mappa globale di un'avventura (vedi [http://www.thelostworlds.net/BO1/Map_Survey.html TheLost Worlds - May survey] per le informazioni complete sui nomi dei livelli).

=== Mattonelle ===
Le mattonelle sono immagini TIM a 256 colori compresse con LZ77 (vedi [[#Metodi di compressione]]).

La texture di ogni mattonella ha 8x8=64 mattonelle. L'engine renderizza ogni mattonella separatmaente, spostando la texture della mattonella del momento come necessario.

 '''uint32''' - dimensione dei dati compressi
 '''bytes''' - dati compressi

'''Consigli''':
* Dato che tutte le mattonelle sono dei TIM a 8 bit 256x256, la dimensione dei dati decompressi è sempre la stessa

=== File della mappa ===

Il file della mappa è una struttura di lunghezza fissa che contiene la posizione delle mattonelle (80x80), i nemici, le luci, i botoni e altri oggetti che compongono il livellod i Blood Omen. Per via della sua natura statica ha molti limiti, e ogni mappa ha esattamente la stessa dimensione (quindi basta copiarla in memoria).

 <span style="color:green">// map trigger</span>
 <span style="color:darkblue">typedef struct</span> 
 <span style="color:darkblue">'''{'''</span>
      '''unsigned short''' parm1;    <span style="color:green">// primo parm, se non definito lo script è 0xFFFF, 0xFFFE è il valore null</span>
                               <span style="color:green">//  - numero di mappa di destinazione/origine (TRIGGER_EXIT, TRIGGER_ENTRANCE, TRIGGER_TELEPORT)</span>
                               <span style="color:green">//  - numero del discorso (TRIGGER_INFOMARK, TRIGGER_IMAGEMARK)</span>
      '''unsigned short''' parm2;    <span style="color:green">// secondo parm:</span>
                               <span style="color:green">//  - numero del pulsante (TRIGGER_BUTTON)</span>
                               <span style="color:green">//  - numero dell'immagine (TRIGGER_IMAGEMARK)</span>
      '''byte'''           parm3;    <span style="color:green">// sezione della mappa di destinazione/origine (TRIGGER_EXIT, TRIGGER_ENTRANCE, TRIGGER_TELEPORT)</span>
      '''byte'''           srcx;     <span style="color:green">// posizione</span>
      '''byte'''           srcy;     <span style="color:green">// posizione</span>
      '''byte'''           type;     <span style="color:green">// tipo di script, uno dei TRIGGER_</span>
      '''byte'''           u2<span style="color:darkblue">'''['''</span>3<span style="color:darkblue">''']'''</span>;    <span style="color:green">// ?</span>
      '''byte'''           x;        <span style="color:green">// posizione</span>
      '''byte'''           y;        <span style="color:green">// posizione</span>
      '''byte'''           u3<span style="color:darkblue">'''['''</span>3<span style="color:darkblue">''']'''</span>;    <span style="color:green">// ?</span>
 <span style="color:darkblue">'''}'''</span>'''bo_trigger_t''';
 
 <span style="color:green">// oggetto della mappa</span>
 <span style="color:darkblue">typedef struct</span>
 <span style="color:darkblue">'''{'''</span>
      '''unsigned short''' savenum;  <span style="color:green">// id unico di salvataggio</span>
      '''byte'''           itemcode; <span style="color:green">// uno dei codici MAPITEM_</span>
      '''byte'''           x;        <span style="color:green">// posizione</span>
      '''byte'''           y;        <span style="color:green">// posizione</span>
      '''byte'''           hidden;   <span style="color:green">// vale 1 se l'oggetto viene spawnato da un attivatore (come la distruzione di un barile)</span>
      '''unsigned short''' target;   <span style="color:green">// gruppo di attivatori bersaglio</span>
      '''byte'''           u<span style="color:darkblue">'''['''</span>4<span style="color:darkblue">''']'''</span>;     <span style="color:green">// ?</span>
 <span style="color:darkblue">'''}'''</span>'''bo_item_t''';
 
 <span style="color:green">// mattonella animata</span>
 <span style="color:darkblue">typedef struct</span>
 <span style="color:darkblue">'''{'''</span>
      '''unsigned short''' targetnum;<span style="color:green">// un gruppo di attivatori</span>
      '''byte''' x;                  <span style="color:green">// posizione</span>
      '''byte''' u1;                 <span style="color:green">// ?</span>
      '''byte''' y;                  <span style="color:green">// posizione</span>
      '''byte''' u2;                 <span style="color:green">// ?</span>
      '''unsigned short''' tile1;    <span style="color:green">// numero della mattonella</span>
      '''unsigned short''' tile2;    <span style="color:green">// numero della mattonella allo stato alternativo</span>
      '''byte''' contents1;          <span style="color:green">// contenuti, vedi le definizioni di CONTENTS_ per i possibili valori dei contenuti</span>
      '''byte''' contents2;          <span style="color:green">// contenuti allo stato alternativo</span>
      '''byte''' u3<span style="color:darkblue">'''['''</span>12<span style="color:darkblue">''']'''</span>;             <span style="color:green">// ?</span>
 <span style="color:darkblue">'''}'''</span>'''bo_atile_t''';
 
 <span style="color:green">// controller del pulsante</span>
 <span style="color:darkblue">typedef struct</span>
 <span style="color:darkblue">'''{'''</span>
      '''unsigned short''' target;   <span style="color:green">// un gruppo di attivatori da chiamare</span>
      '''unsigned short''' tile1;    <span style="color:green">// numero della mattonella</span>
      '''unsigned short''' tile2;    <span style="color:green">// numero della mattonella allo stato alternativo</span>
      '''byte''' flags;              <span style="color:green">// vedi le definizioni dei BUTTONFLAG_*</span>
      '''byte''' u1;                 <span style="color:green">// ?</span>
      '''unsigned short''' savenum;  <span style="color:green">// id unico di salvataggio</span>
      '''byte''' u2;                 <span style="color:green">// ?</span>
      '''byte''' u3;                 <span style="color:green">// ?</span>
 <span style="color:darkblue">'''}'''</span>'''bo_button_t''';
 
 <span style="color:green">// effetto</span>
 <span style="color:darkblue">typedef struct</span>
 <span style="color:darkblue">'''{'''</span>
      '''byte''' x;                  <span style="color:green">// posizione</span>
      '''byte''' y;                  <span style="color:green">// posizione</span>
      '''byte''' lightposx;          <span style="color:green">// posizione della fonte di luce</span>
      '''byte''' lightposy;          <span style="color:green">// posizione della fonte di luce</span>
      '''byte''' sprite;             <span style="color:green">// indice dello sprite dall'array degli sprite</span>
      '''byte''' lightsizex;         <span style="color:green">// dimensione dei poligoni di luce</span>
      '''byte''' lightsizey;         <span style="color:green">// dimensione dei poligoni di luce</span>
      '''byte''' u1;                 <span style="color:green">// ?</span>
      '''byte''' lightform;          <span style="color:green">// flag della forma della luce</span>
      '''byte''' r;                  <span style="color:green">// quantità di rosso</span>
      '''byte''' g;                  <span style="color:green">// quantità di verde</span>
      '''byte''' b;                  <span style="color:green">// quantità di blu</span>
      '''unsigned short''' targetnum;<span style="color:green">// gruppo di attivatori</span>
      '''byte''' start_on;           <span style="color:green">// 1 se l'effetto parte attivo, 0 se parte disattivo</span>
      '''byte''' u3<span style="color:darkblue">'''['''</span>5<span style="color:darkblue">''']'''</span>;              <span style="color:green">// ?</span>
 <span style="color:darkblue">'''}'''</span>'''bo_effect_t''';
 
 <span style="color:darkblue">typedef struct</span>
 <span style="color:darkblue">'''{'''</span>
      '''byte''' data<span style="color:darkblue">'''['''</span>164<span style="color:darkblue">''']'''</span>;
 <span style="color:darkblue">'''}'''</span>'''bo_object_t''';
 
 <span style="color:green">// definizione dell'oggetto sulla mattonella (barili, forzieri)</span>
 <span style="color:darkblue">typedef struct</span>
 <span style="color:darkblue">'''{'''</span>
      '''byte''' x;                  <span style="color:green">// posizione iniziale</span>
      '''byte''' y;                  <span style="color:green">// posizione finale</span>
      '''byte''' w;                  <span style="color:green">// larghezza</span>
      '''byte''' h;                  <span style="color:green">// altezza</span>
      '''byte''' ofsx;               <span style="color:green">// moltiplica per 16 per il vero offset</span>
      '''byte''' ofsy;               <span style="color:green">// moltiplica per 16 per il vero offset</span>
      '''byte''' u1;
      '''byte''' u2;
 <span style="color:darkblue">'''}'''</span>'''bo_grpobject_t''';
 
 <span style="color:green">// entità dello scenario</span>
 <span style="color:darkblue">typedef struct</span>
 <span style="color:darkblue">'''{'''</span>
      '''byte''' u1;                 <span style="color:green">// ?</span>
      '''byte''' u2;                 <span style="color:green">// ?</span>
      '''byte''' u3;                 <span style="color:green">// ?</span>
      '''byte''' u4;                 <span style="color:green">// ?</span>
      '''unsigned short''' tile1;    <span style="color:green">// mattonella base (in realtà l'oggetto gruppo, non la mattonella 32x32 standard</span>
      '''unsigned short''' tile2;    <span style="color:green">// mattonella alternativa (oggetto gruppo)</span>
      '''unsigned short''' tile3;    <span style="color:green">// mattonella distrutta (oggetto gruppo)</span>
      '''byte''' u5;                 <span style="color:green">// ?</span>
      '''byte''' u6;                 <span style="color:green">// ?</span>
      '''byte''' pushable;           <span style="color:green">// una forza necessaria per spingere</span>
      '''byte''' toggled;            <span style="color:green">// l'attivatore che cambia lo stato (significa che c'è la mattonella 2)</span>
      '''byte''' u7;                 <span style="color:green">// ?</span>
      '''byte''' spawnitems<span style="color:darkblue">'''['''</span>3<span style="color:darkblue">''']'''</span>;      <span style="color:green">// codici dell'oggetto da spawnare quando attivato/distrutto</span>
      '''byte''' u8;                 <span style="color:green">// ?</span>
      '''byte''' destructible;       <span style="color:green">// i flag distruggibili</span>
      '''unsigned short''' savenum;  <span style="color:green">// id unico di salvataggio</span>
      '''byte''' u10;                <span style="color:green">// ?</span>
      '''byte''' x;                  <span style="color:green">// posizione</span>
      '''byte''' y;                  <span style="color:green">// posizione</span>
      '''byte''' u11;                <span style="color:green">// ? </span>
      '''byte''' active;             <span style="color:green">// 1 è pieno, altrimenti 0</span>
      '''byte''' u13;                <span style="color:green">// ? </span>
 <span style="color:darkblue">'''}'''</span>'''bo_scenery_t''';
 
 <span style="color:green">// tracciati dei nemici</span>
 <span style="color:darkblue">typedef struct</span>
 <span style="color:darkblue">'''{'''</span>
      '''byte''' x;                  <span style="color:green">// posizione</span>
      '''byte''' y;                  <span style="color:green">// posizione</span>
      '''byte''' u1;                 <span style="color:green">// ?</span>
      '''byte''' u2;                 <span style="color:green">// ?</span>
 <span style="color:darkblue">'''}'''</span>'''bo_path_t''';
 
 <span style="color:green">// entità nemica</span>
 <span style="color:darkblue">typedef struct</span>
 <span style="color:darkblue">'''{'''</span>
      bo_path_t paths<span style="color:darkblue">'''['''</span>4<span style="color:darkblue">''']'''</span>;      <span style="color:green">// tracciati di pattugliamento</span>
      '''byte''' u1<span style="color:darkblue">'''['''</span>12<span style="color:darkblue">''']'''</span>;             <span style="color:green">// ?</span>
      '''unsigned short''' savenum;  <span style="color:green">// id unico di salvataggio</span>
      '''byte''' u2<span style="color:darkblue">'''['''</span>52<span style="color:darkblue">''']'''</span>;             <span style="color:green">// ?</span>
      '''byte''' charnum;            <span style="color:green">// classe del mostro (come per lo sprite del personaggio)</span>
      '''byte''' u3<span style="color:darkblue">'''['''</span>10<span style="color:darkblue">''']'''</span>;             <span style="color:green">// ?</span>
      '''unsigned short''' target;   <span style="color:green">// gruppo di attivatori da chiamare quando viene ucciso</span>
      '''byte''' u4<span style="color:darkblue">'''['''</span>20<span style="color:darkblue">''']'''</span>;             <span style="color:green">// ?</span>
      '''byte''' lastpath;           <span style="color:green">// ?</span>
      '''byte''' u6<span style="color:darkblue">'''['''</span>18<span style="color:darkblue">''']'''</span>;             <span style="color:green">// ?</span>
      '''byte''' u7<span style="color:darkblue">'''['''</span>15<span style="color:darkblue">''']'''</span>;             <span style="color:green">// ?</span>
      '''byte''' x;                  <span style="color:green">// posizione</span>
      '''byte''' y;                  <span style="color:green">// posizione</span>
      '''byte''' u8<span style="color:darkblue">'''['''</span>4<span style="color:darkblue">''']'''</span>;              <span style="color:green">// ?</span>
      '''unsigned short''' speechnum;<span style="color:green">// un numero di parlato per i discorsi del travestimento</span>
      '''byte''' u9<span style="color:darkblue">'''['''</span>6<span style="color:darkblue">''']'''</span>;              <span style="color:green">// ?</span>
 <span style="color:darkblue">'''}'''</span>'''bo_monster_t''';
 
 <span style="color:green">// struttura generale del file della mappa</span>
 <span style="color:darkblue">typedef struct</span>
 <span style="color:darkblue">'''{'''</span>
      <span style="color:green">// una catena di numeri della mappa delle mattonelle usati (per creare i nomi dei file)</span>
      <span style="color:green">// ogni mappa delle mattonelle contiene 64 mattonelle, i cui numeri sono lineari</span>
      <span style="color:green">// per esempio, una mattonella #131 è la mattonella #3 dalla mappa delle mattonelle #2</span>
      <span style="color:green">// con flag da 2-'''byte''' ('''abbreviazione senza firma''') contenuti nel numero della mattonella (i flag cominciano dal '''byte''' 10)</span>
      <span style="color:green">// vedi le definizioni dei TILEFLAG_ per i possibili flag delle mattonelle</span>
      '''unsigned short'''  tilemaps<span style="color:darkblue">'''['''</span>40<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// informazione ancora ignota</span>
      '''byte'''            u1<span style="color:darkblue">'''['''</span>12<span style="color:darkblue">''']'''</span>;
      '''bo_object_t'''     objects<span style="color:darkblue">'''['''</span>10<span style="color:darkblue">''']'''</span>;
      '''bo_monster_t'''    monsters<span style="color:darkblue">'''['''</span>32<span style="color:darkblue">''']'''</span>;
      '''bo_grpobject_t'''  grpobjects<span style="color:darkblue">'''['''</span>8<span style="color:darkblue">''']'''</span><span style="color:darkblue">'''['''</span>32<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// mattonelle animate - una mattonella che può essere in 2 stati e che ha contenuti diversi ad ogni stato</span>
      <span style="color:green">// usato per le porte, le punte che escono dal terreno ecc.</span>
      <span style="color:green">// le mattonelle animate hanno un gruppo di attivatori da eseguire con degli script</span>
      '''bo_atile_t'''      atiles<span style="color:darkblue">'''['''</span>100<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// l'array di un pulsante speciale controlla tutti i pulsanti usati nel livello</span>
      <span style="color:green">// molto simile alle mattonelle animate</span>
      <span style="color:green">// i pulsanti hanno gruppi di attivatori da eseguire con degli script</span>
      '''bo_button_t'''     buttons<span style="color:darkblue">'''['''</span>20<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// informazione #2 ancora ignota</span>
      '''byte'''            u2<span style="color:darkblue">'''['''</span>8<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// oggetti spingibili nella scena - tavoli, sedie, pietre ecc.</span>
      '''bo_scenery_t'''    scenery<span style="color:darkblue">'''['''</span>256<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// prima mappa delle mattonelle</span>
      '''unsigned short'''  backtiles<span style="color:darkblue">'''['''</span>80<span style="color:darkblue">''']'''</span><span style="color:darkblue">'''['''</span>80<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// seconda mappa delle mattonelle</span>
      '''unsigned short'''  foretiles<span style="color:darkblue">'''['''</span>80<span style="color:darkblue">''']'''</span><span style="color:darkblue">'''['''</span>80<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// mappa dei contenuti - un valore di contenuto per ogni mattonella statica (in gioco vengono sostituite dalle mattonelle modificabili, se presenti)</span>
      <span style="color:green">// vedi le definizioni dei CONTENTS_  per i possibili valori dei contenuti</span>
      '''byte'''            contents<span style="color:darkblue">'''['''</span>80<span style="color:darkblue">''']'''</span><span style="color:darkblue">'''['''</span>80<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// linear triggers array - all triggers used on map</span>
      '''bo_trigger_t'''    triggers<span style="color:darkblue">'''['''</span>255<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// triggers are non-solid interaction points, activated when player stands in them</span>
      <span style="color:green">// this array golds pointers to triggers</span>
      '''byte'''            triggertiles<span style="color:darkblue">'''['''</span>80<span style="color:darkblue">''']'''</span><span style="color:darkblue">'''['''</span>80<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// oggetti piazzati nel livello</span>
      <span style="color:green">// i codici degli oggetti 0-9 sono potenziamenti, i codici 10, 11, 12, 13 sono riservati per i codici di oggetti unici</span>
      <span style="color:green">// quindi non possono esserci più di 4 tipi di oggetti unici in ogni livello</span>
      <span style="color:green">//sono oggetti unici: incantesimi, armi, forme, artefatti, oggetti delle missioni</span>
      '''byte'''            uniqueitems<span style="color:darkblue">'''['''</span>4<span style="color:darkblue">''']'''</span>;
      '''bo_item_t'''       items<span style="color:darkblue">'''['''</span>50<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// dati ancora sconosciuti</span>
      '''byte'''            u4<span style="color:darkblue">'''['''</span>8<span style="color:darkblue">''']'''</span>;
      '''byte'''            u5<span style="color:darkblue">'''['''</span>8<span style="color:darkblue">''']'''</span><span style="color:darkblue">'''['''</span>40<span style="color:darkblue">''']'''</span>;
      '''byte'''            u6<span style="color:darkblue">'''['''</span>24<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// effetti</span>
      '''unsigned short'''  sprites<span style="color:darkblue">'''['''</span>8<span style="color:darkblue">''']'''</span>;
      '''bo_effect_t'''     effects<span style="color:darkblue">'''['''</span>64<span style="color:darkblue">''']'''</span>;
      <span style="color:green">// dati ancora sconosciuti</span>
      '''byte'''   u7<span style="color:darkblue">'''['''</span>936<span style="color:darkblue">''']'''</span>;
 <span style="color:darkblue">'''}'''</span>bo_map_t;
 
 <span style="color:green">// cose ancora non capite:</span>
 <span style="color:green">// - come funziona l'illuminazione (luci di vario tipo, luce di notte e giorno, luce ambientale)</span>
 <span style="color:green">// - gli interruttori dei tracciati dei mostri (alcuni tracciati sono incasinati)</span>
 <span style="color:green">// - counter e attivatori dei puzzle?</span>
 
 <span style="color:green">// flag delle mattonelle</span>
 #define '''TILEFLAG_UNKNOWN1'''       1024
 #define '''TILEFLAG_NODRAW'''         2048
 #define '''TILEFLAG_UNKNOWN3'''       4096
 #define '''TILEFLAG_UNKNOWN4'''       8192
 #define '''TILEFLAG_ALWAYSONTOP'''    16384
 #define '''TILEFLAG_UNKNOWN6'''       32768
 
 <span style="color:green">// contenuti</span>
 #define '''CONTENTS_SOLID'''          1
 #define '''CONTENTS_WATER'''          2
 #define '''CONTENTS_LAVA'''           3
 #define '''CONTENTS_FIRE'''           4
 #define '''CONTENTS_SPIKES'''         5
 #define '''CONTENTS_TRAPTELEPORT'''   6
 #define '''CONTENTS_JUMPWALL'''       8
 #define '''CONTENTS_SWAMP'''          11
 #define '''CONTENTS_JUMPFENCE'''      10
 #define '''CONTENTS_MISTWALK'''       12
 #define '''CONTENTS_SACRIFICE'''      13
 #define '''CONTENTS_ICE'''            19
 #define '''CONTENTS_SAVEGAM'''        44
 #define '''CONTENTS_BATMARK'''        45
 
 <span style="color:green">// attivatori</span>
 #define '''TRIGGER_EXIT'''            1
 #define '''TRIGGER_ENTRANCE'''        2
 #define '''TRIGGER_SPEECHMARK'''      3
 #define '''TRIGGER_TOUCH'''           4
 #define '''TRIGGER_TELEPORT'''        6
 #define '''TRIGGER_IMAGEMARK'''       7
 
 <span style="color:green">// flag dei pulsanti</span>
 #define '''BUTTONFLAG_TOGGLE'''       1
 #define '''BUTTONFLAG_SECRET'''       2
 
 <span style="color:green">// codici degli oggetti</span>
 #define '''MAPITEM_SMALLBLOODFLASK''' 1
 #define '''MAPITEM_BLOODFLASK'''      2
 #define '''MAPITEM_RUNEPYRAMID'''     3
 #define '''MAPITEM_PURPLESPHERE'''    4
 #define '''MAPITEM_BLUESPHERE'''      5
 #define '''MAPITEM_GREENSPHERE'''     6
 #define '''MAPITEM_GOLDSPHERE'''      7
 #define '''MAPITEM_REDSPHERE'''       8
 #define '''MAPITEM_ANCIENTVIAL'''     9
 #define '''MAPITEM_UNIQUE1'''         10 <span style="color:green">// codici di oggetti unici</span>
 #define '''MAPITEM_UNIQUE2'''         11 <span style="color:green">// codici di oggetti unici</span>
 #define '''MAPITEM_UNIQUE3'''         12 <span style="color:green">// codici di oggetti unici</span>
 #define '''MAPITEM_UNIQUE4'''         13 <span style="color:green">// codici di oggetti unici</span>
 
 <span style="color:green">// codici degli oggetti unici</span>
 #define '''ITEM_SPELL_INSPIREHATE'''  10
 #define '''ITEM_SPELL_STUN'''         11
 #define '''ITEM_SPELL_SPIRITWRACK'''  12
 #define '''ITEM_SPELL_BLOODGOUT'''    13
 #define '''ITEM_SPELL_BLOODSHOWER'''  14
 #define '''ITEM_SPELL_SPIRITDEATH'''  15
 #define '''ITEM_SPELL_LIGHT'''        16
 #define '''ITEM_SPELL_LIGHTNING'''    17
 #define '''ITEM_SPELL_REPEL'''        18
 #define '''ITEM_SPELL_ENERGYBOLT'''   19
 #define '''ITEM_SPELL_INCAPACITATE''' 20
 #define '''ITEM_SPELL_CONTROLMIND'''  21
 #define '''ITEM_SPELL_SANCTUARY'''    22
 #define '''ITEM_ARTIFACT_FLAY'''      23
 #define '''ITEM_ARTIFACT_PENTALICH''' 24
 #define '''ITEM_ARTIFACT_IMPLODE'''   25
 #define '''ITEM_ARTIFACT_FONT'''      26
 #define '''ITEM_ARTIFACT_BANK'''      27
 #define '''ITEM_ARTIFACT_HEART'''     28
 #define '''ITEM_ARTIFACT_ANTITOXIN''' 29
 #define '''ITEM_ARTIFACT_SLOWTIME'''  30
 #define '''ITEM_TOKEN_MOEBIUS'''      31
 #define '''ITEM_TOKEN_DEJOULE'''      32
 #define '''ITEM_TOKEN_DOLL'''         33
 #define '''ITEM_TOKEN_MALEK'''        34
 #define '''ITEM_TOKEN_AZIMUTH'''      35
 #define '''ITEM_TOKEN_MORTANIUS'''    36
 #define '''ITEM_TOKEN_NUPRAPTOR'''    37
 #define '''ITEM_TOKEN_BANE'''         38
 #define '''ITEM_TOKEN_SIGNETRING'''   39
 #define '''ITEM_TOKEN_TIMEDEVICE'''   40
 #define '''ITEM_TOKEN_ANACROTHE'''    41
 #define '''ITEM_WEAPON_MACE'''        43
 #define '''ITEM_WEAPON_AXES'''        44
 #define '''ITEM_WEAPON_FLAMESWORD'''  45
 #define '''ITEM_WEAPON_SOULREAVER'''  46
 #define '''ITEM_ARMOR_BONE'''         48
 #define '''ITEM_ARMOR_CHAOS'''        49
 #define '''ITEM_ARMOR_FLESH'''        50
 #define '''ITEM_ARMOR_WRAITH'''       51
 #define '''ITEM_FORM_BAT'''           53
 #define '''ITEM_FORM_WOLF'''          54
 #define '''ITEM_FORM_DISGUISE'''      55
 #define '''ITEM_FORM_MIST'''          56
 #define '''ITEM_ENDING_1'''           69
 #define '''ITEM_ENDING_2'''           70

==Metodi di compressione==

''' Run Length Encoding (RLE) basato sull'indice'''

Usato sui dati degli sprite per comprimere le zone nere che normalmente sono trasparenti. Questa tecnica altera il processo di lettura dei byte 0x0 e 0xFF. Se durante la lettura dei dati dell'immagine si ottiene questo byte, si dovrà leggere un byte in più che conterrà il numero di volte che quel byte va ripetuto. Blood Omen RLE è usato solo per valori di 0x00 o 0xFF.
    
Esempio: 

 <span style="color:green">// output di 32 byte col valore 0xFF</span>
 0xFF 0x20

'''Immagini a 4 bit'''

Codifica 2 pixel per ogni byte con una tavolozza da 256 colori ma con solo 16 colori usati (gli altri pixel sono neri).

Per ogni byte produce 2 byte, in ordine:
* byte 1: <byte> - (int)(<byte>/16)*16; <span style="color:green">// <byte> mod 16</span>
* byte 2: (int)(<byte>/16) <span style="color:green">// <byte> div 16</span>
  
Esempio:

  231 manderà in output 2 pixel coi valori:
  byte 1: 7
  byte 2: 14

'''Variazione del LZ77'''

Una variazione degli algoritmi di compressione dei dati del LZ77 (LZ1).

Un decodificatore campione è disponibile a [http://www.thelostworlds.net/Software/Blood_Omen_Decompressor.html The Lost Worlds] e nel codice sorgente di [[Portal:InItalian/Blood Pill|Blood Pill]].

==Ringraziamenti==
* Andrey [Rackot] Grachev - specifiche del file BIG
* Pavel [VorteX] Timofeyev - file della mappa, sprite
* Ben Lincoln - decompressore LZ77
* Specifiche di decodifica JAM di MisterGrim
* Balder e Zench dai forum di XentaX (www.xentax.com) - IMA ADPCM

==Vedere anche==
* [[Portal:InItalian/Blood Pill|Blood Pill]]
* [http://kenai.com/projects/jpsxdec/pages/Home jPsxDec homepage]
* [http://wiki.qhimm.com/PSX/TIM_file TIM specifications at QHimmWiki]
* [http://www.thelostworlds.net/Software/Blood_Omen_Decompressor.html Blood Omen Decompressor homepage]
* [http://www.thelostworlds.net/BO1/Map_Survey.html Blood Omen Map Survey (TheLostWorlds)]


{{initalian|Formati di file di Blood Omen}}
__NOEDITSECTION__ 
{{finished}}
{{grammar}}