README.Epoc
author Patrice Mandin <patmandin@gmail.com>
Thu, 19 Jan 2006 21:28:52 +0000
changeset 1257 448a9a64537b
parent 250 74a8f672f2f8
permissions -rw-r--r--
[PATCH] SDL_GetVideoMode() does not find best mode, part 2

Following commit 1.51, I come accross a problem when SDL must choose between
several video modes that could suit the one asked.

If I ask 320x240 with this list:
768x480 768x240 640x400 640x200 384x480 384x240 320x400 320x200

The smallest selectables modes are 384x240 and 320x400. And SDL choose the later
in this list, but 384x240 is more suitable. So I added a check to compare
the pixel count (surface) of modes, and select the one which has the smallest
pixel count.

In my example, 384x240 has 92160 pixels, and 320x400 has 128000 pixels. So now
SDL will choose 384x240 for the asked 320x240 mode.
slouken@173
     1
slouken@250
     2
==============================================================================
slouken@250
     3
Using the Simple DirectMedia Layer with EPOC/SymbianOS 6.0
slouken@250
     4
==============================================================================
slouken@173
     5
slouken@250
     6
==============================================================================
slouken@250
     7
I.  Building the Simple DirectMedia Layer libraries:
slouken@173
     8
slouken@250
     9
  You can get Symbian SDK from: 
slouken@250
    10
    http://www.symbian.com.
slouken@173
    11
 
slouken@250
    12
  First create "Epoc" directory under SDL main directory and unpack 
slouken@250
    13
  EpocBuildFiles.zip in it.
slouken@250
    14
   
slouken@250
    15
  To build the librarys goto "epoc" directory and type:
slouken@250
    16
    bldmake bldfiles
slouken@250
    17
    abld makefile vc6 (for creating Microsoft Visual C++ makefiles)
slouken@250
    18
    abld build wins udeb (building for wins emulator)
slouken@250
    19
    abld build armi urel (building for real device)
slouken@173
    20
slouken@250
    21
==============================================================================
slouken@250
    22
II. Building the Simple DirectMedia Layer programs:
slouken@173
    23
slouken@250
    24
  Building SDL test programs is easy once you have built the libraries:
slouken@250
    25
    abld test build wins udeb
slouken@250
    26
    abld test build armi urel
slouken@173
    27
slouken@250
    28
  Supported real screen resolutions
slouken@250
    29
    320 x 200 x  8 bit
slouken@250
    30
    320 x 200 x 12 bit
slouken@250
    31
    640 x 200 x  8 bit
slouken@250
    32
    640 x 200 x 12 bit
slouken@250
    33
  Supported "emulated" screen resolutions 
slouken@250
    34
    640 x 400 x  8 bit
slouken@250
    35
    640 x 400 x 12 bit
slouken@250
    36
    640 x 480 x  8 bit
slouken@250
    37
    640 x 480 x 12 bit
slouken@250
    38
  "Emulated" resolutions are implemented by by shrinking the screen vertically 
slouken@250
    39
  i.e. only every second scanline is drawn. This is mainly ment to be used for 
slouken@250
    40
  testing quick ports of programs. Using faked resolutions is a waste of memory 
slouken@250
    41
  and cpu power!
slouken@173
    42
slouken@250
    43
==============================================================================
slouken@250
    44
III. Running test programs
slouken@173
    45
slouken@250
    46
  Copy executable to the device and run it from the File manager.   The Esc 
slouken@250
    47
  key quits demo programs. In Crystal, Exe programs do not appear in task list 
slouken@250
    48
  nor in Extras :-(. Test programs are tested in Nokia 9210 Communicator.
slouken@173
    49
slouken@250
    50
  Special keys used in SDL:
slouken@250
    51
    The Caps lock key enables or disables the virtual cursor. 
slouken@250
    52
    Function keys are mapped as follows: 
slouken@250
    53
    F1=chr+q, F2=chr+w,..., F8=chr+i, 
slouken@250
    54
    F9=chr+a,..., F12=chr+d.
slouken@173
    55
slouken@250
    56
==============================================================================
slouken@250
    57
IV.  Enjoy! :)
slouken@173
    58
slouken@250
    59
  If you have a project you'd like me to know about, or want to ask questions,
slouken@250
    60
  go ahead and join the SDL developer's mailing list by sending e-mail to:
slouken@173
    61
slouken@250
    62
	sdl-request@libsdl.org
slouken@173
    63
slouken@250
    64
  and put "subscribe" into the subject of the message. Or alternatively you
slouken@250
    65
  can use the web interface:
slouken@173
    66
slouken@250
    67
	http://www.libsdl.org/mailman/listinfo/sdl
slouken@173
    68
slouken@250
    69
  You can find more info about Epoc version of SDL from Hannu Viitala's 
slouken@250
    70
  homepage
slouken@250
    71
    http://www.mbnet.fi/~haviital
slouken@250
    72
  
slouken@250
    73
==============================================================================
slouken@173
    74
slouken@173
    75