PortableGUI

Hosted by SourceForge Project page

How to port PortableGUI to a new platform

Porting HelloWorld

• Make a new subdir in pg/demo/helloworld for the new target platform (eg. BeOSHelloWorld)
• Make a new subdir in pg/src/ and pg/pg/pgdep/ for the new platform (eg. pg/src/beos and pg/pg/pgdep/beos)

• Copy the files from an existing platform to these directories

• Port the makefile from another platform (you can also use an IDE and import all files from the makefile in a new project)
• Include the files:
$(DEMO)\helloworld\helloworld.cpp
$(SRC)\common\pgcomponent\pgcomponent.cpp
$(SRC)\common\pgcomponent\pgcontainer.cpp
$(SRC)\common\pgmain\pgapplication.cpp
$(SRC)\common\pgutil\pgobject.cpp
$(SRC)\common\pgutil\pgstring.cpp
$(SRC)\common\pgutil\pgvector.cpp
$(SRC)\common\pgwindow\pgframe.cpp
$(SRC)\common\pgwindow\pgwindow.cpp
$(SRC)\common\pgwindow\pgwindowlistener.cpp
$(SRC)\[NEW]\pgcomponent\pgnormalcont[NEW].cpp
$(SRC)\[NEW]\pgmain\pgapp[NEW].cpp
$(SRC)\[NEW]\pgwindow\pgwindow[NEW].cpp
$(SRC)\[NEW]\pgwindow\pgframe[NEW].cpp
Where $(SRC) = ..\..\..\src, $(DEMO) = ..\..\..\demo and [NEW] is your new platform (eg BeOS)
Make sure you type the slashes in the right direction ('\' vs '/')
• Define the symbols PG[NEW] and PGTINY (the last one only for the HelloWorld demo!)

For example -DPGBEOS -DPGTINY

• Edit the header files in pg/pg/pgdep/[NEW] you only need:

pg[NEW].h, pg[NEW]app.h, pg[NEW]comp.h, pg[NEW]cont.h
• pg[NEW].h
• The most important thing here is to include the platform dependent include files (eg. windows.h or gtk/gtk.h)
• The NEWLINE, NB_NEWLINE, FILE_SEP and PATH_SEP can be adjusted to your new platform
• The main procedure is different for Windows and GTK therefore it was defined here. You can probably just copy the GTK version if your platform doesn't need special tricks
• pg[NEW]app.h
• Include platform dependend variables for your application here (this file is included in pg/pg/pgmain/pgapplication.h)
• pg[NEW]comp.h
• Include a pointer to platform dependent base for all components here (this file is included in pg/pg/pgcomponent/pgcomponent.h)
• For Windows, all controls have a HWND as handle, For GTK all widgets have a GtkWidget* as reference
• Include additional platform specific variables needed for all components
• pg[NEW]cont.h
• Same thing as above, but now for containers

• There are only four small C++ files you have to change to make HelloWorld work:

pgnormalcont[NEW].cpp, pgapp[NEW].cpp, pgwindow[NEW].cpp and pgframe[NEW].cpp

• The best way to start is to first comment out everything platform-dependent and try to make the source compile

void PGApplication::exit(int code) {
    //gtk_main_quit();     <- comment out dependent stuff like this
}

• If it compiles OK, change the four platform dependent files
• pgnormalcont[NEW].cpp
• N/A
• pgapp[NEW].cpp
• N/A
• pgwindow[NEW].cpp
• N/A
• pgframe[NEW].cpp
• N/A

Porting everything

Back to PortableGUI