TheCloud/libSDL2pp
1
0
Fork 0
mirror of https://github.com/libSDL2pp/libSDL2pp.git synced 2025-09-09 07:18:45 -04:00
Code Issues Packages Projects Releases Wiki Activity

Syntax highlight synopsis code in README.md

Browse Source
This commit is contained in:
kumar8600 2015-03-16 12:56:14 +09:00
parent 9e8fb2fc69
commit 4daba0efa8
1 changed files with 47 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

92
README.md
View File

@ -7,66 +7,68 @@ This library provides C++11 bindings/wrapper for SDL2 and satellite libraries.
## Synopsis ## ## Synopsis ##
try { ```c++
using namespace SDL2pp; try {
using namespace SDL2pp;
// Init SDL; will be automatically deinitialized when the object is destroyed // Init SDL; will be automatically deinitialized when the object is destroyed
SDL sdl(SDL_INIT_VIDEO); SDL sdl(SDL_INIT_VIDEO);
// Likewise, init SDL_ttf library // Likewise, init SDL_ttf library
SDLTTF sdl_ttf; SDLTTF sdl_ttf;
// Straightforward wrappers around corresponding SDL2 objects // Straightforward wrappers around corresponding SDL2 objects
// These take full care of proper object destruction and error checking // These take full care of proper object destruction and error checking
Window window("libSDL2pp demo", Window window("libSDL2pp demo",
SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED, SDL_WINDOWPOS_UNDEFINED,
640, 480, SDL_WINDOW_RESIZABLE); 640, 480, SDL_WINDOW_RESIZABLE);
Renderer renderer(window, -1, SDL_RENDERER_ACCELERATED); Renderer renderer(window, -1, SDL_RENDERER_ACCELERATED);
Texture sprite1(renderer, SDL_PIXELFORMAT_ARGB8888, Texture sprite1(renderer, SDL_PIXELFORMAT_ARGB8888,
SDL_TEXTUREACCESS_STATIC, 16, 16); SDL_TEXTUREACCESS_STATIC, 16, 16);
Texture sprite2(renderer, "sprite.png"); // SDL_image support Texture sprite2(renderer, "sprite.png"); // SDL_image support
Font font("Vera.ttf", 20); // SDL_ttf font Font font("Vera.ttf", 20); // SDL_ttf font
// Create texture from surface containing text rendered by SDL_ttf // Create texture from surface containing text rendered by SDL_ttf
Texture text(renderer, font.RenderText_Solid("Hello, world!", Texture text(renderer, font.RenderText_Solid("Hello, world!",
SDL_Color{255, 255, 255, 255})); SDL_Color{255, 255, 255, 255}));
unsigned char pixels[16 * 16 * 4]; unsigned char pixels[16 * 16 * 4];
// Note proper constructor for Rect // Note proper constructor for Rect
sprite1.Update(Rect(0, 0, 16, 16), pixels, 16 * 4); sprite1.Update(Rect(0, 0, 16, 16), pixels, 16 * 4);
// Most setter methods are chainable // Most setter methods are chainable
renderer.SetLogicalSize(640, 480).SetRenderColor(0, 16, 32).Clear(); renderer.SetLogicalSize(640, 480).SetRenderColor(0, 16, 32).Clear();
// Also note a safe way to specify null rects and points // Also note a safe way to specify null rects and points
renderer.Copy(sprite1, NullOpt, NullOpt); renderer.Copy(sprite1, NullOpt, NullOpt);
// There are multiple convenient ways to construct e.g. a Rect; // There are multiple convenient ways to construct e.g. a Rect;
// Objects provide extensive set of getters // Objects provide extensive set of getters
renderer.Copy(text, NullOpt, Rect(Point(0, 0), text.GetSize())); renderer.Copy(text, NullOpt, Rect(Point(0, 0), text.GetSize()));
// Copy() is overloaded, providing access to both SDL_RenderCopy and SDL_RenderCopyEx // Copy() is overloaded, providing access to both SDL_RenderCopy and SDL_RenderCopyEx
renderer.Copy(sprite2, NullOpt, NullOpt, 45.0); renderer.Copy(sprite2, NullOpt, NullOpt, 45.0);
renderer.Present(); renderer.Present();
// You can still access wrapped C SDL types // You can still access wrapped C SDL types
SDL_Renderer* sdl_renderer = renderer.Get(); SDL_Renderer* sdl_renderer = renderer.Get();
// Of course, C SDL2 API is still perfectly valid // Of course, C SDL2 API is still perfectly valid
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 and name of function which failed // Exception stores SDL_GetError() result and name of function which failed
std::cerr << "Error in: " << e.GetSDLFunction() << std::endl; std::cerr << "Error in: " << e.GetSDLFunction() << std::endl;
std::cerr << " Reason: " << e.GetSDLError() << std::endl; std::cerr << " Reason: " << e.GetSDLError() << std::endl;
} catch (std::exception& e) { } catch (std::exception& e) {
// This also works (e.g. "SDL_Init failed: No available video device") // This also works (e.g. "SDL_Init failed: No available video device")
std::cerr << e.what() << std::endl; std::cerr << e.what() << std::endl;
} }
```
## Features ## ## Features ##