/* 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/engine/message.h" #include "sci/engine/kernel.h" #include "sci/engine/seg_manager.h" #include "sci/util.h" namespace Sci { struct MessageRecord { MessageTuple tuple; MessageTuple refTuple; const char *string; byte talker; }; class MessageReader { public: bool init() { if (_headerSize > _size) return false; // Read message count from last word in header _messageCount = READ_SCI11ENDIAN_UINT16(_data + _headerSize - 2); if (_messageCount * _recordSize + _headerSize > _size) return false; return true; } virtual bool findRecord(const MessageTuple &tuple, MessageRecord &record) = 0; virtual ~MessageReader() { } protected: MessageReader(const byte *data, uint size, uint headerSize, uint recordSize) : _data(data), _size(size), _headerSize(headerSize), _recordSize(recordSize), _messageCount(0) { } const byte *_data; const uint _size; const uint _headerSize; const uint _recordSize; uint _messageCount; }; class MessageReaderV2 : public MessageReader { public: MessageReaderV2(byte *data, uint size) : MessageReader(data, size, 6, 4) { } bool findRecord(const MessageTuple &tuple, MessageRecord &record) { const byte *recordPtr = _data + _headerSize; for (uint i = 0; i < _messageCount; i++) { if ((recordPtr[0] == tuple.noun) && (recordPtr[1] == tuple.verb)) { record.tuple = tuple; record.refTuple = MessageTuple(); record.talker = 0; record.string = (const char *)_data + READ_LE_UINT16(recordPtr + 2); return true; } recordPtr += _recordSize; } return false; } }; class MessageReaderV3 : public MessageReader { public: MessageReaderV3(byte *data, uint size) : MessageReader(data, size, 8, 10) { } bool findRecord(const MessageTuple &tuple, MessageRecord &record) { const byte *recordPtr = _data + _headerSize; for (uint i = 0; i < _messageCount; i++) { if ((recordPtr[0] == tuple.noun) && (recordPtr[1] == tuple.verb) && (recordPtr[2] == tuple.cond) && (recordPtr[3] == tuple.seq)) { record.tuple = tuple; record.refTuple = MessageTuple(); record.talker = recordPtr[4]; record.string = (const char *)_data + READ_LE_UINT16(recordPtr + 5); return true; } recordPtr += _recordSize; } return false; } }; class MessageReaderV4 : public MessageReader { public: MessageReaderV4(byte *data, uint size) : MessageReader(data, size, 10, 11) { } bool findRecord(const MessageTuple &tuple, MessageRecord &record) { const byte *recordPtr = _data + _headerSize; for (uint i = 0; i < _messageCount; i++) { if ((recordPtr[0] == tuple.noun) && (recordPtr[1] == tuple.verb) && (recordPtr[2] == tuple.cond) && (recordPtr[3] == tuple.seq)) { record.tuple = tuple; record.refTuple = MessageTuple(recordPtr[7], recordPtr[8], recordPtr[9]); record.talker = recordPtr[4]; record.string = (const char *)_data + READ_SCI11ENDIAN_UINT16(recordPtr + 5); return true; } recordPtr += _recordSize; } return false; } }; #ifdef ENABLE_SCI32 // SCI32 Mac decided to add an extra byte (currently unknown in meaning) between // the talker and the string... class MessageReaderV4_MacSCI32 : public MessageReader { public: MessageReaderV4_MacSCI32(byte *data, uint size) : MessageReader(data, size, 10, 12) { } bool findRecord(const MessageTuple &tuple, MessageRecord &record) { const byte *recordPtr = _data + _headerSize; for (uint i = 0; i < _messageCount; i++) { if ((recordPtr[0] == tuple.noun) && (recordPtr[1] == tuple.verb) && (recordPtr[2] == tuple.cond) && (recordPtr[3] == tuple.seq)) { record.tuple = tuple; record.refTuple = MessageTuple(recordPtr[8], recordPtr[9], recordPtr[10]); record.talker = recordPtr[4]; record.string = (const char *)_data + READ_BE_UINT16(recordPtr + 6); return true; } recordPtr += _recordSize; } return false; } }; #endif bool MessageState::getRecord(CursorStack &stack, bool recurse, MessageRecord &record) { Resource *res = g_sci->getResMan()->findResource(ResourceId(kResourceTypeMessage, stack.getModule()), 0); if (!res) { warning("Failed to open message resource %d", stack.getModule()); return false; } MessageReader *reader; int version = READ_SCI11ENDIAN_UINT32(res->data) / 1000; switch (version) { case 2: reader = new MessageReaderV2(res->data, res->size); break; case 3: reader = new MessageReaderV3(res->data, res->size); break; case 4: #ifdef ENABLE_SCI32 case 5: // v5 seems to be compatible with v4 // SCI32 Mac is different than SCI32 DOS/Win here if (g_sci->getPlatform() == Common::kPlatformMacintosh && getSciVersion() >= SCI_VERSION_2_1) reader = new MessageReaderV4_MacSCI32(res->data, res->size); else #endif reader = new MessageReaderV4(res->data, res->size); break; default: error("Message: unsupported resource version %d", version); return false; } if (!reader->init()) { delete reader; warning("Message: failed to read resource header"); return false; } while (1) { MessageTuple &t = stack.top(); // Fix known incorrect message tuples if (g_sci->getGameId() == GID_QFG1VGA && stack.getModule() == 322 && t.noun == 14 && t.verb == 1 && t.cond == 19 && t.seq == 1) { // Talking to Kaspar the shopkeeper - bug #3604944 t.verb = 2; } if (g_sci->getGameId() == GID_PQ1 && stack.getModule() == 38 && t.noun == 10 && t.verb == 4 && t.cond == 8 && t.seq == 1) { // Using the hand icon on Keith in the Blue Room - bug #3605654 t.cond = 9; } if (g_sci->getGameId() == GID_PQ1 && stack.getModule() == 38 && t.noun == 10 && t.verb == 1 && t.cond == 0 && t.seq == 1) { // Using the eye icon on Keith in the Blue Room - bug #3605654 t.cond = 13; } // Fill in known missing message tuples if (g_sci->getGameId() == GID_SQ4 && stack.getModule() == 16 && t.noun == 7 && t.verb == 0 && t.cond == 3 && t.seq == 1) { // This fixes the error message shown when speech and subtitles are // enabled simultaneously in SQ4 - the (very) long dialog when Roger // is talking with the aliens is missing - bug #3538416. record.tuple = t; record.refTuple = MessageTuple(); record.talker = 7; // Roger // The missing text is just too big to fit in one speech bubble, and // if it's added here manually and drawn on screen, it's painted over // the entrance in the back where the Sequel Police enters, so it // looks very ugly. Perhaps this is why this particular text is missing, // as the text shown in this screen is very short (one-liners). // Just output an empty string here instead of showing an error. record.string = ""; delete reader; return true; } if (!reader->findRecord(t, record)) { // Tuple not found if (recurse && (stack.size() > 1)) { stack.pop(); continue; } delete reader; return false; } if (recurse) { MessageTuple &ref = record.refTuple; if (ref.noun || ref.verb || ref.cond) { t.seq++; stack.push(ref); continue; } } delete reader; return true; } } int MessageState::getMessage(int module, MessageTuple &t, reg_t buf) { _cursorStack.init(module, t); return nextMessage(buf); } int MessageState::nextMessage(reg_t buf) { MessageRecord record; if (!buf.isNull()) { if (getRecord(_cursorStack, true, record)) { outputString(buf, processString(record.string)); _lastReturned = record.tuple; _lastReturnedModule = _cursorStack.getModule(); _cursorStack.top().seq++; return record.talker; } else { MessageTuple &t = _cursorStack.top(); outputString(buf, Common::String::format("Msg %d: %d %d %d %d not found", _cursorStack.getModule(), t.noun, t.verb, t.cond, t.seq)); return 0; } } else { CursorStack stack = _cursorStack; if (getRecord(stack, true, record)) return record.talker; else return 0; } } int MessageState::messageSize(int module, MessageTuple &t) { CursorStack stack; MessageRecord record; stack.init(module, t); if (getRecord(stack, true, record)) return strlen(record.string) + 1; else return 0; } bool MessageState::messageRef(int module, const MessageTuple &t, MessageTuple &ref) { CursorStack stack; MessageRecord record; stack.init(module, t); if (getRecord(stack, false, record)) { ref = record.refTuple; return true; } return false; } void MessageState::pushCursorStack() { _cursorStackStack.push(_cursorStack); } void MessageState::popCursorStack() { if (!_cursorStackStack.empty()) _cursorStack = _cursorStackStack.pop(); else error("Message: attempt to pop from empty stack"); } int MessageState::hexDigitToInt(char h) { if ((h >= 'A') && (h <= 'F')) return h - 'A' + 10; if ((h >= 'a') && (h <= 'f')) return h - 'a' + 10; if ((h >= '0') && (h <= '9')) return h - '0'; return -1; } bool MessageState::stringHex(Common::String &outStr, const Common::String &inStr, uint &index) { // Hex escape sequences of the form \nn, where n is a hex digit if (inStr[index] != '\\') return false; // Check for enough room for a hex escape sequence if (index + 2 >= inStr.size()) return false; int digit1 = hexDigitToInt(inStr[index + 1]); int digit2 = hexDigitToInt(inStr[index + 2]); // Check for hex if ((digit1 == -1) || (digit2 == -1)) return false; outStr += digit1 * 16 + digit2; index += 3; return true; } bool MessageState::stringLit(Common::String &outStr, const Common::String &inStr, uint &index) { // Literal escape sequences of the form \n if (inStr[index] != '\\') return false; // Check for enough room for a literal escape sequence if (index + 1 >= inStr.size()) return false; outStr += inStr[index + 1]; index += 2; return true; } bool MessageState::stringStage(Common::String &outstr, const Common::String &inStr, uint &index) { // Stage directions of the form (n *), where n is anything but a digit or a lowercase character if (inStr[index] != '(') return false; for (uint i = index + 1; i < inStr.size(); i++) { if (inStr[i] == ')') { // Stage direction found, skip it index = i + 1; // Skip trailing white space while ((index < inStr.size()) && ((inStr[index] == '\n') || (inStr[index] == '\r') || (inStr[index] == ' '))) index++; return true; } // If we find a lowercase character or a digit, it's not a stage direction // SCI32 seems to support having digits in stage directions if (((inStr[i] >= 'a') && (inStr[i] <= 'z')) || ((inStr[i] >= '0') && (inStr[i] <= '9') && (getSciVersion() < SCI_VERSION_2))) return false; } // We ran into the end of the string without finding a closing bracket return false; } Common::String MessageState::processString(const char *s) { Common::String outStr; Common::String inStr = Common::String(s); uint index = 0; while (index < inStr.size()) { // Check for hex escape sequence if (stringHex(outStr, inStr, index)) continue; // Check for literal escape sequence if (stringLit(outStr, inStr, index)) continue; // Check for stage direction if (stringStage(outStr, inStr, index)) continue; // None of the above, copy char outStr += inStr[index++]; } return outStr; } void MessageState::outputString(reg_t buf, const Common::String &str) { #ifdef ENABLE_SCI32 if (getSciVersion() >= SCI_VERSION_2) { if (_segMan->getSegmentType(buf.getSegment()) == SEG_TYPE_STRING) { SciString *sciString = _segMan->lookupString(buf); sciString->setSize(str.size() + 1); for (uint32 i = 0; i < str.size(); i++) sciString->setValue(i, str.c_str()[i]); sciString->setValue(str.size(), 0); } else if (_segMan->getSegmentType(buf.getSegment()) == SEG_TYPE_ARRAY) { // Happens in the intro of LSL6, we are asked to write the string // into an array SciArray *sciString = _segMan->lookupArray(buf); sciString->setSize(str.size() + 1); for (uint32 i = 0; i < str.size(); i++) sciString->setValue(i, make_reg(0, str.c_str()[i])); sciString->setValue(str.size(), NULL_REG); } } else { #endif SegmentRef buffer_r = _segMan->dereference(buf); if ((unsigned)buffer_r.maxSize >= str.size() + 1) { _segMan->strcpy(buf, str.c_str()); } else { // LSL6 sets an exit text here, but the buffer size allocated // is too small. Don't display a warning in this case, as we // don't use the exit text anyway - bug report #3035533 if (g_sci->getGameId() == GID_LSL6 && str.hasPrefix("\r\n(c) 1993 Sierra On-Line, Inc")) { // LSL6 buggy exit text, don't show warning } else { warning("Message: buffer %04x:%04x invalid or too small to hold the following text of %i bytes: '%s'", PRINT_REG(buf), str.size() + 1, str.c_str()); } // Set buffer to empty string if possible if (buffer_r.maxSize > 0) _segMan->strcpy(buf, ""); } #ifdef ENABLE_SCI32 } #endif } void MessageState::lastQuery(int &module, MessageTuple &tuple) { module = _lastReturnedModule; tuple = _lastReturned; } } // End of namespace Sci