/* 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. * * $URL$ * $Id$ * */ #include "common/endian.h" #include "sci/sci.h" #include "sci/engine/features.h" #include "sci/engine/script.h" // for SCI_OBJ_EXPORTS and SCI_OBJ_SYNONYMS #include "sci/engine/segment.h" #include "sci/engine/seg_manager.h" #include "sci/engine/state.h" namespace Sci { //#define GC_DEBUG // Debug garbage collection //#define GC_DEBUG_VERBOSE // Debug garbage verbosely SegmentObj *SegmentObj::createSegmentObj(SegmentType type) { SegmentObj *mem = 0; switch (type) { case SEG_TYPE_SCRIPT: mem = new Script(); break; case SEG_TYPE_CLONES: mem = new CloneTable(); break; case SEG_TYPE_LOCALS: mem = new LocalVariables(); break; case SEG_TYPE_SYS_STRINGS: mem = new SystemStrings(); break; case SEG_TYPE_STACK: mem = new DataStack(); break; case SEG_TYPE_HUNK: mem = new HunkTable(); break; case SEG_TYPE_LISTS: mem = new ListTable(); break; case SEG_TYPE_NODES: mem = new NodeTable(); break; case SEG_TYPE_DYNMEM: mem = new DynMem(); break; #ifdef ENABLE_SCI32 case SEG_TYPE_ARRAY: mem = new ArrayTable(); break; case SEG_TYPE_STRING: mem = new StringTable(); break; #endif default: error("Unknown SegmentObj type %d", type); break; } assert(mem); assert(mem->_type == type); return mem; } const char *SegmentObj::getSegmentTypeName(SegmentType type) { switch (type) { case SEG_TYPE_SCRIPT: return "script"; break; case SEG_TYPE_CLONES: return "clones"; break; case SEG_TYPE_LOCALS: return "locals"; break; case SEG_TYPE_SYS_STRINGS: return "strings"; break; case SEG_TYPE_STACK: return "stack"; break; case SEG_TYPE_HUNK: return "hunk"; break; case SEG_TYPE_LISTS: return "lists"; break; case SEG_TYPE_NODES: return "nodes"; break; case SEG_TYPE_DYNMEM: return "dynmem"; break; #ifdef ENABLE_SCI32 case SEG_TYPE_ARRAY: return "array"; break; case SEG_TYPE_STRING: return "string"; break; #endif default: error("Unknown SegmentObj type %d", type); break; } return NULL; } // This helper function is used by Script::relocateLocal and Object::relocate // Duplicate in segment.cpp and script.cpp static bool relocateBlock(Common::Array &block, int block_location, SegmentId segment, int location, size_t scriptSize) { int rel = location - block_location; if (rel < 0) return false; uint idx = rel >> 1; if (idx >= block.size()) return false; if (rel & 1) { error("Attempt to relocate odd variable #%d.5e (relative to %04x)\n", idx, block_location); return false; } block[idx].segment = segment; // Perform relocation if (getSciVersion() >= SCI_VERSION_1_1) block[idx].offset += scriptSize; return true; } SegmentRef SegmentObj::dereference(reg_t pointer) { error("Error: Trying to dereference pointer %04x:%04x to inappropriate segment", PRINT_REG(pointer)); return SegmentRef(); } bool LocalVariables::isValidOffset(uint16 offset) const { return offset < _locals.size() * 2; } SegmentRef LocalVariables::dereference(reg_t pointer) { SegmentRef ret; ret.isRaw = false; // reg_t based data! ret.maxSize = (_locals.size() - pointer.offset / 2) * 2; if (pointer.offset & 1) { ret.maxSize -= 1; ret.skipByte = true; } if (ret.maxSize > 0) { ret.reg = &_locals[pointer.offset / 2]; } else { if ((g_sci->getEngineState()->currentRoomNumber() == 660 || g_sci->getEngineState()->currentRoomNumber() == 660) && g_sci->getGameId() == GID_LAURABOW2) { // Happens in two places during the intro of LB2CD, both from kMemory(peek): // - room 160: Heap 160 has 83 local variables (0-82), and the game // asks for variables at indices 83 - 90 too. // - room 220: Heap 220 has 114 local variables (0-113), and the // game asks for variables at indices 114-120 too. } else { error("LocalVariables::dereference: Offset at end or out of bounds %04x:%04x", PRINT_REG(pointer)); } ret.reg = 0; } return ret; } bool DataStack::isValidOffset(uint16 offset) const { return offset < _capacity * 2; } SegmentRef DataStack::dereference(reg_t pointer) { SegmentRef ret; ret.isRaw = false; // reg_t based data! ret.maxSize = (_capacity - pointer.offset / 2) * 2; if (pointer.offset & 1) { ret.maxSize -= 1; ret.skipByte = true; } ret.reg = &_entries[pointer.offset / 2]; return ret; } bool DynMem::isValidOffset(uint16 offset) const { return offset < _size; } SegmentRef DynMem::dereference(reg_t pointer) { SegmentRef ret; ret.isRaw = true; ret.maxSize = _size - pointer.offset; ret.raw = _buf + pointer.offset; return ret; } bool SystemStrings::isValidOffset(uint16 offset) const { return offset < SYS_STRINGS_MAX && !_strings[offset]._name.empty(); } SegmentRef SystemStrings::dereference(reg_t pointer) { SegmentRef ret; ret.isRaw = true; ret.maxSize = _strings[pointer.offset]._maxSize; if (isValidOffset(pointer.offset)) ret.raw = (byte *)(_strings[pointer.offset]._value); else { if (g_sci->getGameId() == GID_KQ5) { // This occurs in KQ5CD when interacting with certain objects } else { error("SystemStrings::dereference(): Attempt to dereference invalid pointer %04x:%04x", PRINT_REG(pointer)); } } return ret; } //-------------------- clones -------------------- Common::Array CloneTable::listAllOutgoingReferences(reg_t addr) const { Common::Array tmp; // assert(addr.segment == _segId); if (!isValidEntry(addr.offset)) { error("Unexpected request for outgoing references from clone at %04x:%04x", PRINT_REG(addr)); } const Clone *clone = &(_table[addr.offset]); // Emit all member variables (including references to the 'super' delegate) for (uint i = 0; i < clone->getVarCount(); i++) tmp.push_back(clone->getVariable(i)); // Note that this also includes the 'base' object, which is part of the script and therefore also emits the locals. tmp.push_back(clone->getPos()); //debugC(2, kDebugLevelGC, "[GC] Reporting clone-pos %04x:%04x", PRINT_REG(clone->pos)); return tmp; } void CloneTable::freeAtAddress(SegManager *segMan, reg_t addr) { #ifdef GC_DEBUG // assert(addr.segment == _segId); Object *victim_obj = &(_table[addr.offset]); if (!(victim_obj->_flags & OBJECT_FLAG_FREED)) warning("[GC] Clone %04x:%04x not reachable and not freed (freeing now)", PRINT_REG(addr)); #ifdef GC_DEBUG_VERBOSE else warning("[GC-DEBUG] Clone %04x:%04x: Freeing", PRINT_REG(addr)); #endif #endif /* warning("[GC] Clone %04x:%04x: Freeing", PRINT_REG(addr)); warning("[GC] Clone had pos %04x:%04x", PRINT_REG(victim_obj->pos)); */ freeEntry(addr.offset); } //-------------------- locals -------------------- reg_t LocalVariables::findCanonicAddress(SegManager *segMan, reg_t addr) const { // Reference the owning script SegmentId owner_seg = segMan->getScriptSegment(script_id); assert(owner_seg > 0); return make_reg(owner_seg, 0); } Common::Array LocalVariables::listAllOutgoingReferences(reg_t addr) const { Common::Array tmp; // assert(addr.segment == _segId); for (uint i = 0; i < _locals.size(); i++) tmp.push_back(_locals[i]); return tmp; } //-------------------- stack -------------------- reg_t DataStack::findCanonicAddress(SegManager *segMan, reg_t addr) const { addr.offset = 0; return addr; } Common::Array DataStack::listAllOutgoingReferences(reg_t object) const { Common::Array tmp; fprintf(stderr, "Emitting %d stack entries\n", _capacity); for (int i = 0; i < _capacity; i++) tmp.push_back(_entries[i]); fprintf(stderr, "DONE"); return tmp; } //-------------------- lists -------------------- void ListTable::freeAtAddress(SegManager *segMan, reg_t sub_addr) { freeEntry(sub_addr.offset); } Common::Array ListTable::listAllOutgoingReferences(reg_t addr) const { Common::Array tmp; if (!isValidEntry(addr.offset)) { error("Invalid list referenced for outgoing references: %04x:%04x", PRINT_REG(addr)); } const List *list = &(_table[addr.offset]); tmp.push_back(list->first); tmp.push_back(list->last); // We could probably get away with just one of them, but // let's be conservative here. return tmp; } //-------------------- nodes -------------------- void NodeTable::freeAtAddress(SegManager *segMan, reg_t sub_addr) { freeEntry(sub_addr.offset); } Common::Array NodeTable::listAllOutgoingReferences(reg_t addr) const { Common::Array tmp; if (!isValidEntry(addr.offset)) { error("Invalid node referenced for outgoing references: %04x:%04x", PRINT_REG(addr)); } const Node *node = &(_table[addr.offset]); // We need all four here. Can't just stick with 'pred' OR 'succ' because node operations allow us // to walk around from any given node tmp.push_back(node->pred); tmp.push_back(node->succ); tmp.push_back(node->key); tmp.push_back(node->value); return tmp; } //-------------------- hunk -------------------- //-------------------- object ---------------------------- void Object::init(byte *buf, reg_t obj_pos, bool initVariables) { byte *data = buf + obj_pos.offset; _baseObj = data; _pos = obj_pos; if (getSciVersion() < SCI_VERSION_1_1) { _variables.resize(READ_LE_UINT16(data + kOffsetSelectorCounter)); _baseVars = (const uint16 *)(_baseObj + _variables.size() * 2); _baseMethod = (const uint16 *)(data + READ_LE_UINT16(data + kOffsetFunctionArea)); _methodCount = READ_LE_UINT16(_baseMethod - 1); } else { _variables.resize(READ_SCI11ENDIAN_UINT16(data + 2)); _baseVars = (const uint16 *)(buf + READ_SCI11ENDIAN_UINT16(data + 4)); _baseMethod = (const uint16 *)(buf + READ_SCI11ENDIAN_UINT16(data + 6)); _methodCount = READ_SCI11ENDIAN_UINT16(_baseMethod); } if (initVariables) { for (uint i = 0; i < _variables.size(); i++) _variables[i] = make_reg(0, READ_SCI11ENDIAN_UINT16(data + (i * 2))); } } const Object *Object::getClass(SegManager *segMan) const { return isClass() ? this : segMan->getObject(getSuperClassSelector()); } int Object::locateVarSelector(SegManager *segMan, Selector slc) const { const byte *buf; uint varnum; if (getSciVersion() < SCI_VERSION_1_1) { varnum = getVarCount(); int selector_name_offset = varnum * 2 + kOffsetSelectorSegment; buf = _baseObj + selector_name_offset; } else { const Object *obj = getClass(segMan); varnum = obj->getVariable(1).toUint16(); buf = (const byte *)obj->_baseVars; } for (uint i = 0; i < varnum; i++) if (READ_SCI11ENDIAN_UINT16(buf + (i << 1)) == slc) // Found it? return i; // report success return -1; // Failed } bool Object::relocate(SegmentId segment, int location, size_t scriptSize) { return relocateBlock(_variables, getPos().offset, segment, location, scriptSize); } int Object::propertyOffsetToId(SegManager *segMan, int propertyOffset) const { int selectors = getVarCount(); if (propertyOffset < 0 || (propertyOffset >> 1) >= selectors) { error("Applied propertyOffsetToId to invalid property offset %x (property #%d not in [0..%d])", propertyOffset, propertyOffset >> 1, selectors - 1); return -1; } if (getSciVersion() < SCI_VERSION_1_1) { const byte *selectoroffset = ((const byte *)(_baseObj)) + kOffsetSelectorSegment + selectors * 2; return READ_SCI11ENDIAN_UINT16(selectoroffset + propertyOffset); } else { const Object *obj = this; if (!isClass()) obj = segMan->getObject(getSuperClassSelector()); return READ_SCI11ENDIAN_UINT16((const byte *)obj->_baseVars + propertyOffset); } } void Object::initSpecies(SegManager *segMan, reg_t addr) { uint16 speciesOffset = getSpeciesSelector().offset; if (speciesOffset == 0xffff) // -1 setSpeciesSelector(NULL_REG); // no species else setSpeciesSelector(segMan->getClassAddress(speciesOffset, SCRIPT_GET_LOCK, addr)); } void Object::initSuperClass(SegManager *segMan, reg_t addr) { uint16 superClassOffset = getSuperClassSelector().offset; if (superClassOffset == 0xffff) // -1 setSuperClassSelector(NULL_REG); // no superclass else setSuperClassSelector(segMan->getClassAddress(superClassOffset, SCRIPT_GET_LOCK, addr)); } bool Object::initBaseObject(SegManager *segMan, reg_t addr, bool doInitSuperClass) { const Object *baseObj = segMan->getObject(getSpeciesSelector()); if (baseObj) { _variables.resize(baseObj->getVarCount()); // Copy base from species class, as we need its selector IDs _baseObj = baseObj->_baseObj; if (doInitSuperClass) initSuperClass(segMan, addr); return true; } return false; } //-------------------- dynamic memory -------------------- reg_t DynMem::findCanonicAddress(SegManager *segMan, reg_t addr) const { addr.offset = 0; return addr; } Common::Array DynMem::listAllDeallocatable(SegmentId segId) const { const reg_t r = make_reg(segId, 0); return Common::Array(&r, 1); } #ifdef ENABLE_SCI32 SegmentRef ArrayTable::dereference(reg_t pointer) { SegmentRef ret; ret.isRaw = false; ret.maxSize = _table[pointer.offset].getSize() * 2; ret.reg = _table[pointer.offset].getRawData(); return ret; } void ArrayTable::freeAtAddress(SegManager *segMan, reg_t sub_addr) { _table[sub_addr.offset].destroy(); freeEntry(sub_addr.offset); } Common::Array ArrayTable::listAllOutgoingReferences(reg_t addr) const { Common::Array tmp; if (!isValidEntry(addr.offset)) { error("Invalid array referenced for outgoing references: %04x:%04x", PRINT_REG(addr)); } const SciArray *array = &(_table[addr.offset]); for (uint32 i = 0; i < array->getSize(); i++) { reg_t value = array->getValue(i); if (value.segment != 0) tmp.push_back(value); } return tmp; } Common::String SciString::toString() const { if (_type != 3) error("SciString::toString(): Array is not a string"); Common::String string; for (uint32 i = 0; i < _size && _data[i] != 0; i++) string += _data[i]; return string; } void SciString::fromString(const Common::String &string) { if (_type != 3) error("SciString::fromString(): Array is not a string"); if (string.size() > _size) setSize(string.size()); for (uint32 i = 0; i < string.size(); i++) _data[i] = string[i]; } SegmentRef StringTable::dereference(reg_t pointer) { SegmentRef ret; ret.isRaw = true; ret.maxSize = _table[pointer.offset].getSize(); ret.raw = (byte*)_table[pointer.offset].getRawData(); return ret; } void StringTable::freeAtAddress(SegManager *segMan, reg_t sub_addr) { _table[sub_addr.offset].destroy(); freeEntry(sub_addr.offset); } #endif } // End of namespace Sci