view README.OpenBSD @ 172:37e3ca9254c7

Date: Sat, 8 Sep 2001 04:42:23 +0200 From: Max Horn <max@quendi.de> Subject: SDL/OSX: Joystick; Better key handling I just finished implementing improved keyhandling for OS X (in fact the code should be easily ported to the "normal" MacOS part of SDL, I just had no chance yet). Works like this: First init the mapping table statically like before. Them, it queries the OS for the "official" key table, then iterates over all 127 scancode and gets the associates ascii code. It ignores everythng below 32 (has to, as it would lead to many problems if we did not... e.g. both ESC and NUM LOCk produce an ascii code 27 on my keyboard), and all stuff above 127 is mapped to SDLK_WORLD_* simply in the order it is encountered. In addition, caps lock is now working, too. The code work flawless for me, but since I only have one keyboard, I may have not encountered some serious problem... but I am pretty confident that it is better than the old code in most cases. The joystick driver works fine for me, too. I think it can be added to CVS already. It would simply be helpful if more people would test it. Hm, I wonder if Maelstrom or GLTron has Joystick support? That would be a wonderful test application :) I also took the liberty of modifying some text files like BUGS, README.CVS, README.MacOSX (which now contains the OS X docs I long promised)
author Sam Lantinga <slouken@libsdl.org>
date Tue, 11 Sep 2001 19:00:18 +0000
parents 3ad7157c6cfa
children
line wrap: on
line source

=============================================================
Using the Simple DirectMedia Layer with OpenBSD 2.9 and later
=============================================================

Author: 
Peter Valchev <pvalchev@openbsd.org>
  
=======
Install 
=======
There is an OpenBSD port for SDL and various other tools.  Using
this port is recommended, since it contains all the needed patches
and configure arguments nicely organized in several FLAVORS you
can pick from.  If you're unfamiliar with the OpenBSD ports system
please visit:
http://www.openbsd.org/ports.html
http://www.openbsd.org/anoncvs.html

You should have a precompiled binary package on your OpenBSD 2.9
or later CD-ROM, which you can easily add with pkg_add(1).

If for whatever reason you're unable to take the advantage of the
created port, or you want to stick with the newest fresh SDL from
the current CVS repository, here are some hints of what has left
unresolved and needs to be disabled/changed.

To build SDL with OSS + esound:

1. ./configure --disable-joystick \
	--disable-pthread-sem \
	--disable-nasm \
	--enable-esd \
	--enable-oss \
	--disable-arts \
	--disable-video-opengl

OR

To build SDL with native audio + esound (remove --disable-esd otherwise):
1. ./configure --disable-joystick \
	--disable-pthread-sem \
	--disable-nasm \
	--enable-openbsdaudio \
	--enable-esd \
	--disable-arts \
	--disable-video-opengl

If you need arts or GL, omit the responding --disable lines.  In the
port, they're disabled by default, you need to specify flavors to
make use of them.

2. gmake    # Yeah, GNU make is required, install the package 
3. sudo gmake install

=========
Todo List 
=========

Feedback is always welcome with anything you may find useful and
you can suggest.
For now, the following things have to be worked on:

1. The native audio should be widely tested and will eventually
become the default.  At that moment I have not received any 
feedback which should explain its current condition.

2. There are occurences of dynamic loading of drivers in the OpenGL
code section, and our a.out architectures need an underscore prefixed
to symbol names.  Some solution to that may be a good thing.  I can
fix it theoretically, but unfortunately I do not have the needed 
hardware/configuration to test it.  If you bump into that, email me.

===================
Contact Information
===================
Everybody is welcome to give me any suggestions and to report bugs
(as well as fixing them ;-)  You can contact me by email:
Peter Valchev <pvalchev@openbsd.org>

$Id$