README.OpenBSD
author Sam Lantinga <slouken@libsdl.org>
Thu, 22 Nov 2001 06:34:25 +0000
changeset 243 cf4944faad96
parent 37 3ad7157c6cfa
permissions -rw-r--r--
Fixed testgl so that SDL_GL_Enter2DMode() allows alpha blending
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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