/* 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 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(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 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); } 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); } // 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); 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) { 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. const Common::String audioDirectory = s->_segMan->getString(argv[0]); g_sci->getResMan()->changeAudioDirectory(audioDirectory); return s->r_acc; } #endif } // End of namespace Sci