README-winrt.txt
author Ryan C. Gordon <icculus@icculus.org>
Tue, 22 Jul 2014 21:41:49 -0400
changeset 9012 aa058c87737b
parent 8698 0eed6a72e3c1
permissions -rw-r--r--
Added audio device buffer queueing API.
     1 ================================================================================
     2 Simple DirectMedia Layer for WinRT
     3 ================================================================================
     4 
     5 SDL/WinRT layer allows SDL2-based applications to run on many of Microsoft's
     6 platforms that utilize the "Windows Runtime" (aka "WinRT") APIs.  WinRT apps
     7 are currently always full-screen apps, run in what Microsoft calls their
     8 "Modern" environment (aka. "Metro"), and are distributed via Microsoft-run
     9 online stores.  Some of the operating systems that support such apps include:
    10 
    11 * Windows 8.x
    12 * Windows RT 8.x (aka. Windows 8.x for ARM processors)
    13 * Windows Phone 8.x
    14 
    15 To note, WinRT applications that run on Windows 8.x and/or Windows RT are often
    16 called "Windows Store" apps.
    17 
    18 
    19 --------------------------------------------------------------------------------
    20 Requirements
    21 --------------------------------------------------------------------------------
    22 - Microsoft Visual C++ 2012 -- Free, "Express" editions may be used, so long
    23   as they include support for either "Windows Store" or "Windows Phone" apps.
    24   (NOTE: MSVC 2013 support is pending.  2012 projects may be converted to 2013
    25   projects by MSVC, in the meantime.)
    26 - A valid Microsoft account -- This requirement is not imposed by SDL, but
    27   rather by Microsoft's Visual C++ toolchain.
    28 
    29 
    30 --------------------------------------------------------------------------------
    31 TODO
    32 --------------------------------------------------------------------------------
    33 - Finish adding support for MSVC 2013, and "Universal" WinRT apps, which
    34   support Windows 8.1, Windows Phone 8.1, and in the future, Xbox One and
    35   Windows Desktop.
    36 - Finish adding support for the SDL satellite libraries (SDL_image, SDL_mixer,
    37   SDL_ttf, etc.)
    38 - Create templates for both MSVC 2012 and MSVC 2013, and have the corresponding
    39   VSIX packages either include pre-built copies of SDL, or reference binaries
    40   available via MSVC's NuGet servers
    41 - Write setup instructions that use MSVC 201x templates
    42 - Write setup instructions that don't use MSVC 201x templates, and use
    43   MSVC project-to-project references, rather than pre-built binaries
    44 - Write a list of caveats found in SDL/WinRT, such as APIs that don't work due
    45   to platform restrictions, or things that need further work