View source

From thelas.dk

You do not have permission to do that, for the following reason:
The action you have requested is limited to users in the group Sysops.
You can view and copy the source of this page:
[[Image:ucom-0.4-screenshot1.png|thumb|right|200px|A screenshot of the upcomming version of Ucom which uses SdlWidgets]]
<p>
Sad news. I have to mark this project as unmaintained because I have not found time to develop this project for a while now, and I do not see how I would get the time to maintain this project in the forseeable future.
</p>
<p>
[[SdlWidgets]] is a library for creating GUI applications. <br>
It is written in C++, it only uses POSIX and [http://www.libsdl.org SDL], and has a nice object oriented design.<br>
It currently compiles for OSX and Linux.
</p>
== Features ==
<p>
* A simple but powerfull API (A GUI can be expressed in very few lines)
* Multiple windows (this is not usually supported by SDL projects, since it requires a massive hack to accomplish)
* Portable (Currently Linux and OS X is supported, but other platformes are scheduled to be suported. Watch the roadmap)
* Efficient (Practically no startup time. Memmory light. Only few efficiency problems, and they can be avoided)
* Includes basic widgets (Currently the following widgets are included)
** Labels
** Checkboxes
** Radio buttons
** Buttons
** Collection Widgets (Vertical list, Horizontal list, Tab list)
** Input Widgets (String)
** Images
* Extendable (It is easy to write your own widgets. Just write a class that inharits from the Widget class)
</p>
== Roadmap ==
<p>
* Now that [[DynParser]] has been developed, the future releases will have support for configuration files.
* Version 1.0.4: Change all surfaces to use 32 bit per pixel, to alow alpha blending (and hopefully transparrent windows).
* Version 1.0.5: Introduce themes and more dynamic displays.
* Version 1.1.0: Port to Windows (as much as possible), such that it works for Linux, OSX and Windows.
</p>

== Versions / Download ==
<p>
* [[Media:sdlwidgets-1.0.3.tgz|SdlWidgets-1.0.3]]
Stable release
* [[Media:sdlwidgets-1.0.2.tgz|SdlWidgets-1.0.2]]
Stable release
</p>

== Requirements ==
<p>
SdlWidgets depends on the [http://www.libsdl.org SDL] project.
In order to compile SdlWidgets it is necessary to install the SDL development-packages.
<br>
In Ubuntu the required packages are
* libsdl1.2debian-all
* libsdl1.2-dev
* libsdl-ttf2.0
* libsdl-ttf2.0-dev
* libsdl-gfx1.2-4
* libsdl-gfx1.2-dev
* libsdl-image1.2
* libsdl-image1.2-dev
</p>
== Installation Instructions ==
<p>
The usual installation procedure is as follows
<br>
<b>
tar -xvzf sdlwidgets-1.0.3.tgz<br>
cd sdlwidgets-1.0.3<br>
make config<br>
make build<br>
sudo make install<br>
</b>
Now the installation procedure will be explained in more detail.
</p>
<p>
Before installing SdlWidgets project, make sure you have installed the requirements.
</p>
<p>
When the necessary dependencies have been installed, SdlWidgets is downloaded using the above link.
<br>
The rest of the installation is done using a shell or terminal.
</p>
<p>
To unpack the downloaded file, go to the directory containing the downloaded file and execute '''tar -xvzf sdlwidgets-1.0.3'''.
<br>
enter the created folder by typing '''cd sdlwidgets-1.0.3'''.
<br>
Now it is time to create a Makefile from the Makefile.in by typing '''make config'''.
<br>
SdlWidgets can now be compiled by typing '''make build'''.
<br>
Finally install the library by executing '''make install''' as root.
</p>
<p>
If no errors were encountered the project is now installed, and you can begin writing graphical applications using the SdlWidgets API.
</p>

== API Examples ==
<p>
[[Image:sdlwidgets_example1.png|thumb|right|200px|Screenshot of Hello World example]]
We start with a simple '''Hello World''' program.<br>
This program will show a window with the text "Hello World" for 10 seconds. <br>
</p>
<p>
<b> #include <sdlwidgets/Widgets.hpp>
<br>#include <unistd.h>
<br>
<br>using namespace SdlWidgets;
<br>
<br>int main(int argc, char **argv)
<br>{
<br>&nbsp;&nbsp;Window win(800,100,new Label("Hello World"));
<br>&nbsp;&nbsp;usleep(10000000);
<br>}
<br></b>
</p>
<p>
The program is compiled by the command<br>
<b>g++ hello.cpp -o hello -lsdlwidgets `sdl-config --cflags`</b>
</p>
<p>
This is how the program works.
* The application creates a window containing a label with the hello world text.
* Then the application sleeps for 10 seconds.
* When the application quits the window object is automatically destroyed, which means that the window is closed.
</p>
<p>
[[Image:sdlwidgets_example2.png|thumb|right|200px|Screenshot of the collection example]]
The next example includes checkboxes, radiobuttons, and shows what horizontal- and vertical collections are and how to use them.
</p>
<p>
<b> #include <sdlwidgets/Widgets.hpp>
<br>#include <unistd.h>
<br>
<br>using namespace SdlWidgets;
<br>
<br>int main(int argc, char **argv)
<br>{
<br>&nbsp;&nbsp;VCol *checkboxes = new VCol();
<br>&nbsp;&nbsp;checkboxes->AddWidget(new CheckBox(new Label("Check One"),true),2);
<br>&nbsp;&nbsp;checkboxes->AddWidget(new CheckBox(new Label("Check Two"),false),1);
<br>&nbsp;&nbsp;checkboxes->AddWidget(new CheckBox(new Label("Check Three"),true),1);
<br>&nbsp;&nbsp;VCol *radiobuttons = new VCol();
<br>&nbsp;&nbsp;RadioButton *rb = new RadioButton(NULL,new Label("Option One"));
<br>&nbsp;&nbsp;radiobuttons->AddWidget(rb,1);
<br>&nbsp;&nbsp;radiobuttons->AddWidget(new RadioButton(rb,new Label("Option Two")),1);
<br>&nbsp;&nbsp;radiobuttons->AddWidget(new RadioButton(rb,new Label("Option Three")),2);
<br>&nbsp;&nbsp;HCol *choices = new HCol(50,50);
<br>&nbsp;&nbsp;choices->AddWidget(checkboxes,2);
<br>&nbsp;&nbsp;choices->AddWidget(radiobuttons,3);
<br>&nbsp;&nbsp;Window win(800,100,choices);
<br>&nbsp;&nbsp;usleep(10000000);
<br>}
</b>
</p>
<p>
The program is compiled by the command<br>
<b>g++ example.cpp -o example -lsdlwidgets `sdl-config --cflags`</b>
</p>
<p>
This is how the program works.
* The application creates two vertical collections, and adds three checkboxes to the first collection, and three radiobuttons to the second.
* Then the application creates a horizontal collection, and adds the two vertical collections to that.
* Then the application creates a window containing the horizontal collection.
* Then the application sleeps for 10 seconds.
* When the application quits the window object is automatically destroyed, which means that the window is closed.
</p>
<p>
Please notice that the difference in size is a feature and not a bug, since the second element of '''AddWidget''' describes how much room the widget is given.<br>
Suppose a vertical collection contains two widgets, one with size 2 and one with size 3. <br>
Then the first widget is given 2/5 of the space, and the second widget is given 3/5 of the space.
</p>
<p>
Another thing to notice is that in stead of giving the checkboxes and radiobuttons a text to display, they are given a Label.<br>
In fact we could have given them '''any''' widget (an image, a checkbox, a radiobutton, a collection... or a widget you have made yourself). <br>
This is one of the strengths of SdlWidgets, and we will investigate this in future examples.
</p>
More examples will follow.
Return to SdlWidgets.
Retrieved from "http://thelas.dk/index.php?title=SdlWidgets"
View source

From thelas.dk

Views

Personal tools
