annotate README.OpenBSD @ 216:e2a10730ae94

Fail if setting a video mode when requesting GL and can't get it.
author Sam Lantinga <slouken@libsdl.org>
date Thu, 25 Oct 2001 06:22:38 +0000
parents 3ad7157c6cfa
children
rev   line source
37
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
1 =============================================================
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
2 Using the Simple DirectMedia Layer with OpenBSD 2.9 and later
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
3 =============================================================
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
4
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
5 Author:
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
6 Peter Valchev <pvalchev@openbsd.org>
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
7
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
8 =======
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
9 Install
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
10 =======
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
11 There is an OpenBSD port for SDL and various other tools. Using
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
12 this port is recommended, since it contains all the needed patches
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
13 and configure arguments nicely organized in several FLAVORS you
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
14 can pick from. If you're unfamiliar with the OpenBSD ports system
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
15 please visit:
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
16 http://www.openbsd.org/ports.html
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
17 http://www.openbsd.org/anoncvs.html
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
18
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
19 You should have a precompiled binary package on your OpenBSD 2.9
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
20 or later CD-ROM, which you can easily add with pkg_add(1).
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
21
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
22 If for whatever reason you're unable to take the advantage of the
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
23 created port, or you want to stick with the newest fresh SDL from
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
24 the current CVS repository, here are some hints of what has left
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
25 unresolved and needs to be disabled/changed.
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
26
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
27 To build SDL with OSS + esound:
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
28
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
29 1. ./configure --disable-joystick \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
30 --disable-pthread-sem \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
31 --disable-nasm \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
32 --enable-esd \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
33 --enable-oss \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
34 --disable-arts \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
35 --disable-video-opengl
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
36
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
37 OR
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
38
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
39 To build SDL with native audio + esound (remove --disable-esd otherwise):
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
40 1. ./configure --disable-joystick \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
41 --disable-pthread-sem \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
42 --disable-nasm \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
43 --enable-openbsdaudio \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
44 --enable-esd \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
45 --disable-arts \
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
46 --disable-video-opengl
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
47
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
48 If you need arts or GL, omit the responding --disable lines. In the
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
49 port, they're disabled by default, you need to specify flavors to
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
50 make use of them.
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
51
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
52 2. gmake # Yeah, GNU make is required, install the package
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
53 3. sudo gmake install
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
54
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
55 =========
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
56 Todo List
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
57 =========
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
58
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
59 Feedback is always welcome with anything you may find useful and
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
60 you can suggest.
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
61 For now, the following things have to be worked on:
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
62
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
63 1. The native audio should be widely tested and will eventually
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
64 become the default. At that moment I have not received any
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
65 feedback which should explain its current condition.
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
66
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
67 2. There are occurences of dynamic loading of drivers in the OpenGL
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
68 code section, and our a.out architectures need an underscore prefixed
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
69 to symbol names. Some solution to that may be a good thing. I can
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
70 fix it theoretically, but unfortunately I do not have the needed
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
71 hardware/configuration to test it. If you bump into that, email me.
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
72
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
73 ===================
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
74 Contact Information
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
75 ===================
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
76 Everybody is welcome to give me any suggestions and to report bugs
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
77 (as well as fixing them ;-) You can contact me by email:
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
78 Peter Valchev <pvalchev@openbsd.org>
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
79
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
80 $Id$
3ad7157c6cfa Added native OpenBSD audio driver (thanks vedge!)
Sam Lantinga <slouken@lokigames.com>
parents:
diff changeset
81