/* 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_(argc, argv, s->r_acc); } 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 kDoSoundPhantasmagoriaMac(EngineState *s, int argc, reg_t *argv) { // Phantasmagoria Mac (and seemingly no other game (!)) uses this // cutdown version of kDoSound. switch (argv[0].toUint16()) { case 0: return g_sci->_soundCmd->kDoSoundMasterVolume(argc - 1, argv + 1, s->r_acc); case 2: return g_sci->_soundCmd->kDoSoundInit(argc - 1, argv + 1, s->r_acc); case 3: return g_sci->_soundCmd->kDoSoundDispose(argc - 1, argv + 1, s->r_acc); case 4: return g_sci->_soundCmd->kDoSoundPlay(argc - 1, argv + 1, s->r_acc); case 5: return g_sci->_soundCmd->kDoSoundStop(argc - 1, argv + 1, s->r_acc); case 8: return g_sci->_soundCmd->kDoSoundSetVolume(argc - 1, argv + 1, s->r_acc); case 9: return g_sci->_soundCmd->kDoSoundSetLoop(argc - 1, argv + 1, s->r_acc); case 10: return g_sci->_soundCmd->kDoSoundUpdateCues(argc - 1, argv + 1, s->r_acc); } error("Unknown kDoSound Phantasmagoria Mac 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); // Removed warning because of the high amount of console spam /*if (argc == 8) { // TODO: Handle the extra 2 SCI21 params // argv[6] is always 1 // argv[7] is the contents of global 229 (0xE5) warning("kDoAudio: Play called with SCI2.1 extra parameters: %04x:%04x and %04x:%04x", PRINT_REG(argv[6]), PRINT_REG(argv[7])); }*/ } 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(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); } // 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); break; 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); break; 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) { return g_sci->_audio32->kernelPlay(false, argc, argv); } reg_t kDoAudioPlay(EngineState *s, int argc, reg_t *argv) { return g_sci->_audio32->kernelPlay(true, argc, argv); } reg_t kDoAudioStop(EngineState *s, int argc, reg_t *argv) { const int16 channelIndex = g_sci->_audio32->findChannelByArgs(argc, argv, 0, argc > 1 ? argv[1] : NULL_REG); return make_reg(0, g_sci->_audio32->stop(channelIndex)); } reg_t kDoAudioPause(EngineState *s, int argc, reg_t *argv) { const int16 channelIndex = g_sci->_audio32->findChannelByArgs(argc, argv, 0, argc > 1 ? argv[1] : NULL_REG); return make_reg(0, g_sci->_audio32->pause(channelIndex)); } reg_t kDoAudioResume(EngineState *s, int argc, reg_t *argv) { const int16 channelIndex = g_sci->_audio32->findChannelByArgs(argc, argv, 0, argc > 1 ? argv[1] : NULL_REG); return make_reg(0, g_sci->_audio32->resume(channelIndex)); } reg_t kDoAudioPosition(EngineState *s, int argc, reg_t *argv) { const int16 channelIndex = g_sci->_audio32->findChannelByArgs(argc, argv, 0, argc > 1 ? argv[1] : NULL_REG); return make_reg(0, g_sci->_audio32->getPosition(channelIndex)); } reg_t kDoAudioRate(EngineState *s, int argc, reg_t *argv) { // NOTE: In the original engine this would set the hardware // DSP sampling rate; ScummVM mixer does not need this, so // we only store the value to satisfy engine compatibility. 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) { const int16 volume = argc > 0 ? argv[0].toSint16() : -1; const int16 channelIndex = g_sci->_audio32->findChannelByArgs(argc, argv, 1, argc > 2 ? argv[2] : NULL_REG); if (volume != -1) { g_sci->_audio32->setVolume(channelIndex, volume); } return make_reg(0, g_sci->_audio32->getVolume(channelIndex)); } 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) { // NOTE: In the original engine this would set the hardware // DSP bit depth; ScummVM mixer does not need this, so // we only store the value to satisfy engine compatibility. 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) { if (argc > 0) { g_sci->_audio32->setAttenuatedMixing(argv[0].toUint16()); } return make_reg(0, g_sci->_audio32->getAttenuatedMixing()); } reg_t kDoAudioChannels(EngineState *s, int argc, reg_t *argv) { // NOTE: In the original engine this would set the hardware // DSP stereo output; ScummVM mixer does not need this, so // we only store the value to satisfy engine compatibility. 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) { // NOTE: In the original engine this would cause audio // data for new channels to be preloaded to memory when // the channel was initialized; we do not need this, so // we only store the value to satisfy engine compatibility. 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) { if (argc < 4) { return make_reg(0, 0); } // NOTE: Sierra did a nightmarish hack here, temporarily replacing // the argc of the kernel arguments with 2 and then restoring it // after findChannelByArgs was called. const int16 channelIndex = g_sci->_audio32->findChannelByArgs(2, argv, 0, argc > 5 ? argv[5] : NULL_REG); const int16 volume = argv[1].toSint16(); const int16 speed = argv[2].toSint16(); const int16 steps = argv[3].toSint16(); const bool stopAfterFade = argc > 4 ? (bool)argv[4].toUint16() : false; return make_reg(0, g_sci->_audio32->fadeChannel(channelIndex, volume, speed, steps, stopAfterFade)); } 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) { const int16 channelIndex = g_sci->_audio32->findChannelByArgs(argc, argv, 0, argc == 3 ? argv[2] : NULL_REG); const bool loop = argv[0].toSint16() != 0 && argv[0].toSint16() != 1; g_sci->_audio32->setLoop(channelIndex, loop); return s->r_acc; } reg_t kSetLanguage(EngineState *s, int argc, reg_t *argv) { // This is used by script 90 of MUMG Deluxe from the main menu to toggle // the audio language between English and Spanish. // Basically, it instructs the interpreter to switch the audio resources // (resource.aud and associated map files) and load them from the "Spanish" // subdirectory instead. Common::String audioDirectory = s->_segMan->getString(argv[0]); //warning("SetLanguage: set audio resource directory to '%s'", audioDirectory.c_str()); g_sci->getResMan()->changeAudioDirectory(audioDirectory); return s->r_acc; } #endif } // End of namespace Sci