MUGSHOT - OAM

Knowledge #3 – Mugshot OAM– TOOL & SPIEGAZIONI GENERALI
In questa parte vedremo come inserire la routine dei mugshot. A differenza della lezione 1, in questa parte non ci occuperemo nel BG1 ma dell'OAM. Andiamo con ordine: Cos'č l'OAM?

L'OAM, come nel caso dei BG, č un "livello" dove vengono caricati gli OBJ. Gli OBJ possiamo definirli come oggetti i quali hanno determinate proprietŕ.
Gli OBJ in sintesi possono essere gli sprite (pokemon, ow o qualunque cosa non riguardi i tileset). Ogni OBJ ha delle proprietŕ riassunti in 6 byte (+2) e iniziando dall'offset 700000:
[POS_Y][ATTRIBUTE_1][POS_X][ATTRIBUTE_2][START_TILE][ATTRIBUTE_3]+[byte_1][byte_2]
Quindi il secondo OBJ inizierŕ dall'offset 700008, il terzo 700010 e cosi via.
In questo progetto lavoreremo con le showpokepic. Le showpokepic, come si intuisce dal nome, fanno apparire l'immagine (sprite) di un pokemon. Lo sprite viene caricato nell'OAM.

Ora vi elencherň i tool da utilizzare in questa parte per semplificare il lavoro:
SHOWPOKEPIC LIMIT EDITOR 1.2: Per togliere il blocco delle showpokepic, in modo da mostrarne due simultaneamente.
ASM COMPILATOR v.1.2.0.0: Compilatore per le vostre routine ASM (In questo tutorial vi darň gia le routine compilate in ogni caso).
BINARY SPRITE CONVERTER 1.2: Per convertire i vostri mugshot (altrimenti seguite la lezione 1 su come ricavare i file .DMP)
Editor Esadecimale: Io utilizzo HxD

Qual'č il nostro intento? Semplicemente far apparire le due showpokepic e caricare i nostri mugshot al posto delle immagini dei pokemon.
Come prima cosa dobbiamo preoccuparci di come far apparire due showpokepic insieme.
Molto semplicemente utilizziamo il primo tool per rimuovere il blocco delle showpokepic: apriamo la rom col tool, e clicchiamo su "Applica Patch".
Per questa progetto ci serviremo di due routine, la prima caricherŕ l'immagine nella prima showpokepic invece l'altra nella seconda.
(potremmo anche utilizzarne una soltanto ma al momento utilizziamo questo metodo)
In questo caso ho gia fatto la routine che fa al caso nostro:

Per inserire la nostra routine ci avvaliamo di un assemblatore in questo caso vi ho gia fornito precedentemente il donwload. (Secondo tool)
Non ci resta che aprire il nostro tool e incollare la nostra routine.
Per compilarla dobbiamo aprire la nostra ROM andando su File>Apri Rom (*.gba). Infine cercate uno spazio libero nella vostra rom (consiglio dall'offset 700000 in poi) e incollatelo nella casella in alto vicino all'ingranaggio per poi schicciare il tasto

Bene analizziamo ora la routine in tutte le sue parti

In questa parte la routine caricherŕ l'offset della variabile 8000 in r3 e successivamente salverŕ una half-word.
dopodiché mettiamo in r1 il valore 20 (che sarebbero quanti byte occupa un set di palette).
Un set di palette č composto da 16 colori e ogni paletta č composta da 2 byte, quindi in tutti avremo 32 byte.
In esadecimale 32 = 20.
Infine moltiplichiamo la half-word con il valore 20.

In r0 carichiamo l'offset della TABLE delle pal (in questo caso B00000).
successivamente andremo a sommare il prodotto precedentemente ricavato nella prima parte con la nostra TABLE.
Ora arriva la parte fondamentale, carichiamoin r1 il set di palette numero 14 contenuto nella RAM.
e successivamente mettiamo in r2 il valore 10.
Perchč 10?
Ho detto prima che ogni set di palette occupa 20 byte.
Il comando successivo SWI 0xB, sovrascrive 2 byte alla volta di conseguenza č necessario dimezzare il numero dei byte da copiare che non saranno 20 ma 10 byte.
In questo modo tramite la nostra variabile avremo caricato le nostre palette.
Ora manca la parte riguardante il mugshot in se.

Bene ora arriva la parte interessante. Vi ricordate all'inizio la struttura dell'oam su come viene salvato?
Bene sfrutteremo il byte dell'oam contenente da dove inizia l'oam e salviamo il byte un r2.
In r2 ora abbiamo quanti quadretti č distante dall'inizio dove vengono caricati tutti i tile dell'oam.
Ora in r1 mettiamo il valore 20.
Perchč 20? Non centra niente con le palette. In questo caso 20 sono i byte che compongono un quadratino 8x8. Infatti successivamente moltiplicheremo il valore 20 con il byte dove inizia il nostro OBJ.

Bene, in r1 carichiamo l'offset da dove iniziano i tile dell'oam e lo sommiamo al prodotto precedente.
Ora in r2 carichiamo il valore 800 (che sarebbero i byte che occupa una immagine 64x64 compressa) e motliplichiamo il valore 800 con la variabile contenuta in r3 (ormai non serve piů il valore della variabile in r3 quindi salvo il prodotto direttamente in r3).
Ora in r2 carichiamo la nostra TABLE dei mug (io ho scelto A00000) e sommiamo il prodotto precedente con l'offset della nostra TABLE.
Infine, analogamente alla parte finale riguardante le palette, carichiamo in r2 il valore dimezzato dei byte da copiare.

La routine compilata occupa 50 byte

Per caricare il secondo mugshot č molto semplice.
Nella routine comilata potete notare questi byte:
0C 00 00 07
68 F2 02 02
Basterŕ incollare un altra routine e al posto di questi byte metterci:
14 00 00 07
88 F2 02 02
semplicemente cambiamo gli attributi di controllo dell'oam (ovvero il terzo oam) e impostiamo dove caricare la paletta nel set di palette 15 ^^

Come ultima cosa voglio fare una considerazione su come inserire i mugshot.
La nostra routine lavora su due table, entrambe la table verrano riempite nello stesso modo.
Prendiamo come riferimento come offset A00000 come TABLE dei MUG e B00000 come TABLE delle PAL.
In questo caso utilizzando il tool fornito all'inizio (Terzo Tool) ricaveremo il nostro file binario.
Ora non ci resta che incollarlo nell'offset A00000. Occupando 800 byte ogni mugshot il secondo mugshot partirŕ da A00800 fino ad arrivare a A01000 e cosi via.
Analogo l'inserimento delle palette.