Mercurial > sdl-ios-xcode
view README.QNX @ 4447:947201caa46e
Added automated test to Xcode project plus needed changes to SDL_RWFromFile to be OS X bundle aware.
The Mac OS X project has a new target called testsdl which builds the automated test. I looked at using Xcode's native unit test support, but the impedance mismatch between the existing automated test structure and Apple's was more than I could handle.
As such, the testsdl application is a full blown proper OS X application, which means it is a self-contained .app bundle. This immediately revealed some problems from the automated test. The largest problem was the assumption about the current working directory and where to find resources. (I suspect Windows may have a similar problem depending on circumstance.) To open resources, the test was looking in directories relative to the SDL source directory, but this will not work well with self-contained .app bundles and Xcode which can place its built applications almost anywhere. And for real-world situations, this is pretty useless anyway.
So I modified SDL_RWFromFile to do special things on OS X. First, it will look for a file in the .app bundle. If not found, it will fallback and just call fopen as it used to do.
I also had to modify the automated test itself because it had a contrieved test which called fopen directly to do read from an existing FILE pointer. In addition, there was a write test. Since a .app bundle is likely going to be read-only, I added a special case for OS X to write to NSTemporaryDirectory.
I expect these changes should work for both Mac and iPhone OS (which includes iPad).
I will update the iPhone Xcode project next.
Finally, FYI, the X11 automated test seems to be failing. Below is my output.
Pending breakpoint 4 - "-[NSException raise]" resolved
Platform : All tests successful (2)
SDL_RWops : All tests successful (5)
Rect : All tests successful (1)
SDL_Surface : All tests successful (6)
Rendering with cocoa driver : All tests successful (3)
Assert Failed!
Blit output not the same.
Test Case 'Renderer x11'
Test Suite 'Rendering with x11 driver'
Last SDL error ''
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetSurfaceBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorFailure: Set a breakpoint @ CGErrorBreakpoint() to catch errors as they are logged.
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetWindowBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetSurfaceBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetWindowBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetSurfaceBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetWindowBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetSurfaceBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetWindowBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetSurfaceBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetWindowBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetSurfaceBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetWindowBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSGetSurfaceBounds
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Sat May 8 00:30:34 iMacAL.local testsdl[71586] <Error>: kCGErrorIllegalArgument: CGSBindSurface: Invalid window 0xa150
Rendering with x11 driver : Failed 1 out of 4 testcases!
Rendering with dummy driver : All tests successful (3)
SDL_Audio : All tests successful (1)
Tests run with SDL 1.3.0 revision 1095906
System is running Mac OS X and is little endian
author | Eric Wing <ewing . public |-at-| gmail . com> |
---|---|
date | Sat, 08 May 2010 00:54:22 -0700 |
parents | 7c73d5b5a0d6 |
children |
line wrap: on
line source
README.QNX by Mike Gorchak <mike@malva.ua>, <lestat@i.com.ua> Last changed at 10 Jun 2009. QNX Photon and GF drivers are being constructed, OpenGL ES support is finished. Still no 2D renderer support in GF and Photon drivers. QNX QSA (QNX Sound Architecture) driver is ready. QNX HID input driver is finished. ---------------------- -- SDL QSA driver -- ---------------------- Due to QNX Sound Architecture limitations software could not determine what playback channels are designed for, so some casus can be. For example, output after testmultiaudio test utility execution: Using audio driver: qsa playing on device #0: ('Vortex 8820 @ fb000000 d0')...done. playing on device #1: ('Vortex 8820 @ fb000000 d1')...done. playing on device #2: ('i8x0 @ d800 d0')...done. playing on device #3: ('i8x0 @ d800 d1')...done. playing on all devices... Open device 3 failed: QSA: snd_pcm_channel_params failed: Invalid argument If speakers are connected to both audio cards: Vortex 8820 and Intel Integrated Audio we can hear sound playback on device #0 and devices #2, #3 only. Device #1 is an unknown PCM channel which does not produce any sound. As for error during device #3 opening, it's caused by QSA software mixer channel, because it can't open real hardware device #2, since it's already opened by SDL. After simultaneous sound playback on all devices utility testmultiaudio stays running waiting for sound playback finish on device #1, which is locked up due to some Aureal Vortex 8820 driver limitations. --------------------- -- SDL GF driver -- --------------------- Here is an additional information about SDL GF driver: * 0. Introduction. * 1. Environment variables which SDL GF driver supports. * 2. Custom video modes. * 3. Limitations. 0. Introduction. SDL GF driver is a layer between SDL and QNX Graphics Framework (GF). SDL GF driver also supports OpenGL ES through the QNX Graphics Framework. Hardware accelerated features which SDL can support depend on real hardware capabilities. 1. Environment variables which GF driver supports. GF driver supports the following environment variables for QNX GF specific customization options: a) SDL_VIDEO_GF_REFRESH_RATE - refresh rate of video output in Hz. Without this environment variable declaration SDL controls refresh rate of your display. If this enironment variable is set to 0, SDL will control refresh rate of display, otherwise value of flag SDL_VIDEO_GF_REFRESH_RATE is used for all screen resolutions as refresh rate. This example will set 60Hz refresh rate as refresh rate for all graphics modes: export SDL_VIDEO_GF_REFRESH_RATE=60 2. Custom video modes. Since most QNX graphics drivers support GENERIC video modes, i.e. you can specify any horizontal and vertical resolution and any refresh rate, SDL GF driver uses its own fullscreen modes list, which can be incomplete. You can add any custom video mode, which your QNX graphics driver supports by editing file ./src/video/qnxgf/SDL_qnxgf.c. Custom graphics mode definition looks like this: {0, 1024, 640, 60, NULL}, /* 1024x640 mode is 60Hz only */ You must specify horizontal resolution as the second parameter, vertical resolution as the third one and refresh rate as the fourth parameter. Please leave the first and the last parameters as 0 and NULL. Then send me your changes to e-mail address which is specified in the header of this document. 3. Limitations. There are few limitations while using SDL GF driver: a) Since GF driver supports fullscreen modes only, when flag SDL_WINDOW_FULLSCREEN is not specified, SDL GF driver will try to find the fullscreen graphics mode which corresponds to SDL window size. Refresh rate will be the lowest available, if SDL_VIDEO_GF_REFRESH_RATE environment variable is not set. b) As confirmed by QSSL none of existing video drivers has support of doublescan low-resolution video modes. So modes below 640x480 are not supported. If your video driver supports low-resolution video modes, please add SDL_GF_LOWRESOLUTION flag to the gf_devicename array in the SDL_qnxgf.c source file. c) Since GF framework supports hardware mouse cursor only, you'll get hardware mouse cursor in case of specific graphics driver supports it. ------------------------- -- SDL Photon driver -- ------------------------- ---------------------------- -- SDL HID input driver -- ----------------------------