3 \mainpage SDL2_gfx - Graphics primitives and surface functions for SDL2
 
    5 \section contact_sec Contact and License
 
    7 Email aschiffler at ferzkopp dot net to contact the author 
 
    8 or better check author's homepage at http://www.ferzkopp.net 
 
    9 for the most up-to-date contact information.
 
   11 This library is licenced under the zlib License, see the file LICENSE for details. 
 
   14 \section intro_sec Introduction
 
   16 The SDL2_gfx library provides the basic drawing functions such as lines,
 
   17 circles or polygons provided by SDL_gfx on SDL2 against renderers of SDL2.
 
   19 The 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)
 
   26 Note that SDL2_gfx is compatible with SDL version 2.0 (not SDL 1.2).
 
   28 \section install_sec Installation
 
   30 \subsection unix Unix/Linux
 
   32 Use the standard autoconf/automake sequence to compile and install the library. 
 
   34         ./autogen.sh    # (optional, recommended)
 
   40 \\subsubsection nommx Linker Configuration
 
   42 The default location for the installation is /usr/local/lib and /usr/local/include. 
 
   43 This libary path may need to be added to the file the linker configuration file:
 
   49 \\subsubsection nommx Non-MMX Platforms
 
   51 To build without MMX code enabled (i.e. ARM, PPC, AMD64 architectures):
 
   53         ./configure --disable-mmx
 
   58 \subsection visualstudio Windows (VS2012, VS2013)
 
   60 Open the SDL2_gfx.sln solution file, right click on the solution and choose 'Rebuild'.
 
   62 The SDL2 Visual Studio solution must be placed in a directory alongside SDL2_gfx and build in the same configuration, i.e. Debug or Release, beforehand so the referenced SDL2.lib file can be found.
 
   64 \subsection platformosx Mac OSX 
 
   66 The usual autotools build chain should be used. MacPorts or fink may be required.
 
   68 Xcode is supported via templates. See Xcode.zip - this template only supports SDL2_gfx 
 
   69 and not the tests. For this template, the Deployment Target (the lowest version to run on) 
 
   70 is set to 10.11 and expects the SDL2.framework preinstalled in the default location: /Library/Frameworks.
 
   72 \section test_sec Test Programs
 
   74 Change to the ./test directory and run
 
   80 to create several test programs for the libraries functions. This requires
 
   81 the SDL2_gfx library to be previously compiled and installed.
 
   83 See the source in the test/*.c files for some sample code and implementation hints.
 
   85 \section documentation_sec Documentation
 
   87 Please refer to the Doxygen-generated API documentation found in the
 
   88 Docs/html folder as well as the test programs in the test folder.
 
   90 \section changelog_sec Change Log
 
   92 \verbinclude ChangeLog