/* 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/util.h" #include "common/system.h" #include "common/events.h" #include "common/hashmap.h" #include "common/hash-str.h" #include "common/xmlparser.h" #include "gui/ThemeEngine.h" #include "gui/ThemeEval.h" #include "gui/ThemeParser.h" #include "gui/newgui.h" #include "graphics/VectorRenderer.h" namespace GUI { ThemeParser::ThemeParser(ThemeEngine *parent) : XMLParser() { _drawFunctions["circle"] = &Graphics::VectorRenderer::drawCallback_CIRCLE; _drawFunctions["square"] = &Graphics::VectorRenderer::drawCallback_SQUARE; _drawFunctions["roundedsq"] = &Graphics::VectorRenderer::drawCallback_ROUNDSQ; _drawFunctions["bevelsq"] = &Graphics::VectorRenderer::drawCallback_BEVELSQ; _drawFunctions["line"] = &Graphics::VectorRenderer::drawCallback_LINE; _drawFunctions["triangle"] = &Graphics::VectorRenderer::drawCallback_TRIANGLE; _drawFunctions["fill"] = &Graphics::VectorRenderer::drawCallback_FILLSURFACE; _drawFunctions["tab"] = &Graphics::VectorRenderer::drawCallback_TAB; _drawFunctions["void"] = &Graphics::VectorRenderer::drawCallback_VOID; _drawFunctions["bitmap"] = &Graphics::VectorRenderer::drawCallback_BITMAP; _drawFunctions["cross"] = &Graphics::VectorRenderer::drawCallback_CROSS; _defaultStepGlobal = defaultDrawStep(); _defaultStepLocal = 0; _theme = parent; } ThemeParser::~ThemeParser() { delete _defaultStepGlobal; delete _defaultStepLocal; _palette.clear(); _drawFunctions.clear(); } void ThemeParser::cleanup() { delete _defaultStepGlobal; delete _defaultStepLocal; _defaultStepGlobal = defaultDrawStep(); _defaultStepLocal = 0; _palette.clear(); } Graphics::DrawStep *ThemeParser::defaultDrawStep() { Graphics::DrawStep *step = new Graphics::DrawStep; step->fgColor.set = false; step->bgColor.set = false; step->gradColor1.set = false; step->gradColor2.set = false; step->xAlign = Graphics::DrawStep::kVectorAlignManual; step->yAlign = Graphics::DrawStep::kVectorAlignManual; step->x = 0; step->y = 0; step->w = 0; step->h = 0; step->extraData = 0; step->factor = 1; step->autoWidth = true; step->autoHeight = true; step->fillMode = Graphics::VectorRenderer::kFillDisabled; step->scale = (1 << 16); step->shadow = 0; step->bevel = 0; step->stroke = 0; step->radius = 0xFF; return step; } Graphics::DrawStep *ThemeParser::newDrawStep() { assert(_defaultStepGlobal); Graphics::DrawStep *step = 0 ; //new DrawStep; if (_defaultStepLocal) { step = new Graphics::DrawStep(*_defaultStepLocal); } else { step = new Graphics::DrawStep(*_defaultStepGlobal); } return step; } bool ThemeParser::parserCallback_defaults(ParserNode *node) { ParserNode *parentNode = getParentNode(node); Graphics::DrawStep *step = 0; if (parentNode->name == "render_info") { step = _defaultStepGlobal; } else if (parentNode->name == "drawdata") { if (_defaultStepLocal == 0) _defaultStepLocal = new Graphics::DrawStep(*_defaultStepLocal); step = _defaultStepLocal; } else { return parserError(" key out of scope. Must be inside or keys."); } return parseDrawStep(node, step, false); } bool ThemeParser::parserCallback_font(ParserNode *node) { int red, green, blue; if (resolutionCheck(node->values["resolution"]) == false) { node->ignore = true; return true; } if (_palette.contains(node->values["color"])) getPaletteColor(node->values["color"], red, green, blue); else if (!parseIntegerKey(node->values["color"].c_str(), 3, &red, &green, &blue)) return parserError("Error when parsing color value for font definition."); if (!_theme->addFont(node->values["id"], node->values["file"], red, green, blue)) return parserError("Error when loading Font in theme engine."); return true; } bool ThemeParser::parserCallback_fonts(ParserNode *node) { return true; } bool ThemeParser::parserCallback_cursor(ParserNode *node) { if (resolutionCheck(node->values["resolution"]) == false) { node->ignore = true; return true; } int spotx, spoty, scale; if (!parseIntegerKey(node->values["hotspot"].c_str(), 2, &spotx, &spoty)) return parserError("Error when parsing cursor Hot Spot coordinates."); if (!parseIntegerKey(node->values["scale"].c_str(), 1, &scale)) return parserError("Error when parsing cursor scale."); if (!_theme->createCursor(node->values["file"], spotx, spoty, scale)) return parserError("Error when creating Bitmap Cursor."); return true; } bool ThemeParser::parserCallback_bitmap(ParserNode *node) { if (resolutionCheck(node->values["resolution"]) == false) { node->ignore = true; return true; } if (!_theme->addBitmap(node->values["filename"])) return parserError("Error when loading Bitmap file '%s'", node->values["filename"].c_str()); return true; } bool ThemeParser::parserCallback_text(ParserNode *node) { GUI::Theme::TextAlign alignH; GUI::Theme::TextAlignVertical alignV; if (node->values["horizontal_align"] == "left") alignH = GUI::Theme::kTextAlignLeft; else if (node->values["horizontal_align"] == "right") alignH = GUI::Theme::kTextAlignRight; else if (node->values["horizontal_align"] == "center") alignH = GUI::Theme::kTextAlignCenter; else return parserError("Invalid value for text alignment."); if (node->values["vertical_align"] == "top") alignV = GUI::Theme::kTextAlignVTop; else if (node->values["vertical_align"] == "center") alignV = GUI::Theme::kTextAlignVCenter; else if (node->values["vertical_align"] == "bottom") alignV = GUI::Theme::kTextAlignVBottom; else return parserError("Invalid value for text alignment."); if (!_theme->addTextData(getParentNode(node)->values["id"], node->values["font"], alignH, alignV)) return parserError("Error when adding Text Data for '%s'.", getParentNode(node)->values["id"].c_str()); return true; } bool ThemeParser::parserCallback_render_info(ParserNode *node) { if (resolutionCheck(node->values["resolution"]) == false) node->ignore = true; return true; } bool ThemeParser::parserCallback_layout_info(ParserNode *node) { if (resolutionCheck(node->values["resolution"]) == false) node->ignore = true; return true; } bool ThemeParser::parserCallback_palette(ParserNode *node) { return true; } bool ThemeParser::parserCallback_color(ParserNode *node) { Common::String name = node->values["name"]; if (_palette.contains(name)) return parserError("Color '%s' has already been defined.", name.c_str()); int red, green, blue; if (parseIntegerKey(node->values["rgb"].c_str(), 3, &red, &green, &blue) == false || red < 0 || red > 255 || green < 0 || green > 255 || blue < 0 || blue > 255) return parserError("Error when parsing RGB values for palette color '%s'", name.c_str());\ _palette[name].r = red; _palette[name].g = green; _palette[name].b = blue; return true; } bool ThemeParser::parserCallback_drawstep(ParserNode *node) { Graphics::DrawStep *drawstep = newDrawStep(); Common::String functionName = node->values["func"]; if (_drawFunctions.contains(functionName) == false) return parserError("%s is not a valid drawing function name", functionName.c_str()); drawstep->drawingCall = _drawFunctions[functionName]; if (!parseDrawStep(node, drawstep, true)) return false; _theme->addDrawStep(getParentNode(node)->values["id"], *drawstep); delete drawstep; return true; } bool ThemeParser::parserCallback_drawdata(ParserNode *node) { bool cached = false; if (resolutionCheck(node->values["resolution"]) == false) { node->ignore = true; return true; } if (node->values.contains("cache")) { if (node->values["cache"] == "true") cached = true; else if (node->values["cache"] == "false") cached = false; else return parserError("'Parsed' value must be either true or false."); } if (_theme->addDrawData(node->values["id"], cached) == false) return parserError("Error when adding Draw Data set: Invalid DrawData name."); if (_defaultStepLocal) { delete _defaultStepLocal; _defaultStepLocal = 0; } return true; } bool ThemeParser::parseDrawStep(ParserNode *stepNode, Graphics::DrawStep *drawstep, bool functionSpecific) { int red, green, blue, x; Common::String val; /** * Helper macro to sanitize and assign an integer value from a key * to the draw step. * * @param struct_name Name of the field of a DrawStep struct that must be * assigned. * @param key_name Name as STRING of the key identifier as it appears in the * theme description format. * @param force Sets if the key is optional or necessary. */ #define __PARSER_ASSIGN_INT(struct_name, key_name, force) \ if (stepNode->values.contains(key_name)) { \ if (!parseIntegerKey(stepNode->values[key_name].c_str(), 1, &x)) \ return parserError("Error when parsing key value for '%s'.", key_name); \ \ drawstep->struct_name = x; \ } else if (force) { \ return parserError("Missing necessary key '%s'.", key_name); \ } /** * Helper macro to sanitize and assign a RGB value from a key to the draw * step. RGB values have the following syntax: "R, G, B". * * @param struct_name Name of the field of a DrawStep struct that must be * assigned. * @param key_name Name as STRING of the key identifier as it appears in the * theme description format. */ #define __PARSER_ASSIGN_RGB(struct_name, key_name) \ if (stepNode->values.contains(key_name)) { \ val = stepNode->values[key_name]; \ if (_palette.contains(val)) { \ red = _palette[val].r; \ green = _palette[val].g; \ blue = _palette[val].b; \ } else if (parseIntegerKey(val.c_str(), 3, &red, &green, &blue) == false || \ red < 0 || red > 255 || green < 0 || green > 255 || blue < 0 || blue > 255) \ return parserError("Error when parsing color struct '%s'", val.c_str());\ \ drawstep->struct_name.r = red; \ drawstep->struct_name.g = green; \ drawstep->struct_name.b = blue; \ drawstep->struct_name.set = true; \ } __PARSER_ASSIGN_INT(stroke, "stroke", false); __PARSER_ASSIGN_INT(bevel, "bevel", false); __PARSER_ASSIGN_INT(shadow, "shadow", false); __PARSER_ASSIGN_INT(factor, "gradient_factor", false); __PARSER_ASSIGN_RGB(fgColor, "fg_color"); __PARSER_ASSIGN_RGB(bgColor, "bg_color"); __PARSER_ASSIGN_RGB(gradColor1, "gradient_start"); __PARSER_ASSIGN_RGB(gradColor2, "gradient_end"); __PARSER_ASSIGN_RGB(bevelColor, "bevel_color"); if (functionSpecific) { assert(stepNode->values.contains("func")); Common::String functionName = stepNode->values["func"]; if (functionName == "bitmap") { if (!stepNode->values.contains("file")) return parserError("Need to specify a filename for Bitmap blitting."); drawstep->blitSrc = _theme->getBitmap(stepNode->values["file"]); if (!drawstep->blitSrc) return parserError("The given filename hasn't been loaded into the GUI."); } if (functionName == "roundedsq" || functionName == "circle" || functionName == "tab") { if (stepNode->values.contains("radius") && stepNode->values["radius"] == "auto") { drawstep->radius = 0xFF; } else { __PARSER_ASSIGN_INT(radius, "radius", true); } } if (functionName == "triangle") { drawstep->extraData = Graphics::VectorRenderer::kTriangleUp; if (stepNode->values.contains("orientation")) { val = stepNode->values["orientation"]; if ( val == "top") drawstep->extraData = Graphics::VectorRenderer::kTriangleUp; else if (val == "bottom") drawstep->extraData = Graphics::VectorRenderer::kTriangleDown; else if (val == "left") drawstep->extraData = Graphics::VectorRenderer::kTriangleLeft; else if (val == "right") drawstep->extraData = Graphics::VectorRenderer::kTriangleRight; else return parserError("'%s' is not a valid value for triangle orientation.", val.c_str()); } } if (stepNode->values.contains("size")) { warning("The keyword has been deprecated. Use and instead"); } if (stepNode->values.contains("width") && stepNode->values["width"] != "auto") { drawstep->autoWidth = false; val = stepNode->values["width"]; if (parseIntegerKey(val.c_str(), 1, &x)) drawstep->w = x; else if (val == "height") drawstep->w = -1; else return parserError("Invalid value for vector width."); if (stepNode->values.contains("xpos")) { val = stepNode->values["xpos"]; if (parseIntegerKey(val.c_str(), 1, &x)) drawstep->x = x; else if (val == "center") drawstep->xAlign = Graphics::DrawStep::kVectorAlignCenter; else if (val == "left") drawstep->xAlign = Graphics::DrawStep::kVectorAlignLeft; else if (val == "right") drawstep->xAlign = Graphics::DrawStep::kVectorAlignRight; else return parserError("Invalid value for X Position"); } else { return parserError("When width is not set to 'auto', a tag must be included."); } } if (stepNode->values.contains("height") && stepNode->values["height"] != "auto") { drawstep->autoHeight = false; val = stepNode->values["height"]; if (parseIntegerKey(val.c_str(), 1, &x)) drawstep->h = x; else if (val == "width") drawstep->h = -1; else return parserError("Invalid value for vector height."); if (stepNode->values.contains("ypos")) { val = stepNode->values["ypos"]; if (parseIntegerKey(val.c_str(), 1, &x)) drawstep->y = x; else if (val == "center") drawstep->yAlign = Graphics::DrawStep::kVectorAlignCenter; else if (val == "top") drawstep->yAlign = Graphics::DrawStep::kVectorAlignTop; else if (val == "bottom") drawstep->yAlign = Graphics::DrawStep::kVectorAlignBottom; else return parserError("Invalid value for Y Position"); } else { return parserError("When height is not set to 'auto', a tag must be included."); } } if (drawstep->h == -1 && drawstep->w == -1) return parserError("Cross-reference in Vector Size: Height is set to width and width is set to height."); } if (stepNode->values.contains("fill")) { val = stepNode->values["fill"]; if (val == "none") drawstep->fillMode = Graphics::VectorRenderer::kFillDisabled; else if (val == "foreground") drawstep->fillMode = Graphics::VectorRenderer::kFillForeground; else if (val == "background") drawstep->fillMode = Graphics::VectorRenderer::kFillBackground; else if (val == "gradient") drawstep->fillMode = Graphics::VectorRenderer::kFillGradient; else return parserError("'%s' is not a valid fill mode for a shape.", stepNode->values["fill"].c_str()); } #undef __PARSER_ASSIGN_INT #undef __PARSER_ASSIGN_RGB return true; } bool ThemeParser::parserCallback_def(ParserNode *node) { if (resolutionCheck(node->values["resolution"]) == false) { node->ignore = true; return true; } Common::String var = "Globals." + node->values["var"]; int value; if (_theme->getEvaluator()->hasVar(node->values["value"]) == true) value = _theme->getEvaluator()->getVar(node->values["value"]); else if (!parseIntegerKey(node->values["value"].c_str(), 1, &value)) return parserError("Invalid definition for '%s'.", var.c_str()); _theme->getEvaluator()->setVar(var, value); return true; } bool ThemeParser::parserCallback_widget(ParserNode *node) { Common::String var; if (getParentNode(node)->name == "globals") { if (resolutionCheck(node->values["resolution"]) == false) { node->ignore = true; return true; } var = "Globals." + node->values["name"] + "."; if (!parseCommonLayoutProps(node, var)) return parserError("Error when parsing Layout properties of '%s'.", var.c_str()); } else { var = node->values["name"]; int width = -1; int height = -1; bool enabled = true; if (node->values.contains("enabled")) { if (node->values["enabled"] == "false") enabled = false; else if (node->values["enabled"] != "true") return parserError("Invalid value for Widget enabling (expecting true/false)"); } if (node->values.contains("width")) { if (_theme->getEvaluator()->hasVar(node->values["width"]) == true) width = _theme->getEvaluator()->getVar(node->values["width"]); else if (!parseIntegerKey(node->values["width"].c_str(), 1, &width)) return parserError("Corrupted width value in key for %s", var.c_str()); } if (node->values.contains("height")) { if (_theme->getEvaluator()->hasVar(node->values["height"]) == true) height = _theme->getEvaluator()->getVar(node->values["height"]); else if (!parseIntegerKey(node->values["height"].c_str(), 1, &height)) return parserError("Corrupted height value in key for %s", var.c_str()); } _theme->getEvaluator()->addWidget(var, width, height, node->values["type"], enabled); } return true; } bool ThemeParser::parserCallback_dialog(ParserNode *node) { Common::String var = "Dialog." + node->values["name"]; bool enabled = true; int inset = 0; if (resolutionCheck(node->values["resolution"]) == false) { node->ignore = true; return true; } if (node->values.contains("enabled")) { if (node->values["enabled"] == "false") enabled = false; else if (node->values["enabled"] != "true") return parserError("Invalid value for Dialog enabling (expecting true/false)"); } if (node->values.contains("inset")) { if (!parseIntegerKey(node->values["inset"].c_str(), 1, &inset)) return false; } _theme->getEvaluator()->addDialog(var, node->values["overlays"], enabled, inset); if (node->values.contains("shading")) { int shading = 0; if (node->values["shading"] == "dim") shading = 1; else if (node->values["shading"] == "luminance") shading = 2; else return parserError("Invalid value for Dialog background shading."); _theme->getEvaluator()->setVar(var + ".Shading", shading); } return true; } bool ThemeParser::parserCallback_import(ParserNode *node) { if (!_theme->getEvaluator()->addImportedLayout(node->values["layout"])) return parserError("Error when importing external layout"); return true; } bool ThemeParser::parserCallback_layout(ParserNode *node) { int spacing = -1; if (node->values.contains("spacing")) { if (!parseIntegerKey(node->values["spacing"].c_str(), 1, &spacing)) return false; } if (node->values["type"] == "vertical") _theme->getEvaluator()->addLayout(GUI::ThemeLayout::kLayoutVertical, spacing, node->values["center"] == "true"); else if (node->values["type"] == "horizontal") _theme->getEvaluator()->addLayout(GUI::ThemeLayout::kLayoutHorizontal, spacing, node->values["center"] == "true"); else return parserError("Invalid layout type. Only 'horizontal' and 'vertical' layouts allowed."); if (node->values.contains("padding")) { int paddingL, paddingR, paddingT, paddingB; if (!parseIntegerKey(node->values["padding"].c_str(), 4, &paddingL, &paddingR, &paddingT, &paddingB)) return false; _theme->getEvaluator()->addPadding(paddingL, paddingR, paddingT, paddingB); } return true; } bool ThemeParser::parserCallback_space(ParserNode *node) { int size = -1; if (node->values.contains("size")) { if (_theme->getEvaluator()->hasVar(node->values["size"])) size = _theme->getEvaluator()->getVar(node->values["size"]); else if (!parseIntegerKey(node->values["size"].c_str(), 1, &size)) return parserError("Invalid value for Spacing size."); } _theme->getEvaluator()->addSpace(size); return true; } bool ThemeParser::closedKeyCallback(ParserNode *node) { if (node->name == "layout") _theme->getEvaluator()->closeLayout(); else if (node->name == "dialog") _theme->getEvaluator()->closeDialog(); return true; } bool ThemeParser::parseCommonLayoutProps(ParserNode *node, const Common::String &var) { if (node->values.contains("size")) { int width, height; if (!parseIntegerKey(node->values["size"].c_str(), 2, &width, &height)) { Common::StringTokenizer tokenizer(node->values["size"], " ,"); Common::String wtoken, htoken; char *parseEnd; wtoken = tokenizer.nextToken(); if (_theme->getEvaluator()->hasVar(wtoken)) { width = _theme->getEvaluator()->getVar(wtoken); } else { width = strtol(wtoken.c_str(), &parseEnd, 10); if (*parseEnd != 0 && !(*parseEnd == '%' && *(parseEnd + 1) == 0)) return false; if (wtoken.lastChar() == '%') width = g_system->getOverlayWidth() * width / 100; } htoken = tokenizer.nextToken(); if (_theme->getEvaluator()->hasVar(htoken)) { height = _theme->getEvaluator()->getVar(htoken); } else { height = strtol(htoken.c_str(), &parseEnd, 10); if (*parseEnd != 0 && !(*parseEnd == '%' && *(parseEnd + 1) == 0)) return false; if (htoken.lastChar() == '%') height = g_system->getOverlayHeight() * height / 100; } if (!tokenizer.empty()) return false; } _theme->getEvaluator()->setVar(var + "Width", width); _theme->getEvaluator()->setVar(var + "Height", height); } if (node->values.contains("pos")) { int x, y; if (!parseIntegerKey(node->values["pos"].c_str(), 2, &x, &y)) { Common::StringTokenizer tokenizer(node->values["pos"], " ,"); Common::String xpos, ypos; char *parseEnd; xpos = tokenizer.nextToken(); if (xpos == "center") { if (!_theme->getEvaluator()->hasVar(var + "Width")) return false; x = (g_system->getOverlayWidth() / 2) - (_theme->getEvaluator()->getVar(var + "Width") / 2); } else if (_theme->getEvaluator()->hasVar(xpos)) { x = _theme->getEvaluator()->getVar(xpos); } else { x = strtol(xpos.c_str(), &parseEnd, 10); if (*parseEnd != 0 && !(*parseEnd == 'r' && *(parseEnd + 1) == 0)) return false; if (xpos.lastChar() == 'r') x = g_system->getOverlayWidth() - x; } ypos = tokenizer.nextToken(); if (ypos == "center") { if (!_theme->getEvaluator()->hasVar(var + "Height")) return false; y = (g_system->getOverlayHeight() / 2) - (_theme->getEvaluator()->getVar(var + "Height") / 2); } else if (_theme->getEvaluator()->hasVar(ypos)) { y = _theme->getEvaluator()->getVar(ypos); } else { y = strtol(ypos.c_str(), &parseEnd, 10); if (*parseEnd != 0 && !(*parseEnd == 'b' && *(parseEnd + 1) == 0)) return false; if (ypos.lastChar() == 'b') y = g_system->getOverlayHeight() - y; } if (!tokenizer.empty()) return false; } _theme->getEvaluator()->setVar(var + "X", x); _theme->getEvaluator()->setVar(var + "Y", y); } if (node->values.contains("padding")) { int paddingL, paddingR, paddingT, paddingB; if (!parseIntegerKey(node->values["padding"].c_str(), 4, &paddingL, &paddingR, &paddingT, &paddingB)) return false; _theme->getEvaluator()->setVar(var + "Padding.Left", paddingL); _theme->getEvaluator()->setVar(var + "Padding.Right", paddingR); _theme->getEvaluator()->setVar(var + "Padding.Top", paddingT); _theme->getEvaluator()->setVar(var + "Padding.Bottom", paddingB); } return true; } bool ThemeParser::resolutionCheck(const Common::String &resolution) { if (resolution.empty()) return true; Common::StringTokenizer globTokenizer(resolution, ", "); Common::String cur, w, h; bool definedRes = false; while (!globTokenizer.empty()) { bool ignore = false; cur = globTokenizer.nextToken(); if (cur[0] == '-') { ignore = true; cur.deleteChar(0); } else { definedRes = true; } Common::StringTokenizer resTokenizer(cur, "x"); w = resTokenizer.nextToken(); h = resTokenizer.nextToken(); if ((w == "X" || atoi(w.c_str()) == g_system->getOverlayWidth()) && (h == "Y" || atoi(h.c_str()) == g_system->getOverlayHeight())) return !ignore; } return !definedRes; } } // End of namespace GUI