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 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485
|
/* ScummVM - Graphic Adventure Engine
*
* ScummVM is the legal property of its developers, whose names
* are too numerous to list here. Please refer to the COPYRIGHT
* file distributed with this source distribution.
*
* 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 program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*
*/
#include "sci/sci.h"
#include "sci/engine/features.h"
#include "sci/engine/state.h"
#include "sci/engine/kernel.h"
#include "sci/engine/vm.h" // for Object
#include "sci/sound/audio.h"
#ifdef ENABLE_SCI32
#include "sci/sound/audio32.h"
#endif
#include "sci/sound/soundcmd.h"
#include "sci/sound/sync.h"
#include "audio/mixer.h"
#include "common/system.h"
namespace Sci {
/**
* Used for synthesized music playback
*/
reg_t kDoSound(EngineState *s, int argc, reg_t *argv) {
if (!s)
return make_reg(0, g_sci->_features->detectDoSoundType());
error("not supposed to call this");
}
#define CREATE_DOSOUND_FORWARD(_name_) reg_t k##_name_(EngineState *s, int argc, reg_t *argv) { return g_sci->_soundCmd->k##_name_(s, argc, argv); }
CREATE_DOSOUND_FORWARD(DoSoundInit)
CREATE_DOSOUND_FORWARD(DoSoundPlay)
CREATE_DOSOUND_FORWARD(DoSoundDispose)
CREATE_DOSOUND_FORWARD(DoSoundMute)
CREATE_DOSOUND_FORWARD(DoSoundStop)
CREATE_DOSOUND_FORWARD(DoSoundStopAll)
CREATE_DOSOUND_FORWARD(DoSoundPause)
CREATE_DOSOUND_FORWARD(DoSoundResumeAfterRestore)
CREATE_DOSOUND_FORWARD(DoSoundMasterVolume)
CREATE_DOSOUND_FORWARD(DoSoundUpdate)
CREATE_DOSOUND_FORWARD(DoSoundFade)
CREATE_DOSOUND_FORWARD(DoSoundGetPolyphony)
CREATE_DOSOUND_FORWARD(DoSoundUpdateCues)
CREATE_DOSOUND_FORWARD(DoSoundSendMidi)
CREATE_DOSOUND_FORWARD(DoSoundGlobalReverb)
CREATE_DOSOUND_FORWARD(DoSoundSetHold)
CREATE_DOSOUND_FORWARD(DoSoundGetAudioCapability)
CREATE_DOSOUND_FORWARD(DoSoundSuspend)
CREATE_DOSOUND_FORWARD(DoSoundSetVolume)
CREATE_DOSOUND_FORWARD(DoSoundSetPriority)
CREATE_DOSOUND_FORWARD(DoSoundSetLoop)
#ifdef ENABLE_SCI32
reg_t kDoSoundMac32(EngineState *s, int argc, reg_t *argv) {
// Several SCI 2.1 Middle Mac games, but not all, contain a modified kDoSound
// in which all but eleven subops were removed, changing their subop values to
// zero through ten. PQSWAT then restored all of the subops, but kept the new
// subop values that removing caused in the first place, and assigned new
// values to the restored subops. It is the only game that does this and it
// only uses two of them.
switch (argv[0].toUint16()) {
case 0:
return g_sci->_soundCmd->kDoSoundMasterVolume(s, argc - 1, argv + 1);
case 1:
return g_sci->_soundCmd->kDoSoundGetAudioCapability(s, argc - 1, argv + 1);
case 2:
return g_sci->_soundCmd->kDoSoundInit(s, argc - 1, argv + 1);
case 3:
return g_sci->_soundCmd->kDoSoundDispose(s, argc - 1, argv + 1);
case 4:
return g_sci->_soundCmd->kDoSoundPlay(s, argc - 1, argv + 1);
case 5:
return g_sci->_soundCmd->kDoSoundStop(s, argc - 1, argv + 1);
case 6:
return g_sci->_soundCmd->kDoSoundPause(s, argc - 1, argv + 1);
case 7:
return g_sci->_soundCmd->kDoSoundFade(s, argc - 1, argv + 1);
case 8:
return g_sci->_soundCmd->kDoSoundSetVolume(s, argc - 1, argv + 1);
case 9:
return g_sci->_soundCmd->kDoSoundSetLoop(s, argc - 1, argv + 1);
case 10:
return g_sci->_soundCmd->kDoSoundUpdateCues(s, argc - 1, argv + 1);
// PQSWAT only
case 12: // kDoSoundRestore
return kEmpty(s, argc - 1, argv + 1);
case 13:
return g_sci->_soundCmd->kDoSoundGetPolyphony(s, argc - 1, argv + 1);
default:
break;
}
error("Unknown kDoSoundMac32 subop %d", argv[0].toUint16());
return s->r_acc;
}
#endif
reg_t kDoCdAudio(EngineState *s, int argc, reg_t *argv) {
switch (argv[0].toUint16()) {
case kSciAudioPlay: {
if (argc < 2)
return NULL_REG;
uint16 track = argv[1].toUint16();
uint32 startFrame = (argc > 2) ? argv[2].toUint16() * 75 : 0;
uint32 totalFrames = (argc > 3) ? argv[3].toUint16() * 75 : 0;
return make_reg(0, g_sci->_audio->audioCdPlay(track, startFrame, totalFrames));
}
case kSciAudioStop:
g_sci->_audio->audioCdStop();
if (getSciVersion() == SCI_VERSION_1_1)
return make_reg(0, 1);
break;
case kSciAudioPause:
warning("Can't pause CD Audio");
break;
case kSciAudioResume:
// This seems to be hacked up to update the CD instead of resuming
// audio like kDoAudio does.
g_sci->_audio->audioCdUpdate();
break;
case kSciAudioPosition:
return make_reg(0, g_sci->_audio->audioCdPosition());
case kSciAudioWPlay: // CD Audio can't be preloaded
case kSciAudioRate: // No need to set the audio rate
case kSciAudioVolume: // The speech setting isn't used by CD Audio
case kSciAudioLanguage: // No need to set the language
break;
case kSciAudioCD:
// Init
return make_reg(0, 1);
default:
error("kCdDoAudio: Unhandled case %d", argv[0].toUint16());
}
return s->r_acc;
}
/**
* Used for speech playback and digital soundtracks in CD games.
* This is the SCI16 version; SCI32 is handled separately.
*/
reg_t kDoAudio(EngineState *s, int argc, reg_t *argv) {
// JonesCD uses different functions based on the cdaudio.map file
// to use red book tracks.
if (g_sci->_features->usesCdTrack())
return kDoCdAudio(s, argc, argv);
Audio::Mixer *mixer = g_system->getMixer();
switch (argv[0].toUint16()) {
case kSciAudioWPlay:
case kSciAudioPlay: {
uint16 module;
uint32 number;
g_sci->_audio->stopAudio();
if (argc == 2) {
module = 65535;
number = argv[1].toUint16();
} else if (argc == 6 || argc == 8) {
module = argv[1].toUint16();
number = ((argv[2].toUint16() & 0xff) << 24) |
((argv[3].toUint16() & 0xff) << 16) |
((argv[4].toUint16() & 0xff) << 8) |
(argv[5].toUint16() & 0xff);
} else {
warning("kDoAudio: Play called with an unknown number of parameters (%d)", argc);
return NULL_REG;
}
debugC(kDebugLevelSound, "kDoAudio: play sample %d, module %d", number, module);
// return sample length in ticks
if (argv[0].toUint16() == kSciAudioWPlay)
return make_reg(0, g_sci->_audio->wPlayAudio(module, number));
else
return make_reg(0, g_sci->_audio->startAudio(module, number));
}
case kSciAudioStop:
debugC(kDebugLevelSound, "kDoAudio: stop");
g_sci->_audio->stopAudio();
break;
case kSciAudioPause:
debugC(kDebugLevelSound, "kDoAudio: pause");
g_sci->_audio->pauseAudio();
break;
case kSciAudioResume:
debugC(kDebugLevelSound, "kDoAudio: resume");
g_sci->_audio->resumeAudio();
break;
case kSciAudioPosition:
//debugC(kDebugLevelSound, "kDoAudio: get position"); // too verbose
return make_reg(0, g_sci->_audio->getAudioPosition());
case kSciAudioRate:
debugC(kDebugLevelSound, "kDoAudio: set audio rate to %d", argv[1].toUint16());
g_sci->_audio->setAudioRate(argv[1].toUint16());
break;
case kSciAudioVolume: {
int16 volume = argv[1].toUint16();
volume = CLIP<int16>(volume, 0, AUDIO_VOLUME_MAX);
debugC(kDebugLevelSound, "kDoAudio: set volume to %d", volume);
mixer->setVolumeForSoundType(Audio::Mixer::kSpeechSoundType, volume * 2);
break;
}
case kSciAudioLanguage:
// In SCI1.1: tests for digital audio support
if (getSciVersion() == SCI_VERSION_1_1) {
debugC(kDebugLevelSound, "kDoAudio: audio capability test");
return make_reg(0, 1);
} else {
int16 language = argv[1].toSint16();
// athrxx: It seems from disasm that the original KQ5 FM-Towns loads a default language (Japanese) audio map at the beginning
// right after loading the video and audio drivers. The -1 language argument in here simply means that the original will stick
// with Japanese. Instead of doing that we switch to the language selected in the launcher.
if (g_sci->getPlatform() == Common::kPlatformFMTowns && language == -1) {
// FM-Towns calls us to get the current language / also set the default language
// This doesn't just happen right at the start, but also when the user clicks on the Sierra logo in the game menu
// It uses the result of this call to either show "English Voices" or "Japanese Voices".
// Language should have been set by setLauncherLanguage() already (or could have been modified by the scripts).
// Get this language setting, so that the chosen language will get set for resource manager.
language = g_sci->getSciLanguage();
}
debugC(kDebugLevelSound, "kDoAudio: set language to %d", language);
if (language != -1)
g_sci->getResMan()->setAudioLanguage(language);
kLanguage kLang = g_sci->getSciLanguage();
g_sci->setSciLanguage(kLang);
return make_reg(0, kLang);
}
break;
case kSciAudioCD:
if (getSciVersion() <= SCI_VERSION_1_1) {
debugC(kDebugLevelSound, "kDoAudio: CD audio subop");
return kDoCdAudio(s, argc - 1, argv + 1);
}
// fall through
// FIXME: fall through intended?
// 3 new subops in Pharkas CD (including CD demo). kDoAudio in Pharkas sits at seg026:038C
case 11:
// Not sure where this is used yet
warning("kDoAudio: Unhandled case 11, %d extra arguments passed", argc - 1);
break;
case 12:
// SSCI calls this function with no parameters from
// the TalkRandCycle class and branches on the return
// value like a boolean. The conjectured purpose of
// this function is to ensure that the talker's mouth
// does not move if there is read jitter (slow CD
// drive, scratched CD). The old behavior here of not
// doing anything caused a nonzero value to be left in
// the accumulator by chance. This is equivalent, but
// more explicit.
return make_reg(0, 1);
case 13:
// SSCI returns a serial number for the played audio
// here, used in the PointsSound class. The reason is severalfold:
// 1. SSCI does not support multiple wave effects at once
// 2. FPFP may disable its icon bar during the points sound.
// 3. Each new sound preempts any sound already playing.
// 4. If the points sound is interrupted before completion,
// the icon bar could remain disabled.
// Since points (1) and (3) do not apply to us, we can simply
// return a constant here. This is equivalent to the
// old behavior, as above.
return make_reg(0, 1);
case 17:
// Seems to be some sort of audio sync, used in SQ6. Silenced the
// warning due to the high level of spam it produces. (takes no params)
//warning("kDoAudio: Unhandled case 17, %d extra arguments passed", argc - 1);
break;
default:
warning("kDoAudio: Unhandled case %d, %d extra arguments passed", argv[0].toUint16(), argc - 1);
}
return s->r_acc;
}
reg_t kDoSync(EngineState *s, int argc, reg_t *argv) {
switch (argv[0].toUint16()) {
case kSciAudioSyncStart: {
ResourceId id;
g_sci->_sync->stop();
if (argc == 3) {
id = ResourceId(kResourceTypeSync, argv[2].toUint16());
} else if (argc == 7) {
id = ResourceId(kResourceTypeSync36, argv[2].toUint16(), argv[3].toUint16(), argv[4].toUint16(),
argv[5].toUint16(), argv[6].toUint16());
} else {
warning("kDoSync: Start called with an unknown number of parameters (%d)", argc);
return s->r_acc;
}
g_sci->_sync->start(id, argv[1]);
break;
}
case kSciAudioSyncNext:
g_sci->_sync->next(argv[1]);
break;
case kSciAudioSyncStop:
g_sci->_sync->stop();
break;
default:
error("DoSync: Unhandled subfunction %d", argv[0].toUint16());
}
return s->r_acc;
}
#ifdef ENABLE_SCI32
reg_t kDoAudio32(EngineState *s, int argc, reg_t *argv) {
if (!s)
return make_reg(0, getSciVersion());
error("not supposed to call this");
}
reg_t kDoAudioInit(EngineState *s, int argc, reg_t *argv) {
return make_reg(0, 0);
}
reg_t kDoAudioWaitForPlay(EngineState *s, int argc, reg_t *argv) {
if (argc == 0) {
if (g_sci->_features->hasSci3Audio()) {
return make_reg(0, g_sci->_audio32->getNumUnlockedChannels());
} else {
return make_reg(0, g_sci->_audio32->getNumActiveChannels());
}
}
return g_sci->_audio32->kernelPlay(false, argc, argv);
}
reg_t kDoAudioPlay(EngineState *s, int argc, reg_t *argv) {
if (argc == 0) {
return make_reg(0, g_sci->_audio32->getNumActiveChannels());
}
return g_sci->_audio32->kernelPlay(true, argc, argv);
}
reg_t kDoAudioStop(EngineState *s, int argc, reg_t *argv) {
return g_sci->_audio32->kernelStop(argc, argv);
}
reg_t kDoAudioPause(EngineState *s, int argc, reg_t *argv) {
return g_sci->_audio32->kernelPause(argc, argv);
}
reg_t kDoAudioResume(EngineState *s, int argc, reg_t *argv) {
return g_sci->_audio32->kernelResume(argc, argv);
}
reg_t kDoAudioPosition(EngineState *s, int argc, reg_t *argv) {
return g_sci->_audio32->kernelPosition(argc, argv);
}
reg_t kDoAudioRate(EngineState *s, int argc, reg_t *argv) {
if (argc > 0) {
const uint16 sampleRate = argv[0].toUint16();
if (sampleRate != 0) {
g_sci->_audio32->setSampleRate(sampleRate);
}
}
return make_reg(0, g_sci->_audio32->getSampleRate());
}
reg_t kDoAudioVolume(EngineState *s, int argc, reg_t *argv) {
return g_sci->_audio32->kernelVolume(argc, argv);
}
reg_t kDoAudioGetCapability(EngineState *s, int argc, reg_t *argv) {
return make_reg(0, 1);
}
reg_t kDoAudioBitDepth(EngineState *s, int argc, reg_t *argv) {
if (argc > 0) {
const uint16 bitDepth = argv[0].toUint16();
if (bitDepth != 0) {
g_sci->_audio32->setBitDepth(bitDepth);
}
}
return make_reg(0, g_sci->_audio32->getBitDepth());
}
reg_t kDoAudioMixing(EngineState *s, int argc, reg_t *argv) {
return g_sci->_audio32->kernelMixing(argc, argv);
}
reg_t kDoAudioChannels(EngineState *s, int argc, reg_t *argv) {
if (argc > 0) {
const int16 numChannels = argv[0].toSint16();
if (numChannels != 0) {
g_sci->_audio32->setNumOutputChannels(numChannels);
}
}
return make_reg(0, g_sci->_audio32->getNumOutputChannels());
}
reg_t kDoAudioPreload(EngineState *s, int argc, reg_t *argv) {
if (argc > 0) {
g_sci->_audio32->setPreload(argv[0].toUint16());
}
return make_reg(0, g_sci->_audio32->getPreload());
}
reg_t kDoAudioFade(EngineState *s, int argc, reg_t *argv) {
return g_sci->_audio32->kernelFade(argc, argv);
}
reg_t kDoAudioHasSignal(EngineState *s, int argc, reg_t *argv) {
return make_reg(0, g_sci->_audio32->hasSignal());
}
reg_t kDoAudioSetLoop(EngineState *s, int argc, reg_t *argv) {
g_sci->_audio32->kernelLoop(argc, argv);
return s->r_acc;
}
reg_t kDoAudioPan(EngineState *s, int argc, reg_t *argv) {
g_sci->_audio32->kernelPan(argc, argv);
return s->r_acc;
}
reg_t kDoAudioPanOff(EngineState *s, int argc, reg_t *argv) {
g_sci->_audio32->kernelPanOff(argc, argv);
return s->r_acc;
}
reg_t kSetLanguage(EngineState *s, int argc, reg_t *argv) {
// Used by script 90 of MUMG Deluxe from the main menu to toggle between
// English and Spanish in some versions and English and Spanish and
// French and German in others.
const Common::String audioDirectory = s->_segMan->getString(argv[0]);
if (g_sci->getPlatform() == Common::kPlatformMacintosh) {
g_sci->getResMan()->changeMacAudioDirectory(audioDirectory);
} else {
g_sci->getResMan()->changeAudioDirectory(audioDirectory);
}
return s->r_acc;
}
#endif
} // End of namespace Sci
|