Integrare le MFC con Irrlicht. Sezione 1: Creazione del progetto. by Raffaele White tiger Mancuso

Transcript

1 Integrare le MFC con Irrlicht by Raffaele White tiger Mancuso In questo topic spiegherò come integrare irrlicht in un documento singolo MFC *(1). Io ho usato il visual c++ 6 ma la procedura dovrebbe essere sostanzialmente identica anche per le versioni successive o precedenti di visual studio. i documenti MFC singoli sono in pratica quelli con la barra degli strumenti, la barra dei menù e sotto quel "grande riquadro" inizialmente bianco usato per vari scopi (per esempio in Word contiene il testo, in Paint contiene l'immagine, in Excel contiene le celle, in Internet explorer contine il sito web, ecc..) Noi in quel "riquadro" chiamato "view" renderizzeremo un'immagine irrlicht. Iniziamo creando il progetto con l app wizard *(2): Sezione 1: Creazione del progetto 1)Apriamo vc++ 6. Clicchiamo su file->new (o nuovo), selezioniamo la tabella projects, e clicchiamo su MFC AppWizard (exe). Quindi in project name scegliamo un nome per il nostro progetto (per esempio IrrMFC) e in location scegliamo in quale cartella vogliamo che il nostro progetto sia insertio. Quindi premiamo ok.

2 2) Nel prossimo passaggio clicchiamo su single document In the next step, click on single document, e selezioniamo document\view architecture support se vogliamo leggere\scrivere da\su files. In What language would you like your resource in selezioniamo la lingua quandi clicchiamo su finish. Potete anche cliccare su next se volete scegliere alter impostazioni per il vostro progetto. Non spiegherò le altre opzioni disponibili perchè andremmo fuori dallo scopo di questo tutorial e perché in giro per la rete ci sono molti tutorial che li spigano. Le impostazioni di default sono ottime per questo tutorial

3 Sezione 2: Includere irrlicht in IrrMFCview.cpp (è solo un esempio, il nome del file è nome_progettoview.cpp), dopo queste linee: #ifdef _DEBUG #define new DEBUG_NEW #undef THIS_FILE static char THIS_FILE[] = FILE ; #endif scriviamo: #include <irrlicht.h> //include l header di irrlicht #pragma comment(lib,"irrlicht.lib")//linka la libreria irr::irrlichtdevice* device;//il device void RegisterEnvironment();//un funzione che spiegherò + avanti quando //la definiremo HWND mfc_view_hwnd;//contiene l handle *(3) al view (cioè al riquadro inizialmente bianco, vedi sopra) nella funzione IrrMFCview::OnDraw, inseriamo queste linee prima del : //se il device non è aperto chiude il programma if(!device->run()) device->drop(); //elimina il device exit(-1); //esce

4 //renderizza la scena driver->beginscene(true,true,irr::video::scolor(0,0,0,0)); smgr->drawall(); driver->endscene(); la funzione OnDraw non viene ad ogni loop delle MFC, ma solo quando la scena, secondo le MFC, viene modificata (apriamo un menù, muoviamo il mouse, premiamo un bottone della barra degli strumenti,ecc..). però noi la dobbiamo chiamarla ad ogni loop (se abbiamo un oggetto animato così come stanno le cose verrebbe visualizzato un frame dell animazione ogni volta che apriamo un menù). Per fare ciò occorrono 2 semplici operazioni: in IrrMFCview::OnInitialUpdate(), all'inizio scriviamo: this->settimer(1,1,0); prendiamo IrrMFCview::OnTimer() (se la funzione non c'è seguite questi passaggi: -cliccate su view->classwizard per aprire il class wizard *(4) (se compare una finestra che ci chiede se creare il database per il class wizard () clicchiamo su yes o si e in file scegliamo un nome a caso per il database) -nella tabella message maps, in project mettiamo il nostro progetto e in class name mettiamo CIrrMFCView o simile (dipende dal nome del progetto, per esempio se il nome del progetto è prova il nome della classe sarà CprovaView ) -in messages selezioniamo WM_TIMER e premiamo il pulsante add function e poi edit code ) e prima di: CView::OnTimer(nIDEvent); inseriamo: this->invalidate(0); //call OnDraw every loop ora creiamo il device. in IrrMFCView::OnInitialUpdate(), alla fine della funzione (cioè prima del ) scriviamo: //assegniamo il valore di mfc_view_hwnd all handle del view mfc_view_hwnd=this->m_hwnd; //creiamo il device irr::sirrlichtcreationparameters param; //diciamo a irrlicht di renderizzare nel view (vedi l esempio win32 di irrlicht) param.windowid = reinterpret_cast<irr::s32>(mfc_view_hwnd); // hcolorbutton param.drivertype = irr::video::edt_direct3d9; param.stencilbuffer=false;

5 param.vsync=true; device = irr::createdeviceex(param); driver=device->getvideodriver(); smgr=device->getscenemanager(); //chiamiamo la funzione che spiegherò dopo RegisterEnvironment(); ora alla fine del file MyView.cpp, inseriamo queste linee per reindirizzare gli eventi presi dalle MFC (pressione dei tasti, movimenti del mouse,ecc..) all event receiver di irrlicht settato con seteventreceiver o impostato quando creiamo il device // - // - // IRRLICHT<->MFC RELATED - // - // - //la classe CIrrDeviceWin32 è ereditaria di IrrlichtDevice. Il device di irrlicht sotto //win32 viene creato usando la classe CIrrDeviceWin32 che poi viene uppata *(5) nella //sua super classe IrrlichtDevice. Quindi sotto win32 possiamo passare da IrrlichtDevice //a CIrrDeviceWin32 facendo un semplice casting #include "CIrrDeviceWin32.h" //definiamo alcune funzioni della classe CIrrDeviceWin32 poiché queste classe è //contenuta in irrlicht.dll ma non è esportata, così noi non la potremmo utilizzare CIrrDeviceWin32::CCursorControl* CIrrDeviceWin32::getWin32CursorControl() return Win32CursorControl; void CIrrDeviceWin32::OnResized() Resized = true; //struttura che contiene l handle alla finestra su cui renderizzare e il device struct SEnvMapper HWND hwnd; irr::cirrdevicewin32* irrdev; ; //contiene tutte le finestre su cui renderizzare irr::core::list<senvmapper> EnvMap; //questa funzione registra la nostra finestra per essere renderizzata. Modificala per //registrare tutte le finestre su cui vuoi renderizzare. Questa funzione registra la nostra //finestra semplicemente mettendola alla fine nella lista EnvMap

6 RegisterEnvironment() SEnvMapper em; em.irrdev =(CIrrDeviceWin32*) device; em.hwnd = mfc_view_hwnd; EnvMap.push_back(em); //ritorna un oggetto SEnvMapper registrato tramite RegisterEnvironment() partendo //dall handle alla finestra SEnvMapper* getenvmapperfromhwnd(hwnd hwnd) irr::core::list<senvmapper>::iterator it = EnvMap.begin(); for (; it!= EnvMap.end(); ++it) if ((*it).hwnd == hwnd) return &(*it); //ritorna il device partendo dall handle alla finestra irr::cirrdevicewin32* getdevicefromhwnd(hwnd hwnd) irr::core::list<senvmapper>::iterator it = EnvMap.begin(); for (; it!= EnvMap.end(); ++it) if ((*it).hwnd == hwnd) return (*it).irrdev; //la window proc *(5) delle MFC //ricordati di sostituire CIrrMFCView con il nome della tua classe // per ogni evento ricevuto viene creato l oggetto SEvent e viene chiamata //la funzione OnEvent del tuo event receiver usando la funzione //posteventfromuser(sevent event) di irrlicht che appunto chiama OnEvent con //l evento passato LRESULT CIrrMFCView::WindowProc(UINT message, WPARAM wparam, LPARAM lparam) LRESULT result=cview::windowproc(message, wparam, lparam); HWND hwnd=this->getsafehwnd(); #ifndef WM_MOUSEWHEEL #define WM_MOUSEWHEEL 0 020A #endif #ifndef WHEEL_DELTA #define WHEEL_DELTA 120 #endif

7 irr::cirrdevicewin32* dev = 0; //irr::irrlichtdevice* dev = 0; irr::sevent event; SEnvMapper* envm = 0; switch (message) case WM_PAINT: PAINTSTRUCT ps; CDC* hdc = BeginPaint(&ps); EndPaint(&ps); case WM_ERASEBKGND: case WM_SETCURSOR: envm = getenvmapperfromhwnd(hwnd); if (envm &&!envm->irrdev->getwin32cursorcontrol()->isvisible()) SetCursor(NULL); break; case WM_MOUSEWHEEL: event.mouseinput.wheel = (float)((short)hiword(wparam)) / (float)wheel_delta; event.mouseinput.event = irr::emie_mouse_wheel; POINT p; // fixed by jox p.x = 0; p.y = 0; ClientToScreen(&p); event.mouseinput.x = LOWORD(lParam) - p.x; event.mouseinput.y = HIWORD(lParam) - p.y; break; case WM_LBUTTONDOWN: event.mouseinput.event = irr::emie_lmouse_pressed_down;

8 case WM_LBUTTONUP: event.mouseinput.event = irr::emie_lmouse_left_up; case WM_RBUTTONDOWN: event.mouseinput.event = irr::emie_rmouse_pressed_down; case WM_RBUTTONUP: event.mouseinput.event = irr::emie_rmouse_left_up; case WM_MBUTTONDOWN: event.mouseinput.event = irr::emie_mmouse_pressed_down; case WM_MBUTTONUP: event.mouseinput.event = irr::emie_mmouse_left_up;

9 case WM_MOUSEMOVE: event.mouseinput.event = irr::emie_mouse_moved; case WM_KEYDOWN: event.eventtype = irr::eet_key_input_event; event.keyinput.key = (irr::ekey_code)wparam; event.keyinput.presseddown = true; BYTE allkeys[256]; WORD KeyAsc=0; GetKeyboardState(allKeys); ToAscii(wParam,lParam,allKeys,&KeyAsc,0); event.keyinput.shift = ((allkeys[vk_shift] & 0 80)!=0); event.keyinput.control = ((allkeys[vk_control] & 0 80)!=0); event.keyinput.char = KeyAsc; //KeyAsc >= 0? KeyAsc : 0; case WM_KEYUP: event.eventtype = irr::eet_key_input_event; event.keyinput.key = (irr::ekey_code)wparam; event.keyinput.presseddown = false; BYTE allkeys[256]; WORD KeyAsc=0; GetKeyboardState(allKeys); ToAscii(wParam,lParam,allKeys,&KeyAsc,0); event.keyinput.shift = ((allkeys[vk_shift] & 0 80)!=0);

10 event.keyinput.control = ((allkeys[vk_control] & 0 80)!=0); event.keyinput.char = KeyAsc; //KeyAsc >= 0? KeyAsc : 0; case WM_SIZE: // resize dev->onresized(); case WM_DESTROY: PostQuitMessage(0); case WM_SYSCOMMAND: // impedisce lo screensaver o il risparmio energetico del monitor if (wparam == SC_SCREENSAVE wparam == SC_MONITORPOWER) break; return result; questo è tutto. Se hai domande\commenti o hai avuto problemi posta sul forum di irrlicht italia. Alla prossima ;) by Raffaele White tiger Mancuso *(1) MFC (Microsoft Foundation Classes) insieme di librerie OOP (object oriented programming, cioè scritte usando classi e oggetti) sviluppate dalla Microsoft. Contengono principalmente classi per sviluppare interfacce grafiche, ma sono presenti anche classi per gestire tipi di dato (come la classe CString), per leggere\scrivere sui file (CDocument, CFile e altre) Le MFC sono portabili (cioè i programmi scritti con le MFC girano ) solo sui sistemi microsoft windows. Link di approfondimento: 6e.aspx (guida ufficiale)

11 (tutorial inglese di base sulle MFC) *(2) app wizard procedura che consente la creazione automatica di un progetto che usa le MFC. Disponibile solo sugli IDE visual studio Link di approfondimento: content.asp?b=visual_c_plusplus&seqnum=22&rl=1 *(3) handle letteralmente maniglia, non è altro che il puntatore a una risorsa, in questo caso al view. Tramite l handle noi possiamo riferirci a quella risorsa. Link di approfondimento: *(4) class wizard finestra delle MFC che permette di creare funzioni\variabili MFC e quindi di sostituire le proprie funzioni a quelle di default senza scrivere codice addizionale per far riconoscere la nuova funzione al compilatore Link di approfondimento: (guida ufficiale) (opzioni non supportate dal class wizard) (class wizard per progetti device ) *(5) window proc abbreviazione di window procedure, è una funzione del proprio programma chiamata dal sistema operativo ogni qual volta si verifica un evento Link di approfondimento: url=/library/en-us/winprog/winprog/the_window_procedure.asp (guida ufficiale) url=/library/en-us/winui/winui/windowsuserinterface/windowing/windowprocedures /windowprocedurereference/windowprocedurefunctions/windowproc.asp (sintassi della window procedure) /winui/windowsuserinterface/windowing/windowprocedures.asp (altri dettagli)