![\"\"](\"https:\/\/i0.wp.com\/www.colorwave.it\/blog\/wp-content\/uploads\/2015\/06\/ClassDiagram9.png?ssl=1\" "\\"\\"")
<\/a><\/p>\nCome si nota, DOCUMENT ha ereditato da DB_OBJECT l’interfaccia DOCUMENT_HISTORY; pertanto, anche la classe SPECTRAL_IMAGE dispone della stessa interfaccia. Analizziamo ora nei particolari come implementare le azioni di Undo. Mostreremo come esempio l’aggiunta di una funzione di ripristino di un’area modificata.<\/p>\n
A questo scopo verr\u00e0 definita la classe AREA_RESTORE , derivata da ACTION, che ha la funzione di gestire il salvataggio e recupero dalla DOCUMENT_HISTORY dell’area.<\/p>\n\n
Analizziamo la dichiarazione della classe<\/p>\n
[sourcecode language=”cpp”]<\/p>\n
class AFX_EXT_CLASS AREA_RESTORE : public ACTION
\n{
\npublic:
\nAREA_RESTORE(void);
\n~AREA_RESTORE(void);<\/p>\n
void *AllocArea(IRECT rect, int pxsize);
\nUBYTE *GetArea(IRECT *rect,float *angle);
\nvoid SetBitmap(Bitmap *img);
\nvoid *GetBitmap();
\nvirtual bool Do(class OPERATION_CALL *doc);
\nvirtual DB_OBJECT *New();<\/p>\n
USE_FILE
\nUSE_PRIVATE_STRUCT
\n};
\n[\/sourcecode]<\/p>\n
I metodi presenti nella classe sono in parte riscritture delle classi virtuali da ACTION, dalla quale \u00e8 derivata, ed in parte specifici delle funzioni svolte: sono funzioni riscritte la New(), la Do() e quelle definite nella macro USE_FILE; sono invece specifici della funzione la AllocArea, GetArea, GetBitmap e SetBitmap, il cui significato sar\u00e0 spiegato di seguito. In questo articolo analizzeremo solo le funzioni AllocArea e GetArea, in quanto utilizzate effettivamente nella SPECTRAL_IMAGE. Le altre due funzioni sono usate in altri contesti, e per ora non ne \u00e8 necessaria la descrizione.<\/p>\n
AllocArea<\/h3>\n
La funzione alloca un buffer per la memorizzazione di un’area della bitmap. L’area \u00e8 allocata alle dimensioni definite nel parametro rect, e per dimensioni dei pixel pari a pxsize:<\/p>\n
[sourcecode language=”cpp”]
\nvoid *AREA_RESTORE::AllocArea(IRECT rect, int pxsize)
\n{
\nGETSTR
\nSTR->rect=rect;
\nSTR->buf=(UBYTE *)Malloc(rect.dx*rect.dy*pxsize);
\nreturn STR->buf;
\n}
\n[\/sourcecode]<\/p>\n
La funzione\u00a0\u00e8 molto semplice: sfrutta la Malloc della classe ACTIONdalla quale deriva per allocare un buffer void di dimensioni sufficienti alla memorizzazione dell’area (la memoria verr\u00e0 rilasciata automaticamente dal distruttore di ACTION). Viene rimandato un puntatore void alla memoria allocata.<\/p>\n
GetArea<\/h3>\n
[sourcecode language=”cpp”]<\/p>\n
UBYTE *AREA_RESTORE::GetArea(IRECT *rect,float *angle)
\n{
\nGETSTR
\n*angle=STR->angle;
\n*rect=STR->rect;
\nreturn STR->buf;
\n}<\/p>\n
[\/sourcecode]<\/p>\n
La funzione rimanda il\u00a0buffer dell’area allocata da AllocArea per le azioni successive (ripristino o \u00a0inizializzazione, come spiegher\u00f2 di seguito).<\/p>\n
Ora sappiamo che AREA_RESTORE ha il banale compito di allocare la memoria necessaria al salvataggio di un’area, di permetterne l’accesso in modifica attraverso il suo puntatore ed in seguito eliminare il buffer quando non pi\u00f9 necessario. Analizzeremo ora il meccanismo nel quale \u00e8 inserita la classe. A questo scopo analizzeremo il modo in cui viene usata la classe in SPECTRAL_IMAGE.<\/p>\n
In colibr\u00ec \u00e8 definito un meccanismo di definizione ed interfazione fra gli oggetti documento e gli strumenti di modifica, tutti derivati dalla classe TOOL. In un altro articolo spiegheremo questo meccanismo. In questo contesto ci basta sapere che all’istanza della classe SPECTRAL_IMAGE, attraverso la gestione dei messaggi dei TOOL arrivano richieste di azione; una di queste, il taglio di un’area, arriver\u00e0 da un tool \u00a0di azione su\u00a0un’area. La funzione SPECTRAL_IMAGE::ReceiveToolInfo() che riceve la richiesta, individua il messaggio\u00a0OPCUT mandato dal tool e, di conseguenza, chiama una funzione CUT_RECT_AREA che esegue l’azione;<\/p>\n
[sourcecode language=”cpp”]<\/p>\n
static bool CUT_RECT_AREA(CLASS_STR, TOOLS::AREA_SELECTOR *tool)
\n{
\n\/\/ area interessata
\nfloat x,y,dx,dy;
\ntool->GetRectArea(&x,&y,&dx,&dy);
\nIRECT rect=_OBJ->GetPixelArea( x, y, dx, dy);<\/p>\n
ACTIONS::AREA_RESTORE *ars=GET_AREA(STR,rect); \/\/ copia l’area rettangolare..
\nif (ars) {
\nars->SetParam(MAGIC,_OBJ); \/\/ crea un parametro relativo all’origine dell’area..
\nars->SetBitmap(BMAP->GetBitmap(rect.x,rect.y,rect.dx,rect.dy));
\nACTIONS::CLIPBOARD::SetData(ars);
\nPUSH_AREA(STR,rect);
\n_OBJ->Clear(x,y,dx,dy);
\nSEND_APP_MESSAGE(MSG_REDRAW_DOCUMENT_VIEW,_OBJ);
\nreturn true;
\n}
\nreturn false;<\/p>\n
}<\/p>\n
[\/sourcecode]<\/p>\n
La funzione, statica nel file SPECTRAL_IMAGE.cpp. estrae le informazioni relative all’area da tagliare, chiama un’altra funzione locale, la GET_AREA, che estrae l’area spettrale relativa e inizializza con questa un buffer AREA_RESTORE; quindi assegna un parametro per ricordare l’origine dell’area (SetParams), estrae anche la Bitmap RGB di visualizzazione (SPECTRAL_IMAGE contiene sia la mappa spettrale dell’immagine che la sua rappresentazione rgb) e la assegna alla AREA_RESTORE. Per eventuali usi futuri assegna\u00a0alla CLIPBOARD l’area tagliata, quindi chiama la funzione PUSH_AREA<\/p>\n
[sourcecode language=”cpp”]<\/p>\n
static bool PUSH_AREA(CLASS_STR,IRECT rect)
\n{
\nACTIONS::AREA_RESTORE *ars=GET_AREA(STR,rect);
\nreturn _OBJ->Push(ars);
\n}<\/p>\n
[\/sourcecode]<\/p>\n
In questo esempio la AREA_RESTORE \u00e8 usata due volte: la prima per salvare nella clipboard di Colibri un’area (nella logica del comando CUT richiamato), La seconda, interna alla funzione PUSH_AREA per salvare l’area tagliata nella DOCUMENT_HISTORY (funzione Push() richiamata).<\/p>\n
CUT_RECT_AREA ha dunque svolto due compiti: Inserito l’area tagliata nella clipboard (l’area sar\u00e0 gestita da quest’ultima, e resa\u00a0disponibile alla eventuale richiesta di PASTE), e inserito l’area nella storia delle revisioni, per garantirne il ripristino se richiesto (Undo).\u00a0Vedremo ora come viene gestito il comando di Undo<\/p>\n
Dopo avere effettuato il CUT, un eventuale comando di UNDO arriva all’oggetto SPECTRAL_IMAGE attraverso l’oggetto WIDGET_IMAGE che lo \u00a0visualizza.
\nLa WIDGET_IMAGE, ricevuto il messaggio di UNDO (non \u00e8 importante ora capire come), semplicemente richiama il metodo Undo del documento contenuto<\/p>\n
[sourcecode language=”cpp”] Di DOCUMENT_HISTORY ho gi\u00e0 scritto in questo articolo<\/a>. E\u00e8 la classe che gestisce la lista Undo\/Redo e revisioni dei documenti.<\/p>\n In particolare la funzione di ripristino di uno stato precedente\u00a0\u00e8 svolta dalla\u00a0funzione Undo, della quale si riporta il codice, molto semplice:<\/p>\n [sourcecode language=”cpp”]<\/p>\n bool DOCUMENT_HISTORY:: Undo() ACTION *action; [\/sourcecode]<\/p>\n La funzione, verificata la condizione di esistenza di una lista non vuota, estrae l’ultima ACTION\u00a0inserita nella fifo (funzione Pop()) \u00a0e richiama la funzione Do() della stessa. Alla Do viene passato il puntatore al documento di appartenenza. Quindi viene distrutta l’azione dopo averla eliminata dalla lista con la Pop.<\/p>\n La Undo rimanda un valore true se l’azione \u00e8 stata effettuata correttamente (comunicazione ricevuta da ACTION::Do()<\/p>\n In pratica la funzione di Undo \u00e8 semplicemente un router del messaggio, che viene passato all’istanza ACTION estratta dalla lista.<\/p>\n
\nBEGIN_SLOT (ON_UNDO)
\n\/\/
\nif (_DOC)
\n_DOC->Undo();
\n\/\/
\nEND_SLOT
\n[\/sourcecode]
\nIl codice riportato mostra lo slot che intercetta il messaggio MsgUndo<\/strong>. Verificata l’esistenza del documento interno (_DOC), ne richiama la funzione Undo() ereditata attraverso DB_OBJECT (per saperne di pi\u00f9 leggere questo articolo<\/a>).<\/p>\n
\n{
\nGETSTR
\nif (!HISTORY)
\nreturn false;
\nCWaitCursor wait;<\/p>\n
\nif ( HISTORY->Pop(&action)) {
\nbool res=action->Do(STR->doc);
\ndelete action;
\nreturn res;
\n}
\nreturn false;
\n}<\/p>\n