README-macosx.txt
author Sam Lantinga <slouken@libsdl.org>
Mon, 21 Oct 2013 02:38:23 -0700
changeset 7874 446846276cb0
parent 7801 f00cc0a8cd5d
child 8191 b50f4ae6d5f2
permissions -rw-r--r--
We don't have API changes documented yet.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
7222
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
     1
==============================================================================
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
     2
Using the Simple DirectMedia Layer with Mac OS X
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
     3
==============================================================================
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
     4
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
     5
These instructions are for people using Apple's Mac OS X (pronounced
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
     6
"ten").
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
     7
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
     8
From the developer's point of view, OS X is a sort of hybrid Mac and
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
     9
Unix system, and you have the option of using either traditional
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    10
command line tools or Apple's IDE Xcode.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    11
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    12
To build SDL using the command line, use the standard configure and make
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    13
process:
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    14
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    15
	./configure
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    16
	make
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    17
	sudo make install
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    18
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    19
You can also build SDL as a Universal library (a single binary for both
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    20
PowerPC and Intel architectures), on Mac OS X 10.4 and newer, by using
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    21
the fatbuild.sh script in build-scripts:
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    22
	sh build-scripts/fatbuild.sh
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    23
	sudo build-scripts/fatbuild.sh install
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    24
This script builds SDL with 10.2 ABI compatibility on PowerPC and 10.4
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    25
ABI compatibility on Intel architectures.  For best compatibility you
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    26
should compile your application the same way.  A script which wraps
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    27
gcc to make this easy is provided in test/gcc-fat.sh
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    28
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    29
To use the library once it's built, you essential have two possibilities:
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    30
use the traditional autoconf/automake/make method, or use Xcode.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    31
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    32
==============================================================================
7801
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    33
Caveats for using SDL with Mac OS X
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    34
==============================================================================
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    35
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    36
Some things you have to be aware of when using SDL on Mac OS X:
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    37
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    38
- If you register your own NSApplicationDelegate (using [NSApp setDelegate:]),
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    39
  SDL will not register its own. This means that SDL will not terminate using
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    40
  SDL_Quit if it receives a termination request, it will terminate like a 
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    41
  normal app, and it will not send a SDL_DROPFILE when you request to open a
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    42
  file with the app. To solve these issues, put the following code in your 
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    43
  NSApplicationDelegate implementation:
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    44
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    45
  - (NSApplicationTerminateReply)applicationShouldTerminate:(NSApplication *)sender
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    46
  {
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    47
      if (SDL_GetEventState(SDL_QUIT) == SDL_ENABLE) {
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    48
          SDL_Event event;
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    49
          event.type = SDL_QUIT;
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    50
          SDL_PushEvent(&event);
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    51
      }
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    52
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    53
      return NSTerminateCancel;
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    54
  }
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    55
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    56
  - (BOOL)application:(NSApplication *)theApplication openFile:(NSString *)filename
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    57
  {
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    58
      if (SDL_GetEventState(SDL_DROPFILE) == SDL_ENABLE) {
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    59
          SDL_Event event;
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    60
          event.type = SDL_DROPFILE;
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    61
          event.drop.file = SDL_strdup([filename UTF8String]);
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    62
          return (SDL_PushEvent(&event) > 0);
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    63
      }
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    64
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    65
      return NO;
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    66
  }
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    67
f00cc0a8cd5d Mac: Better handling when someone else is the app delegate.
Jørgen P. Tjernø <jorgen@valvesoftware.com>
parents: 7222
diff changeset
    68
==============================================================================
7222
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    69
Using the Simple DirectMedia Layer with a traditional Makefile
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    70
==============================================================================
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    71
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    72
An existing autoconf/automake build system for your SDL app has good chances
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    73
to work almost unchanged on OS X. However, to produce a "real" Mac OS X binary
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    74
that you can distribute to users, you need to put the generated binary into a
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    75
so called "bundle", which basically is a fancy folder with a name like
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    76
"MyCoolGame.app".
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    77
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    78
To get this build automatically, add something like the following rule to
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    79
your Makefile.am:
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    80
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    81
bundle_contents = APP_NAME.app/Contents
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    82
APP_NAME_bundle: EXE_NAME
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    83
	mkdir -p $(bundle_contents)/MacOS
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    84
	mkdir -p $(bundle_contents)/Resources
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    85
	echo "APPL????" > $(bundle_contents)/PkgInfo
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    86
	$(INSTALL_PROGRAM) $< $(bundle_contents)/MacOS/
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    87
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    88
You should replace EXE_NAME with the name of the executable. APP_NAME is what
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    89
will be visible to the user in the Finder. Usually it will be the same
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    90
as EXE_NAME but capitalized. E.g. if EXE_NAME is "testgame" then APP_NAME 
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    91
usually is "TestGame". You might also want to use @PACKAGE@ to use the package
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    92
name as specified in your configure.in file.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    93
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    94
If your project builds more than one application, you will have to do a bit
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    95
more. For each of your target applications, you need a separate rule.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    96
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    97
If you want the created bundles to be installed, you may want to add this
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    98
rule to your Makefile.am:
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
    99
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   100
install-exec-hook: APP_NAME_bundle
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   101
	rm -rf $(DESTDIR)$(prefix)/Applications/APP_NAME.app
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   102
	mkdir -p $(DESTDIR)$(prefix)/Applications/
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   103
	cp -r $< /$(DESTDIR)$(prefix)Applications/
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   104
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   105
This rule takes the Bundle created by the rule from step 3 and installs them
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   106
into $(DESTDIR)$(prefix)/Applications/.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   107
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   108
Again, if you want to install multiple applications, you will have to augment
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   109
the make rule accordingly.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   110
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   111
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   112
But beware! That is only part of the story! With the above, you end up with
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   113
a bare bone .app bundle, which is double clickable from the Finder. But
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   114
there are some more things you should do before shipping your product...
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   115
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   116
1) The bundle right now probably is dynamically linked against SDL. That 
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   117
   means that when you copy it to another computer, *it will not run*,
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   118
   unless you also install SDL on that other computer. A good solution
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   119
   for this dilemma is to static link against SDL. On OS X, you can
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   120
   achieve that by linking against the libraries listed by
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   121
     sdl-config --static-libs
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   122
   instead of those listed by
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   123
     sdl-config --libs
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   124
   Depending on how exactly SDL is integrated into your build systems, the
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   125
   way to achieve that varies, so I won't describe it here in detail
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   126
2) Add an 'Info.plist' to your application. That is a special XML file which
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   127
   contains some meta-information about your application (like some copyright
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   128
   information, the version of your app, the name of an optional icon file,
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   129
   and other things). Part of that information is displayed by the Finder
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   130
   when you click on the .app, or if you look at the "Get Info" window.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   131
   More information about Info.plist files can be found on Apple's homepage.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   132
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   133
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   134
As a final remark, let me add that I use some of the techniques (and some
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   135
variations of them) in Exult and ScummVM; both are available in source on
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   136
the net, so feel free to take a peek at them for inspiration!
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   137
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   138
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   139
==============================================================================
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   140
Using the Simple DirectMedia Layer with Xcode
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   141
==============================================================================
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   142
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   143
These instructions are for using Apple's Xcode IDE to build SDL applications.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   144
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   145
- First steps
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   146
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   147
The first thing to do is to unpack the Xcode.tar.gz archive in the
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   148
top level SDL directory (where the Xcode.tar.gz archive resides).
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   149
Because Stuffit Expander will unpack the archive into a subdirectory,
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   150
you should unpack the archive manually from the command line:
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   151
	cd [path_to_SDL_source]
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   152
	tar zxf Xcode.tar.gz
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   153
This will create a new folder called Xcode, which you can browse
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   154
normally from the Finder.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   155
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   156
- Building the Framework
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   157
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   158
The SDL Library is packaged as a framework bundle, an organized
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   159
relocatable folder hierarchy of executable code, interface headers,
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   160
and additional resources. For practical purposes, you can think of a 
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   161
framework as a more user and system-friendly shared library, whose library
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   162
file behaves more or less like a standard UNIX shared library.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   163
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   164
To build the framework, simply open the framework project and build it. 
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   165
By default, the framework bundle "SDL.framework" is installed in 
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   166
/Library/Frameworks. Therefore, the testers and project stationary expect
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   167
it to be located there. However, it will function the same in any of the
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   168
following locations:
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   169
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   170
    ~/Library/Frameworks
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   171
    /Local/Library/Frameworks
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   172
    /System/Library/Frameworks
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   173
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   174
- Build Options
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   175
    There are two "Build Styles" (See the "Targets" tab) for SDL.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   176
    "Deployment" should be used if you aren't tweaking the SDL library.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   177
    "Development" should be used to debug SDL apps or the library itself.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   178
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   179
- Building the Testers
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   180
    Open the SDLTest project and build away!
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   181
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   182
- Using the Project Stationary
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   183
    Copy the stationary to the indicated folders to access it from
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   184
    the "New Project" and "Add target" menus. What could be easier?
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   185
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   186
- Setting up a new project by hand
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   187
    Some of you won't want to use the Stationary so I'll give some tips:
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   188
    * Create a new "Cocoa Application"
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   189
    * Add src/main/macosx/SDLMain.m , .h and .nib to your project
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   190
    * Remove "main.c" from your project
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   191
    * Remove "MainMenu.nib" from your project
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   192
    * Add "$(HOME)/Library/Frameworks/SDL.framework/Headers" to include path
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   193
    * Add "$(HOME)/Library/Frameworks" to the frameworks search path
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   194
    * Add "-framework SDL -framework Foundation -framework AppKit" to "OTHER_LDFLAGS"
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   195
    * Set the "Main Nib File" under "Application Settings" to "SDLMain.nib"
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   196
    * Add your files
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   197
    * Clean and build
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   198
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   199
- Building from command line
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   200
    Use pbxbuild in the same directory as your .pbproj file
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   201
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   202
- Running your app
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   203
    You can send command line args to your app by either invoking it from
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   204
    the command line (in *.app/Contents/MacOS) or by entering them in the
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   205
    "Executables" panel of the target settings.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   206
    
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   207
- Implementation Notes
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   208
    Some things that may be of interest about how it all works...
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   209
    * Working directory
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   210
        As defined in the SDL_main.m file, the working directory of your SDL app
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   211
        is by default set to its parent. You may wish to change this to better
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   212
        suit your needs.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   213
    * You have a Cocoa App!
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   214
        Your SDL app is essentially a Cocoa application. When your app
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   215
        starts up and the libraries finish loading, a Cocoa procedure is called,
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   216
        which sets up the working directory and calls your main() method.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   217
        You are free to modify your Cocoa app with generally no consequence 
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   218
        to SDL. You cannot, however, easily change the SDL window itself.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   219
        Functionality may be added in the future to help this.
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   220
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   221
2435b221d77d Renamed documentation files to .txt and converted them to DOS line endings so they would open properly on all systems.
Sam Lantinga <slouken@libsdl.org>
parents: 6987
diff changeset
   222
Known bugs are listed in the file "BUGS"