README.txt
author Sam Lantinga <slouken@libsdl.org>
Fri, 28 Nov 2014 04:51:33 -0800
changeset 9246 a761913e5e91
parent 9025 d09d4b578e77
child 9507 b1e690e9c5b3
permissions -rw-r--r--
Fixed bug 2786 - "UCS-2-INTERNAL" iconv encoding is not supported everywhere, use UTF-16LE instead

Jonas Kulla

src/main/windows/SDL_windows_main.c:137:
cmdline = SDL_iconv_string("UTF-8", "UCS-2-INTERNAL", (char *)(text), (SDL_wcslen(text)+1)*sizeof(WCHAR));

I'm trying to compile an SDL2 application for windows using the mingw-w64 32bit toolchain provided by my distro (Fedora 19). However, even the simplest test program that does nothing at all fails to startup with a "Fatal error - out of memory" message because the mingw iconv library provided by my distro does not support the "UCS-2-INTERNAL" encoding and the conversion returns null.

From my little bit of research, it turns out that even though this encoding is supported by the external GNU libiconv library, some glibc versions (?) don't support it with their internal iconv routines, and will instead provide the native endian encoding when "UCS-2" is specified.

Nonetheless, I wonder why the native endianness is considered in the first place when Windows doesn't even run on any big endian archs (to my knowledge). And true enough, 'WIN_StringToUTF8' from core/windows/SDL_windows.h is used everywhere else in the windows backend, which is just a macro to iconv with "UTF-16LE" as source. Therefore it would IMO make sense to use this macro here as well, which would solve my problem (patch attached).
slouken@9025
     1
slouken@9025
     2
                         Simple DirectMedia Layer
slouken@9025
     3
slouken@9025
     4
                                  (SDL)
slouken@9025
     5
slouken@9025
     6
                                Version 2.0
slouken@9025
     7
slouken@9025
     8
---
slouken@9025
     9
http://www.libsdl.org/
slouken@9025
    10
slouken@9025
    11
Simple DirectMedia Layer is a cross-platform development library designed
slouken@9025
    12
to provide low level access to audio, keyboard, mouse, joystick, and graphics
slouken@9025
    13
hardware via OpenGL and Direct3D. It is used by video playback software,
slouken@9025
    14
emulators, and popular games including Valve's award winning catalog
slouken@9025
    15
and many Humble Bundle games.
slouken@9025
    16
slouken@9025
    17
More extensive documentation is available in the docs directory, starting
slouken@9025
    18
with README.md
slouken@9025
    19
slouken@9025
    20
Enjoy!
slouken@9025
    21
	Sam Lantinga				(slouken@libsdl.org)