README-cmake.txt
author Sam Lantinga <slouken@libsdl.org>
Thu, 01 Aug 2013 09:15:36 -0700
changeset 7563 c128ed448c30
parent 7222 2435b221d77d
permissions -rw-r--r--
Fixed bug 1968 - SDL_RenderCopy stretch loses proportion on viewport boundaries for 3D renderers

driedfruit

SDL_RenderCopy clips dstrect against the viewport. Then it adjusts the
srcrect by "appropriate" amount of pixels. This amount is actually
wrong, quite a lot, because of the rounding errors introduced in the "*
factor / factor" scale.

real_srcrect.x += (deltax * real_srcrect.w) / dstrect->w;
real_srcrect.w += (deltaw * real_srcrect.w) / dstrect->w;

For example:

I have a 32 x 32 srcrect and a 64 x 64 dstrect. So far the
stretching is done perfectly, by a factor of 2.

Now, consider dstrect being clipped against the viewport, so it becomes
56 x 64. Now, the factor becomes 1.75 ! The adjustment to "srcrect"
can't handle this, cause srcrect is in integers.

And thus we now have incorrect mapping, with dstrect not being in the
right proportion to srcrect.

The problem is most evident when upscaling stuff, like displaying a 8x8
texture with a zoom of 64 or more, and moving it beyond the corners of
the screen. It *looks* really really bad.

Note: RenderCopyEX does no such clipping, and is right to do so. The fix would be to remove any such clipping from RenderCopy too. And then fix the software renderer, because it has the same fault, independently of RenderCopy.

[attached patch]
this leaves Software Renderer buggy, as it does it's own clipping later on
slouken@7222
     1
================================================================================
slouken@7222
     2
CMake build system for SDL (www.cmake.org)
slouken@7222
     3
================================================================================
slouken@7222
     4
slouken@7222
     5
SDL's build system was traditionally based on autotools. Over time, this
slouken@7222
     6
approach has suffered from several issues across the different supported 
slouken@7222
     7
platforms.
slouken@7222
     8
To solve these problems, a new build system based on CMake is under development.
slouken@7222
     9
It works in parallel to the legacy system, so users can experiment with it
slouken@7222
    10
without complication.
slouken@7222
    11
While still experimental, the build system should be usable on the following
slouken@7222
    12
platforms:
slouken@7222
    13
    
slouken@7222
    14
    * FreeBSD
slouken@7222
    15
    * Linux
slouken@7222
    16
    * VS.NET 2010
slouken@7222
    17
    * MinGW and Msys
slouken@7222
    18
    * OS X with support for XCode
slouken@7222
    19
    
slouken@7222
    20
================================================================================
slouken@7222
    21
Usage
slouken@7222
    22
================================================================================
slouken@7222
    23
slouken@7222
    24
Assuming the source for SDL is located at ~/sdl
slouken@7222
    25
slouken@7222
    26
cd ~
slouken@7222
    27
mkdir build
slouken@7222
    28
cd build
slouken@7222
    29
cmake ../sdl
slouken@7222
    30
slouken@7222
    31
This will build the static and dynamic versions of SDL in the ~/build directory.