.\" Automatically generated by Pod::Man v1.3, Pod::Parser v1.13
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R

.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "CFSNDSERV 6"
.TH CFSNDSERV 6 "2002-02-23" "cfsndserv" "cfsndserv"
.UC
.SH "NAME"
cfsndserv \- crossfire client sound server
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBgetzone\fR adjusts and mixes sounds before playing them
.SH "USAGE"
.IX Header "USAGE"
\&\fBgetzone\fR none \- started automatically by crossfire client
.SH "CONFIGURATION OPTIONS"
.IX Header "CONFIGURATION OPTIONS"
~/.crossfire/sndconfig can contain the following options:
.IP "stereo" 2
.IX Item "stereo"
1 means stereo sound, 0 \- mono
.IP "bits" 2
.IX Item "bits"
bitrate of generated sound \- 8 or 16
.IP "signed" 2
.IX Item "signed"
if we should sent signed data to the soundcard. 1 means yes.
.IP "frequency" 2
.IX Item "frequency"
speed of playing data. This should be 11025, or sound pitch will
change
.IP "buffers" 2
.IX Item "buffers"
how many buffers to allocate
.IP "buflen" 2
.IX Item "buflen"
how big the buffers should be. buffers*buflen shouldn't be smaller
than the longest sound to be played.
.IP "simultaneously" 2
.IX Item "simultaneously"
home many sound can be played at the same time. When this setting is
bigger, each sound volume will decrease.
.SH "HOW DOES IT WORK?"
.IX Header "HOW DOES IT WORK?"
The sound server gets information about sounds to be played on
standard input.
.PP
The information is a line:
<sound number> <sound type> <relative x> <relative y>
All those numbers are hex.
The file ~/.crossfire/sounds contains description of sound numbers and
types. For example:
.PP
3 0 5 0
.PP
Means that normal sound \s-1SOUND_FUMBLE\s0 spell should be played as it's
source was5 units to the right of player.
.PP
Sounds are mixed in special buffers, which are in fact one buffer,
which should be big enough for the biggest sound to be played.
.PP
The buffers, if contain anything, are sent one by one to the sound
device. Each buffer is cleaned after playing.
.PP
Sounds data is multiplied by some ratio (<1) evaluated from it's
position and volume and added to the buffers, starting from the next
after the one being played.
.PP
So bigger buffer means bigger delay, before th sound is actually
played, but the smaller buffer is, the bigger is possibility, we won't
succeed filling the next buffer, before last is played.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIcrossfire\fR\|(1)
.PP
http://crossfire.real\-time.com
.SH "AUTHOR"
.IX Header "AUTHOR"
.Vb 2
\& Jaakko Niemi put this page together for Debian packages by cutting
\& and pasting from README file of crossfire-client.
.Ve