TheCloud/libSDL2pp
1
0
Fork 0
mirror of https://github.com/libSDL2pp/libSDL2pp.git synced 2025-08-04 03:15:59 -04:00
Code Issues Packages Projects Releases Wiki Activity

Make more doxygen friendly

Browse Source
This commit is contained in:
Dmitry Marakasov 2015-01-11 00:58:07 +03:00
parent 75637d72ef
commit dfd82ae6bf
1 changed files with 50 additions and 56 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
README.md
View File

@ -6,8 +6,7 @@ This library provides C++11 bindings/wrapper for SDL2 and satellite libraries.
## Synopsis ## ## Synopsis ##
```c++ try {
try {
// Init SDL; will be automatically deinitialized when the object is destroyed // Init SDL; will be automatically deinitialized when the object is destroyed
SDL2pp::SDL sdl(SDL_INIT_VIDEO); SDL2pp::SDL sdl(SDL_INIT_VIDEO);
@ -43,12 +42,11 @@ try {
SDL_Delay(2000); SDL_Delay(2000);
// All SDL objects are released at this point or if an error occurs // All SDL objects are released at this point or if an error occurs
} catch (SDL2pp::Exception& e) { } catch (SDL2pp::Exception& e) {
// Exception stores SDL_GetError() result // Exception stores SDL_GetError() result
std::cerr << "Exception: " << e.what() << std::endl; std::cerr << "Exception: " << e.what() << std::endl;
std::cerr << "SDL Error: " << e.GetSDLError() << std::endl; std::cerr << "SDL Error: " << e.GetSDLError() << std::endl;
} }
```
## Features ## ## Features ##
@ -105,7 +103,7 @@ Dependencies:
To build standalone version: To build standalone version:
```cmake . && make``` cmake . && make
Following variabled may be supplied to CMake to affect build: Following variabled may be supplied to CMake to affect build:
@ -122,12 +120,12 @@ Following variabled may be supplied to CMake to affect build:
To install the library systemwide, run: To install the library systemwide, run:
```cmake . && make && make install``` cmake . && make && make install
You can change installation prefix with CMAKE_INSTALL_PREFIX cmake You can change installation prefix with CMAKE_INSTALL_PREFIX cmake
variable: variable:
```cmake -DCMAKE_INSTALL_PREFIX=/usr/local . && make && make install``` cmake -DCMAKE_INSTALL_PREFIX=/usr/local . && make && make install
SDL2pp installs pkg-config file, so it can be used with any build SDL2pp installs pkg-config file, so it can be used with any build
system which interacts with pkg-config, including CMake and GNU system which interacts with pkg-config, including CMake and GNU
@ -147,23 +145,19 @@ still recommended).
Just place the library into dedicated directory in your project Just place the library into dedicated directory in your project
(for example, lib/SDL2pp) and add (for example, lib/SDL2pp) and add
```cmake SET(SDL2PP_WITH_IMAGE ON) # if you need SDL_image support
SET(SDL2PP_WITH_IMAGE ON) # if you need SDL_image support SET(SDL2PP_WITH_TTF ON) # if you need SDL_ttf support
SET(SDL2PP_WITH_TTF ON) # if you need SDL_ttf support ADD_SUBDIRECTORY(lib/SDL2pp)
ADD_SUBDIRECTORY(lib/SDL2pp)
```
into your core CMakeLists.txt. This will act as similar to what into your core CMakeLists.txt. This will act as similar to what
FIND_PACKAGE usually does, and will provide ${SDL2PP_INCLUDE_DIRS} FIND_PACKAGE usually does, and will provide ${SDL2PP_INCLUDE_DIRS}
and ${SDL2PP_LIBRARIES} variables for your project. You will then and ${SDL2PP_LIBRARIES} variables for your project. You will then
be able to use them as usual: be able to use them as usual:
```cmake INCLUDE_DIRECTORIES(${SDL2PP_INCLUDE_DIRS})
INCLUDE_DIRECTORIES(${SDL2PP_INCLUDE_DIRS})
ADD_EXECUTABLE(mytarget ...) ADD_EXECUTABLE(mytarget ...)
TARGET_LINK_LIBRARIES(mytarget ${SDL2PP_LIBRARIES}) TARGET_LINK_LIBRARIES(mytarget ${SDL2PP_LIBRARIES})
```
if bundled, libSDL2pp does not build examples and becomes a static if bundled, libSDL2pp does not build examples and becomes a static
library, providing required SDL2 includes/libs in the mentioned library, providing required SDL2 includes/libs in the mentioned