SDL2_gfx 1.0.2
Graphics primitives and surface functions for SDL2
/builddir/build/BUILD/SDL2_gfx-1.0.4/README
Go to the documentation of this file.
1/*!
2
3\mainpage SDL2_gfx - Graphics primitives and surface functions for SDL2
4
5\section contact_sec Contact and License
6
7Email aschiffler at ferzkopp dot net to contact the author
8or better check author's homepage at http://www.ferzkopp.net
9for the most up-to-date contact information.
10
11This library is licenced under the zlib License, see the file LICENSE for details.
12
13
14\section intro_sec Introduction
15
16The SDL2_gfx library provides the basic drawing functions such as lines,
17circles or polygons provided by SDL_gfx on SDL2 against renderers of SDL2.
18
19The current components of the SDL2_gfx library are:
20- Graphic Primitives (SDL2_gfxPrimitives.h, SDL2_gfxPrimitives.c)
21- Surface Rotozoomer (SDL2_rotozoom.h, SDL2_rotozoom.c)
22- Framerate control (SDL2_framerate.h, SDL2_framerate.c)
23- MMX image filters (SDL2_imageFilter.h, SDL2_imageFilter.c)
24- Build-in 8x8 Font (SDL2_gfxPrimitives_font.h)
25
26Note that SDL2_gfx is compatible with SDL version 2.0 (not SDL 1.2).
27
28\section install_sec Installation
29
30\subsection unix Unix/Linux
31
32Use the standard autoconf/automake sequence to compile and install the library.
33\verbatim
34 ./autogen.sh # (optional, recommended)
35 ./configure
36 make
37 make install
38\endverbatim
39
40\\subsubsection nommx Linker Configuration
41
42The default location for the installation is /usr/local/lib and /usr/local/include.
43This libary path may need to be added to the file the linker configuration file:
44\verbatim
45 vi /etc/ld.so.conf
46 ldconfig
47\endverbatim
48
49\\subsubsection nommx Non-MMX Platforms
50
51To build without MMX code enabled (i.e. ARM, PPC, AMD64 architectures):
52\verbatim
53 ./configure --disable-mmx
54 make
55 make install
56\endverbatim
57
58\subsection visualstudio Windows (VS2015)
59
60Open the SDL2_gfx.sln solution file, right click on the solution and choose 'Rebuild'.
61
62The SDL2-2.0.5 folder must be placed in a directory alongside SDL2_gfx (or sdl2gfx-code) and build in the same configuration, i.e. Debug or Release, beforehand so the referenced SDL2.lib file can be found.
63
64\subsection platformosx Mac OSX
65
66The usual autotools build chain should be used. MacPorts or fink may be required.
67
68Xcode is supported via templates. See Xcode.zip - this template only supports SDL2_gfx
69and not the tests. For this template, the Deployment Target (the lowest version to run on)
70is set to 10.11 and expects the SDL2.framework preinstalled in the default location: /Library/Frameworks.
71
72\section test_sec Test Programs
73
74Change to the ./test directory and run
75\verbatim
76 ./autogen.sh
77 ./configure
78 make
79\endverbatim
80to create several test programs for the libraries functions. This requires
81the SDL2_gfx library to be previously compiled and installed.
82
83See the source in the test/*.c files for some sample code and implementation hints.
84
85\section documentation_sec Documentation
86
87Please refer to the Doxygen-generated API documentation found in the
88Docs/html folder as well as the test programs in the test folder.
89
90\section changelog_sec Change Log
91
92\verbinclude ChangeLog
93
94*/