forked from grimfang4/sdl-gpu
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathmainpage.dox
86 lines (50 loc) · 3.18 KB
/
mainpage.dox
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
/*!
\mainpage
<p>SDL_gpu is a C code library for making hardware-accelerated 2D graphics easy.</p>
<p>SDL_gpu is licensed under the terms of the MIT License.<br>
See LICENSE.txt for details of the usage license granted to you for this code.</p>
<p>A good way to use this documentation is to start on the <a href="modules.html">Modules page</a>.</p>
\section features FEATURES
* High performance (it automatically collects and submits batches instead of separate draw commands for each sprite and redundant state changes)
* Shader API
* Arbitrary geometry rendering (triangles)
* Can be integrated with explicit OpenGL calls (mixed 2D and 3D)
* Full blend state control
* Built-in primitive shapes (points, lines, tris, rects, ellipses, polygons, even arcs)
* Uses a style familiar to SDL 1.2 users
* Compatible with either SDL 1.2 or 2.0
* Loads BMP, TGA, and PNG files via stb-image
* Rotates and scales about the center of images, making reasoning about the resulting corner coordinates more obvious (adjustable via anchor settings)
\section help_out HELP OUT
SDL_gpu is free and open source! You can help either by contributing a pull request, filling out a bug report, sending an email, or give me a chance to put more time into it by donating:
<a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=3WJCLJ3P4BV9A">Donate to SDL_gpu development
</a>
Anything you can do to help is really appreciated!
\section latest_source LATEST SOURCE
<p>SDL_gpu is hosted on Github (https://github.com/grimfang4/sdl-gpu). You can check out the latest version of the source code with Git:<br>
<pre>git clone https://github.com/grimfang4/sdl-gpu.git sdl-gpu</pre></p>
\section dependencies DEPENDENCIES
<p>SDL 1.2 or SDL 2.0 (www.libsdl.org)<br>
A rendering backend<br>
Currently implemented: OpenGL 1.1, OpenGL 2.0, OpenGL 3.0, OpenGL 4.0, OpenGL ES 1.1, OpenGL ES 2.0, OpenGL ES 3.0</p>
\section building BUILDING
You can see automated build status at the project page on Travis CI:
<a href="https://travis-ci.org/grimfang4/sdl-gpu.svg?branch=master">[Build Status]</a>
Automated builds will soon be available on the Github.io page.
<p>SDL_gpu uses CMake (www.cmake.org) to coordinate the library build process. CMake is available as a GUI program or on the command line.</p>
<p>For Linux/UNIX systems, run CMake in the base directory:<br>
<pre>cmake -G "Unix Makefiles"
make
sudo make install</pre></p>
<p>For Linux/UNIX systems, changing the default installation directory can be done like so:<br>
<pre>cmake -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX=/usr</pre></p>
<p>For Windows systems, you can use cmake-gui and select appropriate options in there (warning: cmake-gui is messy!).</p>
\section including_linking INCLUDING / LINKING
<p>Add the include for SDL_gpu.h to your sources. Link to SDL2_gpu (libSDL2_gpu.a) or SDL_gpu (if you use the old SDL 1.2).</p>
\section documentation FULL DOCUMENTATION
<p>Documentation is automatically generated with Doxygen (http://sourceforge.net/projects/doxygen).<br><br>
Pre-generated documentation can be found on the Github.io page:<br>
https://grimfang4.github.io/sdl-gpu/<br>
And at DinoMage Games:<br>
http://dinomage.com/reference/SDL_gpu/</p>
*/