blob: fa71cd44f0617edd9a347b1c98f8df297d502947 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
/***************************************************************************
* __________ __ ___.
* Open \______ \ ____ ____ | | _\_ |__ _______ ___
* Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
* Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
* Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
* \/ \/ \/ \/ \/
* $Id$
*
* Pacbox - a Pacman Emulator for Rockbox
*
* Based on PIE - Pacman Instructional Emulator
*
* Namco custom waveform sound generator 3 (Pacman hardware)
*
* Copyright (c) 2003,2004 Alessandro Scotti
* http://www.ascotti.org/
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
*
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
* KIND, either express or implied.
*
****************************************************************************/
#ifndef WSG3_H
#define WSG3_H
/**
Namco 3-channel sound generator voice properties.
This information is only needed by applications that want to do their own
sound rendering, as the playSound() function already plays and mixes all
three voices.
@see PacmanMachine::playSound
*/
struct wsg3_voice
{
/** Volume (from 0 to 15) */
unsigned volume;
/** Index into the 4-bit 32-entry waveform table (0 to 7) */
unsigned waveform;
/** Frequency */
unsigned frequency;
};
struct wsg3
{
unsigned master_clock;
unsigned sampling_rate;
unsigned char sound_regs[0x20];
unsigned char sound_prom[32*8];
unsigned resample_step;
unsigned wave_offset[3];
int16_t sound_wave_data[32*8]; /* sign-extended 4-bit, prenormalized */
};
extern struct wsg3 wsg3;
/**
Constructor.
@param masterClock clock frequency of sound chip (in Hertz)
@see #wsg3_play_sound
*/
void wsg3_init(unsigned master_clock);
/**
Sets the 256 byte PROM that contains the waveform table used by the sound chip.
*/
void wsg3_set_sound_prom( const unsigned char * prom );
/**
Sets the value of the specified register.
*/
static inline void wsg3_set_register(unsigned reg, unsigned char value)
{ wsg3.sound_regs[reg] = value; }
/**
Returns the value of the specified register.
*/
static inline unsigned char wsg3_get_register(unsigned reg)
{ return wsg3.sound_regs[reg]; }
/**
Reproduces the sound that is currently being generated by the sound
chip into the specified buffer.
The sound chip has three independent voices that generate 8-bit signed
PCM audio. This function resamples the voices at the currently specified
sampling rate and mixes them into the output buffer. The output buffer
can be converted to 8-bit (signed) PCM by dividing each sample by 3 (since
there are three voices) or it can be expanded to 16-bit by multiplying
each sample by 85 (i.e. 256 divided by 3). If necessary, it is possible
to approximate these values with 4 and 64 in order to use arithmetic
shifts that are usually faster to execute.
Note: this function does not clear the content of the output buffer before
mixing voices into it.
@param buf pointer to sound buffer that receives the audio samples
@param len length of the sound buffer
*/
void wsg3_play_sound(int16_t * buf, int len);
/**
Returns the sampling rate currently in use for rendering sound.
*/
static inline unsigned wsg3_get_sampling_rate(void)
{ return wsg3.sampling_rate; }
/**
Sets the output sampling rate for playSound().
@param samplingRate sampling rate in Hertz (samples per second)
*/
void wsg3_set_sampling_rate(unsigned sampling_rate);
#endif /* WSG3_H */
|
